Struts2 源码分析——Result类实例

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Struts2 源码分析——Result类实例相关的知识,希望对你有一定的参考价值。

本章简言

上一章笔者讲到关于DefaultActionInvocation类执行action的相关知识。我们清楚的知道在执行action类实例之后会相关处理返回的结果。而这章笔者将对处理结果相关的内容进行讲解。笔者叫他们为Result类实例。如果还记得在上一章最后笔者说可以把处理action执行的结果简单的理解处理网页。而且还用红色标识。实际是处理跟表现层有关的内容。而不是页面上的内容。如html。即是MVC里面的C到V的内容。当然这还关系到配置文件里面的result元素节点信息。如strtus.xml文件等里面的action元素节点下的result信息。

Result类实例的来源

我们都知道action节点下会很多result节点。在笔者的脑中好像result节点常用的有俩个属性节点:name和type。那么result元素节点下到底有些什么呢?这就不得不去看一下相关的DTD文件。请找到对应的struts-2.5.dtd文件。查看一下下面的内容。

<!ELEMENT result (#PCDATA|param)*>
<!ATTLIST result
    name CDATA #IMPLIED
    type CDATA #IMPLIED
>

好了。好像只有上面讲到的俩个属性节点。但是可以看到他还有一个子节点param。那么为什么要讲到result节点呢?主要是上一章出笔者讲到action类实例执行之后,会去处理结果。哪怕是返回String类型的结果,最终也会获得对应的Result类实例并执行处理结果。关于Result接口的源码却显的非常的简单。如下

1 public interface Result extends Serializable {
2 
3     public void execute(ActionInvocation invocation) throws Exception;
4 
5 }

使用过struts2的人都知道result节点的type值有很多种。type值更是用来表示返回结果的类型。即是type值有多少种,返回的结果就有多少种。如果让笔者来记的话。说真的笔者输了。笔者主要是通过源码文件才能知道到底有多少种。找到源码文件struts-default.xml查看里面的package元素节点下的result-types节点。如下

<result-types>
            <result-type name="chain" class="com.opensymphony.xwork2.ActionChainResult"/>
            <result-type name="dispatcher" class="org.apache.struts2.result.ServletDispatcherResult" default="true"/>
            <result-type name="freemarker" class="org.apache.struts2.views.freemarker.FreemarkerResult"/>
            <result-type name="httpheader" class="org.apache.struts2.result.HttpHeaderResult"/>
            <result-type name="redirect" class="org.apache.struts2.result.ServletRedirectResult"/>
            <result-type name="redirectAction" class="org.apache.struts2.result.ServletActionRedirectResult"/>
            <result-type name="stream" class="org.apache.struts2.result.StreamResult"/>
            <result-type name="velocity" class="org.apache.struts2.result.VelocityResult"/>
            <result-type name="xslt" class="org.apache.struts2.views.xslt.XSLTResult"/>
            <result-type name="plainText" class="org.apache.struts2.result.PlainTextResult" />
            <result-type name="postback" class="org.apache.struts2.result.PostbackResult" />
        </result-types>

好吧。struts2为我们提供了11种。认真的查看源码的人会看到一个属性default。如上面的name为“dispatcher”的result-types的default属性值为true。实际这个值表示为默认使用dispatcher类型的返回结果。同时我们也看到每一个类型对应的类。这个时候笔者就会有一个问题。action执行之后,他是什么样根据String类型的结果值找到对应的Result类实例。笔者就不得不去找上一章解了到的源码。即是createResult方法的源码。如果没有记错的话。从createResult方法我们知道Result类实例是通过ObjectFactory类的buildResult方法得到的。对应的源码如下

ObjectFactory类:

public Result buildResult(ResultConfig resultConfig, Map<String, Object> extraContext) throws Exception {
        return resultFactory.buildResult(resultConfig, extraContext);
    }

 看到上面的代码我们就清楚要找ResultFactory接口的实例类。那么实现ResultFactory接口的类有StrutsResultFactory类和DefaultResultFactory类。到底是哪一个呢?这个问题当年笔者找了很久就是不明白他到底是什么知道用哪一个。当年我去查看了初始化Container容器时,发现好像关于了ResultFactory接口对应的类,只有注入一个DefaultResultFactory类。如下源码。可是项目运行起来跟踪下去。发现用的是StrutsResultFactory类实例。笔者闷了很久。按道理应该是DefaultResultFactory类实例。可是为什么用的是StrutsResultFactory类呢?后来又在struts-default.xml文件里面找到一个。即是StrutsResultFactory类。如下源吗。

DefaultConfiguration类的createBootstrapContainer方法。

builder.factory(ResultFactory.class, DefaultResultFactory.class, Scope.SINGLETON);

struts-default.xml文件:

<bean type="com.opensymphony.xwork2.factory.ResultFactory" name="struts" class="org.apache.struts2.factory.StrutsResultFactory" />

看过XmlConfigurationProvider类的源码就明白这边ResultFactory接口注入的名字值是“struts”。而前面初始化Container容器注入的名字值是“default”。所以Container容器里面有俩个关于ResultFactory接口的注册类。看样子光是找到了struts-default.xml文件里面ResultFactory接口对应的StrutsResultFactory类。还是不能说明为什么要用StrutsResultFactory类实例。另一个原因是因为笔者认为应该是调用名字值为“default”的注册类。为什么这样子讲呢?在于ObjectFactory类里面,setResultFactory方法上面用的是@Inject。即是用默认名字值为default的注册类。笔者也不清楚到底是经过多少时间。最后在DefaultBeanSelectionProvider类的源码里面找到了原因。原来在Container容器里面,名字值为default的注册类被名字值为struts的注册类替换了。源码请读者自己行查看吧。

既然ObjectFactory类可以用来生成对应的Result类实例。那么他做了些什么呢?这是笔者想要了解的关键点。上面ObjectFactory类的buildResult方法源码里面我们至少知道他是在调用了StrutsResultFactory类实例。现在我们只要去找StrutsResultFactory类源码就可以明白他做了什么。如下

 1  public Result buildResult(ResultConfig resultConfig, Map<String, Object> extraContext) throws Exception {
 2         String resultClassName = resultConfig.getClassName();
 3         Result result = null;
 4 
 5         if (resultClassName != null) {
 6             result = (Result) objectFactory.buildBean(resultClassName, extraContext);
 7             Map<String, String> params = resultConfig.getParams();
 8             if (params != null) {
 9                 setParameters(extraContext, result, params);
10             }
11         }
12         return result;
13     }

我们可以看出首先他是根据result节点的配置信息来获得对应的类名。即是上面讲到的11种结果类型对应的类。然后生成Result类实例。哎!又跑回ObjectFactory类了。这次却是生成对象。在把对象转化为Result类实例。接着就是设置对应的参数了。最后返回Result类实例。

Result类实例的处理

经过上面的过程之后。我们可以得到对应的Result类实例。相信大家都知道Result接口对的类实例就有11种。笔者当然也不可能在这里把11种都哪出来讲。笔者只能把一些比较常用的Result类实例拿出来讲。

1.ServletDispatcherResult类是strust2默认的返回结果。即是dispatcher类型。ServletDispatcherResult类实现于StrutsResultSupport类。让我们一下StrutsResultSupport类的源码吧。知道他做了些什么。如下

1   public void execute(ActionInvocation invocation) throws Exception {
2         lastFinalLocation = conditionalParse(location, invocation);
3         doExecute(lastFinalLocation, invocation);
4     }

上面就是Result类实例执行的入口方法。StrutsResultSupport类把当前location进行了处理。也是把要转跳到哪一个网页。其中conditionalParse方法是用于处理表达式。如动态返回结果。不管如何最后是一个跳转的URL。然后调用doExecute抽象方法。好了。让我们看一下ServletDispatcherResult类doExecute方法的源码。

 1  public void doExecute(String finalLocation, ActionInvocation invocation) throws Exception {
 2         LOG.debug("Forwarding to location: {}", finalLocation);
 3 
 4         PageContext pageContext = ServletActionContext.getPageContext();
 5 
 6         if (pageContext != null) {
 7             pageContext.include(finalLocation);
 8         } else {
 9             HttpServletRequest request = ServletActionContext.getRequest();
10             HttpServletResponse response = ServletActionContext.getResponse();
11             RequestDispatcher dispatcher = request.getRequestDispatcher(finalLocation);
12 
13             //处理跳转URL上面的参数。并把他增加action请求的参数集合里面。
14             if (StringUtils.isNotEmpty(finalLocation) && finalLocation.indexOf("?") > 0) {
15                 String queryString = finalLocation.substring(finalLocation.indexOf("?") + 1);
16                 Map<String, Object> parameters = getParameters(invocation);
17                 Map<String, Object> queryParams = urlHelper.parseQueryString(queryString, true);
18                 if (queryParams != null && !queryParams.isEmpty())
19                     parameters.putAll(queryParams);
20             }
21 
22             // 如果不存在网址的话,就跳出404
23             if (dispatcher == null) {
24                 response.sendError(404, "result ‘" + finalLocation + "‘ not found");
25                 return;
26             }
27 
28             //是否是一个action tag 就是网页里面的一个包含action
29             Boolean insideActionTag = (Boolean) ObjectUtils.defaultIfNull(request.getAttribute(StrutsStatics.STRUTS_ACTION_TAG_INVOCATION), Boolean.FALSE);
30 
31             //最后跳转
32             if (!insideActionTag && !response.isCommitted() && (request.getAttribute("javax.servlet.include.servlet_path") == null)) {
33                 request.setAttribute("struts.view_uri", finalLocation);
34                 request.setAttribute("struts.request_uri", request.getRequestURI());
35 
36                 dispatcher.forward(request, response);
37             } else {
38                 dispatcher.include(request, response);
39             }
40         }
41     }

这段代码很简单,处理相关的参数。最后跳转配置里面对应的网页。笔者就不多说了。

2.ServletRedirectResult类是也是Result接口的实例类。即是redirect类型。相信看名字就可以知道用于重定向。也实现于StrutsResultSupport类。笔者也看了源码。真不知道要讲些什么。主要是判断要重定向的finalLocation是不是完全的URL。如果不是就生成对应的完全URL。然后在去找result节点的参数,并把他的参数一起放到requestParameters集合里面。这样子下面才可以生成对应的带参数的URL。如http://xxxx/sss?xxx=xxx。最后重定向。

ServletRedirectResult类:

 1 protected void doExecute(String finalLocation, ActionInvocation invocation) throws Exception {
 2         ActionContext ctx = invocation.getInvocationContext();
 3         HttpServletRequest request = (HttpServletRequest) ctx.get(ServletActionContext.HTTP_REQUEST);
 4         HttpServletResponse response = (HttpServletResponse) ctx.get(ServletActionContext.HTTP_RESPONSE);
 5 
 6         //判断是否为完全的URL。true不是完全的URL。
 7         //如果不是完全的URL就生成完全的URL
 8         if (isPathUrl(finalLocation)) {
 9             if (!finalLocation.startsWith("/")) {
10                 ActionMapping mapping = actionMapper.getMapping(request, Dispatcher.getInstance().getConfigurationManager());
11                 String namespace = null;
12                 if (mapping != null) {
13                     namespace = mapping.getNamespace();
14                 }
15 
16                 if ((namespace != null) && (namespace.length() > 0) && (!"/".equals(namespace))) {
17                     finalLocation = namespace + "/" + finalLocation;
18                 } else {
19                     finalLocation = "/" + finalLocation;
20                 }
21             }
22 
23             // if the URL‘s are relative to the servlet context, append the servlet context path
24             if (prependServletContext && (request.getContextPath() != null) && (request.getContextPath().length() > 0)) {
25                 finalLocation = request.getContextPath() + finalLocation;
26             }
27         }
28         
29         //把result节点上的参数一起放到请求参数集合里面,
30         ResultConfig resultConfig = invocation.getProxy().getConfig().getResults().get(invocation.getResultCode());
31         if (resultConfig != null) {
32             Map<String, String> resultConfigParams = resultConfig.getParams();
33 
34             List<String> prohibitedResultParams = getProhibitedResultParams();
35             for (Map.Entry<String, String> e : resultConfigParams.entrySet()) {
36                 if (!prohibitedResultParams.contains(e.getKey())) {
37                     Collection<String> values = conditionalParseCollection(e.getValue(), invocation, suppressEmptyParameters);
38                     if (!suppressEmptyParameters || !values.isEmpty()) {
39                         requestParameters.put(e.getKey(), values);
40                     }
41                 }
42             }
43         }
44 
45         //根据上面的参数来生成带有参数的URL,
46         StringBuilder tmpLocation = new StringBuilder(finalLocation);
47         urlHelper.buildParametersString(requestParameters, tmpLocation, "&");
48 
49         // add the anchor
50         if (anchor != null) {
51             tmpLocation.append(‘#‘).append(anchor);
52         }
53 
54         finalLocation = response.encodeRedirectURL(tmpLocation.toString());
55 
56         LOG.debug("Redirecting to finalLocation: {}", finalLocation);
57 
58         sendRedirect(response, finalLocation);//重定向到对应的URL
59     }

3.ServletActionRedirectResult类是ServletRedirectResult类的一个子类。 即是redirectAction类型。这个类的做法就是把相应的action的URL处理好。在把URL转给子类ServletRedirectResult去处理。当然要去获得对应的action名字,空间命名,方法。然后生成完全的action的URL。

 1 public void execute(ActionInvocation invocation) throws Exception {
 2         actionName = conditionalParse(actionName, invocation);
 3         if (namespace == null) {
 4             namespace = invocation.getProxy().getNamespace();
 5         } else {
 6             namespace = conditionalParse(namespace, invocation);
 7         }
 8         if (method == null) {
 9             method = "";
10         } else {
11             method = conditionalParse(method, invocation);
12         }
13 
14         String tmpLocation = actionMapper.getUriFromActionMapping(new ActionMapping(actionName, namespace, method, null));
15 
16         setLocation(tmpLocation);
17 
18         super.execute(invocation);
19     }

笔者就介绍这三个类吧。相信读者也知道要去找哪里类了。我们可以看到action类实例执行结束之后。就会去获得对应的Result类实例。当然这里Result类实例具体是哪个类。就有result节点上的配置信息来决定了。然后进行要应的处理。

本章总结

本章讲到Result类实例的知识点。知道了struts2内部有几种的结果类型。每一个类型是什么处理得到的结果信息。是跳转,还是重定向,一切都是strust.xml文件的result节点的信息了。

以上是关于Struts2 源码分析——Result类实例的主要内容,如果未能解决你的问题,请参考以下文章

2018.11.20 Struts2中对结果处理方式分析&struts2内置的方式底层源码剖析

Struts2之result中标准结果代码

Struts2中 Result类型配置详解

Struts2中 Result类型配置详解(转)

DefaultActionInvocation类的执行action

C++卷积神经网络实例:tiny_cnn代码详解(11)——层结构容器layers类源码分析