struts1源码分析(三)请求处理主线

在初始化主线一文中,我们详细分析了框架的初始化过程。本文将从Struts的另外一条主线出发,分析框架的实现原理。上文的初始化主线是一个铺垫,它将框架运行时需要的数据和组件准备完毕,为请求处理主线打下基础。本文基于Struts1.2.8版本,1.3.x系列的差异性将另文说明。

[请求处理接口]

在整体概览和核心组件一文中,我们提到了Struts框架抽象出统一的业务逻辑基类,用户可以继承该类并覆盖请求处理方法,实现自己的业务逻辑。我们再来看一下请求处理方法签名:

public ActionForward execute(
        ActionMapping mapping,
        ActionForm form,
        HttpServletRequest request,
        HttpServletResponse response)
        throws Exception {
    }

与原生的servlet生命周期方法service()相比,该方法增加了三个元素: ActionMapping, ActionForm和ActionForward。由于引入了新的编程元素,使得用户在业务处理上比原生的servlet更加方便。该方法也提现出框架对变化的业务处理逻辑进行抽象,框架的请求处理主线也是围绕该方法展开,包括方法参数的准备和返回值的处理。对变化的进行抽象,对不变的进行固化,这是框架的精髓所在。

[问题]

在分析请求处理主线之前,我们先来思考几个问题。

1. 请求处理过程中哪些东西需要被固化?

2. 如何构建请求处理方法中需要的参数对象(ActionMapping和ActionForm)?

3. 如何对请求处理返回值ActionForward进行处理?

[处理流程]

在整体概览和核心组件一文中,我们介绍了请求处理的核心流程,对各组件功能已经有了整体上的认识。Struts请求处理核心步骤如下:


struts1源码分析(三)请求处理主线
Struts框架包含默认模块和用户自定义模块,ActionServlet在接收请求后获取当前请求对应的模块信息,进而获取模块对应的请求处理类RequestProcessor,并将请求委托给RequestProcessor处理。整个请求处理过程可以分为两段:一是ActionServlet准备委托处理对象RequestProcessor, 二是RequestProcessor对请求进行处理。下面从源码角度分别解读这两段过程。

[准备委托处理对象]

在Servlet生命周期中,请求处理由生命周期方法service()完成。对于不同的请求method(如Get/Post等),service()方法内部调用method处理方法(如doGet()/doPost()等)完成请求处理。ActionServlet重写doGet()和doPost()方法,完成对Get和Post请求处理。我们看一下doGet()方法实现:

public void doGet(HttpServletRequest request,
              HttpServletResponse response)
        throws IOException, ServletException {

        process(request, response);

    }
该方法比较简单,只是简单调用process()方法,doPost()方法也是如此。我们再看一下process()方法实现:
protected void process(HttpServletRequest request, HttpServletResponse response)
    throws IOException, ServletException {

    // 1. 获取当前请求对应的Module配置信息(ModuleConfig和MessageResources),并将信息存入request作用域
    ModuleUtils.getInstance().selectModule(request, getServletContext());
    
    // 2. 获取当前请求的ModuleConfig实例
    ModuleConfig config = getModuleConfig(request);

    // 3. 获取模块对应的处理类RequestProcessor
    RequestProcessor processor = getProcessorForModule(config);
    if (processor == null) {
       processor = getRequestProcessor(config);
    }
    
    // 4. 将请求委托给RequestProcessor进行处理
    processor.process(request, response);

}

以上过程总共分为四步,在代码注释中已经详细说明。这里需要说明一点,每个Module都有唯一的RequestProcessor实例,该实例保存在ServletContext中,使用的key为”Globals.REQUEST_PROCESSOR_KEY + 模块前缀“。如果从ServletContext获取不到该实例,就新建一个实例并保存。因为一个模块只有唯一的RequestProcessor实例,所以RequestProcessor从实现上必须无状态,才不会出现并发问题。

[RequestProcessor请求处理]

上个阶段的目标是获取请求对应的RequestProcessor实例,真正的请求处理过程由RequestProcessor的process()方法完成。该方法实现如下:
public void process(HttpServletRequest request,
                    HttpServletResponse response)
    throws IOException, ServletException {

    // 1. 针对multipart请求类型,使用MultipartRequestWrapper对请求进行包装
    request = processMultipart(request);

    // 2. 获取当前请求的path信息
    String path = processPath(request, response);
    if (path == null) {
        return;
    }
    
    // 此处省略log信息

    // 3. 从请求中获取locale信息并放入session中
    processLocale(request, response);

    // 4. 对响应头ContentType和NoCache设置默认值
    processContent(request, response);
    processNoCache(request, response);

    // 5. 增加预处理钩子,可以重写该方法,增加自定义处理逻辑
    if (!processPreprocess(request, response)) {
        return;
    }
    
    // 6. 清除session中的ActionMessages对象,比如错误信息
    this.processCachedMessages(request, response);

    // 7. 根据path获取当前路径对应的ActionMapping对象
    ActionMapping mapping = processMapping(request, response, path);
    if (mapping == null) {
        return;
    }

    // 8. 验证用户角色是否在允许列表中
    if (!processRoles(request, response, mapping)) {
        return;
    }

    // 9. 获取当前请求对应的ActionForm实例
    ActionForm form = processActionForm(request, response, mapping);
    // 10. 根据请求参数填充ActionForm实例
    processPopulate(request, response, form, mapping);
    // 11. 完成Form验证
    if (!processValidate(request, response, form, mapping)) {
        return;
    }

    // 12. 完成ActionMapping中forward请求处理
    if (!processForward(request, response, mapping)) {
        return;
    }
    
    // 13. 完成ActionMapping中include请求处理
    if (!processInclude(request, response, mapping)) {
        return;
    }

    // 14. 获取当前请求对应的Action实例
    Action action = processActionCreate(request, response, mapping);
    if (action == null) {
        return;
    }

    // 15. 调用Action实例的execute()方法,完成业务逻辑处理
    ActionForward forward =
        processActionPerform(request, response,
                             action, form, mapping);

    // 16. 对执行结果ActionForward进行处理
    processForwardConfig(request, response, forward);

}
该方法条理清晰,可读性高,每一步的作用已经在方法注释中说明。下面对方法中几个核心对象的使用做进一步说明。

[ActionMapping]

在第2步中,从request中提取当前请求对应的path信息。该信息将用于第7步中获取path对应的ActionMapping实例。ActionMapping实例是一个请求(路径)对应的框架配置信息载体,通过获取该实例,才能拿到请求对应的ActionForm、Action和ActionForward等配置信息。

[ActionForm]

1. 第9步中,从ActionMapping中获取当前请求的ActionForm名称,然后根据ActionForm名称查找ActionForm配置,进而获取ActionForm实例。 如果没有可重用的ActionForm实例,需要根据ActionForm的类信息通过反射方式生成实例。

2. 第10步中,获取请求的参数列表,然后用这些参数值填充ActionForm中对应的属性值,通过Apache BeanUtils完成填充工作。

3. 第11步中,调用ActionForm的validate()方法完成表单验证。如果验证失败,将错误信息放入request中,结束请求处理。

[Action]

1. 第14步中,从ActionMapping中获取该请求对应的Action名称,RequestProcessor维护了所有Action实例的HashMap,通过Action名称可以获取对应的Action实例。如果没有获取到,则根据Action类信息采用反射方式生成Action实例。由于每个Action对应的实例只有一个,所以Action本身是线程不安全的,编写业务代码时要特别注意。

2. 第15步中,processActionPerform()方法内部调用Action.execute()方法,完成业务逻辑调用。

[ActionForward]

第16步中,对执行结果ActionForward进行处理。processForwardConfig()内部根据配置文件中forward的redirect属性决定采用forward跳转方式还是redirect跳转方式。

[小结]

本文从源码角度分析了Struts1的请求处理主线。ActionServlet在请求处理过程中只负责找到请求对应的RequestProcessor,然后委托给RequestProcessor进行处理;RequestProcessor通过调用ActionMapping/ActionForm/Action/ActionForward这四个核心对象完成请求处理过程。总体上看,请求处理主线逻辑清晰,可读性高。缺陷是可扩展性差,特别是RequestProcessor的处理过程只有一处预处理钩子,不能灵活定制框架处理逻辑。下文将详细分析Struts 1.3.x系列针对请求处理的优化措施。

 

相关推荐