Java struts2請求源碼分析案例詳解

  Struts2是Struts社區和WebWork社區的共同成果,我們甚至可以說,Struts2是WebWork的升級版,他采用的正是WebWork的核心,所以,Struts2並不是一個不成熟的產品,相反,構建在WebWork基礎之上的Struts2是一個運行穩定、性能優異、設計成熟的WEB框架。

  我這裡的struts2源碼是從官網下載的一個最新的struts-2.3.15.1-src.zip,將其解壓即可。裡面的目錄頁文件非常的多,我們隻需要定位到struts-2.3.15.1\src\core\src\main\java\org\apache\struts2查看源文件。目錄結構如下圖

  Struts2框架的正常運行,除瞭占核心地位的xwork的支持以外,Struts2本身也提供瞭許多類,這些類被分門別類組織到不同的包中。從源代碼中發現,基本上每一個Struts2類都訪問瞭WebWork提供的功能,從而也可以看出Struts2與WebWork千絲萬縷的聯系。但無論如何,Struts2的核心功能比如將請求委托給哪個Action處理都是由xwork完成的,Struts2隻是在WebWork的基礎上做瞭適當的簡化、加強和封裝,並少量保留Struts1.x中的習慣。

以下是包說明:

org.apache.struts2. components 該包封裝視圖組件,Struts2在視圖組件上有瞭很大加強,不僅增加瞭組件的屬性個數,更新增瞭幾個非常有用的組件,如updownselect、doubleselect、datetimepicker、token、tree等。 另外,Struts2可視化視圖組件開始支持主題(theme),缺省情況下,使用自帶的缺省主題,如果要自定義頁面效果,需要將組件的theme屬性設置為simple。
org.apache.struts2. config 該包定義與配置相關的接口和類。實際上,工程中的xml和properties文件的讀取和解析都是由WebWork完成的,Struts隻做瞭少量的工作。
org.apache.struts2.dispatcher Struts2的核心包,最重要的類都放在該包中。
org.apache.struts2.impl 該包隻定義瞭3個類,他們是StrutsActionProxy、StrutsActionProxyFactory、StrutsObjectFactory,這三個類都是對xwork的擴展。
org.apache.struts2.interceptor 定義內置的截攔器。
org.apache.struts2.servlet 用HttpServletRequest相關方法實現principalproxy接口。
org.apache.struts2.util 實用包。
org.apache.struts2.views 提供freemarker、jsp、velocity等不同類型的頁面呈現。

根目錄下的5個文件說明:

StrutsStatics Struts常數。常數可以用來獲取或設置對象從行動中或其他集合。
RequestUtils 請求處理程序類。此類隻有一個方法getServletPath,作用檢索當前請求的servlet路徑
ServletActionContext 網站的特定的上下文信息
StrutsConstants 該類提供瞭框架配置鍵的中心位置用於存儲和檢索配置設置。
StrutsException 通用運行時異常類

struts2 架構圖如下圖所示:

依照上圖,我們可以看出一個請求在struts的處理大概有如下步驟:

  1. 客戶端初始化一個指向Servlet容器(例如Tomcat)的請求;
  2. 這個請求經過一系列的過濾器(Filter)(這些過濾器中有一個叫做ActionContextCleanUp的可選過濾器,這個過濾器對於Struts2和其他框架的集成很有幫助,例如:SiteMesh Plugin);
  3. 接著StrutsPrepareAndExecuteFilter被調用,StrutsPrepareAndExecuteFilter詢問ActionMapper來決定這個請求是否需要調用某個Action;
  4. 如果ActionMapper決定需要調用某個Action,FilterDispatcher把請求的處理交給ActionProxy;
  5. ActionProxy通過Configuration Manager詢問框架的配置文件,找到需要調用的Action類;
  6. ActionProxy創建一個ActionInvocation的實例。
  7. ActionInvocation實例使用命名模式來調用,在調用Action的過程前後,涉及到相關攔截器(Intercepter)的調用。
  8. 一旦Action執行完畢,ActionInvocation負責根據struts.xml中的配置找到對應的返回結果。返回結果通常是(但不總是,也可能是另外的一個Action鏈)一個需要被表示的JSP或者FreeMarker的模版。在表示的過程中可以使用Struts2 框架中繼承的標簽。在這個過程中需要涉及到ActionMapper。

strut2源碼分析:

  首先我們使用struts2框架都會在web.xml中註冊和映射struts2,配置內容如下:

<filter>
    <filter-name>struts2</filter-name>
    <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>struts2</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

註:在早期的struts2中,都是使用FilterDispathcer,從Struts 2.1.3開始,它已不推薦使用。如果你使用的Struts的版本 >= 2.1.3,推薦升級到新的Filter,StrutsPrepareAndExecuteFilter。在此研究的是StrutsPrepareAndExecuteFilter。

StrutsPrepareAndExecuteFilter中的方法:

void init(FilterConfig filterConfig)  繼承自Filter,過濾器的初始化
doFilter(ServletRequest req, ServletResponse res, FilterChain chain)  繼承自Filter,執行過濾器
void destroy() 繼承自Filter,用於資源釋放
void postInit(Dispatcher dispatcher, FilterConfig filterConfig)  Callback for post initialization(一個空的方法,用於方法回調初始化)

 web容器一啟動,就會初始化核心過濾器StrutsPrepareAndExecuteFilter,並執行初始化方法,初始化方法如下:

public void init(FilterConfig filterConfig) throws ServletException {
        InitOperations init = new InitOperations();
        Dispatcher dispatcher = null;
        try {
            //封裝filterConfig,其中有個主要方法getInitParameterNames將參數名字以String格式存儲在List中
            FilterHostConfig config = new FilterHostConfig(filterConfig);
            //初始化struts內部日志
            init.initLogging(config);
            //創建dispatcher ,並初始化
            dispatcher = init.initDispatcher(config);
            init.initStaticContentLoader(config, dispatcher);
            //初始化類屬性:prepare 、execute
            prepare = new PrepareOperations(filterConfig.getServletContext(), dispatcher);
            execute = new ExecuteOperations(filterConfig.getServletContext(), dispatcher);
            this.excludedPatterns = init.buildExcludedPatternsList(dispatcher);
            //回調空的postInit方法
            postInit(dispatcher, filterConfig);
        } finally {
            if (dispatcher != null) {
                dispatcher.cleanUpAfterInit();
            }
            init.cleanup();
        }
    }

 關於封裝filterConfig,首先看下FilterHostConfig ,源碼如下:

public class FilterHostConfig implements HostConfig {

    private FilterConfig config;
    //構造方法
    public FilterHostConfig(FilterConfig config) {
        this.config = config;
    }
    //根據init-param配置的param-name獲取param-value的值
    public String getInitParameter(String key) {
        return config.getInitParameter(key);
    }
    //返回初始化參數名的迭代器
    public Iterator<String> getInitParameterNames() {
        return MakeIterator.convert(config.getInitParameterNames());
    }
    //返回Servlet上下文
    public ServletContext getServletContext() {
        return config.getServletContext();
    }
}

  隻有短短的幾行代碼,getInitParameterNames是這個類的核心,將Filter初始化參數名稱有枚舉類型轉為Iterator。此類的主要作為是對filterConfig 封裝。

  接下來,看下StrutsPrepareAndExecuteFilter中init方法中dispatcher = init.initDispatcher(config);這是初始化dispatcher的,是通過init對象的initDispatcher方法來初始化的,init是InitOperations類的對象,我們看看InitOperations中initDispatcher方法:

public Dispatcher initDispatcher( HostConfig filterConfig ) {
  Dispatcher dispatcher = createDispatcher(filterConfig);
  dispatcher.init();
  return dispatcher;
}

  創建Dispatcher,會讀取 filterConfig 中的配置信息,將配置信息解析出來,封裝成為一個Map,然後根絕servlet上下文和參數Map構造Dispatcher :

private Dispatcher createDispatcher( HostConfig filterConfig ) {
        //存放參數的Map
        Map<String, String> params = new HashMap<String, String>();
        //將參數存放到Map
        for ( Iterator e = filterConfig.getInitParameterNames(); e.hasNext(); ) {
            String name = (String) e.next();
            String value = filterConfig.getInitParameter(name);
            params.put(name, value);
        }
        //根據servlet上下文和參數Map構造Dispatcher
        return new Dispatcher(filterConfig.getServletContext(), params);
    }

  這樣dispatcher對象創建完成,接著就是dispatcher對象的初始化,打開Dispatcher類,看到它的init方法如下:

public void init() {

        if (configurationManager == null) {
            configurationManager = createConfigurationManager(BeanSelectionProvider.DEFAULT_BEAN_NAME);
        }

        try {
            init_FileManager();
            //加載org/apache/struts2/default.properties
            init_DefaultProperties(); // [1]
            //加載struts-default.xml,struts-plugin.xml,struts.xml
            init_TraditionalXmlConfigurations(); // [2]
            init_LegacyStrutsProperties(); // [3]
            //用戶自己實現的ConfigurationProviders類
            init_CustomConfigurationProviders(); // [5]
            //Filter的初始化參數
            init_FilterInitParameters() ; // [6]
            init_AliasStandardObjects() ; // [7]

            Container container = init_PreloadConfiguration();
            container.inject(this);
            init_CheckWebLogicWorkaround(container);

            if (!dispatcherListeners.isEmpty()) {
                for (DispatcherListener l : dispatcherListeners) {
                    l.dispatcherInitialized(this);
                }
            }
        } catch (Exception ex) {
            if (LOG.isErrorEnabled())
                LOG.error("Dispatcher initialization failed", ex);
            throw new StrutsException(ex);
        }
    }

  這裡主要是加載一些配置文件的,將按照順序逐一加載:default.properties,struts-default.xml,struts-plugin.xml,struts.xml,……關於文件是如何加載的,大傢可以自己取看源文件,主要是由xwork核心類加載的,代碼在xwork-core\src\main\java\com\opensymphony\xwork2\config\providers包裡面。

  現在,我們回到StrutsPrepareAndExecuteFilter類中,剛才我們分析瞭StrutsPrepareAndExecuteFilter類的init方法,該方法在web容器一啟動就會調用的,當用戶訪問某個action的時候,首先調用核心過濾器StrutsPrepareAndExecuteFilter的doFilter方法,該方法內容如下:

public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {

        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) res;

        try {
            //設置編碼和國際化
            prepare.setEncodingAndLocale(request, response);
            //創建action上下文
            prepare.createActionContext(request, response);
            prepare.assignDispatcherToThread();
            if (excludedPatterns != null && prepare.isUrlExcluded(request, excludedPatterns)) {
                chain.doFilter(request, response);
            } else {
                request = prepare.wrapRequest(request);
                ActionMapping mapping = prepare.findActionMapping(request, response, true);
                //如果mapping為空,則認為不是調用action,會調用下一個過濾器鏈,直到獲取到mapping才調用action
                if (mapping == null) {
                    boolean handled = execute.executeStaticResourceRequest(request, response);
                    if (!handled) {
                        chain.doFilter(request, response);
                    }
                } else {
                    //執行action
                    execute.executeAction(request, response, mapping);
                }
            }
        } finally {
            prepare.cleanupRequest(request);
        }
    }

  下面對doFilter方法中的重點部分一一講解:

(1)prepare.setEncodingAndLocale(request, response);

  第8行是調用prepare對象的setEncodingAndLocale方法,prepare是PrepareOperations類的對象,PrepareOperations類是用來做請求準備工作的。我們看下PrepareOperations類中的setEncodingAndLocale方法:

public void setEncodingAndLocale(HttpServletRequest request, HttpServletResponse response) {
    dispatcher.prepare(request, response);
}

  在這方法裡面我們可以看到它隻是調用瞭dispatcher的prepare方法而已,下面我們看看dispatcher的prepare方法:

public void prepare(HttpServletRequest request, HttpServletResponse response) {
        String encoding = null;
        if (defaultEncoding != null) {
            encoding = defaultEncoding;
        }
        // check for Ajax request to use UTF-8 encoding strictly http://www.w3.org/TR/XMLHttpRequest/#the-send-method
        if ("XMLHttpRequest".equals(request.getHeader("X-Requested-With"))) {
            encoding = "UTF-8";
        }

        Locale locale = null;
        if (defaultLocale != null) {
            locale = LocalizedTextUtil.localeFromString(defaultLocale, request.getLocale());
        }

        if (encoding != null) {
            applyEncoding(request, encoding);
        }

        if (locale != null) {
            response.setLocale(locale);
        }

        if (paramsWorkaroundEnabled) {
            request.getParameter("foo"); // simply read any parameter (existing or not) to "prime" the request
        }
    }

  我們可以看到該方法隻是簡單的設置瞭encoding 和locale ,做的隻是一些輔助的工作。

(2)prepare.createActionContext(request, response)

  我們回到StrutsPrepareAndExecuteFilter的doFilter方法,看到第10行代碼:prepare.createActionContext(request, response);這是action上下文的創建,ActionContext是一個容器,這個容易主要存儲request、session、application、parameters等相關信 息.ActionContext是一個線程的本地變量,這意味著不同的action之間不會共享ActionContext,所以也不用考慮線程安全問 題。其實質是一個Map,key是標示request、session、……的字符串,值是其對應的對象,我們可以看到com.opensymphony.xwork2.ActionContext類中時如下定義的:

static ThreadLocal<ActionContext> actionContext = new ThreadLocal<ActionContext>();

我們看下PrepareOperations類的createActionContext方法:

/**
     * Creates the action context and initializes the thread local
     */
    public ActionContext createActionContext(HttpServletRequest request, HttpServletResponse response) {
        ActionContext ctx;
        Integer counter = 1;
        Integer oldCounter = (Integer) request.getAttribute(CLEANUP_RECURSION_COUNTER);
        if (oldCounter != null) {
            counter = oldCounter + 1;
        }
        //此處是從ThreadLocal中獲取此ActionContext變量
        ActionContext oldContext = ActionContext.getContext();
        if (oldContext != null) {
            // detected existing context, so we are probably in a forward
            ctx = new ActionContext(new HashMap<String, Object>(oldContext.getContextMap()));
        } else {
            ValueStack stack = dispatcher.getContainer().getInstance(ValueStackFactory.class).createValueStack();
            stack.getContext().putAll(dispatcher.createContextMap(request, response, null, servletContext));
            //stack.getContext()返回的是一個Map<String,Object>,根據此Map構造一個ActionContext
            ctx = new ActionContext(stack.getContext());
        }
        request.setAttribute(CLEANUP_RECURSION_COUNTER, counter);
        //將ActionContext存到ThreadLocal
        ActionContext.setContext(ctx);
        return ctx;
    }

    上面第18行代碼中dispatcher.createContextMap,如何封裝相關參數:

public Map<String,Object> createContextMap(HttpServletRequest request, HttpServletResponse response,
            ActionMapping mapping, ServletContext context) {

        // request map wrapping the http request objects
        Map requestMap = new RequestMap(request);

        // parameters map wrapping the http parameters.  ActionMapping parameters are now handled and applied separately
        Map params = new HashMap(request.getParameterMap());

        // session map wrapping the http session
        Map session = new SessionMap(request);

        // application map wrapping the ServletContext
        Map application = new ApplicationMap(context);
        //requestMap、params、session等Map封裝成為一個上下文Map
        Map<String,Object> extraContext = createContextMap(requestMap, params, session, application, request, response, context);

        if (mapping != null) {
            extraContext.put(ServletActionContext.ACTION_MAPPING, mapping);
        }
        return extraContext;
    }

(3)request = prepare.wrapRequest(request)

  我們再次回到StrutsPrepareAndExecuteFilter的doFilter方法中,看到第15行:request = prepare.wrapRequest(request);這一句是對request進行包裝的,我們看下prepare的wrapRequest方法:

public HttpServletRequest wrapRequest(HttpServletRequest oldRequest) throws ServletException {
        HttpServletRequest request = oldRequest;
        try {
            // Wrap request first, just in case it is multipart/form-data
            // parameters might not be accessible through before encoding (ww-1278)
            request = dispatcher.wrapRequest(request, servletContext);
        } catch (IOException e) {
            throw new ServletException("Could not wrap servlet request with MultipartRequestWrapper!", e);
        }
        return request;
    }

  由第6行我們可以看到它裡面調用的是dispatcher的wrapRequest方法,並且將servletContext對象也傳進去瞭,我們看下dispatcher的wrapRequest:

public HttpServletRequest wrapRequest(HttpServletRequest request, ServletContext servletContext) throws IOException {
        // don't wrap more than once
        if (request instanceof StrutsRequestWrapper) {
            return request;
        }

        String content_type = request.getContentType();
        //如果content_type是multipart/form-data類型,則將request包裝成MultiPartRequestWrapper對象,否則包裝成StrutsRequestWrapper對象
        if (content_type != null && content_type.contains("multipart/form-data")) {
            MultiPartRequest mpr = getMultiPartRequest();
            LocaleProvider provider = getContainer().getInstance(LocaleProvider.class);
            request = new MultiPartRequestWrapper(mpr, request, getSaveDir(servletContext), provider);
        } else {
            request = new StrutsRequestWrapper(request, disableRequestAttributeValueStackLookup);
        }

        return request;
    }

  此次包裝根據請求內容的類型不同,返回不同的對象,如果為multipart/form-data類型,則返回MultiPartRequestWrapper類型的對象,該對象服務於文件上傳,否則返回StrutsRequestWrapper類型的對象,MultiPartRequestWrapper是StrutsRequestWrapper的子類,而這兩個類都是HttpServletRequest接口的實現。

(4)ActionMapping mapping = prepare.findActionMapping(request, response, true)

  包裝request後,通過ActionMapper的getMapping()方法得到請求的Action,Action的配置信息存儲在ActionMapping對象中,如StrutsPrepareAndExecuteFilter的doFilter方法中第16行:ActionMapping mapping = prepare.findActionMapping(request, response, true);我們找到prepare對象的findActionMapping方法:

public ActionMapping findActionMapping(HttpServletRequest request, HttpServletResponse response, boolean forceLookup) {
        //首先從request對象中取mapping對象,看是否存在
        ActionMapping mapping = (ActionMapping) request.getAttribute(STRUTS_ACTION_MAPPING_KEY);
        //不存在就創建一個
        if (mapping == null || forceLookup) {
            try {
                //首先創建ActionMapper對象,通過ActionMapper對象創建mapping對象
                mapping = dispatcher.getContainer().getInstance(ActionMapper.class).getMapping(request, dispatcher.getConfigurationManager());
                if (mapping != null) {
                    request.setAttribute(STRUTS_ACTION_MAPPING_KEY, mapping);
                }
            } catch (Exception ex) {
                dispatcher.sendError(request, response, servletContext, HttpServletResponse.SC_INTERNAL_SERVER_ERROR, ex);
            }
        }

        return mapping;
    }

  下面是ActionMapper接口的實現類DefaultActionMapper的getMapping()方法的源代碼:

public ActionMapping getMapping(HttpServletRequest request, ConfigurationManager configManager) {
        ActionMapping mapping = new ActionMapping();
        //獲得請求的uri,即請求路徑URL中工程名以後的部分,如/userAction.action
        String uri = getUri(request);
        //修正url的帶;jsessionid 時找不到的bug
        int indexOfSemicolon = uri.indexOf(";");
        uri = (indexOfSemicolon > -1) ? uri.substring(0, indexOfSemicolon) : uri;
        //刪除擴展名,如.action或者.do
        uri = dropExtension(uri, mapping);
        if (uri == null) {
            return null;
        }
        //從uri中分離得到請求的action名、命名空間。
        parseNameAndNamespace(uri, mapping, configManager);
        //處理特殊的請求參數
        handleSpecialParameters(request, mapping);
        //如果允許動態方法調用,即形如/userAction!getAll.action的請求,分離action名和方法名
        return parseActionName(mapping);
    }

  下面對getMapping方法中的重要部分一一講解:

  ①:parseNameAndNamespace(uri, mapping, configManager)

  我們主要看下第14行的parseNameAndNamespace(uri, mapping, configManager);這個方法的主要作用是分離出action名和命名空間:

protected void parseNameAndNamespace(String uri, ActionMapping mapping, ConfigurationManager configManager) {
        String namespace, name;
        int lastSlash = uri.lastIndexOf("/"); //最後的斜桿的位置
        if (lastSlash == -1) {
            namespace = "";
            name = uri;
        } else if (lastSlash == 0) {
            // ww-1046, assume it is the root namespace, it will fallback to
            // default
            // namespace anyway if not found in root namespace.
            namespace = "/";
            name = uri.substring(lastSlash + 1);
        //允許采用完整的命名空間,即設置命名空間是否必須進行精確匹配
        } else if (alwaysSelectFullNamespace) {
            // Simply select the namespace as everything before the last slash
            namespace = uri.substring(0, lastSlash);
            name = uri.substring(lastSlash + 1);
        } else {
            // Try to find the namespace in those defined, defaulting to ""
            Configuration config = configManager.getConfiguration();
            String prefix = uri.substring(0, lastSlash); //臨時的命名空間,將會用來進行匹配
            namespace = "";//將命名空間暫時設為""
            boolean rootAvailable = false;//rootAvailable作用是判斷配置文件中是否配置瞭命名空間"/"
            // Find the longest matching namespace, defaulting to the default
            for (Object cfg : config.getPackageConfigs().values()) { //循環遍歷配置文件中的package標簽
                String ns = ((PackageConfig) cfg).getNamespace();    //獲取每個package標簽的namespace屬性
                //進行匹配
                if (ns != null && prefix.startsWith(ns) && (prefix.length() == ns.length() || prefix.charAt(ns.length()) == '/')) {
                    if (ns.length() > namespace.length()) {
                        namespace = ns;
                    }
                }
                if ("/".equals(ns)) {
                    rootAvailable = true;
                }
            }

            name = uri.substring(namespace.length() + 1);

            // Still none found, use root namespace if found
            if (rootAvailable && "".equals(namespace)) {
                namespace = "/";
            }
        }

        if (!allowSlashesInActionNames) {
            int pos = name.lastIndexOf('/');
            if (pos > -1 && pos < name.length() - 1) {
                name = name.substring(pos + 1);
            }
        }
        //將分離後的acion名和命名空間保存到mapping對象
        mapping.setNamespace(namespace);
        mapping.setName(cleanupActionName(name));
    }

  看到上面代碼的第14行,參數alwaysSelectFullNamespace我們可以通過名字就能大概猜出來”允許采用完整的命名空間”,即設置命名空間是否必須進行精確匹配,true必須,false可以模糊匹配,默認是false。進行精確匹配時要求請求url中的命名空間必須與配置文件中配置的某個命名空間必須相同,如果沒有找到相同的則匹配失敗。這個參數可通過struts2的”struts.mapper.alwaysSelectFullNamespace”常量配置,如:<constant name=”struts.mapper.alwaysSelectFullNamespace” value=”true” />。當alwaysSelectFullNamespace為true時,將uri以lastSlash為分割,左邊的為namespace,右邊的為name。如:http://localhost:8080/myproject/home/actionName!method.action,此時uri為/home/actionName!method.action(不過前面把後綴名去掉瞭,變成/home/actionName!method),lastSlash的,當前值是5,這樣namespace為”/home”, name為actionName!method。

  我們再看到上面代碼第18行到第44行:當上面的所有條件都不滿足時,其中包括alwaysSelectFullNamespace 為false(命名空間進行模糊匹配),將由此部分處理,進行模糊匹配。第1句,通過configManager.getConfiguration()從配置管理器中獲得配置對象Configuration,Configuration中存放著struts2的所有配置,形式是將xml文檔的相應元素封裝為java bean,如<package>元素被封裝到PackageConfig類中,這個一會兒會用到。第2句按lastSlash將uri截取出prefix,這是一個臨時的命名空間,之後將會拿prefix進行模糊匹配。第3句namespace = “”,將命名空間暫時設為””。第4句創建並設置rootAvailable,rootAvailable作用是判斷配置文件中是否配置瞭命名空間”/”,true為配置瞭,false未配置,下面for語句將會遍歷我們配置的所有包(<package>),同時設置rootAvailable。第5句for,通過config.getPackageConfigs()獲得所有已經配置的包,然後遍歷。String ns = ((PackageConfig) cfg).getNamespace()獲得當前包的命名空間ns,之後的if句是進行模糊匹配的核心,我摘出來單獨說,如下:

if (ns != null && prefix.startsWith(ns) && (prefix.length() == ns.length() || prefix.charAt(ns.length()) == '/')) {
    if (ns.length() > namespace.length()) {
        namespace = ns;
    }
}

  ns != null && prefix.startsWith(ns)這部分判斷當ns不等於空並且ns是prefix的前綴。prefix.length() == ns.length()當二者長度相等時,結合前面部分就是ns是prefix的前綴並且二者長度相等,最終結論就是ns和prefix相等。如果前面的條件不成立,則說明prefix的長度大於ns。prefix.charAt(ns.length()) == ‘/’)意思是prefix中與ns不相等的字符中的第一個字符必須是”/”,也就是說,在命名空間采用斜杠分級的形式中,ns必須是prefix的某一子集,如:/common/home 是用戶配置的命名空間,則在http的請求url中,/common/home/index1、/common/home/index2、/common/home/index/aaa 都是正確的,都可以成功的匹配到/common/home,而/common/homeaa、/common/homea/aaa都是錯誤的。接著if (ns.length() > namespace.length()) 句,目的是找出字符長度最長的。因為命名空間采用的是分級的,則長度越長所表示的越精確,如/common/home/index比/common/home精確。之後將namespace = ns。

  我們接著往下看if (“/”.equals(ns)) 當我們配置瞭”/”這個命名空間時,將rootAvailable = true。name = uri.substring(namespace.length() + 1)句不涉及到命名空間就不說瞭。if (rootAvailable && “”.equals(namespace))如果通過上面的for循環沒有找到匹配的命名空間即namespace的值仍然是當初設置的””,但卻配置瞭”/”時,將命名空間設為”/”。

  我們再看到第46到51行那個if語句:

if (!allowSlashesInActionNames) {
    int pos = name.lastIndexOf('/');
    if (pos > -1 && pos < name.length() - 1) {
        name = name.substring(pos + 1);
    }
}

  allowSlashesInActionNames代表是否允許”/”出現在Action的名稱中,默認為false,如果不允許”/”出現在Action名中,並且這時的Action名中有”/”,則取”/”後面的部分。

下面是命名空間匹配規則的總結:

(1). 如果請求url中沒有命名空間時,將采用”/”作為命名空間。

(2). 當我們將常量 struts.mapper.alwaysSelectFullNamespace設為true時,那麼請求url的命名空間必須和配置文件配置的完全相同才能匹配。

當將常量 struts.mapper.alwaysSelectFullNamespace設為false時,那麼請求url的命名空間和配置文件配置的可按模糊匹配。規則:

  a.如果配置文件中配置瞭/common 而url中的命名空間/common、/common/home、/common/home/index等等都是可匹配的,即子命名空間可匹配父命名空間。

  b.如果對於某個url請求中的命名空間同時匹配瞭倆個或倆個以上的配置文件中配置的命名空間,則選字符最長的,如:當前請求的命名空間為/common/home/index/aaaa,  而我們在配置時同時配置               瞭/common/home、/common/home/index  則將會匹配命名空間最長的,即/common/home/index。

(3).最後,如果請求的命名空間在配置中沒有匹配到時,將采用””作為命名空間。如果沒有設置為””的命名空間將拋出404錯誤。

  ②:parseActionName(mapping)

  好瞭,到這裡parseNameAndNamespace方法已經分析完瞭,我們再次回到getMapping方法中去,看到16行:handleSpecialParameters(request, mapping);好像是處理特殊參數的函數吧,裡面有點看不懂,暫時就不管,以後有時間再研究。我們看到18行:return parseActionName(mapping);主要是用來處理形如/userAction!getAll.action的請求,分離action名和方法名:

protected ActionMapping parseActionName(ActionMapping mapping) {
        if (mapping.getName() == null) {
            return null;
        }
        //如果允許動態方法調用
        if (allowDynamicMethodCalls) {
            // handle "name!method" convention.
            String name = mapping.getName();
            int exclamation = name.lastIndexOf("!");
            //如果包含"!"就進行分離
            if (exclamation != -1) {
                //分離出action名
                mapping.setName(name.substring(0, exclamation));
                //分離出方法名
                mapping.setMethod(name.substring(exclamation + 1));
            }
        }
        return mapping;
    }

  到此為止getMapping方法已經分析結束瞭!

(5)execute.executeAction(request, response, mapping)

  上面我們分析完瞭mapping的獲取,繼續看doFilter方法:

//如果mapping為空,則認為不是調用action,會調用下一個過濾器鏈,直到獲取到mapping才調用action
                if (mapping == null) {
                    boolean handled = execute.executeStaticResourceRequest(request, response);
                    if (!handled) {
                        chain.doFilter(request, response);
                    }
                } else {
                    //執行action
                    execute.executeAction(request, response, mapping);
                }

  如果mapping對象不為空,則會執行action,我們看到上面代碼第9行:execute是ExecuteOperations類的對象,ExecuteOperations類在包org.apache.struts2.dispatcher.ng下面,我們找到它裡面的executeAction方法:

public void executeAction(HttpServletRequest request, HttpServletResponse response, ActionMapping mapping) throws ServletException {
    dispatcher.serviceAction(request, response, servletContext, mapping);
}

我們可以看到它裡面隻是簡單的調用瞭dispatcher的serviceAction方法:我們找到dispatcher的serviceAction方法:

public void serviceAction(HttpServletRequest request, HttpServletResponse response, ServletContext context,
                              ActionMapping mapping) throws ServletException {
        //封轉上下文環境,主要將requestMap、params、session等Map封裝成為一個上下文Map
        Map<String, Object> extraContext = createContextMap(request, response, mapping, context);

        // If there was a previous value stack, then create a new copy and pass it in to be used by the new Action
        ValueStack stack = (ValueStack) request.getAttribute(ServletActionContext.STRUTS_VALUESTACK_KEY);
        boolean nullStack = stack == null;
        if (nullStack) {
            ActionContext ctx = ActionContext.getContext();
            if (ctx != null) {
                stack = ctx.getValueStack();
            }
        }
        if (stack != null) {
            extraContext.put(ActionContext.VALUE_STACK, valueStackFactory.createValueStack(stack));
        }

        String timerKey = "Handling request from Dispatcher";
        try {
            UtilTimerStack.push(timerKey);
            String namespace = mapping.getNamespace();//從mapping對象獲取命名空間
            String name = mapping.getName();          //獲取請求的action名
            String method = mapping.getMethod();      //獲取請求方法
            //得到配置對象
            Configuration config = configurationManager.getConfiguration();
            //根據執行上下文參數,命名空間,名稱等創建用戶自定義Action的代理對象
            ActionProxy proxy = config.getContainer().getInstance(ActionProxyFactory.class).createActionProxy(
                    namespace, name, method, extraContext, true, false);

            request.setAttribute(ServletActionContext.STRUTS_VALUESTACK_KEY, proxy.getInvocation().getStack());

            // if the ActionMapping says to go straight to a result, do it!
            //如果配置文件中執行的這個action配置瞭result,就直接轉到result
            if (mapping.getResult() != null) {
                Result result = mapping.getResult();
                result.execute(proxy.getInvocation());
            } else {
                proxy.execute();
            }

            // If there was a previous value stack then set it back onto the request
            if (!nullStack) {
                request.setAttribute(ServletActionContext.STRUTS_VALUESTACK_KEY, stack);
            }
        } catch (ConfigurationException e) {
            // WW-2874 Only log error if in devMode
            if (devMode) {
                String reqStr = request.getRequestURI();
                if (request.getQueryString() != null) {
                    reqStr = reqStr + "?" + request.getQueryString();
                }
                LOG.error("Could not find action or result\n" + reqStr, e);
            } else {
                if (LOG.isWarnEnabled()) {
                    LOG.warn("Could not find action or result", e);
                }
            }
            sendError(request, response, context, HttpServletResponse.SC_NOT_FOUND, e);
        } catch (Exception e) {
            if (handleException || devMode) {
                sendError(request, response, context, HttpServletResponse.SC_INTERNAL_SERVER_ERROR, e);
            } else {
                throw new ServletException(e);
            }
        } finally {
            UtilTimerStack.pop(timerKey);
        }
    }

最後通過Result完成頁面跳轉!

到此這篇關於Java struts2請求源碼分析案例詳解的文章就介紹到這瞭,更多相關Java struts2請求源碼分析內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: