struts2基础之配置详解

Posted

woonu

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了struts2基础之配置详解相关的知识,希望对你有一定的参考价值。

一、struts2工作原理(网友总结,千遍一律)

 

1 客户端初始化一个指向Servlet容器(例如Tomcat)的请求
2 这个请求经过一系列的过滤器(Filter)(这些过滤器中有一个叫做ActionContextCleanUp的可选过滤器,这个过滤器对于Struts2和其他框架的集成很有帮助,例如:SiteMesh Plugin) 
3 接着FilterDispatcher被调用,FilterDispatcher询问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

在上述过程中所有的对象(Action,Results,Interceptors,等)都是通过ObjectFactory来创建的。

 

 技术分享

二、struts2基本配置

2.1  struts.xml配置文件详解

<struts>
    <!-- 开发模式下使用,打印更多详细错误信息 -->
    <constant name="struts.devMode" value="true" />
    
    <!-- 国际化 -->
    <constant name="struts.i18n.encoding" value="UTF-8"/>
    
    <!-- 允许ognl访问静态方法 -->
    <constant name="struts.ognl.allowStaticMethodAccess" value="true" />
    
    <!-- 
        该属性指定需要struts2处理的请求后缀,默认值是action,即,所有匹配*.action的请求
        都由struts2处理,如果用户需要指定多个请求后缀,则多个后缀之间以英文逗号","隔开
     -->
    <constant name="struts.action.extension" value="action"/>
    
    <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->
    <constant name="struts.serve.static.browserCache" value="false"/>
    
    <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值false:不重新加载 -->
    <constant name="struts.configuration.xml.reload" value="true"/>
    
    <!-- 默认的视图主题 -->
    <constant name="struts.ui.theme" value="simple"/>
    
    <!-- 与spring集成时,指定由spring负责管理action对象的创建 -->
    <constant name="struts.objectFactory" value="spring"/>
    
    <!-- 该属性设置struts2是否支持动态方法调用,默认值true:支持 -->
    <constant name="struts.enable.DynamicMethodInvocation" value="false"/>
    
    <!-- 上传文件的大小限制 -->
    <constant name="struts.multipart.maxSize" value="10701096"/>
    
    <!-- 引入文件 -->
    <include file="cn/qjc/action/login/login.xml"></include>
    <include file="cn/qjc/action/demo/demo01.xml"></include>
    <include file="cn/qjc/interceptor/interceptor.xml"></include>
</struts>

 

struts2配置文件加载顺序

  a、default.properties:struts2-core**.jar org.apache.struts包中(程序员只能看)

  b、struts-default.xml:struts2-core**.jar中(程序员只能看)

  c、struts-plugin.xml:在插件的jar包中(程序员只能看)

  d、struts.xml:在应用的构建路径顶端。自己定义的Struts配置文件(推荐

  e、struts.properties:在应用的构建路径顶端。程序员可以编写(不推荐)

  f、web.xml:配置过滤器时,指定参数。程序员可以编写(不推荐)

特别注意:顺序是固定的。后面的配置会覆盖前面的同名配置信息。

 

加载struts.xml过程

技术分享

说明:

  1、  在启动的时候加载了三个配置文件  struts-default.xml、struts-plugin.xml、struts.xml

  2、  如果这三个文件有相同的项,后面覆盖前面的。

  3、  struts.xml文件必须放在src下才能找到。

2.2  package元素

意义:分模块开发

属性:

  name:必须的。配置文件中要唯一。就是一个名字。

  extends:指定父包。会把父包中的配置内容继承下来。一般需要直接或间接的继承一个叫做“struts-default”的包(在struts-default.xml配置文件中)。

        如果不继承该包,那么Struts2中的核心功能将无法使用。

  abstract:是否是抽象包。没有任何action子元素的package可以声明为抽象包。

  namespace:指定名称空间。一般以”/”开头。该包中的动作访问路径:namesapce+动作名称。如果namespace=””,这是默认名称空间,和不写该属性是一样的。

 

2.3  action配置

作用:定义一个动作。

属性:

  name:必须的。动作名称。用户用于发起请求。在包中要唯一。

  class:指定动作类的全名。框架会通过反射机制实例化。默认是:com.opensymphony.xwork2.ActionSupport。

  method:指定动作类中的动作方法。框架会执行该方法。默认是execute()。

  <!-- 配置全局视图:访问动作时没有局部视图,则找全局视图 -->
    <package name="default" extends="struts-default" abstract="true">
        <global-results>
            <result name="success">/WEB-INF/login/success.jsp</result>
        </global-results>
    </package>
    
    <package name="login" namespace="/user" extends="default">
        <action name="login" class="cn.qjc.action.login.Login" method="login">
            <!-- type默认dispatcher 表示请求转发 -->
            <result name="success" type="dispatcher">/WEB-INF/login/success.jsp</result>
            <result name="error">/WEB-INF/login/error.jsp</result>
        </action>
    </package>

三、动作类(Action类)

3.1  编写动作类的三种方式:

a、POJO(Plain Old Java Object)普通的JavaBean。

/**
 * 编写动作类方式一:普通javaBean
 * @author qjc
 */
public class Demo1Action {
    public String seyHello(){
        System.out.println("动作类执行了");
        return "success";
    }
}

b、实现com.opensymphony.xwork2.Action接口

/**
 * 编写动作类方式二:实现Aaction接口
 * @author qjc
 */
public class Demo2Action implements Action{

    @Override
    public String execute() throws Exception {
        System.out.println("动作类执行了");
        return SUCCESS;
    }
}

c、继承com.opensymphony.xwork2.ActionSupport(推荐)

意义:提供了一些基本的功能。比如验证和国际化消息提示等。

/**
 * 编写动作类方式三:继承ActionSupport类
 * @author qjc
 */
public class Demo3Action extends ActionSupport{

}

3.2 ActionSupport用法

在struts框架中,准备了一个ActionSupport类,源码分析:

代码段一:

public class ActionSupport implements Action, Validateable, ValidationAware, TextProvider, LocaleProvider, Serializable {

代码段二:

  /**
     * A default implementation that does nothing an returns "success".
     * <p/> ActionSupport是一个默认的Action实现,但是只返回了一个字符串success
     * Subclasses should override this method to provide their business logic.
     * <p/>子类需要重新覆盖整个方法,在这个方法中写相应的逻辑
     * See also {@link com.opensymphony.xwork2.Action#execute()}.
     *
     * @return returns {@link #SUCCESS}
     * @throws Exception can be thrown by subclasses.
     */
    public String execute() throws Exception {
        return SUCCESS;
    }

代码段三:

    public static final String SUCCESS = "success";

说明:

  1、代码段一说明了ActionSupport也实现了Action接口(以前写的类实现了Action接口)

  2、代码段二说明如果程序员写自己的action继承了ActionSupport,需要重新覆盖execute方法即可。

  3、这个方法默认的返回的是success;

所以在配置文件中也可以这样写:

<action name="actionSupprotAction">
    <result name="success">/baseconfig/successActionSupport.jsp</result>
</action>

可以看到action标签中没有class属性,在struts-default.xml中,

<default-class-ref class="com.opensymphony.xwork2.ActionSupport" />

说明:

  如果在action标签中没有写class属性。那么根据上述的配置文件,struts2会启用ActionSupport这个类。所以action标签中的class属性可以不写。

 

四、结果类型

  1、  每个action方法都返回一个String类型的值,struts一次请求返回什么值是由这个值确定的。

  2、  在配置文件中,每一个action元素的配置都必须有result元素,每一个result对应一个action的返回值。

  3、  Result有两个属性:

    name:结果的名字,和action中的返回值一样,默认值为success;

    type:响应结果类型,默认值为dispatcher.

在struts-default.xml文件中,如下面所示

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

 

说明:

  1、  从上述可以看出总共10种类型

  2、  默认类型为ServletDispatcherResult即转发。

  3、  结果类型可以是这10种结果类型的任意一种。

  

4.1 dispatcher类型:

dispatcher类型是最常用的结果类型,也是struts框架默认的结果类型。

在配置文件中,可以有两种写法:

第一种写法:
    <result name="success">/resulttype/successDispatcher.jsp</result>
第二种写法:
    <result name="success">
        <param name="location">/resulttype/successDispatcher.jsp</param>
</result>

下面的图说明了location的来历:

技术分享

4.2 redirect类型:

这种结果类型与dispatcher类型相对,dispatcher结果类型是将请求forwsrd(转发)到指定的JSP资源;而redirect结果类型,则意味着将请求redirect(重定向)到指定的视图资源。

redirect与dispatcher差别主要是转发和重定向的差别:重定向会丢失所有的请求参数、请求属性,当然也丢失Action处理结果。

注意:

  使用redirect类型的结果时,不能重定向到/WEB-INF/路径下任何资源,因为重定向相当于重新发送请求,而Web应用的WEB-INF/路径是受保护的。

4.3 redirectAction类型:  

这种结果类型与redirect类型非常相似,一样是重新生成一个全新请求,但与redirect区别在于:redirectAction使用ActionMapperFactory提供的ActionMapper来重定向求情。

即:把结果类型重新定向到action。

可以接受两种参数

  a) actionName: action的名字

  b) namespace:命名空间

第一种方式

<result name="success" type="redirectAction">resulttype/redirectactionAction.action</result>

第二种方式

<result name="success" type="redirectAction">
    <!-- 
        actionName:
            请求的action的路径
        namespace:
            如果不写,默认就是请求的action的路径,如果写,路径将被重新赋值
    -->
    <param name="actionName">
        resulttype/redirectactionAction.action
    </param>
</result>

4.4 其他类型

  freemarker:用于转发到另外一个freemarker模板。(页面静态化)

  velocity:用于转发到另外一个velocity模板。

  httpheader:用于输出http协议的消息头。

  xslt:XML有关的样式

  redirect:用于重定向到另外一个JSP页面。

  redirectAction:用于重定向到另外一个动作。

  stream:用于文件下载(日后再讲。文件上传和下载)

  plainText:以纯文本的形式展现页面。输出源码。

4.5 自定义类型

自定义结果类型步骤

技术分享

以随机验证码图片为例

a、编写一个类,直接或间接实现com.opensymphony.xwork2.Result接口。一般继承org.apache.struts2.dispatcher.StrutsResultSupport类

/**
 * 使用自定义结果集加载验证码
 * @author qjc
 */
public class Demo02 extends StrutsResultSupport{
    private int width=120;
    private int height=80;
    private int codeCount=4;
    private int lineCount=100;
    @Override
    protected void doExecute(String finalLocation, ActionInvocation invocation)
            throws Exception {
        //输出结果即可
        
        ValidateCode vc = 
                new ValidateCode(width, height, codeCount, lineCount);
        BufferedImage image = vc.getBuffImg();
        
        //输出即可
        HttpServletResponse response = ServletActionContext.getResponse();
        ImageIO.write(image, "jpeg", response.getOutputStream());
        
    }
    //此处省略getter and setter ...
}

 

b、声明结果类型,然后才能使用

  <!-- 
    自定义结果集
  --> <package name="p3" extends="struts-default"> <result-types> <!-- 结果类型定义 --> <result-type name="captcha" class="cn.qjc.action.demo.Demo02"></result-type> </result-types> </package>

 

c、使用

<action name="captcha">
    <!--使用自定义结果类型:captcha -->
    <result name="success" type="captcha">
          <param name="width">200</param>
    </result>
</action>

页面编写

<body>
         <form action="${pageContext.request.contextPath }/user/login.action">
              用户名:<input name="username"><br>
              密   码:<input type="password" name="password"><br>
              验证码:<input name="code" size="4">
                     <img src="${pageContext.request.contextPath}/captcha.action"><br>
                    <input type="submit" value="登录">
          </form>
  </body>

 

五、Action原型模式

在servlet中,一个servlet只有一个对象,也就是说servlet是单例模式。如果把一个集合写在servlet属性中,则要考虑线程安全的问题。

但是在struts2的框架中,并不存在这种情况,action是多例的。也就是说struts2中的action,只要访问一次就要实例化一个对象。这样就不存在线程安全的问题。这也是struts2框架的一个好处。

可以写一个类,如下:

package cn.qjc.struts2.action.moreinstance;

import com.opensymphony.xwork2.ActionSupport;

@SuppressWarnings("serial")
public class MoreInstanceAction extends ActionSupport{
    public MoreInstanceAction(){
        System.out.println("create new action");
    }
    public String execute(){
        System.out.println("more instance action");
        return SUCCESS;
    }
}

配置文件为:

<struts>
    <package name="moreinstance" namespace="/moreinstance">
        <action name="moreinstanceAction"
            class="cn.qjc.struts2.action.moreinstance.MoreInstanceAction">
        </action>
    </package>
</struts>

请求两次http://localhost:8080/struts2/moreinstance/moreinstanceAction.action路径,如果构造函数中的”create new action”输出两次,说明创建了两次对象。

以上是关于struts2基础之配置详解的主要内容,如果未能解决你的问题,请参考以下文章

Struts2工作原理及xml配置文件简介

Struts2拦截器详解

Struts2搭建配置详解

Struts2工作原理

Struts2工作原理

详解Spring mvc工作原理及源码分析