Struts笔记02

对于Convention插件而言，它会自动搜索位于action，actions，struts，struts2包下的所有java类，Convention插件会把如下两种java类当成Action处理：


1）  所有实现了com.opensymphony.xwork2.Action的java类


2）  所有类名以Action结尾的java类


===========================
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两个常量的作用比较微妙，开发者在利用这两个常量时务必小心。


默认情况下。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




<!—配置Convention插件自动重加载映射--！>


<constant name=”struts.convention.classes.reload” value=”true”/>


几个重要的常量
=============================
struts.convention.action.disableJarScanning---是否从包中搜索Action


struts.convention.action.packages--------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。


==============================
与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目录下寻找物理视图资源。


 
================================
与包和命名空间相关的Annotation：


   @Namespace：修饰Action类或其所在的包。该Annotation中指定一个value属性值，用于指定被修饰的Action所在的命名空间


  @Namespaces：修饰Action类或其所在的包，用于组合多个@Namespace


  @ParentPackage: 用于指定被修饰的Action所在包的夫包。


==============================
异常处理相关的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属性的作用。