首页 > 代码库 > 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请求