Zuul的內(nèi)置過(guò)濾器?詳解(源碼解析)

從技術(shù)角度來(lái)說(shuō),Zuul的的核心就是一系列的過(guò)濾器。這些過(guò)濾器都實(shí)現(xiàn)了ZuulFilter接口旺聚。

Zuul的過(guò)濾器ZuulFilter與Spring的過(guò)濾器Filter有什么區(qū)別?


一,ZuulFilter


ZuulFilter是一個(gè)抽象類(lèi)煎谍。ZuulFilter實(shí)現(xiàn)了IZuulFilter接口、Comparable接口阻逮。

繼承ZuulFilter的類(lèi)需要實(shí)現(xiàn)下面4個(gè)方法:

filterType():過(guò)濾器類(lèi)型粱快,可選值有4個(gè),pre叔扼、route事哭、post、error瓜富。

filterOrder():過(guò)濾器執(zhí)行的優(yōu)先級(jí)鳍咱。當(dāng)某種類(lèi)型的過(guò)濾器有多個(gè)時(shí),根據(jù)優(yōu)先級(jí)依次執(zhí)行与柑。

shouldFilter():判斷過(guò)濾器是否需要執(zhí)行谤辜。可以通過(guò)這個(gè)方法來(lái)限制過(guò)濾器的執(zhí)行條件价捧。

run():過(guò)濾器的具體執(zhí)行邏輯丑念。


二,pre過(guò)濾器


1结蟋,ServletDetectionFilter

ServletDetectionFilter:檢查請(qǐng)求是否經(jīng)過(guò)DispatcherServlet的轉(zhuǎn)發(fā)脯倚。如果經(jīng)過(guò),則把

isDispatcherServletRequest置為true嵌屎,否則置為false推正。


2,F(xiàn)ormBodyWrapperFilter

filterOrder=-1

解析表單數(shù)據(jù)宝惰,并為請(qǐng)求重新編碼植榕。


3,DebugFilter

調(diào)試過(guò)濾器尼夺。源碼很簡(jiǎn)單:

RequestContext ctx =

RequestContext.getCurrentContext();

ctx.setDebugRouting(true);

ctx.setDebugRequest(true);

該過(guò)濾器可以控制debug日志的打印尊残。如果需要打印debug日志炒瘸,我們可以這樣設(shè)置:

zuul.debug.request=true

這樣就可以打印相關(guān)的debug日志,這對(duì)于我們定位zuul的問(wèn)題有幫助夜郁。例如下面這段代碼:

if(RequestContext.getCurrentContext().debugRouting()){…}

Zuul會(huì)根據(jù)debugRoute來(lái)判斷是否打印這條日志信息什燕。

4,PreDecorationFilter

根據(jù)提供的RouteLocator竞端,設(shè)置路由地址屎即。還會(huì)設(shè)置這些屬性:requestURI、proxy事富、

retryable技俐、forward.to、serviceId统台、Host等屬性雕擂。


5,TracePreZuulFilter

結(jié)合Sleuth實(shí)現(xiàn)鏈路追蹤功能贱勃。


6井赌,Servlet30WrapperFilter

對(duì)原始請(qǐng)求進(jìn)行包裝,為什么要包裝一下呢贵扰?包裝就是為了拿過(guò)來(lái)仇穗,然后有必要的話方便擴(kuò)展。

原始請(qǐng)求:HttpServletRequest

包裝后請(qǐng)求:Servlet30RequestWrapper



三戚绕,route過(guò)濾器

1纹坐,SendForwardFilter

這個(gè)過(guò)濾器的優(yōu)先級(jí)是500,在route過(guò)濾器的實(shí)現(xiàn)中是最大的舞丛。也就是說(shuō)三個(gè)route過(guò)濾器耘子,SendForwardFilter最后執(zhí)行。

SendForwardFilter過(guò)濾器的執(zhí)行需要滿(mǎn)足下面的條件:

RequestContext中包含屬性:forward.to

RequestContext中包含屬性:sendForwardFilter.ran并且值為true

SendForwardFilter是根據(jù)forward.to配置的url來(lái)轉(zhuǎn)發(fā)請(qǐng)求的球切。

RequestDispatcher dispatcher = cxt.getRequest().getRequestDispatcher(path);

if(dispatcher != null){

? ? ctx.set("sendForwardFilter.ran", true);

? ? if(!ctx.getResponse().isCommited()){

? ? ? ? dispatcher.forward(cxt.getRequest(), ctx.getResponse());

? ? ? ? ctx.getResponse().flushBuffer();

? ? }

}

SendForwardFilter與下面兩種過(guò)濾器的區(qū)別是:SendForwardFilter使用ApplicationDispatcher來(lái)轉(zhuǎn)發(fā)請(qǐng)求谷誓。


2,RibbonRoutingFilter

RibbonRoutingFilter過(guò)濾器的執(zhí)行需要滿(mǎn)足下面的條件:

RequestContext中不包含屬性:routeHost

RequestContext中包含屬性:serviceId

RequestContext中包含屬性:sendZuulResponse并且值為true

RibbonRoutingFilter與SendForwardFilter的區(qū)別是RibbonRoutingFilter使用robbin來(lái)請(qǐng)求微服務(wù)吨凑。


3片林,SimpleHostRoutingFilter

SimpleHostRoutingFilter過(guò)濾器的執(zhí)行需要滿(mǎn)足下面的條件:

RequestContext中包含屬性:routeHost

RequestContext中包含屬性:sendZuulResponse并且值為true

SimpleHostRoutingFilter與RibbonRoutingFilter的區(qū)別是:RibbonRoutingFilter使用robbin來(lái)請(qǐng)求微服務(wù),而SimpleHostRoutingFilter是通過(guò)HttpClient來(lái)轉(zhuǎn)發(fā)請(qǐng)求怀骤。


四,post過(guò)濾器


1焕妙,SendResponseFilter

SendResponseFilter主要做兩件事:

// 從RequestContext中取出微服務(wù)的響應(yīng)結(jié)果蒋伦,然后封裝到HttpServletResponse中。

this.addResponseHeaders();

// 把響應(yīng)結(jié)果寫(xiě)入輸出流焚鹊,發(fā)送給客戶(hù)端痕届。

this.writeResponse();


五韧献,error過(guò)濾器


1,SendErrorFilter

轉(zhuǎn)發(fā)請(qǐng)求到/error研叫。這里的路徑是可配置的锤窑。

首先會(huì)從ZuulException中拿到具體的異常信息:

RequestContext ctx =

RequestContext.getCurrentContext();

ZuulException exception = this.findZuulException(ctx.getThrowable());

HttpServletRequest request =

ctx.getRequest();

然后把異常信息放到request,最后轉(zhuǎn)發(fā)請(qǐng)求到指定路徑嚷炉。

RequestDispatcher dispatcher = request.getRequestDispatcher(this.errorPath);

if(dispatcher != null){

? ? ctx.set("sendErrorFilter.ran", true);

? ? if(!ctx.getResponse().isCommited()){

? ? ? ? dispatcher.forward(request, ctx.getResponse())

? ? }



六渊啰,Zuul內(nèi)置的特殊過(guò)濾器


zuul還提供了一類(lèi)特殊的過(guò)濾器,分別為:StaticResponseFilter和SurgicalDebugFilter

StaticResponseFilter:StaticResponseFilter允許從Zuul本身生成響應(yīng)申屹,而不是將請(qǐng)求轉(zhuǎn)發(fā)到源绘证。也就是說(shuō),Zuul接收到請(qǐng)求后哗讥,直接返回給客戶(hù)端嚷那,不再轉(zhuǎn)發(fā)給其他微服務(wù)击碗。

SurgicalDebugFilter:SurgicalDebugFilter允許將特定請(qǐng)求路由到分隔的調(diào)試集群或主機(jī)戒良。


六,Zuul過(guò)濾器的優(yōu)先級(jí)


ServletDetectionFilter:-3

Servlet30WrapperFilter:-2

FormBodyWrapperFilter:-1

SendErrorFilter:0

DebugFilter:1

PreDecorationFilter:5

RibbonRoutingFulter:10

SimpleHostRoutingFilter:100

SendForwardFilter:500

SendResponseFilter:1000

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末滴肿,一起剝皮案震驚了整個(gè)濱河市决乎,隨后出現(xiàn)的幾起案子队询,更是在濱河造成了極大的恐慌,老刑警劉巖瑞驱,帶你破解...
    沈念sama閱讀 219,539評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件娘摔,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡唤反,警方通過(guò)查閱死者的電腦和手機(jī)凳寺,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,594評(píng)論 3 396
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)彤侍,“玉大人肠缨,你說(shuō)我怎么就攤上這事≌到祝” “怎么了晒奕?”我有些...
    開(kāi)封第一講書(shū)人閱讀 165,871評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)名斟。 經(jīng)常有香客問(wèn)我脑慧,道長(zhǎng),這世上最難降的妖魔是什么砰盐? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,963評(píng)論 1 295
  • 正文 為了忘掉前任闷袒,我火速辦了婚禮,結(jié)果婚禮上岩梳,老公的妹妹穿的比我還像新娘囊骤。我一直安慰自己晃择,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,984評(píng)論 6 393
  • 文/花漫 我一把揭開(kāi)白布也物。 她就那樣靜靜地躺著宫屠,像睡著了一般。 火紅的嫁衣襯著肌膚如雪滑蚯。 梳的紋絲不亂的頭發(fā)上浪蹂,一...
    開(kāi)封第一講書(shū)人閱讀 51,763評(píng)論 1 307
  • 那天,我揣著相機(jī)與錄音膘魄,去河邊找鬼乌逐。 笑死,一個(gè)胖子當(dāng)著我的面吹牛创葡,可吹牛的內(nèi)容都是我干的浙踢。 我是一名探鬼主播,決...
    沈念sama閱讀 40,468評(píng)論 3 420
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼灿渴,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼洛波!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起骚露,我...
    開(kāi)封第一講書(shū)人閱讀 39,357評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤蹬挤,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后棘幸,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體焰扳,經(jīng)...
    沈念sama閱讀 45,850評(píng)論 1 317
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,002評(píng)論 3 338
  • 正文 我和宋清朗相戀三年误续,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了吨悍。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,144評(píng)論 1 351
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡蹋嵌,死狀恐怖育瓜,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情栽烂,我是刑警寧澤躏仇,帶...
    沈念sama閱讀 35,823評(píng)論 5 346
  • 正文 年R本政府宣布,位于F島的核電站腺办,受9級(jí)特大地震影響焰手,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜怀喉,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,483評(píng)論 3 331
  • 文/蒙蒙 一册倒、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧磺送,春花似錦驻子、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 32,026評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至馅袁,卻和暖如春域慷,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背汗销。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,150評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工犹褒, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人弛针。 一個(gè)月前我還...
    沈念sama閱讀 48,415評(píng)論 3 373
  • 正文 我出身青樓叠骑,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親削茁。 傳聞我的和親對(duì)象是個(gè)殘疾皇子宙枷,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,092評(píng)論 2 355