Struts2技术总结

 

• 必备jar文件

早在struts2.0.*的时候，struts2的必备jar包需要如下几个：

commons-logging-*.jar   Apache旗下commons项目的log日志包

freemarker-*.jar             一种前台页面模板，应用比较广泛

ognl-*.jar                        动态图导航语言，struts2处理前台页面的核心语言，相当实用

struts2-core-*.jar           struts2的核心包

xwork-core-*.jar             webwork的核心包，因为struts2的前身是webwork，所以这个是必须的

只要满足这5个基本jar包就可以运行一个struts2的hello world

(注：*表示版本号，struts2不同版本，使用的jar包版本也可能不一样。)

 

但是后面版本，比如struts-2.1.8.1，必须再添加一个新jar包才能运行，不然启动就会报错：

commons-fileupload-1.2.1.jar   支持文件上传的jar包

 

 

• web.xml文件配置

在web.xml需要配置struts2滤镜，即当jsp向后台发送请求时需要经过struts2拦截分析处理，需要注意的是struts2与struts1和spring mvc的拦截机制不同，它是通过一个filter拦截的。

filter拦截器的类除了下面这个类以外，也可以引用“org.apache.struts2.dispatcher.FilterDispatcher”。

注意filter-mapping配置的url-pattern即拦截所有的请求，如果写成/*.action就只能拦截以.action结尾的请求。

<init-param>标签中的config指定struts2初始核心文件路径，struts.xml是最核心文件

<!-- struts2 滤镜配置  -->
	<filter>
		<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
		<init-param>
			<param-name>config</param-name>
			<param-value>
        	struts-default.xml,
        	struts-plugin.xml,
        	<!-- 核心struts.xml文件  -->
        	../conf/common/struts2/struts.xml,
        	</param-value>
		</init-param>
	</filter>

	<filter-mapping>
		<filter-name>struts2</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

 

• struts.xml文件配置

下面介绍一些struts2常用的配置信息，注意这些配置都有合适的默认值，不是必须的。

属性struts.i18n.encoding：指定字符集编码，这个配置经常用到；

属性struts.action.extension：指定JSP哪些后缀请求是struts2的请求，常用配置

属性struts.devMode：当系统发生异常，在浏览器打印详细的错误消息，产品上线时间以设为false关闭

属性struts.enable.DynamicMethodInvocation：是否允许OGNL在JSP中直接调用java方法，不推荐使用

标签include：项目大的话，通常都会写很多struts2配置文件，然后通过include标签将其它配置文件引进来，需要注意的是如果struts.xml文件放在src根目录下，include的内容是支持通配符的，但是如果struts.xml文件放在其它位置就不能用通配符了，必须老老实实写路径，下面这个include就是struts.xml放在conf目录后引用其它文件的方式。

<?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>
	
	<!--载入默认的struts配置-->
	<include file="struts-default.xml" />

	<!--指定web应用的默认编码集，相当于调用HttpServletRequest的setCharacterEncoding方法-->
    <constant name="struts.i18n.encoding" value="UTF-8"></constant>
    
    <!--该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts 2处理
        如果用户需要制定多个请求后缀，则多个后缀之间以英文逗号隔开-->
    <constant name="struts.action.extension" value="action,do"></constant>
    
    <!--设置浏览器是否缓存静态内容，默认值为true，生产环境下使用，开发阶段最好关闭 -->
    <constant name="struts.serve.static.browserCache" value="false"></constant>
    
    <!--当struts的配置文件修改后，系统是否自动重新加载该文件，默认值为false，生产环境下使用，开发阶段最好打开 -->
    <constant name="struts.configuration.xml.reload" value="true"></constant>
    
    <!--开发模式下使用，可以打印出更详细的错误信息 -->
    <constant name="struts.devMode" value="true" />
    
    <!-- 动态方法调用 false为不允许 -->
    <constant name="struts.enable.DynamicMethodInvocation" value="true" />
  	
    <!-- 默认的视图主题,标签不支持label  ; theme属性包括xhtml,html,simple,ajax ,默认是xhtml-->
    <constant name="struts.ui.theme" value="simple"></constant>
    
    <!--Struts2集成Spring：所有action对象由Spring来负责创建-->
    <constant name="struts.objectFactory" value="spring"></constant>

    <!-- 支持页面使用静态方法和属性 -->
    <constant name="struts.ognl.allowStaticMethodAccess" value="true"></constant>
    
    <!-- 跳转到登录页 -->
    <package name="CommonPackage" extends="struts-default" namespace="/common">
    	<action name="toLoginPage">
    		<result>/Web/login/page/login.jsp</result>
    	</action>
    </package>
	<!-- 指定其它的配置文件路径 -->
    <include file="../conf/common/struts2/interceptor-common-exception.xml"></include>
</struts>

 

• 获取Servlet内置对象

基于java web开发，我们经常会使用到servlet的内置对象：request、session、application等，通过struts2框架获取内置对象有四种方式：

（1）通过ActionContext来获得，获取的对象是不基于Servlet容器的；

（2）通过ServletActionContext获得，获取的对象是Servlet内置对象

//取得HttpServletRequest对象
HttpServletRequest request = ServletActionContext. getRequest();

//取得HttpSession对象
HttpSession session = ServletActionContext. getRequest().getSession();

（3）通过Struts2提供的IOC实现RequestAware,SessionAware,ApplicationAware三个接口的抽象方法

（4）通过Struts2提供的IOC实现ServletRequestAware,ServletContextAware这两个接口的抽象方法，这种方式个人比较推荐，你只需要创建一个BaseAction实现IOC，其它Action继承BaseAction，随后就直接调用内置对象即可：

public class BaseAction extends ActionSupport implements ServletRequestAware,
ServletContextAware,ServletResponseAware{
	//配置序列化标志
	private static final long serialVersionUID = 1L;
	
	//request,response,application,session作用域
	protected HttpServletRequest request ;
	protected ServletContext application;
	protected HttpServletResponse response;
	protected HttpSession session;
	
	/**
	 * 依赖servlet容器的IOC设置-start
	 */
	@Override
	public void setServletRequest(HttpServletRequest arg0) {
		this.request = arg0;
		session = this.request.getSession();
	}

	@Override
	public void setServletContext(ServletContext arg0) {
		this.application = arg0;
	}

	@Override
	public void setServletResponse(HttpServletResponse arg0) {
		this.response = arg0;
	}
	/**
	 * 依赖servlet容器的IOC设置-end
	 */

	//重写execute方法
	@Override
	public String execute() throws Exception {
		request.setAttribute("requestKey", "requestValue");
		session.setAttribute("sessionKey", "sessionValue");
		application.setAttribute("applicationKey", "applicationValue");
		return SUCCESS;
	}
}}

 

• OGNL对象图导航语言

OGNL是一个功能强大的EL，通过它简单一致的表达式语法，可以存取对象的任意属性，调用对象的方法，遍历整个对象的结构图，实现字段类型转化等功能。它使用相同的表达式去存取对象的属性。因为太过复杂，这里就简单介绍几个常用的。

假设demo1.jsp页面有姓名name,年龄age这两个表单数据，它们被提交到action（action可以访问数据库保存或者比对或者更新），然后action再转发到demo2.jsp页面显示刚才输入的数据。

这是一个典型的B/S案例，我们可以将表单数据封装到一个JavaBean中（有的人喜欢叫pojo，还有的叫vo，还有的叫formbean），到demo2.jsp的时候通过ognl表达式取出来。

【demo1.jsp】

 

<%@ page contentType="text/html; charset=UTF-8" language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!--添加struts2标签的引用-->
<%@ taglib prefix="s" uri="/struts-tags" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
	<head>
	</head>
  
	<body>
		<s:form action="doSaveAction.action" method="post">
		<s:textfield  name="user.name">姓名：</s:textfield>
		<s:textfield name="user.age">年龄：</s:textfield>
	   	<s:submit value="提交"></s:submit>
	   	</s:form>
	</body>
</html>

 

  【User.java】

 

public class User{
  private String name;
  private String age;
  ...get、set方法...
}

  【SaveAction.java】

public class SaveAction extends ActionSupport{
	private static final long serialVersionUID = 1L;
	//将User这个javabean创建set方法便能获得从jsp请求过来的user对象数据
	//同时user对象会放在值栈中，在demo1.jsp--SaveAction--demo2.jsp这个生命周期都存在
	private User user;

	public String doSave(){
		return SUCCESS;
	}
	
	public User getUser() {
		return user;
	}
	public void setUser(User user) {
		this.user = user;
	}
}

  【demo2.jsp】

<s:property value="user.name"/>
<s:property value="user.age"/>

之所以命名为OGNL，就是因为它处理对象很给力，struts能够将对象层层解析，把各个对象的关系以图的样式展示出来。比如user.name，之所以能找到这个对象，就是因为OGNL会先找user对象，然后再找user对象里的name对象。假设User这个类还包含了名为Role的javabean的实例，Role里面包含字段roleName，我们要找到roleName就可以直接写<s:property value="user.role.roleName">，OGNL通过对象逐级导航找到子对象。

当然OGNL也可以像jsp一样调用后台代码，不过我发现在jsp调用后台代码的效率很低，所以不是很推荐。

ognl调用静态方法的写法如下：@类全名@静态方法名，这句话等同于java代码：类全名.静态方法名

运行静态方法：<s:property value="@com.bless.ssh2.action.OgnlAction@staticMethod()"/><br/>
运行值栈对象中的方法：<s:property value="user.method()"/><br/>
调用JDK中的静态方法：<s:property value="@java.lang.Math@floor(44.56)"/><br/>

   需要注意的是，struts2.1.*默认是不允许调用静态方法的，你需要在struts.xml配置这样一句话：

<constant name="struts.ognl.allowStaticMethodAccess" value="true"/>

下面这个是早前自己写的Struts2标签库的例子，内容肯定不全：

<body>
<!-- "%{}"表示支持ognl表达式，"#u"表示从值栈的actioncontex中查找值 -->
<s:form action="doTags.action">
<h3>常用标签库</h3>
<table>
	<tr>
		<td>编号：</td>
		<!-- 直接获取后台的值 -->
		<td><s:property value="tagBean.id"></s:property></td>
	</tr>

	<tr>
		<td>姓名：</td>
		<!-- 文本框 -->
		<td><s:textfield name="tagBean.name"></s:textfield></td>
	</tr>
	
	<tr>
		<td>密码：</td>
		<!-- 密码框 -->
		<td><s:password name="tagBean.password"></s:password></td>
	</tr>
	
	<tr>
		<td>生日：</td>
		<td>
		<!-- 在文本框中格式化时间 -->
		<s:textfield name="tagBean.birthday">
			<s:param name="value">
				<s:date name="tagBean.birthday" format="yyyy-MM-dd hh:MM:ss" />
			</s:param>
		</s:textfield>
		</td>
		<td>生日：</td>
		<!-- 时间标签，可以格式化滴 -->
		<td><s:date name="tagBean.birthday" format="yyyy年MM月dd日"></s:date></td>
	</tr>
	
	<tr>
		<td>性别：</td>
		<td><s:radio name="tagBean.sex" list="#request.lstSex" listKey="sexId" listValue="sexValue"></s:radio></td>
	</tr>
	
	<tr>
		<td>城市：</td>
		<!-- listKey:下拉列表被选中后的真实值，listValue：下拉列表被选中后的显示值，headerKey：默认值，headerValue：默认显示值，emptyOption：是否在默认值和实际值下拉列表之间加一个空行 -->
		<td><s:select name="tagBean.city" list="#request.lstCity" listKey="cityId" listValue="cityValue" headerKey="0" headerValue="--请选择--"  emptyOption="true"></s:select></td>
	</tr>
	
	<tr>
		<!-- 此标签等同于：struts2.tags.ListAddress la = new struts2.tags.ListAddress(); -->
		<!-- 此标签需要启用struts2的一个配置常量：<constant name="struts.enable.DynamicMethodInvocation" value="true" />，通常不推荐使用此法，在这只是做个例子 -->
		<s:bean name="struts2.tags.ListAddress" id="la"></s:bean>
		<td>地区：</td>
		<!-- s:checkboxlist标签支持多个checkbox， s:checkbox只支持单个checkbox-->
		<td><s:checkboxlist name="tagBean.address" list="#la.lstAddress" listKey="addressId" listValue="addressValue"></s:checkboxlist></td>
	</tr>
</table>
<!-- hidden标签存放隐藏值 -->
<s:hidden></s:hidden>
<s:submit value="确定"></s:submit>
<s:reset value="重置"></s:reset>
<hr/>
<h3>OGNL</h3>
<table>
	<!-- #符号： 获取值栈中的作用域 [parameters]路径中传参，[request][session][application]这几个不用说，[attr]表示从parameters到application依次找-->
	<!-- %{}符号：可以获取值栈中的对象,可以使用ognl表达式 -->
	<!-- 如果需要用到直接调用静态方法，需要启用struts2的一个配置常量：<constant name="struts.ognl.allowStaticMethodAccess" value="true"/> -->
	<tr>
		<td>直接调用静态方法：</td>
		<td><s:property value="@struts2.tags.Ognl@staticMethod()"/></td>
	</tr>
	<tr>
		<td>直接调用静态属性：</td>
		<td><s:property value="@struts2.tags.Ognl@STATIC"/></td>
	</tr>
	<tr>
		<td>调用值栈对象中的普通方法：</td>
		<td><s:property value="tagBean.normalMethod()"/></td>
	</tr>
	<tr>
		<td>调用JDK的静态方法(带参)：</td>
		<td><s:property value="@java.lang.Math@floor(11.11)"/></td>
		<td>吓死你：</td>
		<!-- 如果第一个@后不带任何类，就默认表示java.lang.Math这个工具类，其它类不能这样写 -->
		<td><s:property value="@@floor(22.22)"/></td>
	</tr>
	<tr>
		<td>new一个对象:</td>
		<td><s:property value="new struts2.tags.Ognl('构造参数').result"></s:property></td>
	</tr>
	<tr>
		<td>#获取request数据：</td>
		<td><s:property value="#request.lstCity"></s:property></td>
	</tr>
	<tr>
		<td>#获取session数据：</td>
		<td><s:property value="#session.sess"></s:property></td>
	</tr>
	<tr>
		<td>下标-获取List集合第一条数据：</td>
		<td><s:property value="#request.lstCity[0]"></s:property></td>
		<!-- 注：Set集合是无序的所以不能通过下标获取数据；Map集合是键值对的，获取的时候应该根据key找value：map['key'] -->
	</tr>
	<tr>
		<td>获取List数据总条数：</td>
		<td><s:property value="#request.lstCity.size"></s:property></td>
	</tr>
	<tr>
		<td>投影技术获取List中指定对象数组：</td>
		<td><s:property value="#request.lstCity.{cityValue}"></s:property></td>
	</tr>
	<tr>
		<td>投影技术+下标获取一个值：</td>
		<td><s:property value="#request.lstCity.{cityValue}[0]"></s:property></td>
	</tr>
	<tr>
		<td>选择器：</td>
		<td><s:property value="#request.lstCity.{#this.cityId<=2}"></s:property></td>
	</tr>
	<tr>
		<td>选择器(?)+投影</td>
		<!-- ?表示获得所有满足条件的对象 -->
		<td><s:property value="#request.lstCity.{?#this.cityId<=2}.{cityId}"></s:property></td>
	</tr>
	<tr>
		<td>选择器(^)+投影</td>
		<!-- ^表示取得第一个满足条件的元素 -->
		<td><s:property value="#request.lstCity.{^#this.cityId<=2}.{cityId}"></s:property></td>
	</tr>
	<tr>
		<td>选择器($)+投影</td>
		<!-- $表示取得最后一个满足条件的元素 -->
		<td><s:property value="#request.lstCity.{$#this.cityId<=2}.{cityId}"></s:property></td>
	</tr>
	<tr>
		<td>Top语法：</td>
		<!-- .top取栈中的对象 ,[n]表示获取栈中第几个对象(从0开始)-->
		<td><s:property value="[0].top.locale"></s:property></td>
	</tr>
	<tr>
		<td>[n]语法：</td>
		<!-- [n]表示获取栈中第几个对象(从0开始)-->
		<td><s:property value="[0].locale"></s:property></td>
	</tr>
</table>
<hr/>
<h3>逻辑，迭代标签</h3>
<!-- test代码块中支持其它数据类型，如果是int的可以这样：test="#request.if==1" -->
--if标签--
<s:if test="#request.if=='if'">
	这里是if模块
</s:if><s:elseif test="#request.if=='elseif'">
	这里是elseif模块
</s:elseif><s:else>
	这里是else模块
</s:else>
<br/><br/>
--循环标签①--
<!-- first表示起始值，last表示结束值 iterator表示内部循环代码-->
<s:bean name="org.apache.struts2.util.Counter" id="counter">
   <s:param name="first" value="3" />
   <s:param name="last" value="10" />
   <s:iterator>
     <s:property/>&nbsp;
   </s:iterator>
</s:bean>
<br/><br/>
--循环标签②--
<s:iterator	begin="1" end="10">
	<s:property/>
</s:iterator>

<br/><br/>
--迭代list--
<!--  等同于for(int i=1;i<=lstCity.size;i++) 标签同样从0开始计数 -->
<s:iterator value="#request.lstCity" status="st" var="value" begin="1" end="#request.lstCity.length">
	[<s:property value="%{#attr.st.index+1}"/>]
	<s:property value="%{#attr.value.cityValue}"/>
	<!-- 或者使用EL表达式取值:${value.cityId}  -->
</s:iterator>
</s:form>
<s:debug></s:debug>
</body>

<tr>
		<td>生日：</td>
		<td>
		<!-- 在文本框中格式化时间 -->
		<s:textfield name="tagBean.birthday">
			<s:param name="value">
				<s:date name="tagBean.birthday" format="yyyy-MM-dd hh:MM:ss" />
			</s:param>
		</s:textfield>
		</td>
		<td>生日：</td>
		<!-- 时间标签，可以格式化滴 -->
		<td><s:date name="tagBean.birthday" format="yyyy年MM月dd日"></s:date></td>
	</tr>

 

• 拦截器

struts2的核心内容是拦截器，拦截器的作用简单理解就是：在JSP向后台发送请求，访问某个方法之前或之后会运行拦截器处理一些特殊操作，比如异常拦截器，当运行后台某方法发生异常时会被拦截器截获并进行一些特殊处理：

<struts>
	<package name="bless-default" extends="struts-default" >
		<interceptors>
			<!--定义一个名为privilege的拦截器-->  
			 <interceptor  
				class="....ExceptionHandler"  
				name="exceptionInterceptor"/>  
			
			<!--①定义一个包含异常处理的拦截器栈-->  
			<interceptor-stack name="exceptionStack">
				<!-- 默认的拦截器 -->
				<interceptor-ref name="defaultStack"/>
				<!-- 异常拦截器 -->
				<interceptor-ref name="exceptionInterceptor"/>		
			</interceptor-stack>
			
			<!-- ③需要用到chain跳转的拦截器栈 -->
			<interceptor-stack name="chainStack">
				<interceptor-ref name="chain"/>
				<interceptor-ref name="basicStack"/>
				<interceptor-ref name="exceptionInterceptor"/>
			</interceptor-stack>
		</interceptors>
		
		<!-- 默认运行的拦截器栈 -->
		<default-interceptor-ref name="exceptionStack" /> 
		
		<global-results>
			<result name="error" >/Web/common/page/error.jsp</result>
		</global-results>
		
		<global-exception-mappings>
			<exception-mapping result="error" exception="java.lang.Exception"></exception-mapping>
		</global-exception-mappings>
		
	</package>
</struts>

自定义一个拦截器非常简单：首先继承AbstractInterceptor类，实现intercept(ActionInvocation actioninvocation)方法即可：

public class ExceptionHandler extends AbstractInterceptor {
	private static final long serialVersionUID = 1L;

	public String intercept(ActionInvocation actioninvocation) {

		String result = null; // Action的返回值
		try {
			// 运行被拦截的Action,期间如果发生异常会被catch住
			result = actioninvocation.invoke();
			return result;
		} catch (Exception e) {
			/**
			 * 处理异常
			 */
			String errorCode = null; // ospms的异常
			int errorId = -1; // 达运的异常

			if (e instanceof FunctionException) {
				// OSPMS异常
				FunctionException fe = (FunctionException) e;
				errorCode = fe.getErrorCode();
				fe.printStackTrace();
			}...........
			/**
			 * 发送错误消息到页面
			 */
			...........
		
			/**
			 * log4j记录日志
			 */
			...........

			return "error";
		}// ...end of catch
	}
} 

   需要注意的是：异常拦截器XML配置文件一定要在struts.xml中include进来，很多朋友说拦截器不起作用，多半是因为这个问题。

• 总结

Struts2是一个非常优秀的MVC框架，在开发中或多或少会遇到这样那样的问题，只有多总结多尝试才能找到问题的根源。

评论

4 楼 yy15814007420 2012-10-10  

很不错，解决了我遇到的一个棘手的问题，谢谢啦

3 楼 白糖_ 2011-10-03  

hwh0919 写道

hi,后台你怎么验证呢！若用 actionName-validate.xml这个做法，action里都得列字段啊！有没有没后台可能对  对象的每个属性都验证的方法呢

你提出的疑问“action里都得列字段”我不明白什么意思，但是我可以确认的是stuts2验证框架可以验证每个对象的每个属性。

我写了篇struts2验证框架的文章，你可以参考一下：http://blessht.iteye.com/blog/979645

2 楼 hwh0919 2011-09-30  

hi,后台你怎么验证呢！若用 actionName-validate.xml这个做法，action里都得列字段啊！有没有没后台可能对  对象的每个属性都验证的方法呢

1 楼 hwh0919 2011-09-18  

仁兄，总结得不错。拦截器那个写得不错，思路清析，结构良好！