Struts2 源码剖析 控制部分-----1

这部分着重分析从我们发出一个uri请求,一直到代码运行到我们自己写的action类为止,struts的控制部分的代码(还有数据流部分,我们后面再分析)

已经用了快1年多的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。

先看我自己画的时序图:



struts在web.xml中的配置如下:

<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>

很显然,我们得去StrutsPrepareAndExecuteFilter里看看,这是一个filter。

现在,我们先不看代码,根据以往关于filter的学习经历,我们能知道,filter至少有3个方法:

init(FilterConfig filterConfig)

doFilter(ServletRequest req, ServletResponse res, FilterChain chain)

destroy()

init方法是初始化的,只运行一次,destroy一样,也只运行一次。

doFilter是真正的struts的业务逻辑。

我们猜一下,init应该就是struts的环境初始化,目前我们先不管它。(下一节,我们再探讨init方法)

我们就按照前面说的struts运行的八个步骤来看看doFilter。

 

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

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

try {
if (excludedPatterns != null && prepare.isUrlExcluded(request, excludedPatterns)) {
chain.doFilter(request, response);
} else {
prepare.setEncodingAndLocale(request, response);
prepare.createActionContext(request, response);
prepare.assignDispatcherToThread();
request = prepare.wrapRequest(request);
//之前的代码 我们先不管
//第三步 找到action的信息
ActionMapping mapping = prepare.findActionMapping(request, response, true);
if (mapping == null) {
boolean handled = execute.executeStaticResourceRequest(request, response);
if (!handled) {
chain.doFilter(request, response);
}
} else {
execute.executeAction(request, response, mapping);
}
}
} finally {
prepare.cleanupRequest(request);
}
}

上面的ActionMapping mapping = prepare.findActionMapping(request, response, true);就是找到对应的action,怎么找的?看代码:

//PrepareOperations.java
public ActionMapping findActionMapping(HttpServletRequest request, HttpServletResponse response, boolean forceLookup) {
ActionMapping mapping = (ActionMapping) request.getAttribute(STRUTS_ACTION_MAPPING_KEY);
if (mapping == null || forceLookup) {
try {
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;
}

这里有一个actionmapping,它是干什么的?

看代码:

public class ActionMapping {

private String name;
private String namespace;
private String method;
private String extension;
private Map<String, Object> params;
private Result result;
//.....
}

懂了么?,就是对应一个action

 mapping = dispatcher.getContainer().getInstance(ActionMapper.class).getMapping(request, dispatcher.getConfigurationManager());

上面的这行,就是先获取ActionMapper,再通过ActionMapper获取ActionMapping。

actionMapper是干什么的?

暂时不清楚

但是我能知道,getInstance返回的是ActionMapper的实现类:DefaultActionMapper

   

//DefaultActionMapper.java 下面的就是时序图中的第四步
public ActionMapping getMapping(HttpServletRequest request, ConfigurationManager configManager) {
ActionMapping mapping = new ActionMapping();
//去除工程名等等 获得uri
String uri = RequestUtils.getUri(request);

//url的带; jsessionid 问题
int indexOfSemicolon = uri.indexOf(";");
uri = (indexOfSemicolon > -1) ? uri.substring(0, indexOfSemicolon) : uri;

//删除扩展名，如.action或者.do
uri = dropExtension(uri, mapping);
if (uri == null) {
return null;
}

//把uri中的信息分析到mapping中
parseNameAndNamespace(uri, mapping, configManager);
//处理特殊参数
handleSpecialParameters(request, mapping);
//主要是用来处理形如/userAction!getAll.action的请求，分离action名和方法名：
return parseActionName(mapping);
}

对DefaultActionMapper的getMapping方法,我们得边调试边看。

例如我访问下面这个路径:
http://localhost:8080/Struts2.3.16.1Hibernate4.3.4Spring4.0.2/login.jsp
RequestUtils.getUri(request)返回的string是:/login.jsp

另外,经过uri = dropExtension(uri, mapping)后,uri就是null了。

然后就直接返回一个null

我们换一个请求路径
http://localhost:8080/Struts2.3.16.1Hibernate4.3.4Spring4.0.2/user/login.action
此时RequestUtils.getUri(request)的返回值就是:/user/login.action

经过dropExtension(uri, mapping)后,uri就是:/user/login

我们看到parseNameAndNamespace,这里干的就是从uri中分离得到请求的action名、命名空间。

这里面的代码,比较复杂,我们只需要知道它干了什么事就OK,它不是我们的重点。

之后的parseActionName干的就是处理动态方法调用的事,感兴趣的,大家可以看看代码

之后,我们就回到了StrutsPrepareAndExecuteFilter的dofilter方法,此时调用的是:

 execute.executeAction(request, response, mapping); (时序图中的第五步)

 查看代码,最终我们到达了Dispatcher的serviceAction方法:

 serviceAction方法,如下,我已经删掉了一些数据相关的代码,例如valuestack

//Dispatcher.java  时序图中的第六步
public void serviceAction(HttpServletRequest request, HttpServletResponse response, ServletContext context,
ActionMapping mapping) throws ServletException {

//处理栈的问题

String namespace = mapping.getNamespace();
String name = mapping.getName();
String method = mapping.getMethod();

Configuration config = configurationManager.getConfiguration();
//时序图中的第7,8步
ActionProxy proxy = config.getContainer().getInstance(ActionProxyFactory.class).createActionProxy(
namespace, name, method, extraContext, true, false);

//时序图中的第9步
//4、如果ActionMapper决定需要调用某个Action，
//FilterDispatcher把请求的处理交给ActionProxy；
proxy.execute();
}

  

 

//StrutsActionProxy.java  时序图中的第10步
public String execute() throws Exception {
ActionContext previous = ActionContext.getContext();
ActionContext.setContext(invocation.getInvocationContext());
try {
return invocation.invoke();
} finally {
if (cleanupContext)
ActionContext.setContext(previous);
}
}

StrutsActionProxy.execute中的invocation是DefaultActionInvocation的实例,其invoke方法如下:

 

//DefaultActionInvocation.java
public String invoke() throws Exception {

if (interceptors.hasNext()) {
final InterceptorMapping interceptor = interceptors.next();
resultCode = interceptor.getInterceptor().intercept(DefaultActionInvocation.this);
} else {
resultCode = invokeActionOnly();
}
return resultCode;
}

}

关于interceptor.getInterceptor().intercept(DefaultActionInvocation.this),这是一个典型的责任链模式,如果对它不清楚,大家可以参考
说说struts2中拦截器的请求流程一(模拟大致流程)

DefaultActionInvocation中有很多过滤器,对每一个请求,都是首先经过那个一个个过滤器然后进入action,之后再通过过滤器

invokeActionOnly之后会调用invokeAction,马上就要进入我们自己写的action里面了。

//DefaultActionInvocation.java  代码有省略
protected String invokeAction(Object action, ActionConfig actionConfig) throws Exception {
String methodName = proxy.getMethod();

String timerKey = "invokeAction: " + proxy.getActionName();

boolean methodCalled = false;
Object methodResult = null;
Method method = null;
try {
method = getAction().getClass().getMethod(methodName, EMPTY_CLASS_ARRAY);
}

if (!methodCalled) {
//OK,我们已经进入 自己写的action了
methodResult = method.invoke(action, EMPTY_OBJECT_ARRAY);
}

return saveResult(actionConfig, methodResult);
}

这里我们只是分析了控制部分的代码,action中的成员变量的值是什么时候写入的,我们写的action返回一个success之后struts又干了什么,struts的启动过程是怎么样的,这都是一个一个的大问题,我会在后面的博客里和大家一一道来。

另外,今天glt回来了

glt是谁?

我女朋友

呵呵 她刚从成都飞回来

辛苦了~~~

参考资料
http://www.cnblogs.com/liuling/p/2013-8-10-01.html