Struts2 源码分析
| 本章简言 |
上一章笔者讲到关于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节点的信息了。
