详解在Java的Struts2框架中配置Action的方法
作者：Ai2015WER
在Struts2中Action部分，也就是Controller层采用了低侵入的方式。为什么这么说？这是因为在Struts2中action类并不需要继承任何的基类，或实现任何的接口，更没有与Servlet的API直接耦合。它通常更像一个普通的POJO（通常应该包含一个无参数的execute方法）,而且可以在内容定义一系列的方法(无参方法)，并可以通过配置的方式，把每一个方法都当作一个独立的action来使用，从而实现代码复用。
例如:
package example;
public class UserAction {
private String username;
private String password;
public String execute() throws Exception {
//…………..
return “success”;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
action访问servlet
在这个Action类里的属性，既可以封装参数，又可以封装处理结果。系统并不会严格区分它们。
但是为了使用户开发的Action类更规范，Struts2为我们提供了一个接口Action,该类定义如下：
publicinterface Action {
publicstaticfinal String ERROR="error";
publicstaticfinal String INPUT="input";
publicstaticfinal String NONE="none";
publicstaticfinal String LOGIN="login";
publicstaticfinal String SUCCESS="success";
public String execute()throws Exception;
}
但是我们写Action通常不会实现该接口，而是继承该接口的实现类ActionSupport.
该类代码如下:
public class ActionSupport implements Action, Validateable, ValidationAware, TextProvider, LocaleProvider, Serializable {
................
public void setActionErrors(Collection errorMessages) {
validationAware.setActionErrors(errorMessages);
}
public Collection getActionErrors() {
return validationAware.getActionErrors();
}
public void setActionMessages(Collection messages) {
validationAware.setActionMessages(messages);
}
public Collection getActionMessages() {
return validationAware.getActionMessages();
}
public Collection getErrorMessages() {
return getActionErrors();
}
public Map getErrors() {
return getFieldErrors();
}
//设置表单域校验错误
public void setFieldErrors(Map errorMap) {
validationAware.setFieldErrors(errorMap);
}
public Map getFieldErrors() {
return validationAware.getFieldErrors();
}
public Locale getLocale() {
ActionContext ctx = ActionContext.getContext();
if (ctx != null) {
return ctx.getLocale();
} else {
LOG.debug("Action context not initialized");
return null;
}
}
//获取国际化信息的方法
public String getText(String aTextName) {
return textProvider.getText(aTextName);
}
public String getText(String aTextName, String defaultValue) {
return textProvider.getText(aTextName, defaultValue);
}
public String getText(String aTextName, String defaultValue, String obj) {
return textProvider.getText(aTextName, defaultValue, obj);
}
.........
//用于访问国际化资源包的方法
public ResourceBundle getTexts() {
return textProvider.getTexts();
}
public ResourceBundle getTexts(String aBundleName) {
return textProvider.getTexts(aBundleName);
}
//添加action的错误信息
public void addActionError(String anErrorMessage) {
validationAware.addActionError(anErrorMessage);
}
//添加action的普通信息
public void addActionMessage(String aMessage) {
validationAware.addActionMessage(aMessage);
}
public void addFieldError(String fieldName, String errorMessage) {
validationAware.addFieldError(fieldName, errorMessage);
}
public void validate() {
}
public Object clone() throws CloneNotSupportedException {
return super.clone();
}
..........
}
前面说到struts2并没有直接与Servlet的API耦合，那么它是怎么访问Servlet的API的呢？
原来struts2中提供了一个ActionContext类，该类模拟了Servlet的API。其主要方法如下:
1)Object get (Object key)：该方法模拟了HttpServletRequest.getAttribute(String name)方法。
2)Map getApplication()返回一个Map对象，该对象模拟了ServletContext实例.
3)static ActionContext getContext():获取系统的ActionContext实例。
4)Map getSession():返回一个Map对象，该对象模拟了HttpSession实例.
5)Map getParameters():获取所有的请求参数，模拟了HttpServletRequest.getParameterMap()
你也许会奇怪为什么这些方法老是返回一个Map?这主要是为了便于测试。至于它是怎么把Map对象与实际的Servlet API的实例进行转换的，这个我们根本就不要担心，因为struts2已经内置了一些拦截器来帮我们完成这一转换。
为了直接使用Servlet的API，Struts2为我们提供了以下几个接口。
1）ServletContextAware:实现该接口的Action可以直接访问ServletContext实例。
2）ServletRequestAware:实现该接口的Action可以直接访问HttpServletRequest实例。
3）ServletResponseAware：实现该接口的Action可以直接访问HttpServletResponse实例。
以上主要讲了action访问servlet,下面让我们来看一下Struts2的Action是如何实现代码复用的。就拿UserAction来说，我如果让这个action既处理用户注册（regist）又处理登录（longin）该如何改写这个action呢？改写后的UserAction如下:
package example;
public class UserAction extends ActionSupport {
private String username;
private String password;
public String regist() throws Exception {
//…………..
return SUCCESS;
}
public String login() throws Exception {
//…………..
return SUCCESS;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
struts.xml中的action配置
是不是这么写就ok了，当然不行我们还必须在struts.xml文件中配置一下。配置方法有两种:
1) 使用普通的方式为Action元素指定method属性.
<action name=”loginAction” class=”example.UserAction” method=”login”>
<result name=”success”>/success.jsp</result>
</action>
<action name=”registAction” class=”example.UserAction” method=”regist”>
<result name=”success”>/success.jsp</result>
</action>
2) 采用通配符的方式为Action元素指定method属性。
<action name=”*Action” class=”example.UserAction” method=”{1}”>
<result name=”success”>/success.jsp</result>
</action>
使用通配符的方式过于灵活，下面是一个较复杂的配置情况。
<action name=”*_*” class=”example.{1}Action” method=”{2}”>
……….
</action>
其中占位符{1}与_的前一个*匹配，{2}与后一个*匹配。
基于注解方式Action配置:
下面要说的Action的配置不是在src/struts.xml中，而是用注解方式来进行配置的
前提是除了基本的那六个jar包之外，还需要一个struts-2.1.8.1\lib\struts2-convention-plugin-2.1.8.1.jar
不过struts.xml还是要有的
具体示例
Login.jsp
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Struts2登录验证</title>
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="This is my page">
<!--
<link rel="stylesheet" type="text/css" href="styles.css">
-->
</head>
<body>
<h3>Struts2登录</h3><hr/>
<form action="${pageContext.request.contextPath}/user/login.qqi" method="post">
<table border="1" width="500px">
<tr>
<td>用户名</td>
<td><input type="text" name="loginname"/></td>
</tr>
<tr>
<td>密码</td>
<td><input type="password" name="pwd"/></td>
</tr>
<tr>
<td colspan="2"><input type="submit" value="登录"/></td>
</tr>
</table>
</form>
</body>
</html>
src/struts.xml
<span style="font-size: large;"><?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" "http://struts.apache.org/dtds/struts-2.1.7.dtd"> <struts> <!-- 请求参数的编码方式 --> <constant name="struts.i18n.encoding" value="UTF-8"/> <!-- 指定被struts2处理的请求后缀类型。多个用逗号隔开 --> <constant name="struts.action.extension" value="action,do,go,qqi"/> <!-- 当struts.xml改动后，是否重新加载。默认值为false(生产环境下使用),开发阶段最好打开 --> <constant name="struts.configuration.xml.reload" value="true"/> <!-- 是否使用struts的开发模式。开发模式会有更多的调试信息。默认值为false(生产环境下使用),开发阶段最好打开 --> <constant name="struts.devMode" value="false"/> <!-- 设置浏览器是否缓存静态内容。默认值为true(生产环境下使用),开发阶段最好关闭 --> <constant name="struts.serve.static.browserCache" value="false" /> <!-- 指定由spring负责action对象的创建 <constant name="struts.objectFactory" value="spring" /> --> <!-- 是否开启动态方法调用 --> <constant name="struts.enable.DynamicMethodInvocation" value="false"/> </struts></span>
LoginAction.java
package com.javacrazyer.web.action;
import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.ExceptionMapping;
import org.apache.struts2.convention.annotation.ExceptionMappings;
import org.apache.struts2.convention.annotation.Namespace;
import org.apache.struts2.convention.annotation.ParentPackage;
import org.apache.struts2.convention.annotation.Result;
import org.apache.struts2.convention.annotation.Results;
import com.opensymphony.xwork2.ActionSupport;
/**
* 使用注解来配置Action
*
*/
@ParentPackage("struts-default")
// 父包
@Namespace("/user")
@Results( { @Result(name = "success", location = "/msg.jsp"),
@Result(name = "error", location = "/error.jsp") })
@ExceptionMappings( { @ExceptionMapping(exception = "java.lange.RuntimeException", result = "error") })
public class LoginAction extends ActionSupport {
private static final long serialVersionUID = -2554018432709689579L;
private String loginname;
private String pwd;
@Action(value = "login")
public String login() throws Exception {
if ("qq".equals(loginname) && "123".equals(pwd)) {
return SUCCESS;
} else {
return ERROR;
}
}
@Action(value = "add", results = { @Result(name = "success", location = "/index.jsp") })
public String add() throws Exception {
return SUCCESS;
}
public String getLoginname() {
return loginname;
}
public void setLoginname(String loginname) {
this.loginname = loginname;
}
public String getPwd() {
return pwd;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
}
success.jsp和error.jsp我就不贴出来了
注解配置的解释
1) @ParentPackage 指定父包
2) @Namespace 指定命名空间
3) @Results 一组结果的数组
4) @Result(name="success",location="/msg.jsp") 一个结果的映射
5) @Action(value="login") 指定某个请求处理方法的请求URL。注意，它不能添加在Action类上，要添加到方法上。
6) @ExceptionMappings 一级声明异常的数组
7) @ExceptionMapping 映射一个声明异常
由于这种方式不是很常用，所以大家只做了解即可