使用注解可以用来替换struts.xml配置文件！！！
必须导入struts2-convention-plugin-2.3.15.jar包，它在struts2安装包下lib目录中。
@Action来代替<action>元素！
l String value()：指定访问路径；
l Result[] results()：指定局部结果。
@Result来代替<result>元素！
l String name()：指定结果名称；
l String location()：指定结果路径。
@Namespace代替<package>的namespace属性：
l String value()：指定名称空间。
@ParentPackage代替<package>的extends属性：
l String value()：指定父包名称
@Namespace("/order")
@ParentPackage("struts-default")
publicclass OrderAction extends ActionSupport {
@Action(value="add", results={
@Result(name="success", location="/index.jsp"),
@Result(name="input", location="/add.jsp")})
public String add() {
System.out.println("add()");
returnSUCCESS;
}
@Action(value="mod", results={@Result(name="success", location="/index.jsp")})
public String mod() {
System.out.println("mod()");
returnSUCCESS;
}
@Action(value="del", results={@Result(name="success", location="/index.jsp")})
public String del() {
System.out.println("del()");
returnSUCCESS;
}
}
struts.convention.classes.reload，默认值为false。表示在修改注解后需要重启Tomcat！
使用约定可以连注解都不写，是真正的零配置，但是它的能力有限，所以这种方式不可取的。
l Struts2会对Action的命名，以及Action的包名都有限制；
l Struts2会对结果页面的存放路径，以及结果页面的名称也都有限制。
使用约定与使用注解一样，也要导包：struts2-convention-plugin-2.3.15.jar
约定Action类名：
要求Action的命名必须以“Action”为后缀，例如：UserAction、BookAction等等。可以使用下面常量来修改后缀限制：
<constant name="struts.convention.action.suffix" value="Action"/>
约定Action包名：
要求Action必须放到action、actions、struts、struts2包中。例如：cn.itcast.action、cn.itcast.sturts、cn.itcast.action.user等等。可以使用下面常量来修改Actoin的包
<constant name="struts.convention.package.locators" value="action,actions,struts,struts2"/>
上面已经知道约定对Action的限制，现在通过Action的包名和类名得到它的访问路径
例如：cn.itcast.action.UserAction，它的访问路径为/user.action
例如：cn.itcast.action.user.UserAction，它的访问路径为/user/user.action。因为在约定包action后面还有一层包user，那么这一层就是名称空间了。
例如：com.action.cn.itcast.user.UserAction，它的访问路径为/cn/itcast/user/user.action。
例如：cn.itcast.action.user.UserListAction, 它的访问路径为/user/user-list.action。当Action名称由多个单词构成，那么在访问路径中使用“-”来连接多个单词。
Struts2约定限制结果页面必须放到/WEB-INF/content/目录中，可以通过下面常量来修改这个限制。
<constant name="struts.convention.result.path" value="/WEB-INF/content/"/>
当cn.itcast.action.UserAction返回结果为success时，Struts会依次查找如下结果页面：
l /WEB-INF/content/user-success.jsp；
l /WEB-INF/content/user-success.html；
l /WEB-INF/content/user.jsp
当cn.itcast.action.user.UserListAction返回的结果为error时，Struts会依次查找如下结果页面：
l /WEB-INF/content/user/user-list-error.jsp；
l /WEB-INF/content/user/user-list-error.html；
l /WEB-INF/content/user/user-list.jsp。
=====================================================================================================
以前使用Struts2的时候参数都是在struts.xml里面配置的，现在转入了一个新的项目中，发现这个项目struts.xml中只定义了几个常量，并没有大量的action、interceptor的配置信息，项目显得非常整洁，但是同时也看的云里雾里。今天花了一小会看了一个Struts2 Convention Plugin的官方文档，才大致了解了一二，这里简单叙述一下。 具体的阐述请参考官网http://struts.apache.org/2.1.6/docs/convention-plugin.html。Convention Plugin是从2.1版本开始引进的。2.1以前的版本请参考http://struts.apache.org/2.0.14/docs/zero-configuration.html。不同的版本大家再到官网查看一下吧。呵呵 下面是常用的常量
namedefault valuedescriptionstruts.convention.result.path/WEB-INF/content/Directory where templates are locatedstruts.convention.result.flatLayouttrueIf set to false, the result can be put in its own directory: resultsRoot/namespace/actionName/result.extensionstruts.convention.package.locatorsaction,actions,struts,struts2Packages whose name end with one of these strings will be scanned for actionsstruts.convention.exclude.packagesorg.apache.struts.*,org.apache.struts2.*Packages excluded from the action scanningstruts.convention.package.locators.basePackage If set, only packages that start with its value will be scanned for actions 下面是步骤： 1，首先需要将架包(struts2-convention-plugin-xxx.jar)导入工程中(如果将action打包在了jar包中，那么属性struts.convention.action.disableJarScanning需要设置为true)。 2,跳转路径是根据请求路径的url处理的，即使没有请求对应的action，但是WEB-INF目录下有对应的页面，也可以跳转到页面上去。例如我们有页面WEB-INF/content/hello-world.jsp，如果我们请求http://localhost:8080/hello-world，即使没有HelloWorldAction，那么我们仍然能跳转到上面的欢迎页面，这是因为Convention plugin获取跳转结果只是根据Struts获取的URL，而不是action中配置的跳转路径。 下面是Annotation的分类： 1，Action annotation。 最简单的例子 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; public class HelloWorld extends ActionSupport { @Action("/different/url") public String execute() { return SUCCESS; } } 那么这个HelloWorld的访问url就变为了/different/url。 一个方法可以被映射到多个url上面，如下所示，方位注解中的两个url都可以访问这个方法 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; public class HelloWorld extends ActionSupport { @Actions({ @Action("/different/url"), @Action("/another/url") }) public String execute() { return SUCCESS; } } 如果一个action中有多个方法，那么可以分别为各个方法指定访问url Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; public class HelloWorld extends ActionSupport { @Action("/different/url") public String execute() { return SUCCESS; } @Action("url") public String doSomething() { return SUCCESS; } } 请注意上面这个类的第二个方法doSomething()，它的url是“url”，这是个相对路径是，也就是说访问这个方法时的正确路径是namespace+url。而execute()通过访问/different/url就可以访问。 使用@Action的interceptorRefs 属性可以指定action或者方法的interceptor，如下面的例子 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; public class HelloWorld extends ActionSupport { @Action(interceptorRefs={@InterceptorRef("validation"), @InterceptorRef("defaultStack")}) public String execute() { return SUCCESS; } @Action("url") public String doSomething() { return SUCCESS; } } 上面的action中execute()方法应用了validation拦截器和defaultStack拦截器栈。 还可以使用params属性指定要传给拦截器的参数。形式为{键，值，键，值…………}，键值总是会成对出现，如下面的例子 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; public class HelloWorld extends ActionSupport { @Action(interceptorRefs=@InterceptorRef(value="validation",params={"programmatic", "false", "declarative", "true})) public String execute() { return SUCCESS; } @Action("url") public String doSomething() { return SUCCESS; } } 如果Action没有显式的指定拦截器的话，默认的拦截器会应用在这个Action上。 2,Interceptor Annotation。 拦截器可以在类和方法的层面上应用。在方法层面指定拦截器使用@Action注解，在类层面指定拦截器使用@InterceptorRefs注解。类层面引用的拦截器会应用在所有的方法上，如下面的例子 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; @InterceptorRefs({ @InterceptorRef("interceptor-1"), @InterceptorRef("defaultStack") }) public class HelloWorld extends ActionSupport { @Action(value="action1", interceptorRefs=@InterceptorRef("validation")) public String execute() { return SUCCESS; } @Action(value="action2") public String doSomething() { return SUCCESS; } } 如上代码所示，execute()方法应用了interceptor-1,validation和defaultStack中的所有拦截器；而doSomething()方法则没有validation拦截器。 3,Result Annotation。 Convention plugin允许为一个Action设置多个跳转路径，使用@Result注解标识。@Result可以已经用在Action上，可以应用在方法上，应用在Action上作为全局路径，应用在Method上那么只对当前的Method起作用。如下面的例子 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; import org.apache.struts2.convention.annotation.Result; import org.apache.struts2.convention.annotation.Results; @Results({ @Result(name="failure", location="fail.jsp") }) public class HelloWorld extends ActionSupport { @Action(value="/different/url", results={@Result(name="success", location="http://struts.apache.org", type="redirect")} ) public String execute() { return SUCCESS; } @Action("/another/url") public String doSomething() { return SUCCESS; } } 同@InterceptorRef注解，@Result注解同样可以使用params属性设置参数，实例如下 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; import org.apache.struts2.convention.annotation.Result; import org.apache.struts2.convention.annotation.Results; public class HelloWorld extends ActionSupport { @Action(value="/different/url", results={@Result(name="success", type="httpheader", params={"status", "500", "errorMessage", "Internal Error"})} ) public String execute() { return SUCCESS; } @Action("/another/url") public String doSomething() { return SUCCESS; } } 4,Namespace annotation 可以定义在Action中或者是定义在package-info.java文件中。在Action中定义的@Namespace会应用在该Action中所有的相对url上。如果定义在package-info.java文件中，那么该包中的所有的Action的namespace（不包括子包中的action）。 实例代码一：在Action中使用@Namespace注解。 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Namespace; @Namespace("/custom") public class HelloWorld extends ActionSupport { @Action("/different/url") public String execute() { return SUCCESS; } @Action("url") public String doSomething() { return SUCCESS; } } 如上代码，execute()访问的url为/different/url,doSomething()的访问url为/custom/url，这个路径前面追加了@Namespace。 示例代码二：在package-info.java中配置@Namespace注解 Java代码 @org.apache.struts2.convention.annotation.Namespace("/custom") package com.example.actions; 那么包com.example.actions中所有的action的Namespace都被指向了/custom。 5,ResultPath annotation，用来改变结果页面所在的目录。如下例所示 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.ResultPath; @ResultPath("/WEB-INF/jsps") public class HelloWorld extends ActionSupport { public String execute() { return SUCCESS; } } 该Action跳转的结果页面将指向/WEB-INF/jsps目录。 6,ParentPackage annotation，用来改变特定的Action类或者是java包的parent XWork packages（不好意思，这几个单词怎么翻译觉得都不好，就直接引用了）。示例代码如下 Java代码 package com.example.actions; import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.ParentPackage; @ParentPackage("customXWorkPackage") public class HelloWorld extends ActionSupport { public String execute() { return SUCCESS; } } 7,ExceptionMapping Annotation，用来配置action出现异常时的跳转路径。该注解同样可以使用params属性配置要传入的参数。该注解可以配置在Action级别和Method级别，配置在Action级别对所有的Method都适用；配置在Method级别只对当前的Method使用。示例代码如下： 在Action上配置ExceptionMapping Annotation： Java代码 @ExceptionMappings({ @ExceptionMapping(exception = "java.lang.NullPointerException", result = "success", params = {"param1", "val1"}) }) public class ExceptionsActionLevelAction { public String execute() throws Exception { return null; } } 在Method上配置ExceptionMapping Annotation，使用params属性传入要设置的参数 Java代码 public class ExceptionsMethodLevelAction { @Action(value = "exception1", exceptionMappings = { @ExceptionMapping(exception = "java.lang.NullPointerException", result = "success", params = {"param1", "val1"}) }) public String run1() throws Exception { return null; } } Convention Plugin在Action中的配置改变时，可以自动加载改变的内容而不用重新启动容器。这时需要在struts.xml文件中做如下设置 Java代码 <constant name="struts.devMode" value="true"/> <constant name="struts.convention.classes.reload" value="true" /> 但这种加载方式只是实验性的并且还没有在所有的容器中进行测试，因此官方不推荐使用。 ==========常见错误============ 1,"There is no Action mapped for namespace /orders and action name view.",这说明URL"/orders/view.action"并没有被映射到任何一个action，这是你需要检查action的namespace或者action的名称是否正确。 2,如果碰见如“"No result defined for action my.example.actions.orders.ViewAction and result success"的错误，说明action被映射到了正确的url上，但是action返回success时要跳转的页面并没有找到，请确保您的工程的正确目录中含有诸如/WEB-INF/content/orders/view-success.jsp的页面。 ============难点============= 1,要确保Action的namespace要有对应的页面。定位器(action,actions,struts,strutss)后面的namespace将作为action的namespace，并且用来定位该action要跳转到的页面。例如包my.example.actions.orders中有个名为ViewAction的action,那么他会被映射到/orders/view.action,该Action对应的页面必须在目录/WEB-INF/content/orders下面，例如/WEB-INF/content/orders/view-success.jsp。 2,关于Convention Plugin的日志输出。本插件在Debug模式下会输出大量的日志信息，因此不建议开启Debug模式。如果你是用的是JDK自带的logger,可以使用"trace"日志级别打印日志；如果使用的是Log4J，可以在配置文件中做如下配置 Java代码 log4j.logger.org.apache.struts2.convention=DEBUG ========================================================================================
从struts2.1开始，struts2不再推荐使用Codebehind作为零配置插件，而是改为使用Convention插件来支持零配置，和Codebehind相比，Convention插件更彻底，该插件完全抛弃配置信息，不仅不需要是使用struts.xml文件进行配置，甚至不需要使用Annotation进行配置，而是由struts2根据约定自动配置。
如何使用Convention
1. 将struts-Convention-plugin-2.1.6.jar文件复制到WEB-INF/lib路径下
2. 对于Convention插件而言，它会自动搜索位于action，actions，struts，struts2包下的所有Java类，Convention插件会把如下两种Java类当成Action处理：
1） 所有实现了com.opensymphony.xwork2.Action的java类
2） 所有类名以Action结尾的java类
3. Convention插件还允许设置如下三个常量：
1） struts.Convention.exclude.packges:指定不扫描哪些包下的java类，位于这些包结构下的java类将不会自动映射成Action；
2） struts.convention.package.locators:Convention插件使用该常量指定的包作为搜寻Action的根包。对于actions.fore.LoginAction类，按约定原本应映射到/fore/login;如果将该常量设为fore，则该Action将会映射到/login
3） struts.convention.action.packages:Convention插件以该常量指定包作为根包来搜索Action类。Convention插件除了扫描action,actions,struts,struts2四个包的类以外，还会扫描该常量指定的一个或多个包，Convention会试图从中发现Action类。
注意：struts.convention.package.locators和struts.convention.action.packages两个常量的作用比较微妙，开发者在利用这两个常量时务必小心。
如：下面Action所在包被映射的命名空间如下：
com.fun.actions.LoginAction 映射到 /
com.fun.actions.myoffice.CarInfoAction 映射到 /myoffice
com.fun.struts.myoffice.EntINfoAction 映射到 /myofiice
4. 映射Action的name时，遵循如下两步规则：
1） 如果该Action类名包含Action后缀，将该Action类名的Action后缀去掉。否则不做任何处理。
2） 将Action类名的驼峰写法（每个单词首字母大写、其他字母小写的写法）转成中画线写法（所有字母小写，单词与单词之间以中画线隔开）
如：LoginAction映射的Acion的name属性为login，GetBooks映射的Action的name的属性为get-books，AddEmployeeAction映射的Action的name属性为add-employee
5. 默认情况下。Convention总会到WEB应用的WEB-INF/content路径下定位物理资源，定位资源的约定是：actionRUL+resultCODE+suffix。当某个逻辑视图找不到对应的试图资源时，Convention会自动视图使用ActionURL+suffix作为物理视图资源。
如：actions.fore.LoginAction 返回success字符串时，Convention优先考虑使用WEB-INF/content/fore目录下的login-success.jsp作为视图资源。如果找不到该文件，login.jsp也可作为对应的试图资源。如果返回input字符串，Convention会将WEB-INF/content/fore里面查找login-input.jsp
6. 为了看到struts2应用里的Action等各种资源的影射情况，struts2提供了Config Browser插件。使用方法，将struts2-config-browser-plugin-2.1.6.jar文件复制到struts2应用的WEB-INF/lib目录中。
打开首页地址：http://localhost:8080/应用名字/config-browser/actionNames.action这里可以看到Config Browser插件的首页。
注意：这里不管开发者是否使用struts.xml文件进行配置，一样可以看到struts的配置信息。
7.Action链的约定
如果希望一个Action处理结束后不是进入一个试图页面，而是进行另一个Action形成的Action链。通过Convention插件则只需遵守如下三个约定即可。
1） 第一个Action返回的逻辑视图字符串没有对应的视图资源
2） 第二个Action与第一个Action处在同一个包下
3） 第二个Action影射的URL为：firstActionURL+resultCODE
如，第一个Action为OneAction，里面有个方法返回为“two”,那么就得保证，WEB-INF/content/下没有one.jsp或one-two.jsp 对于第二个action 它的名字应该是OneTwoAction，而对应的url应该是：“one-two.action”
注意：由于Convention插件根据Action和jsp页面来动态生成映射的，因此不管是Acion的改变，还是JSP页面的改变都需要Convention插件重新加载映射。那么只要我们为struts2应用配置如下两个常量就可以了。
<!--配置struts2应用于开发模式--！>
<constant name=”struts.devMode” value=”true”/>
<!—配置Convention插件自动重加载映射--！>
<constant name=”struts.convention.classes.reload” value=”true”/>
几个重要的常量
struts.convention.action.disableJarScanning---是否从包中搜索Action
struts.convention.action.package--------Convention插件以该常量指定包作为根包
struts.convention.result.path ---设置Convention插件定位视图资源的根路径。默认值为/WEB-INF/content
struts.convention.result.flatLayout—如果是为false则可以将试图放置Action对应的目录下，无需放入WEB-INF/content
8. Convention的Annotation
1） 与Action相关的两个Annotation是@Action 和@Actions
2） @Action中可指定一个value属性。类似于指定<action name=””/>属性值
3） @Action中还可以指定一个params属性，该属性是一个字符串数组，用于该Acion指定的参数名和参数值。params属性应遵守如下格式：{“name1”,”value1”,”name2”,”value2”}
4） @Actions 也用于修饰Action类里的方法，用于将该方法映射到多个URL.@Actions用于组织多个@Action.因此它可将一个方法映射成多个逻辑Action。
如：
view plain package com.fun.actions; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; import com.fun.service.LoginService; import com.opensymphony.xwork2.ActionSupport; public class LoginAction extends ActionSupport { private String str; @Actions({ @Action(value="login1",params={"str","这是已经注入的了！"}), @Action(value="login2") }) public String login(){ return "str"; } @Action(value="ggg") public String abc(){ return "abc"; } public String getStr() { return str; } public void setStr(String str) { this.str = str; } }
我们可以通过/login1.action访问，而在访问时，str这个属性已经有值，为str=”这是已经注入的！” 返回的视图是login1-str.jsp
当我们用/login2.action访问时，str的值为null。返回的视图为 login2-str.jsp
而我们通过/ggg.action调用的是abc（）方法，返回的视图为/ggg-abc.jsp
9. 与Result配置相关的Annotation
1）@ResultPath @Result 和Results
2）@Results用于组织多个@Result因此它只需指定一个value属性值，该value属性值为多个@Result
3）@Result相当于struts.xml文件中的<result/>元素的做哟欧诺个。使用@Result必须指定一个name属性，相当于<result name=””/>另外，它还有几个可选的属性。
☆ type 相当于<result type=””/>指定返回视图资源的类型
☆ location 相当于<result>…..</result>中间部分，用于指定实际视图位置
☆ params：该属性相当于<result/>元素里多个<param../>子元素的作用，用于为该Result指定参数值。该属性应满足{“name1”,”value1”,”name2”,”value2”}格式
4)@Result有以下两种用法
1 Action级的Result映射：以@Actions组合多个@Action后修饰的Action类。这种Result映射对该Action里的所有方法都有效。
2方法级Result映射：将多个@Result组成数组后作为@Action的results属性值。这种Result映射仅对被修饰的方法有效。
5）@ResultPath则用于修饰包和Action类，用于改变被修饰Action所对应的物理视图资源的根路径。举例说：默认情况下，Convention都会到WEB-INF/content路径下找物理视图资源，一旦我们使用@ResultPath(“/abc”)修饰该Action，系统将回到abc目录下寻找物理视图资源。举例：在默认情况下，Convention都会到WEB-INF/content路径下需找物理视图资源，一旦我们使用@ResultPath(“/abc”)修饰该Action，系统会到abc目录下寻找物理视图资源。
10. 与包和命名空间相关的Annotation：
@Namespace：修饰Action类或其所在的包。该Annotation中指定一个value属性值，用于指定被修饰的Action所在的命名空间
@Namespaces：修饰Action类或其所在的包，用于组合多个@Namespace
@ParentPackage: 用于指定被修饰的Action所在包的夫包。
11. 异常处理相关的Annotation
@ExceptionMappings 用于组织多个@ExceptionMapping，因此它只需指定一个value属性值，该value属性值为多个@ExceptionMapping。
@ExceptionMapping 用于定义异常类和物理视图之间的对应关系，也相当于struts.xml文件里<exception-mapping../>元素的作用 使用时，必须注意以下两个属性：
exception: 用于指定异常类
result ： 用于指定逻辑视图
@ExceptionMpping有如下两种用法
Action级的异常定义:以@ExceptionMappings组合多个@ExceptionMapping后修饰的Action类。这种异常定义对Action中的所有方法有效
方法级的异常定义： 将多个@ExceptionMapping组成数组后作为@Action的exceptionMappings属性值，这种异常定义仅对被修饰的方法有效。
12.拦截器配置相关的Annotation
与拦截器配置的Annotation有@InterceptorRef、@InterceptorRefs和@DefaultInterceptorRef
@InterceptorRefs用于组织多个@InterceptorRef，因此它只需要指定一个value属性值，该value属性值为多个@InterceptorRef
@InterceptorRef用于为指定Action引用lanjieq或者是拦截器栈。也就相当于strut.xml中位于<action../>元素内部的<interceptor-ref../>子元素的作用。使用@InterceptorRefAnnotation时，必须制定一个value属性，用于指定所引用的拦截器或拦截器栈的名字。相当于<interceptor-ref../>子元素里name属性的作用。
