Spring Cloud內(nèi)置的Zuul過濾器詳解
我是51CTO學(xué)院講師周立，在51CTO學(xué)院“4.20 IT充電節(jié)”(4月19~20日)到來之際，和大家分享一下《Spring Cloud內(nèi)置的Zuul過濾器應(yīng)用》的經(jīng)驗(yàn)。正文來啦~~~
Spring Cloud默認(rèn)為Zuul編寫并啟用了一些過濾器，這些過濾器有什么作用呢?我們不妨按照@EnableZuulServer、@EnableZuulProxy兩個(gè)注解進(jìn)行展開，相信大家對(duì)這兩個(gè)注解都不陌生(至少都見過吧)。如果覺得陌生也沒有關(guān)系，可將@EnableZuulProxy簡(jiǎn)單理解為@EnableZuulServer的增強(qiáng)版。事實(shí)上，當(dāng)Zuul與Eureka、Ribbon等組件配合使用時(shí)，@EnableZuulProxy是我們常用的注解。
在Spring Cloud的官方文檔中，只說@EnableZuulServer是一個(gè)“空白”的Zuul，那么究竟空白在什么地方呢?與@EnableZuulProxy到底有什么區(qū)別呢?諸多問題，都將在本文找到答案。
在此之前，我們先理解什么是RequestContext：
RequestContext：用于在過濾器之間傳遞消息。它的數(shù)據(jù)保存在每個(gè)請(qǐng)求的ThreadLocal中。它用于存儲(chǔ)請(qǐng)求路由到哪里、錯(cuò)誤、HttpServletRequest、HttpServletResponse都存儲(chǔ)在RequestContext中。RequestContext擴(kuò)展了ConcurrentHashMap，所以，任何數(shù)據(jù)都可以存儲(chǔ)在上下文中。
@EnableZuulServer過濾器
一、pre類型過濾器
(1) ServletDetectionFilter：該過濾器用于檢查請(qǐng)求是否通過Spring Dispatcher。檢查后，通過isDispatcherServletRequest設(shè)置布爾值。
(2) FormBodyWrapperFilter：解析表單數(shù)據(jù)，并為請(qǐng)求重新編碼。
(3) DebugFilter：顧名思義，調(diào)試用的過濾器，可以通過zuul.debug.request=true，或在請(qǐng)求時(shí)，加上debug=true的參數(shù)，例如$ZUUL_HOST:ZUUL_PORT/path?debug=true開啟該過濾器。這樣，該過濾器就會(huì)把RequestContext.setDebugRouting()、RequestContext.setDebugRequest()設(shè)為true。
二、route類型過濾器
SendForwardFilter：該過濾器使用Servlet RequestDispatcher轉(zhuǎn)發(fā)請(qǐng)求，轉(zhuǎn)發(fā)位置存儲(chǔ)在RequestContext.getCurrentContext().get("forward.to")中。可以將路由設(shè)置成：
- zuul:
- routes:
- abc:
- path: /abc/**
- url: forward:/abc
然后訪問$ZUUL_HOST:ZUUL_PORT/abc，觀察該過濾器的執(zhí)行過程。
三、post類型過濾器
SendResponseFilter：將Zuul所代理的微服務(wù)的響應(yīng)寫入當(dāng)前響應(yīng)。
四、error類型過濾器
SendErrorFilter：如果RequestContext.getThrowable()不為null，那么默認(rèn)就會(huì)轉(zhuǎn)發(fā)到/error，也可以設(shè)置error.path屬性修改默認(rèn)的轉(zhuǎn)發(fā)路徑。
@EnableZuulProxy過濾器
如果使用注解@EnableZuulProxy，那么除上述過濾器之外，Spring Cloud還會(huì)安裝以下過濾器：
一、pre類型過濾器
PreDecorationFilter：該過濾器根據(jù)提供的RouteLocator確定路由到的地址，以及怎樣去路由。該路由器也可為后端請(qǐng)求設(shè)置各種代理相關(guān)的header。
二、route類型過濾器
(1) RibbonRoutingFilter：該過濾器使用Ribbon，Hystrix和可插拔的HTTP客戶端發(fā)送請(qǐng)求。serviceId在RequestContext.getCurrentContext().get("serviceId")中。該過濾器可使用不同的HTTP客戶端，例如
Apache HttpClient：默認(rèn)的HTTP客戶端
SquareupOkHttpClient v3：如需使用該客戶端，需保證com.squareup.okhttp3的依賴在classpath中，并設(shè)置ribbon.okhttp.enabled = true。
Netflix Ribbon HTTP client：設(shè)置ribbon.restclient.enabled = true即可啟用該HTTP客戶端。需要注意的是，該客戶端有一定限制，例如不支持PATCH方法，另外，它有內(nèi)置的重試機(jī)制。
(2) SimpleHostRoutingFilter：該過濾器通過Apache HttpClient向指定的URL發(fā)送請(qǐng)求。URL在RequestContext.getRouteHost()中。
51CTO學(xué)院 4.20 IT充電節(jié)
(19-20號(hào)兩天，100門視頻課程免單搶，更有視頻課程會(huì)員享6折，非會(huì)員享7折，套餐折上8折，微職位立減2000元鉅惠)
活動(dòng)鏈接：http://edu.51cto.com/activity/lists/id-47.html?wenzhang
相關(guān)視頻教程：
Spring Cloud微服務(wù)實(shí)戰(zhàn)
