博客
关于我
强烈建议你试试无所不能的chatGPT，快点击我
Struts2中核心过滤器的解读 抄来的
阅读量：5243 次
发布时间：2019-06-14

本文共 15636 字，大约阅读时间需要 52 分钟。

一、概述

     Struts2的核心是一个Filter，Action可以脱离web容器，那么是什么让http请求和action关联在一起的，下面我们深入源码来分析下Struts2是如何工作的。

FilterDispatcher API 写道
Deprecated. Since Struts 2.1.3, use StrutsPrepareAndExecuteFilter instead or StrutsPrepareFilter and StrutsExecuteFilter if needing using the ActionContextCleanUp filter in addition to this one

    

     鉴于常规情况官方推荐使用StrutsPrepareAndExecuteFilter替代FilterDispatcher，我们此文 将剖析StrutsPrepareAndExecuteFilter，其在工程中作为一个Filter配置在web.xml中，配置如下：

Xml代码  
  1. <filter>  
  2.     <filter-name>struts2</filter-name>  
  3.     <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>  
  4. </filter>  
  5. <filter-mapping>  
  6.     <filter-name>struts2</filter-name>  
  7.     <url-pattern>/*</url-pattern>  
  8. </filter-mapping>  

    

二、源码属性方法简介

    下面我们研究下StrutsPrepareAndExecuteFilter源码，类的主要信息如下：

 

属性摘要

protected  <>
           
protected  
           
protected  
           

 

    StrutsPrepareAndExecuteFilter与普通的Filter并无区别，方法除继承自Filter外，仅有一个回调方法，第三部分我 们将按照Filter方法调用顺序，由init—>doFilter—>destroy顺序地分析源码。

方法摘要

 void ()
           继承自Filter，用于资源释放
 void ( req,  res,  chain) 
           继承自Filter，执行方法
 void ( filterConfig) 
           继承自Filter，初始化参数
protected  void ( dispatcher,  filterConfig)
          Callback for post initialization（一个空的方法，用于方法回调初始化）

 

三、源码剖析    

  

    1、init方法

         init是Filter第一个运行的方法，我们看下struts2的核心Filter在调用init方法初始化时做哪些工作：

Java代码  
  1.  public void init(FilterConfig filterConfig) throws ServletException {  
  2.         InitOperations init = new InitOperations();  
  3.         try {  
  4. //封装filterConfig，其中有个主要方法getInitParameterNames将参数名字以String格式存储在List中  
  5.             FilterHostConfig config = new FilterHostConfig(filterConfig);  
  6. // 初始化struts内部日志  
  7.            init.initLogging(config);  
  8. //<strong>创建dispatcher ，并初始化，这部分下面我们重点分析，初始化时加载那些资源</strong>  
  9.             Dispatcher dispatcher = init.initDispatcher(config);  
  10.             init.initStaticContentLoader(config, dispatcher);  
  11. //初始化类属性：prepare 、execute   
  12.             prepare = new PrepareOperations(filterConfig.getServletContext(), dispatcher);  
  13.             execute = new ExecuteOperations(filterConfig.getServletContext(), dispatcher);  
  14.             this.excludedPatterns = init.buildExcludedPatternsList(dispatcher);  
  15. //回调空的postInit方法  
  16.             postInit(dispatcher, filterConfig);  
  17.         } finally {  
  18.             init.cleanup();  
  19.         }  
  20.  }  

 

   首先看下FilterHostConfig ，源码如下：

  

Java代码  
  1. public class FilterHostConfig implements HostConfig {  
  2.   
  3.     private FilterConfig config;  
  4.     /** 
  5.      *构造函数   
  6.      */      
  7.     public FilterHostConfig(FilterConfig config) {  
  8.         this.config = config;  
  9.     }  
  10.     /** 
  11.      *  根据init-param配置的param-name获取param-value的值 
  12.      */    
  13.     public String getInitParameter(String key) {  
  14.         return config.getInitParameter(key);  
  15.     }  
  16.        /** 
  17.          *  返回初始化参数名的List 
  18.      */   
  19.     public Iterator<String> getInitParameterNames() {  
  20.         return MakeIterator.convert(config.getInitParameterNames());  
  21.     }  
  22.   
  23.     public ServletContext getServletContext() {  
  24.         return config.getServletContext();  
  25.     }  
  26. }  

   只有短短的几行代码，getInitParameterNames是这个类的核心，将Filter初始化参数名称有枚举类型转为Iterator。此类的主要作为是对filterConfig 封装。

   

  

    重点来了，创建并初始化Dispatcher     

Java代码  
  1. public Dispatcher initDispatcher( HostConfig filterConfig ) {  
  2.        Dispatcher dispatcher = createDispatcher(filterConfig);  
  3.        dispatcher.init();  
  4.        return dispatcher;  
  5.    }  

     创建Dispatcher，会读取 filterConfig 中的配置信息，将配置信息解析出来，封装成为一个Map，然后根绝servlet上下文和参数Map构造Dispatcher ：

Java代码  
  1. private Dispatcher createDispatcher( HostConfig filterConfig ) {  
  2.         Map<String, String> params = new HashMap<String, String>();  
  3.         for ( Iterator e = filterConfig.getInitParameterNames(); e.hasNext(); ) {  
  4.             String name = (String) e.next();  
  5.             String value = filterConfig.getInitParameter(name);  
  6.             params.put(name, value);  
  7.         }  
  8.         return new Dispatcher(filterConfig.getServletContext(), params);  
  9.     }  

  Dispatcher初始化，加载struts2的相关配置文件，将按照顺序逐一加载：default.properties，struts-default.xml,struts-plugin.xml,struts.xml，……

 

Java代码  
  1. /** 
  2. *初始化过程中依次加载如下配置文件 
  3. */  
  4. public void init() {  
  5.   
  6.         if (configurationManager == null) {  
  7.             configurationManager = new ConfigurationManager(BeanSelectionProvider.DEFAULT_BEAN_NAME);  
  8.         }  
  9.   
  10.         try {  
  11.             //加载org/apache/struts2/default.properties  
  12.             init_DefaultProperties(); // [1]  
  13.            //加载struts-default.xml,struts-plugin.xml,struts.xml  
  14.             init_TraditionalXmlConfigurations(); // [2]  
  15.             init_LegacyStrutsProperties(); // [3]  
  16.            //用户自己实现的ConfigurationProviders类              
  17.         init_CustomConfigurationProviders(); // [5]  
  18.             //Filter的初始化参数  
  19.         init_FilterInitParameters() ; // [6]  
  20.             init_AliasStandardObjects() ; // [7]  
  21.   
  22.             Container container = init_PreloadConfiguration();  
  23.             container.inject(this);  
  24.             init_CheckConfigurationReloading(container);  
  25.             init_CheckWebLogicWorkaround(container);  
  26.   
  27.             if (!dispatcherListeners.isEmpty()) {  
  28.                 for (DispatcherListener l : dispatcherListeners) {  
  29.                     l.dispatcherInitialized(this);  
  30.                 }  
  31.             }  
  32.         } catch (Exception ex) {  
  33.             if (LOG.isErrorEnabled())  
  34.                 LOG.error("Dispatcher initialization failed", ex);  
  35.             throw new StrutsException(ex);  
  36.         }  
  37.     }  

 

   初始化default.properties，具体的初始化操作在DefaultPropertiesProvider类中

  

Java代码  
  1. private void init_DefaultProperties() {  
  2.        configurationManager.addConfigurationProvider(new DefaultPropertiesProvider());  
  3.    }  

    

   下面我们看下DefaultPropertiesProvider类源码：

  

Java代码  
  1. public void register(ContainerBuilder builder, LocatableProperties props)  
  2.             throws ConfigurationException {  
  3.           
  4.         Settings defaultSettings = null;  
  5.         try {  
  6.             defaultSettings = new PropertiesSettings("org/apache/struts2/default");  
  7.         } catch (Exception e) {  
  8.             throw new ConfigurationException("Could not find or error in org/apache/struts2/default.properties", e);  
  9.         }  
  10.           
  11.         loadSettings(props, defaultSettings);  
  12.     }  

 

   其他的我们再次省略，大家可以浏览下各个初始化操作都加载了那些文件

 

3、doFilter方法

 

     doFilter是过滤器的执行方法，它拦截提交的HttpServletRequest请求，HttpServletResponse响应，作为strtus2的核心拦截器，在doFilter里面到底做了哪些工作，我们将逐行解读其源码，源码如下：

   

Java代码  
  1.  public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {  
  2.      //父类向子类转：强转为http请求、响应  
  3.      HttpServletRequest request = (HttpServletRequest) req;  
  4.      HttpServletResponse response = (HttpServletResponse) res;  
  5.   
  6.      try {  
  7.          //设置编码和国际化  
  8.          prepare.setEncodingAndLocale(request, response);  
  9.           //创建Action上下文（重点）  
  10.          prepare.createActionContext(request, response);  
  11.          prepare.assignDispatcherToThread();  
  12. if ( excludedPatterns != null && prepare.isUrlExcluded(request, excludedPatterns)) {  
  13.     chain.doFilter(request, response);  
  14. } else {  
  15.     request = prepare.wrapRequest(request);  
  16.     ActionMapping mapping = prepare.findActionMapping(request, response, true);  
  17.     if (mapping == null) {  
  18.         boolean handled = execute.executeStaticResourceRequest(request, response);  
  19.         if (!handled) {  
  20.             chain.doFilter(request, response);  
  21.         }  
  22.     } else {  
  23.         execute.executeAction(request, response, mapping);  
  24.     }  
  25. }  
  26.      } finally {  
  27.          prepare.cleanupRequest(request);  
  28.      }  
  29.  }  

 

    setEncodingAndLocale调用了dispatcher方法的prepare方法：

   

Java代码  
  1. /** 
  2.      * Sets the request encoding and locale on the response 
  3.      */  
  4.     public void setEncodingAndLocale(HttpServletRequest request, HttpServletResponse response) {  
  5.         dispatcher.prepare(request, response);  
  6.     }  

 

   下面我们看下prepare方法，这个方法很简单只是设置了encoding 、locale ，做的只是一些辅助的工作：

Java代码  
  1. public void prepare(HttpServletRequest request, HttpServletResponse response) {  
  2.         String encoding = null;  
  3.         if (defaultEncoding != null) {  
  4.             encoding = defaultEncoding;  
  5.         }  
  6.   
  7.         Locale locale = null;  
  8.         if (defaultLocale != null) {  
  9.             locale = LocalizedTextUtil.localeFromString(defaultLocale, request.getLocale());  
  10.         }  
  11.   
  12.         if (encoding != null) {  
  13.             try {  
  14.                 request.setCharacterEncoding(encoding);  
  15.             } catch (Exception e) {  
  16.                 LOG.error("Error setting character encoding to '" + encoding + "' - ignoring.", e);  
  17.             }  
  18.         }  
  19.   
  20.         if (locale != null) {  
  21.             response.setLocale(locale);  
  22.         }  
  23.   
  24.         if (paramsWorkaroundEnabled) {  
  25.             request.getParameter("foo"); // simply read any parameter (existing or not) to "prime" the request  
  26.         }  
  27.     }  

   

   Action上下文创建（重点）

 

       ActionContext是一个容器，这个容易主要存储request、session、application、parameters等相关信 息.ActionContext是一个线程的本地变量，这意味着不同的action之间不会共享ActionContext，所以也不用考虑线程安全问 题。其实质是一个Map，key是标示request、session、……的字符串，值是其对应的对象：

Java代码  
  1. static ThreadLocal actionContext = new ThreadLocal();  
  2. Map<String, Object> context;  

 

   下面我们看下如何创建action上下文的，代码如下：

   

Java代码  
  1. /** 
  2. *创建Action上下文，初始化thread local 
  3. */  
  4. public ActionContext createActionContext(HttpServletRequest request, HttpServletResponse response) {  
  5.     ActionContext ctx;  
  6.     Integer counter = 1;  
  7.     Integer oldCounter = (Integer) request.getAttribute(CLEANUP_RECURSION_COUNTER);  
  8.     if (oldCounter != null) {  
  9.         counter = oldCounter + 1;  
  10.     }  
  11.     //注意此处是从ThreadLocal中获取此ActionContext变量  
  12.     ActionContext oldContext = ActionContext.getContext();  
  13.     if (oldContext != null) {  
  14.         // detected existing context, so we are probably in a forward  
  15.         ctx = new ActionContext(new HashMap<String, Object>(oldContext.getContextMap()));  
  16.     } else {  
  17.         ValueStack stack = dispatcher.getContainer().getInstance(ValueStackFactory.class).createValueStack();  
  18.         stack.getContext().putAll(dispatcher.createContextMap(request, response, null, servletContext));  
  19.         //stack.getContext()返回的是一个Map<String，Object>，根据此Map构造一个ActionContext  
  20.         ctx = new ActionContext(stack.getContext());  
  21.     }  
  22.     request.setAttribute(CLEANUP_RECURSION_COUNTER, counter);  
  23.     //将ActionContext存如ThreadLocal  
  24.     ActionContext.setContext(ctx);  
  25.     return ctx;  
  26. }  

 

    上面代码中dispatcher.createContextMap，如何封装相关参数：

 

Java代码  
  1. public Map<String,Object> createContextMap(HttpServletRequest request, HttpServletResponse response,  
  2.             ActionMapping mapping, ServletContext context) {  
  3.   
  4.         // request map wrapping the http request objects  
  5.         Map requestMap = new RequestMap(request);  
  6.   
  7.         // parameters map wrapping the http parameters.  ActionMapping parameters are now handled and applied separately  
  8.         Map params = new HashMap(request.getParameterMap());  
  9.   
  10.         // session map wrapping the http session  
  11.         Map session = new SessionMap(request);  
  12.   
  13.         // application map wrapping the ServletContext  
  14.         Map application = new ApplicationMap(context);  
  15.                 //requestMap、params、session等Map封装成为一个上下文Map，逐个调用了map.put(Map p).  
  16.         Map<String,Object> extraContext = createContextMap(requestMap, params, session, application, request, response, context);  
  17.   
  18.         if (mapping != null) {  
  19.             extraContext.put(ServletActionContext.ACTION_MAPPING, mapping);  
  20.         }  
  21.         return extraContext;  
  22. }  

 

 我们简单看下RequestMap，其他的省略。RequestMap类实现了抽象Map，故其本身是一个Map，主要方法实现：

Java代码  
  1. //map的get实现  
  2. public Object get(Object key) {  
  3.     return request.getAttribute(key.toString());  
  4. }  
  5. //map的put实现  
  6. public Object put(Object key, Object value) {  
  7.     Object oldValue = get(key);  
  8.     entries = null;  
  9.     request.setAttribute(key.toString(), value);  
  10.     return oldValue;  
  11. }  

 

   下面是源码展示了如何执行Action控制器：

 

Java代码  
  1. public void executeAction(HttpServletRequest request, HttpServletResponse response, ActionMapping mapping) throws ServletException {  
  2.     dispatcher.serviceAction(request, response, servletContext, mapping);  
  3. }  
  4.   
  5.     public void serviceAction(HttpServletRequest request, HttpServletResponse response, ServletContext context,  
  6.                               ActionMapping mapping) throws ServletException {  
  7.                 //封装执行的上下文环境，主要讲相关信息存储入map  
  8.         Map<String, Object> extraContext = createContextMap(request, response, mapping, context);  
  9.   
  10.         // If there was a previous value stack, then create a new copy and pass it in to be used by the new Action  
  11.         ValueStack stack = (ValueStack) request.getAttribute(ServletActionContext.STRUTS_VALUESTACK_KEY);  
  12.         boolean nullStack = stack == null;  
  13.         if (nullStack) {  
  14.             ActionContext ctx = ActionContext.getContext();  
  15.             if (ctx != null) {  
  16.                 stack = ctx.getValueStack();  
  17.             }  
  18.         }  
  19.         if (stack != null) {  
  20.             extraContext.put(ActionContext.VALUE_STACK, valueStackFactory.createValueStack(stack));  
  21.         }  
  22.   
  23.         String timerKey = "Handling request from Dispatcher";  
  24.         try {  
  25.             UtilTimerStack.push(timerKey);  
  26.             //获取命名空间  
  27.             String namespace = mapping.getNamespace();  
  28.             //获取action配置的name属性  
  29.             String name = mapping.getName();  
  30.             //获取action配置的method属性  
  31.             String method = mapping.getMethod();  
  32.   
  33.             Configuration config = configurationManager.getConfiguration();  
  34.             //根据执行上下文参数，命名空间，名称等创建用户自定义Action的代理对象  
  35.             ActionProxy proxy = config.getContainer().getInstance(ActionProxyFactory.class).createActionProxy(  
  36.                     namespace, name, method, extraContext, true, false);  
  37.   
  38.             request.setAttribute(ServletActionContext.STRUTS_VALUESTACK_KEY, proxy.getInvocation().getStack());  
  39.   
  40.             // if the ActionMapping says to go straight to a result, do it!  
  41.                     //执行execute方法，并转向结果  
  42.             if (mapping.getResult() != null) {  
  43.                 Result result = mapping.getResult();  
  44.                 result.execute(proxy.getInvocation());  
  45.             } else {  
  46.                 proxy.execute();  
  47.             }  
  48.   
  49.             // If there was a previous value stack then set it back onto the request  
  50.             if (!nullStack) {  
  51.                 request.setAttribute(ServletActionContext.STRUTS_VALUESTACK_KEY, stack);  
  52.             }  
  53.         } catch (ConfigurationException e) {  
  54.             // WW-2874 Only log error if in devMode  
  55.             if(devMode) {  
  56.                 String reqStr = request.getRequestURI();  
  57.                 if (request.getQueryString() != null) {  
  58.                     reqStr = reqStr + "?" + request.getQueryString();  
  59.                 }  
  60.                 LOG.error("Could not find action or result\n" + reqStr, e);  
  61.             }  
  62.             else {  
  63.                 LOG.warn("Could not find action or result", e);  
  64.             }  
  65.             sendError(request, response, context, HttpServletResponse.SC_NOT_FOUND, e);  
  66.         } catch (Exception e) {  
  67.             sendError(request, response, context, HttpServletResponse.SC_INTERNAL_SERVER_ERROR, e);  
  68.         } finally {  
  69.             UtilTimerStack.pop(timerKey);  
  70.         }  
  71.     }  

 

   文中对如何解析Struts.xml，如何将URL与action映射匹配为分析，有需要的我后续补全，因为 StrutsXmlConfigurationProvider继承XmlConfigurationProvider，并在register方法回调父 类的register，有兴趣的可以深入阅读下下XmlConfigurationProvider源码：

  

Java代码  
  1. public void register(ContainerBuilder containerBuilder, LocatableProperties props) throws ConfigurationException {  
  2.        if (servletContext != null && !containerBuilder.contains(ServletContext.class)) {  
  3.            containerBuilder.factory(ServletContext.class, new Factory<ServletContext>() {  
  4.                public ServletContext create(Context context) throws Exception {  
  5.                    return servletContext;  
  6.                }  
  7.            });  
  8.        }  
  9.        //调用父类的register，关键点所在  
  10.        super.register(containerBuilder, props);  
  11.    }  

   

 

     struts2-core-2.2.1.jar包中struts-2.1.7.dtd对于Action的定义如下：

Xml代码  
  1. <!ELEMENT action (param|result|interceptor-ref|exception-mapping)*>  
  2. <!ATTLIST action  
  3.     name CDATA #REQUIRED  
  4.     class CDATA #IMPLIED  
  5.     method CDATA #IMPLIED  
  6.     converter CDATA #IMPLIED  
  7. >  

    从上述DTD中可见Action元素可以含有name 、class 、method 、converter 属性。

 

   XmlConfigurationProvider解析struts.xml配置的Action元素：

Java代码  
  1. protected void addAction(Element actionElement, PackageConfig.Builder packageContext) throws ConfigurationException {  
  2.      String name = actionElement.getAttribute("name");  
  3.      String className = actionElement.getAttribute("class");  
  4.      String methodName = actionElement.getAttribute("method");  
  5.      Location location = DomHelper.getLocationObject(actionElement);  
  6.   
  7.      if (location == null) {  
  8.          LOG.warn("location null for " + className);  
  9.      }  
  10.      //methodName should be null if it's not set  
  11.      methodName = (methodName.trim().length() > 0) ? methodName.trim() : null;  
  12.   
  13.      // if there isnt a class name specified for an <action/> then try to  
  14.      // use the default-class-ref from the <package/>  
  15.      if (StringUtils.isEmpty(className)) {  
  16.          // if there is a package default-class-ref use that, otherwise use action support  
  17.         /* if (StringUtils.isNotEmpty(packageContext.getDefaultClassRef())) {
     
  18.              className = packageContext.getDefaultClassRef(); 
  19.          } else {
     
  20.              className = ActionSupport.class.getName(); 
  21.          }*/  
  22.   
  23.      } else {  
  24.          if (!verifyAction(className, name, location)) {  
  25.              if (LOG.isErrorEnabled())  
  26.                  LOG.error("Unable to verify action [#0] with class [#1], from [#2]", name, className, location.toString());  
  27.              return;  
  28.          }  
  29.      }  
  30.   
  31.   
  32.   
  33.      Map<String, ResultConfig> results;  
  34.      try {  
  35.          results = buildResults(actionElement, packageContext);  
  36.      } catch (ConfigurationException e) {  
  37.          throw new ConfigurationException("Error building results for action " + name + " in namespace " + packageContext.getNamespace(), e, actionElement);  
  38.      }  
  39.   
  40.      List<InterceptorMapping> interceptorList = buildInterceptorList(actionElement, packageContext);  
  41.   
  42.      List<ExceptionMappingConfig> exceptionMappings = buildExceptionMappings(actionElement, packageContext);  
  43.   
  44.      ActionConfig actionConfig = new ActionConfig.Builder(packageContext.getName(), name, className)  
  45.              .methodName(methodName)  
  46.              .addResultConfigs(results)  
  47.              .addInterceptors(interceptorList)  
  48.              .addExceptionMappings(exceptionMappings)  
  49.              .addParams(XmlHelper.getParams(actionElement))  
  50.              .location(location)  
  51.              .build();  
  52.      packageContext.addActionConfig(name, actionConfig);  
  53.   
  54.      if (LOG.isDebugEnabled()) {  
  55.          LOG.debug("Loaded " + (StringUtils.isNotEmpty(packageContext.getNamespace()) ? (packageContext.getNamespace() + "/") : "") + name + " in '" + packageContext.getName() + "' package:" + actionConfig);  
  56.      }  
  57.  }  

 

   

     工作中不涉及Struts2，本周工作有个2天的空档期，稍微看了下struts2的文档，写了个demo，从源码的角度研究了下运行原理，如有分析不当请指出，我后续逐步完善更正，大家共同提高。

转载于:https://www.cnblogs.com/voctrals/archive/2013/05/02/3054527.html

你可能感兴趣的文章
连接Oracle需要jar包和javadoc文档的下载
查看>>
UVA 10976 - Fractions Again?!
查看>>
Dreamweaver cc新版本css单行显示
查看>>
【android】安卓的权限提示及版本相关
查看>>
JavaScript可否多线程? 深入理解JavaScript定时机制
查看>>
IOS基础学习
查看>>
PHP 导出 Excell
查看>>
Java基础教程——网络基础知识
查看>>
Kruskal基础最小生成树
查看>>
浅谈算法和数据结构: 一 栈和队列
查看>>
Java内部类详解
查看>>
【hdu 1429】胜利大逃亡(续)
查看>>
图论-次短路求法
查看>>
What's New for Visual C# 6.0
查看>>
ExtJs学习笔记之ComboBox组件
查看>>
关于收费软件
查看>>
getopt_long
查看>>
TensorFlow MNIST CNN 代码
查看>>
javascript之Style物
查看>>
JSON跨域解决方案收集
查看>>
喝酒易醉，品茶养心，人生如梦，品茶悟道，何以解忧？唯有杜康！-- 愿君每日到此一游！
当前时间: 2024-11-24 12:36:47   当前IP: 52.14.6.41   联系邮箱:javaeecc@qq.com     Copyright © 2020 - 2022 baihongyu.com 京ICP备2021015314号-2
强烈建议你试试无所不能的CHAT-GPT，快点击我
强烈建议你试试无所不能的CHAT-GPT，快点击我