spring cloud 网关,依赖于netflix 下的zuul 组件
zuul 的流程是,自定义 了zuulservletfilter和zuulservlet两种方式,让开发者可以去实现,并调用
先来看下zuulservletfilter的实现片段
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
@override public void dofilter(servletrequest servletrequest, servletresponse servletresponse, filterchain filterchain) throws ioexception, servletexception { try { init((httpservletrequest) servletrequest, (httpservletresponse) servletresponse); try { prerouting(); } catch (zuulexception e) { error(e); postrouting(); return ; } // only forward onto to the chain if a zuul response is not being sent if (!requestcontext.getcurrentcontext().sendzuulresponse()) { filterchain.dofilter(servletrequest, servletresponse); return ; } try { routing(); } catch (zuulexception e) { error(e); postrouting(); return ; } try { postrouting(); } catch (zuulexception e) { error(e); return ; } } catch (throwable e) { error( new zuulexception(e, 500 , "uncaught_exception_from_filter_" + e.getclass().getname())); } finally { requestcontext.getcurrentcontext().unset(); } } |
从上面的代码可以看到,比较关心的是prerouting、routing,postrouting三个方法 ,这三个方法会调用 注册为zuulfilter的子类,首先来看下这三个方法
prerouting: 是路由前会做一些内容
routing():开始路由事项
postrouting:路由结束,不管是否有错误都会经过该方法
那这三个方法是怎么和zuulfilter
联系在一起的呢?
先来分析下 prerouting:
1
2
3
|
void postrouting() throws zuulexception { zuulrunner.postroute(); } |
同时 zuulrunner
再来调用
1
2
3
|
public void postroute() throws zuulexception { filterprocessor.getinstance().postroute(); } |
最终调用 filterprocessor
的 runfilters
1
2
3
4
5
6
7
8
9
|
public void preroute() throws zuulexception { try { runfilters( "pre" ); } catch (zuulexception e) { throw e; } catch (throwable e) { throw new zuulexception(e, 500 , "uncaught_exception_in_pre_filter_" + e.getclass().getname()); } } |
看到了runfilters 是通过 filtertype(pre ,route ,post )来过滤出已经注册的 zuulfilter:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
public object runfilters(string stype) throws throwable { if (requestcontext.getcurrentcontext().debugrouting()) { debug.addroutingdebug( "invoking {" + stype + "} type filters" ); } boolean bresult = false ; //通过stype获取 zuulfilter的列表 list<zuulfilter> list = filterloader.getinstance().getfiltersbytype(stype); if (list != null ) { for ( int i = 0 ; i < list.size(); i++) { zuulfilter zuulfilter = list.get(i); object result = processzuulfilter(zuulfilter); if (result != null && result instanceof boolean ) { bresult |= (( boolean ) result); } } } return bresult; } |
再来看下 zuulfilter的定义
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
public abstract class zuulfilter implements izuulfilter, comparable<zuulfilter> { private final dynamicbooleanproperty filterdisabled = dynamicpropertyfactory.getinstance().getbooleanproperty(disablepropertyname(), false ); /** * to classify a filter by type. standard types in zuul are "pre" for pre-routing filtering, * "route" for routing to an origin, "post" for post-routing filters, "error" for error handling. * we also support a "static" type for static responses see staticresponsefilter. * any filtertype made be created or added and run by calling filterprocessor.runfilters(type) * * @return a string representing that type */ abstract public string filtertype(); /** * filterorder() must also be defined for a filter. filters may have the same filterorder if precedence is not * important for a filter. filterorders do not need to be sequential. * * @return the int order of a filter */ abstract public int filterorder(); /** * by default zuulfilters are static; they don't carry state. this may be overridden by overriding the isstaticfilter() property to false * * @return true by default */ public boolean isstaticfilter() { return true ; } |
只列出了一部分字段,但可以看到filtertype和filterorder两个字段,这两个分别是指定filter是什么类型,排序
这两个决定了实现的zuulfilter会在什么阶段被执行,按什么顺序执行
当选择好已经注册的zuulfilter后,会调用zuulfilter的runfilter
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
public zuulfilterresult runfilter() { zuulfilterresult zr = new zuulfilterresult(); if (!isfilterdisabled()) { if (shouldfilter()) { tracer t = tracerfactory.instance().startmicrotracer( "zuul::" + this .getclass().getsimplename()); try { object res = run(); zr = new zuulfilterresult(res, executionstatus.success); } catch (throwable e) { t.setname( "zuul::" + this .getclass().getsimplename() + " failed" ); zr = new zuulfilterresult(executionstatus.failed); zr.setexception(e); } finally { t.stopandlog(); } } else { zr = new zuulfilterresult(executionstatus.skipped); } } return zr; } |
其中run 是一个zuulfilter的一个抽象方法
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
public interface izuulfilter { /** * a "true" return from this method means that the run() method should be invoked * * @return true if the run() method should be invoked. false will not invoke the run() method */ boolean shouldfilter(); /** * if shouldfilter() is true, this method will be invoked. this method is the core method of a zuulfilter * * @return some arbitrary artifact may be returned. current implementation ignores it. */ object run(); } |
所以,实现zuulfilter的子类要重写 run方法,我们来看下 其中一个阶段的实现 predecorationfilter 这个类是spring cloud封装的在使用zuul 作为转发的代码服务器时进行封装的对象,目的是为了决定当前的要转发的请求是按serviceid,http请求,还是forward来作转发
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
@override public object run() { requestcontext ctx = requestcontext.getcurrentcontext(); final string requesturi = this .urlpathhelper.getpathwithinapplication(ctx.getrequest()); route route = this .routelocator.getmatchingroute(requesturi); if (route != null ) { string location = route.getlocation(); if (location != null ) { ctx.put( "requesturi" , route.getpath()); ctx.put( "proxy" , route.getid()); if (!route.iscustomsensitiveheaders()) { this .proxyrequesthelper .addignoredheaders( this .properties.getsensitiveheaders().toarray( new string[ 0 ])); } else { this .proxyrequesthelper.addignoredheaders(route.getsensitiveheaders().toarray( new string[ 0 ])); } if (route.getretryable() != null ) { ctx.put( "retryable" , route.getretryable()); } // 如果配置的转发地址是http开头,会设置 routehost if (location.startswith( "http:" ) || location.startswith( "https:" )) { ctx.setroutehost(geturl(location)); ctx.addoriginresponseheader( "x-zuul-service" , location); } // 如果配置的转发地址forward,则会设置forward.to else if (location.startswith( "forward:" )) { ctx.set( "forward.to" , stringutils.cleanpath(location.substring( "forward:" .length()) + route.getpath())); ctx.setroutehost( null ); return null ; } else { // 否则以serviceid进行转发 // set serviceid for use in filters.route.ribbonrequest ctx.set( "serviceid" , location); ctx.setroutehost( null ); ctx.addoriginresponseheader( "x-zuul-serviceid" , location); } if ( this .properties.isaddproxyheaders()) { addproxyheaders(ctx, route); string xforwardedfor = ctx.getrequest().getheader( "x-forwarded-for" ); string remoteaddr = ctx.getrequest().getremoteaddr(); if (xforwardedfor == null ) { xforwardedfor = remoteaddr; } else if (!xforwardedfor.contains(remoteaddr)) { // prevent duplicates xforwardedfor += ", " + remoteaddr; } ctx.addzuulrequestheader( "x-forwarded-for" , xforwardedfor); } if ( this .properties.isaddhostheader()) { ctx.addzuulrequestheader( "host" , tohostheader(ctx.getrequest())); } } } else { log.warn( "no route found for uri: " + requesturi); string fallbackuri = requesturi; string fallbackprefix = this .dispatcherservletpath; // default fallback // servlet is // dispatcherservlet if (requestutils.iszuulservletrequest()) { // remove the zuul servletpath from the requesturi log.debug( "zuulservletpath=" + this .properties.getservletpath()); fallbackuri = fallbackuri.replacefirst( this .properties.getservletpath(), "" ); log.debug( "replaced zuul servlet path:" + fallbackuri); } else { // remove the dispatcherservlet servletpath from the requesturi log.debug( "dispatcherservletpath=" + this .dispatcherservletpath); fallbackuri = fallbackuri.replacefirst( this .dispatcherservletpath, "" ); log.debug( "replaced dispatcherservlet servlet path:" + fallbackuri); } if (!fallbackuri.startswith( "/" )) { fallbackuri = "/" + fallbackuri; } string forwarduri = fallbackprefix + fallbackuri; forwarduri = forwarduri.replaceall( "//" , "/" ); ctx.set( "forward.to" , forwarduri); } return null ; } |
这个前置处理,是为了后面决定以哪种zuulfilter来处理当前的请求 ,如 simplehostroutingfilter,这个的filtertype是post ,当 ``predecorationfilter设置了requestcontext中的 routehost,如 simplehostroutingfilter中的判断
1
2
3
4
5
|
@override public boolean shouldfilter() { return requestcontext.getcurrentcontext().getroutehost() != null && requestcontext.getcurrentcontext().sendzuulresponse(); } |
在 simplehostroutingfilter中的run中,真正实现地址转发的内容,其实质是调用 httpclient进行请求
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
@override public object run() { requestcontext context = requestcontext.getcurrentcontext(); httpservletrequest request = context.getrequest(); multivaluemap<string, string> headers = this .helper .buildzuulrequestheaders(request); multivaluemap<string, string> params = this .helper .buildzuulrequestqueryparams(request); string verb = getverb(request); inputstream requestentity = getrequestbody(request); if (request.getcontentlength() < 0 ) { context.setchunkedrequestbody(); } string uri = this .helper.buildzuulrequesturi(request); this .helper.addignoredheaders(); try { httpresponse response = forward( this .httpclient, verb, uri, request, headers, params, requestentity); setresponse(response); } catch (exception ex) { context.set(error_status_code, httpservletresponse.sc_internal_server_error); context.set( "error.exception" , ex); } return null ; } |
最后如果是成功能,会调用 注册 为post的zuulfilter ,目前有两个 senderrorfilter 和 sendresponsefilter 这两个了,一个是处理错误,一个是处理成功的结果
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:https://www.jianshu.com/p/295e51bc1518