struts.xml文件结构
struts.xml文件是整个Struts2框架的核心。
struts.xml文件内定义了
Struts2的系列Action,定义Action时,指定该Action的实现类,并定义该Action处理结果与视图资源之间的映射关系。
<?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>
<package name="example"
namespace="/example" extends="struts-default">
<!--
定义一个Action名称为HelloWorld,实现类为example.HelloWorld.java-->
<action
name="HelloWorld" class="example.HelloWorld">
<!--
任何情况下都转入到/example/HelloWorld.jsp -->
<result>/example/HelloWorld.jsp</result>
</action>
<action name="Login_*" method="{1}"
class="example.Login">
<!-- 返回input时,转入到/example/login.jsp
-->
<result name="input">/example/Login.jsp</result>
<!--
重定向到Menu的Action -->
<result
type="redirect-action">Menu</result>
</action>
<action
name="*" class="example.ExampleSupport">
<result>/example/{1}.jsp</result>
</action>
</package>
</struts>
*<result
name="input">/example/Login.jsp</result>
以上表示当execute方法返回
input的字符串时,跳转到/example/Login.jsp。定义rusult元素时,可以指定两个属性:type和name。其中name指定
了execute方法返回的字符串,而type指定转向的资源类型,此处转向的资源可以是JSP,也可以是FreeMarker等,甚至是另一个
Action。
加载子配置文件
Struts2框架的核心配置文件就是struts.xml配置文件,该文件主要负责管理
Struts2框架的业务控制器Action。
在默认情况下,Struts2框架将自动加载放在WEB-INF/classes路径下的
struts.xml文件。为了避免随着应用规模的增加,而导致的struts.xml文件过于庞大,臃肿,从而是该文件的可读性下降。我们可以将一个
struts.xml配置文件分解成多个配置文件,然后在struts.xml文件中包含其他配置文件。
<?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.enable.DynamicMethodInvocation" value="false" />
<constant
name="struts.devMode" value="false" />
<!--通过include元素导入其他元素
-->
<include file="example.xml"/>
</struts>
通
过这种方式,Struts2提供了一种模块化的方式来管理struts.xml配置文件。
Package配置
Struts2
框架使用包来管理Action和拦截器等。每个包就是多个Action、多个拦截器、多个拦截器引用的集合。使用package可以将逻辑上相关的一组
Action,Result,Intercepter等组件分为一组,Package有些想对象,可以继承其他的Package,也可以被其他
package继承,甚至可以定义抽象的Package。
Package的可以使用的属性:
属性 是否必须 说明
name
是 Package的表示,为了让其他的package引用
extends 否 从哪个package集成行为
namespace
否 参考Namespace配置说明
abstract 否 定义这个package为抽象的,这个package中不需要定义action
package
元素用于定义包配置,每个package元素定义了一个包配置。定义package元素时可以指定如下几个属性:
name:必填,指定包的名
字,该名字是该包被其他包引用的key。
extends:可选,指定该包继承其他包。继承其他包,可以继承其他包中的Action定义、拦截器
定义等。
namespace:可选,定义该包的命名空间。
abstract:可选,它指定该包是否是一个抽象包。抽象包不能包含
Action定义。
*由于struts.xml文件是自上而下解析的,所以被集成的package要放在集成package的前边。
Namespace
配置(命名空间配置)
Struts2以命名空间的方式来管理Action,同一个命名空间里不能有同名的Action,不同的命名空间里可以有
同名的Action。Struts2不支持为单独的Action设置命名空间,而是通过为包指定namespace属性来为包下面的所有Action指定
共同的命名空间。
Namespace将action分成逻辑上的不同模块,每一个模块有自己独立的前缀。使用namespace可以有效的避免
action重名的冲突,例如每一个package都可以有自己独立的Menu和Help
action,但是事项方式各有不同。Struts2标签带有namespace选项,可以根据namespace的不同向服务器提交不同的
package的action的请求。
“/”表示根namespace,所有直接在应用程序上下文环境下的请求(Context)都在这个
package中查找。
“”表示默认namespace,当所有的namespace中都找不到的时候就在这个namespace中寻找,例如
我们上面的login应用程序。
例如,有如下配置:
<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。
又例:
<struts>
<constant name="struts.custom.i18n.resources"
value="messageResource"/>
<package name="lee"
extends="struts-default">
<action name="login"
class="lee.LoginAction">
<result
name="input">/login.jsp</result>
<result
name="error">/error.jsp</result>
<result
name="success">/welcome.jsp</result>
</action>
</package>
<package name="get" extends="struts-default"
namespace="/book">
<action name="getBooks"
class="lee.GetBooksAction">
<result
name="login">/login.jsp</result>
<result
name="success">/showBook.jsp</result>
</action>
</package>
</struts>
以上代码配置了两个包:lee和get,配置get包时,指定了该包的命名空间为/book。对于名
为lee的包而言,没有指定namespace属性。如果某个包没有指定namespace属性,即该包使用默认的命名空间,则默认的命名空间总是""。
需要注意的问题有两个:
默认命名空间里的Action可以处理任何模块下的Action请求。
即:如果存在URL为
/book/GetBooks.action的请求,并且/book的命名空间没有名为GetBooks的Action,则默认命名空间下名为
GetBooks的Action也会处理用户请求。
当某个包指定了命名空间后,该包下所有的Action处理的URL应该是命名空
间+Action名。
以上面的get的包为例,该包下包含了名为getBooks的Action,则该Action处理的URL为:
http://localhost:8080/namespace/book/GetBooks.action
*namespace是应用名,book是该Action所有包对应的命名空间,GetBooks是Action名。
Action
配置
配置Action就是让Struts2容器知道该Action的存在,并且能调用该Action来处理用户请求。因此,我们认
为:Action是Struts2的基本“程序单位”。即,在struts2框架中每一个Action是一个工作单元。
Action负责将一个
请求对应到一个Action处理上去,每当一个Action类匹配一个请求的时候,这个Action类就会被Struts2框架调用。Action只是一
个控制器,它并不直接对浏览者生成任何响应,因此,Action处理完用户请求后,Action需要将指定的视图资源呈现给用户。因此,配置Action
时,应该配置逻辑视图和物理视图资源之间的映射。
Struts2使用包来组织Action,因此,将Action的定义是放在包定义下完成的,
定义Action通过使用package下的action子元素来完成。至少需要指定该Action的name属性,该name属性既是该Action的
名字,也是该Action需要处理的URL的前半部分。除此之外,通常还需要为action元素指定一个class属性,其中class属性指定了该
Action的实现类。
一个简单的例子:
<package name="lee"
extends="struts-default">
<action name="login"
class="lee.LoginAction">
<result
name="input">/login.jsp</result>
<result
name="error">/error.jsp</result>
<result
name="success">/welcome.jsp</result>
</action>
</package>
一个较全面的Action配置示例:
<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框架会自动添加诸如后缀等的扩展,例如:
<s:form
action="Hello">
<s:textfield label="Please enter your name"
name="name"/>
<s:submit/>
</s:form>
将产生一个如下的链
接的请求:
http://Hostname:post/appname/Hello.action
在定义Action的名字的时候不
要使用.和/来命名,最好使用英文字母和下划线。
1,Action中的方法
Action的默认入口方法由xwork2的Action
接口来定义,代码清单为:
public interface Action {
public String execute()
throws Exception;
}
有些时候我们想指定一个Action的多个方法,我们可以做如下两步:
建立一些
execute签名相同的方法,例如:
Public String forward() throws Exception
在
Action配置的时候使用method属性,例如:
<action name="delete"
class="example.CrudAction" method="delete">
2,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方法
通配符和普通的配置具有相同的
地位,可以结合使用框架的所有其他功能。
3,默认的Action
当我们没有指定Action的class属性的时候,例如:
<action
name="Hello">
我们默认使用com.opensymphony.xwork.ActionSupport
ActionSupport
有两个方法input和execute,每个方法都是简单的返回SUCCESS。
4,Post-Back Action
可以使用如下
画面达到字画面刷新的效果
<s:form>
<s:textfield label="Please enter
your name" name="name"/>
<s:submit/>
</s:form>
4,
默认Action
通常情况下,请求的Action不存在的情况下,Struts2框架会返回一个Error画面:“404 - Page
not
found”,有些时候或许我们不想出现一个控制之外的错误画面,我们可以指定一个默认的Action,在请求的Action不存在的情况下,调用默认的
Action,通过如下配置可以达到要求:
<package name="Hello"
extends="action-default">
<default-action-ref
name="UnderConstruction">
<action name="UnderConstruction">
<result>/UnderConstruction.jsp</result>
</action>
</package>
5,默认通配符
<action name="*" >
<result>/{1}.jsp</result>
</action>
每个Action将会被映射到以自己名字明明的JSP上。
分享到:
相关推荐
struts-config.xml struts标准配置文件 struts-config
Struts框架中struts-config.xml文件配置小结
struts-config.xml配置文件 struts-config.xml配置文件 struts-config.xml配置文件
struts-config.xml配置文件对学struts的人必备的查找资料。
struts.xml配置文件详解struts.xml配置文件详解struts.xml配置文件详解
书写struts.xml时候使eclipse拥有代码提示功能必要的DTD文件struts-2.3.dtd及Key
struts自动加载的一个配置文件列表 struts.configuration.xml.reload Whether to reload the XML configuration or not 是否加载xml配置(true,false) struts.continuations.package The package containing ...
struts-config.xml配置文件详解
struts.xml文件配置解释,对action配置进行说明
在原有的struts.xml的基础上进行相应的配置,配置如下例 <package name="default" namespace="/" extends="struts-default"> <!-- 添加如下内容 --> <result-types> <result-type name="streamx" class=...
·Struts2配置文件介绍 struts.xml action package ·Struts2配置文件介绍 struts.xml action package
本书内容非常全面,涵盖了众多书籍所有知识要点,并结合作者自己经验总结而编写,内容相当丰富,是查找技术的好帮手及学习Struts2的不二选择 众所周知,一般书籍为了销售需要,往往很少的知识点,却需要添加大量的...
struts2配置文件以及代码示例struts2配置文件以及代码示例struts2配置文件以及代码示例struts2配置文件以及代码示例struts2配置文件以及代码示例struts2配置文件以及代码示例struts2配置文件以及代码示例struts2配置...
SSH(Struts,Spring,Hibernate)struts.xml文件配置
绝对的好东西 struts2.0中struts.xml配置文件详解
Struts应用采用两个基于XML配置文件来配置,分别是web.xml和struts-cofig.xml文件.web.xml文件 是配置所有web应用而struts-config.xml文件是struts专用配置文件,事实上也是可以根据需要给这个配置文件 起其他名称.
这个strut-config配置详解是韩顺平老师指定的 很多同学都看过韩老师的视频或者上过韩老师的课程吧
struts2 使用注解现在零配置不需要在使用struts.xml配置文件。 struts2 注解实例。可以直接跑
Struts2 的第三方插件 使用注解的方式配置struts.xml文件
struts2.0中struts.xml配置文件详解