ActionContext和ServletActionContext

1. ActionContext

       在Struts2开发中,除了将请求参数自动设置到Action的字段中,我们往往也需要在Action里直接获取请求(Request)或会话(Session)的一些信息,甚至需要直接对JavaServlet Http的请求(HttpServletRequest),响应(HttpServletResponse)操作. 我们需要在Action中取得request请求参数"username"的值:

ActionContext context = ActionContext.getContext();
Map params = context.getParameters(); //HttpServletRequest获取请求中数据
String username = (String) params.get("username");
ActionContext(com.opensymphony.xwork.ActionContext)是Action执行时的上下文,上下文可以看作是一个容器(其实我们这里的容器就是一个Map而已),它存放的是Action在执行时需要用到的对象. 一般情况, 我们的ActionContext都是通过: ActionContext context = (ActionContext) actionContext.get();来获取的.我们再来看看这里的actionContext对象的创建:

static ThreadLocal actionContext = new ActionContextThreadLocal();

ActionContextThreadLocal是实现ThreadLocal的一个内部类.ThreadLocal可以命名为"线程局部变量",它为每一个使用该变量的线程都提供一个变量值的副本,使每一个线程都可以独立地改变自己的副本,而不会和其它线程的副本冲突.这样,我们ActionContext里的属性只会在对应的当前请求线程中可见,从而保证它是线程安全的. 通过ActionContext取得HttpSession: Map session = ActionContext.getContext().getSession();

       (Map)Struts2框架将与Web相关的很多对象重新进行了包装，比如将HttpSession对象重新包装成了一个Map对象，里面存放着Session中的数据，提供这个Map给Action使用，而不用Action直接和底层的HttpSession打交道。也正是因为框架的包装，让Action可以完全的和Web层解耦。

       但是要注意一点，ActionContext不能在普通的Java应用程序中使用。

       在以前的学习中，介绍了Action和Servlet API是解耦的，因此可以在Java应用程序中调用Action的execute方法来进行测试。但是如果使用了ActionContext来获取session数据，那么就不能这样运行了。因为ActionContext包装的都是Web的数据，在Java应用程序中运行的时候，没有Web的环境和响应的数据，因而会抛出空指针的异常。访问其它的Web对象的值也是与此类似的，你通过ActionContext去访问的都是包装后的Map。

　　2. ServletActionContext

ServletActionContext(com.opensymphony.webwork. ServletActionContext),这个类直接继承了我们上面介绍的ActionContext,它提供了直接与Servlet相关对象访问的功能,它可以取得的对象有:

(1)javax.servlet.http.HttpServletRequest : HTTPservlet请求对象

(2)javax.servlet.http.HttpServletResponse : HTTPservlet相应对象

(3)javax.servlet.ServletContext : Servlet上下文信息

(4)javax.servlet.ServletConfig : Servlet配置对象

(5)javax.servlet.jsp.PageContext : Http页面上下文

如何从ServletActionContext里取得Servlet的相关对象:

<1>取得HttpServletRequest对象: HttpServletRequest request =ServletActionContext. getRequest();

<2>取得HttpSession对象: HttpSession session = ServletActionContext. getRequest().getSession();

　　3. ServletActionContext和ActionContext联系

       ServletActionContext和ActionContext有着一些重复的功能,在我们的Action中,该如何去抉择呢?我们遵循的原则是:如果ActionContext能够实现我们的功能,那最好就不要使用ServletActionContext,让我们的Action尽量不要直接去访问Servlet的相关对象.

注意：在使用ActionContext时有一点要注意: 不要在Action的构造函数里使用ActionContext.getContext(),因为这个时候ActionContext里的一些值也许没有设置,这时通过ActionContext取得的值也许是null；同样，      HttpServletRequest req = ServletActionContext.getRequest()也不要放在构造函数中，也不要直接将req作为类变量给其赋值。至于原因，我想是因为前面讲到的static ThreadLocal actionContext = new ActionContextThreadLocal()，从这里我们可以看出ActionContext是线程安全的，而ServletActionContext继承自ActionContext，所以ServletActionContext也线程安全，线程安全要求每个线程都独立进行，所以req的创建也要求独立进行，所以ServletActionContext.getRequest()这句话不要放在构造函数中，也不要直接放在类中，而应该放在每个具体的方法体中(eg：login()、queryAll()、insert()等)，这样才能保证每次产生对象时独立的建立了一个req。

　　4. struts2中获得request、response和session

(1)非IoC方式

方法一：使用org.apache.struts2.ActionContext类，通过它的静态方法getContext()获取当前Action的上下文对象。

ActionContext ctx = ActionContext.getContext();

ctx.put("liuwei", "andy"); //request.setAttribute("liuwei", "andy");
Map session = ctx.getSession(); //session

HttpServletRequest request = ctx.get(org.apache.struts2.StrutsStatics.HTTP_REQUEST);
HttpServletResponse response = ctx.get(org.apache.struts2.StrutsStatics.HTTP_RESPONSE);
细心的朋友可以发现这里的session是个Map对象, 在Struts2中底层的session都被封装成了Map类型. 我们可以直接操作这个Map对象进行对session的写入和读取操作, 而不用去直接操作HttpSession对象.

方法二：使用org.apache.struts2.ServletActionContext类

public class UserAction extends ActionSupport {
    //其他代码片段
    private HttpServletRequest req;
 // private HttpServletRequest req = ServletActionContext.getRequest(); 这条语句放在这个位置是错误的，同样把这条语句放在构造方法中也是错误的。

    public String login() {
        req = ServletActionContext.getRequest(); //req的获得必须在具体的方法中实现
        user = new User();
        user.setUid(uid);
        user.setPassword(password);
        if (userDAO.isLogin(user)) {
            req.getSession().setAttribute("user", user);
            return SUCCESS;
        }
        return LOGIN;
    }
    public String queryAll() {
        req = ServletActionContext.getRequest(); //req的获得必须在具体的方法中实现
        uList = userDAO.queryAll();
        req.getSession().setAttribute("uList", uList);
        return SUCCESS;
    }
    
    //其他代码片段
}

(2)IoC方式(即使用Struts2 Aware拦截器) 

       Struts2还提供另外一种简单的方式，使用SessionAware接口来访问存储于ActionContext中的数据，该接口通过使用IoC/DI来为Action注入Session Map，就可以在程序里面直接使用这个Map来操作数据了。

      （1）在Action中不再需要访问ActionContext了，取而代之，Action实现SessionAware接口，该接口告知Struts2在Action执行之前要设置Session Map，是通过servletConfig 拦截器来实现的，这个拦截器在defaultStack里面就有。

要使用IoC方式，我们首先要告诉IoC容器(Container)想取得某个对象的意愿，通过实现相应的接口做到这点。

public class UserAction extends ActionSupport implements SessionAware, ServletRequestAware, ServletResponseAware {

    private HttpServletRequest request;
    private HttpServletResponse response;

    public void setServletRequest(HttpServletRequest request) {
        this.request = request;
    }

    public void setServletResponse(HttpServletResponse response) {
        this.response = response;
    }

    public String execute() {
        HttpSession session = request.getSession();
        session.put("sessionTestKey", "测试SessionAware");

        return "success";
    }
}

在上面的代码中：

• Action类实现SessionAware接口
• 这个接口要求Action类实现一个方法setSession(Map<String, Object> session)，通过这个方法注入Session的数据
• 在execute方法中，通过这个私有属性就可以操作会话中的数据，注意一点，这个Map中的值也是与HttpSession联动的。

（2）结果界面也稍作修改，好来看出Action操作session后的效果，示例如下：

        <%@ taglib prefix="s" uri="/struts-tags"%> 

        会话中的值：<s:property value="#session['sessionTestKey']"/><br> 

        通过Servlet的Api获取会话中的值：<%=session.getAttribute("sessionTestKey") %> 

        EL表达式：${session.sessionTestKey }

结果为：会话中的值：测试SessionAware

              通过Servlet的Api获取会话中的值：测试SessionAware

              EL表达式：测试SessionAware

       为了能够在普通的Java应用中运行并测试Action，推荐大家使用SessionAware的方式来访问HttpSession。因为这样一来，在通过main方法运行或测试的时候，可以直接调用setSession方法，传入模拟的会话数据，就不会出现execute方法中抛出空指针的异常了。

       因此，推荐大家使用SessionAware的方式来访问HttpSession

        ActionContext主要负责值的操作；ServletActionContext主要负责获取Servlet对象。

        优先使用ActionContext

       只有ActionContext不能满足功能要求的时候，才使用ServletActionContext