struts2 学习笔记

 Struts.xml配置中的包介绍：

<package name="itcast" namespace="/test" extends="struts-default">

<action name="helloworld" class="cn.itcast.action.HelloWorldAction" method="execute" >

<result name="success">/WEB-INF/page/hello.jsp</result>

</action>

 </package>

在struts2框架中使用包来管理Action，包的作用和java中的类包是非常类似的，它主要用于管理一组业务功能相关的action。在实际应用中，我们应该把一组业务功能相关的Action放在同一个包下。

配置包时必须指定name属性，该name属性值可以任意取名，但必须唯一，他不对应java的类包，如果其他包要继承该包，必须通过该属性进行引用。包的namespace属性用于定义该包的命名空间，命名空间作为访问该包下Action的路径的一部分，如访问上面例子的Action，访问路径为：/test/helloworld.action。 namespace属性可以不配置，对本例而言，如果不指定该属性，默认的命名空间为“”（空字符串）。

通常每个包都应该继承struts-default包， 因为Struts2很多核心的功能都是拦截器来实现。如：从请求中把请求参数封装到action、文件上传和数据验证等等都是通过拦截器实现的。struts-default定义了这些拦截器和Result类型。可以这么说：当包继承了struts-default才能使用struts2提供的核心功能。 struts-default包是在struts2-core-2.x.x.jar文件中的struts-default.xml中定义。 struts-default.xml也是Struts2默认配置文件。 Struts2每次都会自动加载 struts-default.xml文件。

包还可以通过abstract=“true”定义为抽象包，抽象包中不能包含action。

 

Action名称的搜索顺序

1．获得请求路径的URI，例如url是：http://server/struts2/path1/path2/path3/test.action

2．首先寻找namespace为/path1/path2/path3的package，如果不存在这个package则执行步骤3；如果存在这个package，则在这个package中寻找名字为test的action，当在该package下寻找不到action 时就会直接跑到默认namaspace的package里面去寻找action（默认的命名空间为空字符串“” ） ，如果在默认namaspace的package里面还寻找不到该action，页面提示找不到action

3．寻找namespace为/path1/path2的package，如果不存在这个package，则转至步骤4；如果存在这个package，则在这个package中寻找名字为test的action，当在该package中寻找不到action 时就会直接跑到默认namaspace的package里面去找名字为test的action ，在默认namaspace的package里面还寻找不到该action，页面提示找不到action

4．寻找namespace为/path1的package，如果不存在这个package则执行步骤5；如果存在这个package，则在这个package中寻找名字为test的action，当在该package中寻找不到action 时就会直接跑到默认namaspace的package里面去找名字为test的action ，在默认namaspace的package里面还寻找不到该action，页面提示找不到action

5．寻找namespace为/的package，如果存在这个package，则在这个package中寻找名字为test的action，当在package中寻找不到action或者不存在这个package时，都会去默认namaspace的package里面寻找action，如果还是找不到，页面提示找不到action。

 

Action配置中的各项默认值

<package name="itcast" namespace="/test" extends="struts-default">

        <action name="helloworld" class="cn.itcast.action.HelloWorldAction" method="execute" >

<result name="success">/WEB-INF/page/hello.jsp</result>

        </action>

  </package>

1>如果没有为action指定class，默认是ActionSupport。

2>如果没有为action指定method，默认执行action中的execute() 方法。

3>如果没有指定result的name属性，默认值为success。

 

Action中result的各种转发类型

<action name="helloworld" class="cn.itcast.action.HelloWorldAction">

<result name="success">/WEB-INF/page/hello.jsp</result>

</action>

result配置类似于struts1中的forward，但struts2中提供了多种结果类型，常用的类型有： dispatcher(默认值)、redirect、 redirectAction 、 plainText。

在result中还可以使用${属性名}表达式访问action中的属性，表达式里的属性名对应action中的属性。如下：

<result type="redirect">/view.jsp?id=${id}</result>

下面是redirectAction 结果类型的例子，如果重定向的action中同一个包下：

<result type="redirectAction">helloworld</result>

如果重定向的action在别的命名空间下：

<result type="redirectAction">

<param name="actionName">helloworld</param>

<param name="namespace">/test</param>

</result>

plaintext:显示原始文件内容，例如：当我们需要原样显示jsp文件源代码 的时候，我们可以使用此类型。

<result name="source" type="plainText ">

<param name="location">/xxx.jsp</param>

<param name="charSet">UTF-8</param><!-- 指定读取文件的编码 -->

</result>

 

多个Action共享一个视图--全局result配置

当多个action中都使用到了相同视图，这时我们应该把result定义为全局视图。struts1中提供了全局forward，struts2中也提供了相似功能：

<package ....>

<global-results>

<result name="message">/message.jsp</result>

</global-results>

</package>

 

指定需要Struts 2处理的请求后缀

前面我们都是默认使用.action后缀访问Action。其实默认后缀是可以通过常量”struts.action.extension“进行修改的，例如：我们可以配置Struts 2只处理以.do为后缀的请求路径：

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE struts PUBLIC

    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"

    "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>

    <constant name="struts.action.extension" value="do"/>

</struts>

如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。如：

 <constant name="struts.action.extension" value="do,go"/>

 

细说常量定义

常量可以在struts.xml或struts.properties中配置，建议在struts.xml中配置，两种配置方式如下：

在struts.xml文件中配置常量

<struts>

    <constant name="struts.action.extension" value="do"/>

</struts>

在struts.properties中配置常量

struts.action.extension=do

因为常量可以在下面多个配置文件中进行定义，所以我们需要了解struts2加载常量的搜索顺序:

struts-default.xml

struts-plugin.xml

struts.xml

struts.properties

web.xml

如果在多个文件中配置了同一个常量，则后一个文件中配置的常量值会覆盖前面文件中配置的常量值.

 

常用的常量介绍

<!-- 指定默认编码集,作用于HttpServletRequest的setCharacterEncoding方法 和freemarker 、velocity的输出 -->

    <constant name="struts.i18n.encoding" value="UTF-8"/>

    <!-- 该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。

    如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。 -->

    <constant name="struts.action.extension" value="do"/>

    <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->

    <constant name="struts.serve.static.browserCache" value="false"/>

    <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->

    <constant name="struts.configuration.xml.reload" value="true"/>

    <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->

    <constant name="struts.devMode" value="true" />

     <!-- 默认的视图主题 -->

    <constant name="struts.ui.theme" value="simple" />

    <!– 与spring集成时，指定由spring负责action对象的创建 -->

    <constant name="struts.objectFactory" value="spring" />

 <!–该属性设置Struts 2是否支持动态方法调用，该属性的默认值是true。如果需要关闭动态方法调用，则可设置该属性为false。 -->

<constant name="struts.enable.DynamicMethodInvocation" value="false"/>

 <!--上传文件的大小限制-->

<constant name="struts.multipart.maxSize" value=“10701096"/>

 

Struts2的处理流程

用户请求------------------>StrutsPrepareAndExecuteFilter
                                                                 |
                                                       Interceptor      Struts2内置的一些拦截器或用户自定义拦截器
                                                                 |
                                                           Action      用户编写的action类，类似struts1中的Action
                                                                |
                                                          Result   类似struts1中的forward
                                                              |
                                 响应 <---------Jsp/html

StrutsPrepareAndExecuteFilter是Struts 2框架的核心控制器，它负责拦截由<url-pattern>/*</url-pattern>指定的所有用户请求，当用户请求到达时，该Filter会过滤用户的请求。默认情况下，如果用户请求的路径不带后缀或者后缀以.action结尾，这时请求将被转入Struts 2框架处理，否则Struts 2框架将略过该请求的处理。当请求转入Struts 2框架处理时会先经过一系列的拦截器，然后再到Action。与Struts1不同，Struts2对用户的每一次请求都会创建一个Action，所以Struts2中的Action是线程安全的。

 

为应用指定多个struts配置文件

 

在大部分应用里，随着应用规模的增加，系统中Action的数量也会大量增加，导致struts.xml配置文件变得非常臃肿。为了避免struts.xml文件过于庞大、臃肿，提高struts.xml文件的可读性，我们可以将一个struts.xml配置文件分解成多个配置文件，然后在struts.xml文件中包含其他配置文件。下面的struts.xml通过<include>元素指定多个配置文件：

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE struts PUBLIC

    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"

    "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>

<include file="struts-user.xml"/>

<include file="struts-order.xml"/>

</struts>

通过这种方式，我们就可以将Struts 2的Action按模块添加在多个配置文件中。

 

 

自定义局部类型转换器

java.util.Date类型的属性可以接收格式为2009-07-20的请求参数值。但如果我们需要接收格式为20091221的请求参数，我们必须定义类型转换器，否则struts2无法自动完成类型转换。

import java.util.Date;

public class HelloWorldAction {

private Date createtime;

public Date getCreatetime() {

return createtime;

}

public void setCreatetime(Date createtime) {

this.createtime = createtime;

}

}

 

public class DateConverter extends DefaultTypeConverter 

public class DateConverter extends DefaultTypeConverter {

 @Override 

public Object convertValue(Map context, Object value, Class toType) {

SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMdd");

try {

if(toType == Date.class){//当字符串向Date类型转换时

String[] params = (String[]) value;// Request.getParameterValues()

return dateFormat.parse(params[0]);

}else if(toType == String.class){//当Date转换成字符串时

Date date = (Date) value;

return dateFormat.format(date);

}

} catch (ParseException e) {}

return null;

}

}

将上面的类型转换器注册为局部类型转换器：

在Action类所在的包下放置ActionClassName-conversion.properties文件，ActionClassName是Action的类名，后面的-conversion.properties是固定写法，对于本例而言，文件的名称应为HelloWorldAction-conversion.properties 。在properties文件中的内容为：

属性名称=类型转换器的全类名

对于本例而言， HelloWorldAction-conversion.properties文件中的内容为：

createtime= cn.itcast.conversion.DateConverter

 

 

自定义全局类型转换器

将上面的类型转换器注册为全局类型转换器：

在WEB-INF/classes下放置xwork-conversion.properties文件 。在properties文件中的内容为：

待转换的类型=类型转换器的全类名

对于本例而言， xwork-conversion.properties文件中的内容为：

java.util.Date= cn.itcast.conversion.DateConverter

 

访问或添加request/session/application属性

public String scope() throws Exception{

   ActionContext ctx = ActionContext.getContext();

   ctx.getApplication().put("app", "应用范围");//往ServletContext里放入app

   ctx.getSession().put("ses", "session范围");//往session里放入ses

   ctx.put("req", "request范围");//往request里放入req

   return "scope";

}

JSP:

 <body>

    ${applicationScope.app} <br>

    ${sessionScope.ses}<br>

    ${requestScope.req}<br>

 </body>

 

获取HttpServletRequest / HttpSession / ServletContext / HttpServletResponse对象

方法一，通过ServletActionContext.类直接获取：

public String rsa() throws Exception{

HttpServletRequest request = ServletActionContext.getRequest();

ServletContext servletContext = ServletActionContext.getServletContext();

request.getSession()

HttpServletResponse response = ServletActionContext.getResponse();

return "scope";

}

方法二，实现指定接口，由struts框架运行时注入：

public class HelloWorldAction implements ServletRequestAware, ServletResponseAware, ServletContextAware{

private HttpServletRequest request;

private ServletContext servletContext;

private HttpServletResponse response;

public void setServletRequest(HttpServletRequest req) {

this.request=req;

}

public void setServletResponse(HttpServletResponse res) {

this.response=res;

}

public void setServletContext(ServletContext ser) {

this.servletContext=ser;

}

}