详解在Java的Struts2框架中配置Action的方法
在Struts2中Action部分,也就是Controller层采用了低侵入的方式。为什么这么说?这是因为在Struts2中action类并不需要继承任何的基类,或实现任何的接口,更没有与Servlet的API直接耦合。它通常更像一个普通的POJO(通常应该包含一个无参数的execute方法),而且可以在内容定义一系列的方法(无参方法),并可以通过配置的方式,把每一个方法都当作一个独立的action来使用,从而实现代码复用。
例如:
packageexample;
publicclassUserAction{
privateStringusername;
privateStringpassword;
publicStringexecute()throwsException{
//…………..
return“success”;
}
publicStringgetUsername(){
returnusername;
}
publicvoidsetUsername(Stringusername){
this.username=username;
}
publicStringgetPassword(){
returnpassword;
}
publicvoidsetPassword(Stringpassword){
this.password=password;
}
}
action访问servlet
在这个Action类里的属性,既可以封装参数,又可以封装处理结果。系统并不会严格区分它们。
但是为了使用户开发的Action类更规范,Struts2为我们提供了一个接口Action,该类定义如下:
publicinterfaceAction{
publicstaticfinalStringERROR="error";
publicstaticfinalStringINPUT="input";
publicstaticfinalStringNONE="none";
publicstaticfinalStringLOGIN="login";
publicstaticfinalStringSUCCESS="success";
publicStringexecute()throwsException;
}
但是我们写Action通常不会实现该接口,而是继承该接口的实现类ActionSupport.
该类代码如下:
publicclassActionSupportimplementsAction,Validateable,ValidationAware,TextProvider,LocaleProvider,Serializable{
................
publicvoidsetActionErrors(CollectionerrorMessages){
validationAware.setActionErrors(errorMessages);
}
publicCollectiongetActionErrors(){
returnvalidationAware.getActionErrors();
}
publicvoidsetActionMessages(Collectionmessages){
validationAware.setActionMessages(messages);
}
publicCollectiongetActionMessages(){
returnvalidationAware.getActionMessages();
}
publicCollectiongetErrorMessages(){
returngetActionErrors();
}
publicMapgetErrors(){
returngetFieldErrors();
}
//设置表单域校验错误
publicvoidsetFieldErrors(MaperrorMap){
validationAware.setFieldErrors(errorMap);
}
publicMapgetFieldErrors(){
returnvalidationAware.getFieldErrors();
}
publicLocalegetLocale(){
ActionContextctx=ActionContext.getContext();
if(ctx!=null){
returnctx.getLocale();
}else{
LOG.debug("Actioncontextnotinitialized");
returnnull;
}
}
//获取国际化信息的方法
publicStringgetText(StringaTextName){
returntextProvider.getText(aTextName);
}
publicStringgetText(StringaTextName,StringdefaultValue){
returntextProvider.getText(aTextName,defaultValue);
}
publicStringgetText(StringaTextName,StringdefaultValue,Stringobj){
returntextProvider.getText(aTextName,defaultValue,obj);
}
.........
//用于访问国际化资源包的方法
publicResourceBundlegetTexts(){
returntextProvider.getTexts();
}
publicResourceBundlegetTexts(StringaBundleName){
returntextProvider.getTexts(aBundleName);
}
//添加action的错误信息
publicvoidaddActionError(StringanErrorMessage){
validationAware.addActionError(anErrorMessage);
}
//添加action的普通信息
publicvoidaddActionMessage(StringaMessage){
validationAware.addActionMessage(aMessage);
}
publicvoidaddFieldError(StringfieldName,StringerrorMessage){
validationAware.addFieldError(fieldName,errorMessage);
}
publicvoidvalidate(){
}
publicObjectclone()throwsCloneNotSupportedException{
returnsuper.clone();
}
..........
}
前面说到struts2并没有直接与Servlet的API耦合,那么它是怎么访问Servlet的API的呢?
原来struts2中提供了一个ActionContext类,该类模拟了Servlet的API。其主要方法如下:
1)Objectget(Objectkey):该方法模拟了HttpServletRequest.getAttribute(Stringname)方法。
2)MapgetApplication()返回一个Map对象,该对象模拟了ServletContext实例.
3)staticActionContextgetContext():获取系统的ActionContext实例。
4)MapgetSession():返回一个Map对象,该对象模拟了HttpSession实例.
5)MapgetParameters():获取所有的请求参数,模拟了HttpServletRequest.getParameterMap()
你也许会奇怪为什么这些方法老是返回一个Map?这主要是为了便于测试。至于它是怎么把Map对象与实际的ServletAPI的实例进行转换的,这个我们根本就不要担心,因为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如下:
packageexample;
publicclassUserActionextendsActionSupport{
privateStringusername;
privateStringpassword;
publicStringregist()throwsException{
//…………..
returnSUCCESS;
}
publicStringlogin()throwsException{
//…………..
returnSUCCESS;
}
publicStringgetUsername(){
returnusername;
}
publicvoidsetUsername(Stringusername){
this.username=username;
}
publicStringgetPassword(){
returnpassword;
}
publicvoidsetPassword(Stringpassword){
this.password=password;
}
}
struts.xml中的action配置
是不是这么写就ok了,当然不行我们还必须在struts.xml文件中配置一下。配置方法有两种:
1) 使用普通的方式为Action元素指定method属性.
<actionname=”loginAction”class=”example.UserAction”method=”login”> <resultname=”success”>/success.jsp</result> </action> <actionname=”registAction”class=”example.UserAction”method=”regist”> <resultname=”success”>/success.jsp</result> </action>
2) 采用通配符的方式为Action元素指定method属性。
<actionname=”*Action”class=”example.UserAction”method=”{1}”>
<resultname=”success”>/success.jsp</result>
</action>
使用通配符的方式过于灵活,下面是一个较复杂的配置情况。
<actionname=”*_*”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
<%@pagelanguage="java"import="java.util.*"pageEncoding="utf-8"%>
<!DOCTYPEHTMLPUBLIC"-//W3C//DTDHTML4.01Transitional//EN">
<html>
<head>
<title>Struts2登录验证</title>
<metahttp-equiv="keywords"content="keyword1,keyword2,keyword3">
<metahttp-equiv="description"content="Thisismypage">
<!--
<linkrel="stylesheet"type="text/css"href="styles.css">
-->
</head>
<body>
<h3>Struts2登录</h3><hr/>
<formaction="${pageContext.request.contextPath}/user/login.qqi"method="post">
<tableborder="1"width="500px">
<tr>
<td>用户名</td>
<td><inputtype="text"name="loginname"/></td>
</tr>
<tr>
<td>密码</td>
<td><inputtype="password"name="pwd"/></td>
</tr>
<tr>
<tdcolspan="2"><inputtype="submit"value="登录"/></td>
</tr>
</table>
</form>
</body>
</html>
src/struts.xml
<spanstyle="font-size:large;"><?xmlversion="1.0"encoding="UTF-8"?> <!DOCTYPEstrutsPUBLIC "-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.1.7//EN" "http://struts.apache.org/dtds/struts-2.1.7.dtd"> <struts> <!--请求参数的编码方式--> <constantname="struts.i18n.encoding"value="UTF-8"/> <!--指定被struts2处理的请求后缀类型。多个用逗号隔开--> <constantname="struts.action.extension"value="action,do,go,qqi"/> <!--当struts.xml改动后,是否重新加载。默认值为false(生产环境下使用),开发阶段最好打开--> <constantname="struts.configuration.xml.reload"value="true"/> <!--是否使用struts的开发模式。开发模式会有更多的调试信息。默认值为false(生产环境下使用),开发阶段最好打开--> <constantname="struts.devMode"value="false"/> <!--设置浏览器是否缓存静态内容。默认值为true(生产环境下使用),开发阶段最好关闭--> <constantname="struts.serve.static.browserCache"value="false"/> <!--指定由spring负责action对象的创建 <constantname="struts.objectFactory"value="spring"/> --> <!--是否开启动态方法调用--> <constantname="struts.enable.DynamicMethodInvocation"value="false"/> </struts></span>
LoginAction.java
packagecom.javacrazyer.web.action;
importorg.apache.struts2.convention.annotation.Action;
importorg.apache.struts2.convention.annotation.ExceptionMapping;
importorg.apache.struts2.convention.annotation.ExceptionMappings;
importorg.apache.struts2.convention.annotation.Namespace;
importorg.apache.struts2.convention.annotation.ParentPackage;
importorg.apache.struts2.convention.annotation.Result;
importorg.apache.struts2.convention.annotation.Results;
importcom.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")})
publicclassLoginActionextendsActionSupport{
privatestaticfinallongserialVersionUID=-2554018432709689579L;
privateStringloginname;
privateStringpwd;
@Action(value="login")
publicStringlogin()throwsException{
if("qq".equals(loginname)&&"123".equals(pwd)){
returnSUCCESS;
}else{
returnERROR;
}
}
@Action(value="add",results={@Result(name="success",location="/index.jsp")})
publicStringadd()throwsException{
returnSUCCESS;
}
publicStringgetLoginname(){
returnloginname;
}
publicvoidsetLoginname(Stringloginname){
this.loginname=loginname;
}
publicStringgetPwd(){
returnpwd;
}
publicvoidsetPwd(Stringpwd){
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映射一个声明异常
由于这种方式不是很常用,所以大家只做了解即可