Struts2中struts.xml的配置详解
http://liguocai.zhmy.com/archives/2008/149931.html
Struts2中struts.xml的Action配置详解
使用package可以将逻辑上相关的一组Action,Result,Interceptor等组件分为一组,Package有些像对象,可以继承其他的Package,也可以被其他package继承,甚至可以定义抽象的Package。
Package的可以使用的属性:
属性
是否必须
说明
name 是 Package的表示,为了让其他的package引用
extends 否 从哪个package继承行为
namespace 否 参考Namespace配置说明
abstract 否
定义这个package为抽象的,这个package中不需要定义action
由于struts.xml文件是自上而下解析的,所以被继承的package要放在继承package的前边。Namespace将action分成逻辑上的不同模块,每一个模块有自己独立的前缀。使用namespace可以有效的避免action重名的冲突,例如每一个package都可以有自己独立的Menu和Help action,但是事项方式各有不同。Struts2标签带有namespace选项,可以根据namespace的不同向服务器提交不同的package的action的请求。
“/”表示根namespace,所有直接在应用程序上下文环境下的请求(Context)都在这个package中查找。
“”表示默认namespace,当所有的namespace中都找不到的时候就在这个namespace中寻找。
例如,有如下配置:
CODE:
<package name="default">
<action name="foo" class="mypackage.simpleAction>
<result name="success" type="dispatcher">
greeting.jsp
</result>
</action>
<action name="bar" class="mypackage.simpleAction">
<result name="success" type="dispatcher">bar1.jsp</result>
</action>
</package>
<package name="mypackage1" namespace="/">
<action name="moo" class="mypackage.simpleAction">
<result name="success" type="dispatcher">moo.jsp</result>
</action>
</package>
<package name="mypackage2" namespace="/barspace">
<action name="bar" class="mypackage.simpleAction">
<result name="success" type="dispatcher">bar2.jsp</result>
</action>
</package>1 如果请求为/barspace/bar.action
查找namespace:/barspace,如果找到bar则执行对应的action,否则将会查找默认的namespace,在上面的例子中,在barspace中存在名字为bar的action,所以这个action将会被执行,如果返回结果为success,则画面将定为到bar2.jsp
2 如果请求为/moo.action
根namespace('/')被查找,如果moo action存在则执行,否则查询默认的namespace,上面的例子中,根namespace中存在moo action,所以该action被调用,返回success的情况下画面将定位到moo.jsp、
Action配置
在struts2框架中每一个Action是一个工作单元。Action负责将一个请求对应到一个Action处理上去,每当一个Action类匹配一个请求的时候,这个Action类就会被Struts2框架调用。
一个Action配置示例:
CODE:
<action name="Logon" class="tutorial.Logon">
<result type="redirect-action">Menu</result>
<result name="input">/tutorial/Logon.jsp</result>
</action>每一个Action可以配置多个result,多个ExceptionHandler,多个Intercepter,但是只能有一个name,这个name和package的namespace来唯一区别一个Action。
每当struts2框架接受到一个请求的时候,它会去掉Host,Application和后缀等信息,得到Action的名字,例如如下的请求将得到Welcome这个Action。 http://www.planetstruts.org/struts2-mailreader/Welcome.action
在一个Struts2应用程序中,一个指向Action的链接通常有Struts Tag产生,这个Tag只需要指定Action的名字,Struts框架会自动添加诸如后缀等的扩展,例如:
CODE:
<s:form action="Hello">
<s:textfield label="Please enter your name" name="name"/>
<s:submit/>
</s:form将产生一个如下的链接的请求:
http://Hostname:post/appname/Hello.action
在定义Action的名字的时候不要使用.和/,最好使用英文字母和下划线。
Action中的方法
Action的默认入口方法由xwork2的Action接口来定义,代码清单为:
CODE:
public interface Action {
public String execute() throws Exception;
}有些时候我们想指定一个Action的多个方法,我们可以做如下两步:
1 建立一些execute签名相同的方法,例如:
Public String forward() throws Exception
2 在Action配置的时候使用method属性,例如:
<action name="delete" class="example.CrudAction" method="delete">
Action中的方法通配符
有些时候对Action中方法的调用满足一定的规律,例如edit Action对应edit方法,delete Action对应 delete方法,这个时候我们可以使用方法通配符,例如:
<action name="*Crud" class="example.Crud" method="{1}"> 这时,editCrud Action的引用将调用edit方法,同理,deleteCrud Action的引用将调用delete 方法。
另外一种比较常用的方式是使用下划线分割,例如:
<action name="Crud_*" class="example.Crud" method="{1}">
这样当遇到如下调用的时候可以找到对应的方法。
"action=Crud_input" => input方法
"action=Crud_delete" => delete方法
通配符和普通的配置具有相同的地位,可以结合使用框架的所有其他功能。
默认的Action
当我们没有指定Action的class属性的时候,例如:
<action name="Hello">
我们默认使用com.opensymphony.xwork.ActionSupport
ActionSupport有两个方法input和execute,每个方法都是简单的返回SUCCESS。
通常情况下,请求的Action不存在的情况下,Struts2框架会返回一个Error画面:“404 - Page not found”,有些时候或许我们不想出现一个控制之外的错误画面,我们可以指定一个默认的Action,在请求的Action不存在的情况下,调用默认的Action,通过如下配置可以达到要求:
CODE:
<package name="Hello" extends="action-default">
<default-action-ref name="UnderConstruction">
<action name="UnderConstruction">
<result>/UnderConstruction.jsp</result>
</action>默认通配符
CODE:
<action name="*" >
<result>/{1}.jsp</result>
</action>每个Action将会被映射到以自己名字命名的JSP上。
struts2中动态方法的调用
可以采用DMI(Dynamic Method Invocation,动态方法)调用来处理这种请求,动态方法调用是指表单元素的action并不是直接等于某个Action的名字,而是以如下形式来指定Form的action属性:
<!-- action属性为actionName!methodName的形式 -->
action="ActionName!methodName.action"
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd" >
<struts>
<!--include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->
<include file="struts-default.xml"></include>
<!--package提供了将多个Action组织为一个模块的方式
package的名字必须是唯一的 package可以扩展 当一个package扩展自
另一个package时该package会在本身配置的基础上加入扩展的package
的配置 父package必须在子package前配置
name:package名称
extends:继承的父package名称
abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false
namespace:定义package命名空间 该命名空间影响到url的地址,例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action
-->
<package name="com.kay.struts2"extends="struts-default"namespace="/test">
<interceptors>
<!--定义拦截器
name:拦截器名称
class:拦截器类路径
-->
<interceptor name="timer"class="com.kay.timer"></interceptor>
<interceptor name="logger"class="com.kay.logger"></interceptor>
<!--定义拦截器栈 -->
<interceptor-stack name="mystack">
<interceptor-ref name="timer"></interceptor-ref>
<interceptor-ref name="logger"></interceptor-ref>
</interceptor-stack>
</interceptors>
<!--定义默认的拦截器 每个Action都会自动引用
如果Action中引用了其它的拦截器 默认的拦截器将无效 -->
<default-interceptor-ref name="mystack"></default-interceptor-ref>
<!--全局results配置 -->
<global-results>
<result name="input">/error.jsp</result>
</global-results>
<!--Action配置 一个Action可以被多次映射(只要action配置中的name不同)
name:action名称
class: 对应的类的路径
method: 调用Action中的方法名
-->
<action name="hello"class="com.kay.struts2.Action.LoginAction">
<!--引用拦截器
name:拦截器名称或拦截器栈名称
-->
<interceptor-ref name="timer"></interceptor-ref>
<!--节点配置
name : result名称 和Action中返回的值相同
type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher
-->
<result name="success"type="dispatcher">/talk.jsp</result>
<!--参数设置
name:对应Action中的get/set方法
-->
<param name="url">http://www.sina.com</param>
</action>
</package>
</struts>
<package name="struts2" extends="struts-default" namespace="/sys">
<!-- 添加NameSpace的时候一定要添加根"/"-->
<action name="login" class="com.bian.LoginAction" method="add">
<!-- method 表示执行action中的哪个方法 -->
<result name="action" type="redirect">${action}</result>
<!-- ${action} 变量表示 执行action中存储的变量 type="redirect" 应用了页面或action type="redirect-action" 应用与action-->
</action>
<action name="*" class="com.bian.LoginAction" method="{1}">
<!-- 通配符表示法 -->
<result name="action" type="redirect">${action}</result>
</action>
</package>
package com.bian;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import com.opensymphony.xwork2.ActionSupport;
public class LoginAction extends ActionSupport {
private String action;
public String getAction() {
return action;
}
public void setAction(String action) {
this.action = action;
}
private static final Log log = LogFactory.getLog(LoginAction.class);
public String execute(){
log.error("++++++++++++++++++");
this.action = "user/add.jsp";
return "action";
}
public String add(){
System.out.println("add ++++++++++++++++++++++++++++++++ ");
this.action = "user/add.jsp";
return "action";
}
public String edit(){
System.out.println("edit +++++++++++++++");
this.action = "/list.action";
return "action";
}
public String delete(){
System.out.println("delete +++++++++++++++");
this.action = "/list.action";
return "action";
}
}
http://liguocai.zhmy.com/archives/2008/149931.html
Struts2中struts.xml的Action配置详解
使用package可以将逻辑上相关的一组Action,Result,Interceptor等组件分为一组,Package有些像对象,可以继承其他的Package,也可以被其他package继承,甚至可以定义抽象的Package。
Package的可以使用的属性:
属性
是否必须
说明
name 是 Package的表示,为了让其他的package引用
extends 否 从哪个package继承行为
namespace 否 参考Namespace配置说明
abstract 否
定义这个package为抽象的,这个package中不需要定义action
由于struts.xml文件是自上而下解析的,所以被继承的package要放在继承package的前边。Namespace将action分成逻辑上的不同模块,每一个模块有自己独立的前缀。使用namespace可以有效的避免action重名的冲突,例如每一个package都可以有自己独立的Menu和Help action,但是事项方式各有不同。Struts2标签带有namespace选项,可以根据namespace的不同向服务器提交不同的package的action的请求。
“/”表示根namespace,所有直接在应用程序上下文环境下的请求(Context)都在这个package中查找。
“”表示默认namespace,当所有的namespace中都找不到的时候就在这个namespace中寻找。
例如,有如下配置:
CODE:
<package name="default">
<action name="foo" class="mypackage.simpleAction>
<result name="success" type="dispatcher">
greeting.jsp
</result>
</action>
<action name="bar" class="mypackage.simpleAction">
<result name="success" type="dispatcher">bar1.jsp</result>
</action>
</package>
<package name="mypackage1" namespace="/">
<action name="moo" class="mypackage.simpleAction">
<result name="success" type="dispatcher">moo.jsp</result>
</action>
</package>
<package name="mypackage2" namespace="/barspace">
<action name="bar" class="mypackage.simpleAction">
<result name="success" type="dispatcher">bar2.jsp</result>
</action>
</package>1 如果请求为/barspace/bar.action
查找namespace:/barspace,如果找到bar则执行对应的action,否则将会查找默认的namespace,在上面的例子中,在barspace中存在名字为bar的action,所以这个action将会被执行,如果返回结果为success,则画面将定为到bar2.jsp
2 如果请求为/moo.action
根namespace('/')被查找,如果moo action存在则执行,否则查询默认的namespace,上面的例子中,根namespace中存在moo action,所以该action被调用,返回success的情况下画面将定位到moo.jsp、
Action配置
在struts2框架中每一个Action是一个工作单元。Action负责将一个请求对应到一个Action处理上去,每当一个Action类匹配一个请求的时候,这个Action类就会被Struts2框架调用。
一个Action配置示例:
CODE:
<action name="Logon" class="tutorial.Logon">
<result type="redirect-action">Menu</result>
<result name="input">/tutorial/Logon.jsp</result>
</action>每一个Action可以配置多个result,多个ExceptionHandler,多个Intercepter,但是只能有一个name,这个name和package的namespace来唯一区别一个Action。
每当struts2框架接受到一个请求的时候,它会去掉Host,Application和后缀等信息,得到Action的名字,例如如下的请求将得到Welcome这个Action。 http://www.planetstruts.org/struts2-mailreader/Welcome.action
在一个Struts2应用程序中,一个指向Action的链接通常有Struts Tag产生,这个Tag只需要指定Action的名字,Struts框架会自动添加诸如后缀等的扩展,例如:
CODE:
<s:form action="Hello">
<s:textfield label="Please enter your name" name="name"/>
<s:submit/>
</s:form将产生一个如下的链接的请求:
http://Hostname:post/appname/Hello.action
在定义Action的名字的时候不要使用.和/,最好使用英文字母和下划线。
Action中的方法
Action的默认入口方法由xwork2的Action接口来定义,代码清单为:
CODE:
public interface Action {
public String execute() throws Exception;
}有些时候我们想指定一个Action的多个方法,我们可以做如下两步:
1 建立一些execute签名相同的方法,例如:
Public String forward() throws Exception
2 在Action配置的时候使用method属性,例如:
<action name="delete" class="example.CrudAction" method="delete">
Action中的方法通配符
有些时候对Action中方法的调用满足一定的规律,例如edit Action对应edit方法,delete Action对应 delete方法,这个时候我们可以使用方法通配符,例如:
<action name="*Crud" class="example.Crud" method="{1}"> 这时,editCrud Action的引用将调用edit方法,同理,deleteCrud Action的引用将调用delete 方法。
另外一种比较常用的方式是使用下划线分割,例如:
<action name="Crud_*" class="example.Crud" method="{1}">
这样当遇到如下调用的时候可以找到对应的方法。
"action=Crud_input" => input方法
"action=Crud_delete" => delete方法
通配符和普通的配置具有相同的地位,可以结合使用框架的所有其他功能。
默认的Action
当我们没有指定Action的class属性的时候,例如:
<action name="Hello">
我们默认使用com.opensymphony.xwork.ActionSupport
ActionSupport有两个方法input和execute,每个方法都是简单的返回SUCCESS。
通常情况下,请求的Action不存在的情况下,Struts2框架会返回一个Error画面:“404 - Page not found”,有些时候或许我们不想出现一个控制之外的错误画面,我们可以指定一个默认的Action,在请求的Action不存在的情况下,调用默认的Action,通过如下配置可以达到要求:
CODE:
<package name="Hello" extends="action-default">
<default-action-ref name="UnderConstruction">
<action name="UnderConstruction">
<result>/UnderConstruction.jsp</result>
</action>默认通配符
CODE:
<action name="*" >
<result>/{1}.jsp</result>
</action>每个Action将会被映射到以自己名字命名的JSP上。
struts2中动态方法的调用
可以采用DMI(Dynamic Method Invocation,动态方法)调用来处理这种请求,动态方法调用是指表单元素的action并不是直接等于某个Action的名字,而是以如下形式来指定Form的action属性:
<!-- action属性为actionName!methodName的形式 -->
action="ActionName!methodName.action"
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd" >
<struts>
<!--include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->
<include file="struts-default.xml"></include>
<!--package提供了将多个Action组织为一个模块的方式
package的名字必须是唯一的 package可以扩展 当一个package扩展自
另一个package时该package会在本身配置的基础上加入扩展的package
的配置 父package必须在子package前配置
name:package名称
extends:继承的父package名称
abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false
namespace:定义package命名空间 该命名空间影响到url的地址,例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action
-->
<package name="com.kay.struts2"extends="struts-default"namespace="/test">
<interceptors>
<!--定义拦截器
name:拦截器名称
class:拦截器类路径
-->
<interceptor name="timer"class="com.kay.timer"></interceptor>
<interceptor name="logger"class="com.kay.logger"></interceptor>
<!--定义拦截器栈 -->
<interceptor-stack name="mystack">
<interceptor-ref name="timer"></interceptor-ref>
<interceptor-ref name="logger"></interceptor-ref>
</interceptor-stack>
</interceptors>
<!--定义默认的拦截器 每个Action都会自动引用
如果Action中引用了其它的拦截器 默认的拦截器将无效 -->
<default-interceptor-ref name="mystack"></default-interceptor-ref>
<!--全局results配置 -->
<global-results>
<result name="input">/error.jsp</result>
</global-results>
<!--Action配置 一个Action可以被多次映射(只要action配置中的name不同)
name:action名称
class: 对应的类的路径
method: 调用Action中的方法名
-->
<action name="hello"class="com.kay.struts2.Action.LoginAction">
<!--引用拦截器
name:拦截器名称或拦截器栈名称
-->
<interceptor-ref name="timer"></interceptor-ref>
<!--节点配置
name : result名称 和Action中返回的值相同
type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher
-->
<result name="success"type="dispatcher">/talk.jsp</result>
<!--参数设置
name:对应Action中的get/set方法
-->
<param name="url">http://www.sina.com</param>
</action>
</package>
</struts>
<package name="struts2" extends="struts-default" namespace="/sys">
<!-- 添加NameSpace的时候一定要添加根"/"-->
<action name="login" class="com.bian.LoginAction" method="add">
<!-- method 表示执行action中的哪个方法 -->
<result name="action" type="redirect">${action}</result>
<!-- ${action} 变量表示 执行action中存储的变量 type="redirect" 应用了页面或action type="redirect-action" 应用与action-->
</action>
<action name="*" class="com.bian.LoginAction" method="{1}">
<!-- 通配符表示法 -->
<result name="action" type="redirect">${action}</result>
</action>
</package>
package com.bian;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import com.opensymphony.xwork2.ActionSupport;
public class LoginAction extends ActionSupport {
private String action;
public String getAction() {
return action;
}
public void setAction(String action) {
this.action = action;
}
private static final Log log = LogFactory.getLog(LoginAction.class);
public String execute(){
log.error("++++++++++++++++++");
this.action = "user/add.jsp";
return "action";
}
public String add(){
System.out.println("add ++++++++++++++++++++++++++++++++ ");
this.action = "user/add.jsp";
return "action";
}
public String edit(){
System.out.println("edit +++++++++++++++");
this.action = "/list.action";
return "action";
}
public String delete(){
System.out.println("delete +++++++++++++++");
this.action = "/list.action";
return "action";
}
}