首页 > 代码库 > Struts2 源码分析——调结者(Dispatcher)之action请求
Struts2 源码分析——调结者(Dispatcher)之action请求
| 章节简言 |
上一章笔者讲到关于struts2启动的时候加载对应的准备工作。如加载配置文件struts.xml之类的信息。而相应的这些操作都离不开Dispatcher类的帮助。如果读者只是认为Dispatcher类的作用只有这些。那真的是大错特错了。所以本章笔者将继续讲到关于Dispatcher类的另一个功能。即是StrutsPrepareFilter类俩项工作中的处理request请求相关信息。在讲解之前，笔者还是想把相关的信息回想一下：当项目启动的时候，strtus2也就启动了。然后就会去初始化对应需要的信息（这部分内容上一章已经讲到了）。之后当用户在网址上输入访问的URL的时候。就会进入StrutsPrepareFilter类处理request请求的功能。好了。明白是什么到这一步就可以了。因为下面就是要讲到关于这一部分的内容。
| 调结者的action请求 |
StrutsPrepareFilter类在处理request请求的时候，需要用到一个叫PrepareOperations类的帮忙。PrepareOperations类可以说是StrutsPrepareFilter类和Dispatcher类的中间人。PrepareOperations类大部分的工作都是通过Dispatcher类完成的。先让我们看一段代码。如下
StrutsPrepareFilter类：
public void init(FilterConfig filterConfig) throws ServletException { InitOperations init = new InitOperations();//用于初始化相关的功能操作。你可以理解为工具类一样子。 Dispatcher dispatcher = null;//这个类相当的重要。他的作用连接着StrutsExecuteFilter。这里可以命名为调结者。 try { FilterHostConfig config = new FilterHostConfig(filterConfig);//这里可以理解为把filterConfig在进行封装FilterHostConfig更为主便操作和理解。 init.initLogging(config);//获取名为loggerFactory的参数，并实例化这个类。一般为去用户自定义日志。 dispatcher = init.initDispatcher(config);//初化调结者。这里是重要。 prepare = new PrepareOperations(dispatcher); this.excludedPatterns = init.buildExcludedPatternsList(dispatcher);//加载排除在内的action的正则表达式 postInit(dispatcher, filterConfig); } finally { if (dispatcher != null) { dispatcher.cleanUpAfterInit(); } init.cleanup(); } }
从上面的红色代码我们可以看出来，PrepareOperations类在实例化时候，接受Dispatcher类作为构造函数的参数。即是在struts2启动加载准备工作之后初始化。那么PrepareOperations类到底又做哪些工作呢？让我们在看一下下面的代码。如下
StrutsPrepareFilter类：
1 public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { 2 3 HttpServletRequest request = (HttpServletRequest) req; 4 HttpServletResponse response = (HttpServletResponse) res; 5 6 try { 7 if (excludedPatterns != null && prepare.isUrlExcluded(request, excludedPatterns)) { 8 request.setAttribute(REQUEST_EXCLUDED_FROM_ACTION_MAPPING, new Object()); 9 } else {10 prepare.setEncodingAndLocale(request, response);//设置请求的格式编码。11 prepare.createActionContext(request, response);//action的上下文12 prepare.assignDispatcherToThread();//把Dispatcher放入本地线程里面。13 request = prepare.wrapRequest(request);14 prepare.findActionMapping(request, response);//找到action映射的信息15 }16 chain.doFilter(request, response);17 } finally {18 prepare.cleanupRequest(request);19 }20 }
上面代码我们可以看出PrepareOperations类总共做了五件事情。先让笔者简单的讲解一下：当用户的request请求过来的时候，会判断一下request请求是不是被排除之外的。如果是，则把REQUEST_EXCLUDED_FROM_ACTION_MAPPING常量作为KEY，object实例作为值存放在request的Attrbute里面。这是为后面的StrutsExecuteFilter类作准备(下一章笔者会讲到)。如果不是，则进行request请求处理。如下
1.设置request请求的本地化和格式编码。实现上还是Dispatcher类在做工作。代码如下
PrepareOperations类：
1 /**2 * 设置本地化和请求格式编码3 *4 * @param request servlet request5 * @param response servlet response6 */7 public void setEncodingAndLocale(HttpServletRequest request, HttpServletResponse response) {8 dispatcher.prepare(request, response);9 }
Dispatcher类：
1 /** 2 * 设置请求的本地化和格式编码 3 * 4 * @param request 5 * The request 6 * @param response 7 * The response 8 */ 9 public void prepare(HttpServletRequest request, HttpServletResponse response) {10 String encoding = null;11 if (defaultEncoding != null) {12 encoding = defaultEncoding;13 }14 15 if ("XMLHttpRequest".equals(request.getHeader("X-Requested-With"))) {16 encoding = "UTF-8";17 }18 19 Locale locale = null;20 if (defaultLocale != null) {21 locale = LocalizedTextUtil.localeFromString(defaultLocale, request.getLocale());22 }23 24 if (encoding != null) {25 applyEncoding(request, encoding);26 }27 28 if (locale != null) {29 response.setLocale(locale);30 }31 32 if (paramsWorkaroundEnabled) {33 request.getParameter("foo"); // simply read any parameter (existing34 // or not) to "prime" the request35 }36 }
2.创建Action上下文(ActionContext类),并把上下文存放在本地线程(ThreadLocal)。所谓的上下文可以理解为把相同性质的业务归为一类。而上下文就是这一类和外部相交处。所有的数据操作都可以通过他还完成。当然上下文的定义在不同的地方有不同的意思。请读者自行找阅资料。先让我们看一下代码。如下
PrepareOperations类：
1 /** 2 * 创建Action的上下文 ，并存在到本地线程 3 * 4 * @param request servlet request 5 * @param response servlet response 6 * 7 * @return the action context 8 */ 9 public ActionContext createActionContext(HttpServletRequest request, HttpServletResponse response) {10 ActionContext ctx;11 Integer counter = 1;12 Integer oldCounter = (Integer) request.getAttribute(CLEANUP_RECURSION_COUNTER);13 if (oldCounter != null) {14 counter = oldCounter + 1;15 }16 17 ActionContext oldContext = ActionContext.getContext();18 if (oldContext != null) {19 // 有旧的action上下文，我们可以认为有可能是跳转。20 ctx = new ActionContext(new HashMap<>(oldContext.getContextMap()));21 } else {22 ValueStack stack = dispatcher.getContainer().getInstance(ValueStackFactory.class).createValueStack();//从容器中获得值栈工厂,并新建值栈。23 stack.getContext().putAll(dispatcher.createContextMap(request, response, null));//创建上下MAP并合到值栈里面去。24 ctx = new ActionContext(stack.getContext());//用值栈的上下MAP来新建上下文25 }26 request.setAttribute(CLEANUP_RECURSION_COUNTER, counter);27 ActionContext.setContext(ctx);28 return ctx;29 }
从上面的红色代码我们就能够看出第一次request请求就会创建一个新的action上下文(ActionContext)。同时也能明白ActionContext里面存放大量的关于request请求对应的数据。而这些操作又离不开Dispatcher类的帮忙。最后把上下文(ActionContext类)存放到ActionContext类内部的本地线程(ThreadLocal)。代码ActionContext.setContext(ctx)就是最好的说明。另外，上面有一点让笔者一直不明白为什么这么做。觉得没有什么意义。即是获得request的属性为CLEANUP_RECURSION_COUNTER的值，然后进行计算操作的功能。笔者不得不将他理解为：用于计算request请求跳转action的次数。就是一个request请求的生命周期通过了几个action请求。如果不对的话，请读者自行屏蔽。
3.把Dispatcher实例分配置到他内部的本地线程(ThreadLocal)。这一步主要是为了后面的StrutsExecuteFilter类的工作。让我们看一下代码吧。如下
PrepareOperations类：
1 /**2 * dispatcher分配到Dispatcher类的本地线程3 */4 public void assignDispatcherToThread() {5 Dispatcher.setInstance(dispatcher);6 }
4.把HttpServletRequest包装为对应的StrutsRequestWrapper或是MultiPartRequestWrapper。主要是为了方便开发人员操作处理multipart而以。这里比较简单。笔者不想过的解释。
5.找到对应action映射信息(ActionMapping类)。这部分的工作笔者认为是比较重要的。因为他将是StrutsExecuteFilter类工作的核心点。那么ActionMapping类又是什么呢？他是struts.xml配置文件上的action信息。有了他struts2才能知道当前请求是哪一个action类。那么相关的知识笔者会在后面的章节讲到。让我们看一下代码。如下
PrepareOperations类：
1 public ActionMapping findActionMapping(HttpServletRequest request, HttpServletResponse response, boolean forceLookup) { 2 ActionMapping mapping = (ActionMapping) request.getAttribute(STRUTS_ACTION_MAPPING_KEY); 3 if (mapping == null || forceLookup) { 4 try { 5 mapping = dispatcher.getContainer().getInstance(ActionMapper.class).getMapping(request, dispatcher.getConfigurationManager()); 6 if (mapping != null) { 7 request.setAttribute(STRUTS_ACTION_MAPPING_KEY, mapping); 8 } 9 } catch (Exception ex) {10 dispatcher.sendError(request, response, HttpServletResponse.SC_INTERNAL_SERVER_ERROR, ex);11 }12 }13 14 return mapping;15 }
当笔者看到红色代码的时候，不得不说一句。看！又离不开Dispatcher类。同时值得注意是的ActionMapper类。所有的struts.xml配置文件的action信息都在这个类上面。即是可以通过ActionMapper类找到对应的action映射信息(ActionMapping)。从而找到对应的action类(用户定义的action)。另外代码request.setAttribute(STRUTS_ACTION_MAPPING_KEY, mapping)这边所做的事情。功能意思大家都能看得出来。那为什么这么做。主要还是因为后面的StrutsExecuteFilter类要用到。
从上面的五个事件中。笔者至少知道一点。Dispatcher类的工作真的很重要。而PrepareOperations类大部分只是一个中间人而以。当然这是笔者自己的理解。
| Dispatcher的结束处理 |
笔者本来想把这个知识点做一个章节来讲。可是想太少了。为什么是结束工作呢？不管是struts2启动的准备工作。还是启动成功后的action请求工作。struts2都会在工作结束之进行一些处理。先看一下struts2启动的准备工作成完之后的处理。如下
StrutsPrepareFilter类的init方法：
1 if (dispatcher != null) {2 dispatcher.cleanUpAfterInit();3 }4 init.cleanup();
Dispatcher类：
1 public void cleanUpAfterInit() {2 if (LOG.isDebugEnabled()) {3 LOG.debug("Cleaning up resources used to init Dispatcher");4 }5 ContainerHolder.clear();6 }
InitOperations类：
1 public void cleanup() {2 ActionContext.setContext(null);3 }
从上面的代码中我们可以看一个叫ContainerHolder类。这个类主要是用于存放Container容器。而上面在struts2启动加载相关信息的准备工作结束之后。把Container容器给册除了。同时也去掉了上下文(ActionContext类)。
让我们看一下request请求结束后做了什么。如下
StrutsPrepareFilter类的doFilter方法：
1 prepare.cleanupRequest(request);PrepareOperations类：
1 public void cleanupRequest(HttpServletRequest request) { 2 Integer counterVal = (Integer) request.getAttribute(CLEANUP_RECURSION_COUNTER); 3 if (counterVal != null) { 4 counterVal -= 1; 5 request.setAttribute(CLEANUP_RECURSION_COUNTER, counterVal); 6 if (counterVal > 0 ) { 7 LOG.debug("skipping cleanup counter={}", counterVal); 8 return; 9 }10 }11 // always clean up the thread request, even if an action hasn‘t been executed12 try {13 dispatcher.cleanUpRequest(request);14 } finally {15 ActionContext.setContext(null);16 Dispatcher.setInstance(null);17 devModeOverride.remove();18 }19 }
Dispatcher类：
1 public void cleanUpRequest(HttpServletRequest request) {2 ContainerHolder.clear();3 if (!(request instanceof MultiPartRequestWrapper)) {4 return;5 }6 MultiPartRequestWrapper multiWrapper = (MultiPartRequestWrapper) request;7 multiWrapper.cleanUp();8 }
从上面的红色代码我们知道他在request请求结束之后，把Container容器给册除了。本地线程的Dispatcher类的实例删除了。上下文(ActionContext类)删除了。
到了这里笔者就明白了一点：
1.struts2启动的时候，加载相关的配置信息。然后生成Dispatcher类的实例，初始化Container容器并把Dispatcher类的实例存放在PrepareOperations类里面。那么struts2的启动准备工作结束,启动成功。这时在把对应生成的Container容器和上下文(ActionContext类)删除掉。
注意：上下文(ActionContext类)在这个时候可能是没有生成的。但他做了删除的工作。
2.启动成功之后。用户开始请求action。这个时候struts2会初始化一个新的Container容器和上下文(ActionContext类)，分配Dispatcher类的实例到本地线程(ThreadLocal)中，找到对应的request请求的action映射(ActionMapping)并开始处理用户对应的action请求。action请求成功之后，会删除对应的Container容器、本地线程的Dispatcher类的实例、上下文(ActionContext类)。即是一个请求，一个Container容器，一个上下文(ActionContext类)。一个本地线程的Dispatcher类的实例。
注意：删除Dispatcher类的实例是本地线程的。而不是PrepareOperations类的实例。（读者不要搞错了。然后一直会去想：删除了Dispatcher类的实例。又在哪里创建了。不好意思。启动的时候就创建，之后就在也没有了。）
| 本章总结 |
关于StrutsPrepareFilter类的工作。还有Dispatcher的作用。相信读者看到这里的时候，心里都会有一个大概念的想法。当然笔者并非会专业的写书者。所以可能有些读者或多或少很难去理解笔者的意思。请见谅。关于调结者(Dispatcher)之俩章，主要就是想让读者明白Dispatcher做了什么。和StrutsPrepareFilter类有什么关系。为后面学习StrutsExecuteFilter类的工作做准备。
Struts2 源码分析——调结者(Dispatcher)之action请求