zuul过滤器
過(guò)濾器(filter)是zuul的核心組件 zuul大部分功能都是通過(guò)過(guò)濾器來(lái)實(shí)現(xiàn)的。 zuul中定義了4種標(biāo)準(zhǔn)過(guò)濾器類(lèi)型,這些過(guò)濾器類(lèi)型對(duì)應(yīng)于請(qǐng)求的典型生命周期。
PRE:這種過(guò)濾器在請(qǐng)求被路由之前調(diào)用。可利用這種過(guò)濾器實(shí)現(xiàn)身份驗(yàn)證、在 集群中選擇請(qǐng)求的微服務(wù)、記錄調(diào)試信息等。 ROUTING:這種過(guò)濾器將請(qǐng)求路由到微服務(wù)。這種過(guò)濾器用于構(gòu)建發(fā)送給微服 務(wù)的請(qǐng)求,并使用 Apache HttpCIient或 Netfilx Ribbon請(qǐng)求微服務(wù) POST:這種過(guò)濾器在路由到微服務(wù)以后執(zhí)行。這種過(guò)濾器可用來(lái)為響應(yīng)添加標(biāo)準(zhǔn) 的 HTTP Header、收集統(tǒng)計(jì)信息和指標(biāo)、將響應(yīng)從微服務(wù)發(fā)送給客戶(hù)端等。 ERROR:在其他階段發(fā)生錯(cuò)誤時(shí)執(zhí)行該過(guò)濾器。
如果要編寫(xiě)一個(gè)過(guò)濾器,則需繼承ZuulFilter類(lèi) 實(shí)現(xiàn)其中方法:
@Component public class LogFilter extends ZuulFilter {@Overridepublic String filterType() {return FilterConstants.ROUTE_TYPE;}@Overridepublic int filterOrder() {return FilterConstants.PRE_DECORATION_FILTER_ORDER;}@Overridepublic boolean shouldFilter() {return true;}@Overridepublic Object run() throws ZuulException {RequestContext currentContext = RequestContext.getCurrentContext();HttpServletRequest request = currentContext.getRequest();String remoteAddr = request.getRemoteAddr();System.out.println("訪(fǎng)問(wèn)者IP:"+remoteAddr+"訪(fǎng)問(wèn)地址:"+request.getRequestURI());return null;} }由代碼可知,自定義的 zuul Filter需實(shí)現(xiàn)以下幾個(gè)方法。
filterType:返回過(guò)濾器的類(lèi)型。有 pre、 route、 post、 error等幾種取值,分別對(duì)應(yīng)上文的幾種過(guò)濾器。
詳細(xì)可以參考 com.netflix.zuul.ZuulFilter.filterType()中的注釋。
filter0rder:返回一個(gè) int值來(lái)指定過(guò)濾器的執(zhí)行順序,不同的過(guò)濾器允許返回相同的數(shù)字。
shouldFilter:返回一個(gè) boolean值來(lái)判斷該過(guò)濾器是否要執(zhí)行, true表示執(zhí)行, false表示不執(zhí)行。
run:過(guò)濾器的具體邏輯。
禁用zuul過(guò)濾器 Spring Cloud默認(rèn)為Zuul編寫(xiě)并啟用了一些過(guò)濾器,例如DebugFilter、 FormBodyWrapperFilter等,這些過(guò)濾器都存放在spring-cloud-netflix-core這個(gè)jar包 里,一些場(chǎng)景下,想要禁用掉部分過(guò)濾器,該怎么辦呢? 只需在application.yml里設(shè)置zuul...disable=true 例如,要禁用上面我們寫(xiě)的過(guò)濾器,這樣配置就行了: zuul.LogFilter.pre.disable=true
?
總結(jié)