struts2: include和global-results

 先贴两段代码，在慢慢解释

(1)struts-user.xml

1. <struts>
2.     <package name="struts-user" extends="struts-default">
3.         
4.         <global-results>
5.             <result type="redirect-action">UserAction_queryAll</result>
6.         </global-results>
7.         
8.         <action name="UserAction_login" class="userAction" method="login"></action>
9.         <action name="UserAction_insert" class="userAction" method="insert"></action>
10.         <action name="UserAction_update" class="userAction" method="update"></action>
11.         <action name="UserAction_delete" class="userAction" method="delete"></action>
12.         <action name="UserAction_queryById" class="userAction" method="queryById"></action> 
13.         <action name="UserAction_queryByLike" class="userAction" method="queryByLike"></action>
14.         <action name="UserAction_queryAll" class="userAction" method="queryAll">
15.             <result>/user/user_list.jsp</result>
16.         </action>
17.         
18.     </package>
19. </struts>

(2)struts.xml(引入了struts-user.xml)

1. <struts>
2.  
3.     <include file="struts-user.xml"></include>
4.     <package name="struts" extends="struts-default"></package>
5.     
6. </struts>

1. 使用<include>标签重用配置文件

(1)在Struts2中提供了一个默认的struts.xml文件，但如果package、action、interceptors等配置比较多时，都放到一个struts.xml文件不太容易维护。因此，就需要将struts.xml文件分成多个配置文件，然后在struts.xml文件中使用<include>标签引用这些配置文件。如上面的代码。

注意：用<include>引用的xml文件也必须是完成的struts2的配置。实际上<include>在引用时是单独解析的xml文件，而不是将被引用的文件插入到struts.xml文件中。

注意：struts.xml和struts-user.xml中<package></package>标签中的name属性不能相同。道理很简单，<struts></struts>标签中可以有多个<package></package>标签，要通过name属性以示区别。

(2)Apache Struts 2 Documentation: Can we break up a large struts.xml file into smaller pieces --> Yes, there are two approaches. We can include other struts.xml file from a bootstrap, or we can package a struts.xml files in a JAR. Or both.

<1>By Include：A typical struts.xml files will have one or more include elements:

1. <struts>
2.     <include file="struts-default.xml"/>
3.     <include file="config-browser.xml"/>
4.     <package name="default" extends="struts-default">
5.     ....
6.     </package>
7.     <include file="other.xml"/>
8. </struts>

The first include element tells the framework to load the struts-default.xml, which it will find in the struts2.jar file. The struts-default.xml file defines the "standard" interceptor and result definitions. You can put your own <include> elements in your struts.xml interchangeably with <package> elements. The configuration objects will be loaded in the order of appearance. The framework reads the configuration from top to bottom and adds objects as they are referenced.

<2>By JAR

A "module" can be added to an application by placing a struts.xml and related classes into a JAR on the classpath. FreeMarker and Velocity templates can also be provided by JAR, making it possible to distribution a module in a single, self-contained JAR that is automatically configured on startup.

2. 全局result(global-results)

(1)有很多时候一个<result>可供很多<action>使用，这时可以使用<global-results>标签来定义全局的<result>，代码见struts-user.xml。执行顺序：当一个Action返回的String没有相应的<result>与之对应，Struts2就会查找全局的<result>。

(2)Apache Struts 2 Documentation: Global Results

Most often, results are nested with the action element. But some results apply to multiple actions. In a secure application, a client might try to access a page without being authorized, and many actions may need access to a "logon" result. If actions need to share results, a set of global results can be defined for each package.The framework will first look for a local result nested in the action. If a local match is not found, then the global results are checked.

1. <!-- Defining global results -->
2. <global-results>
3.     <result name="error">/Error.jsp</result>
4.     <result name="invalid.token">/Error.jsp</result>
5.     <result name="login" type="redirectAction">Logon!input</result>
6. </global-results>

3. <include>标签和<global-results>标签结合

(1)<global-results>标签的作用域只是当前<struts></struts>，也可以说是当前的xml文件；struts2不允许把struts-user.xml(通过<include>引入到struts.xml)中的<global-results>标签写在struts.xml中。

(2)如果struts-user.xml中的package继承自struts.xml中的package，则可以将struts-user.xml中的<global-results>放在struts.xml中。然后struts-user.xml将此<global-results>从struts.xml中继承过来。例如(将上面的两段代码简单修改)：

(1)struts-user.xml

1. <struts>
2.     <!-- 这里struts-user继承(extends)的是struts, 即struts.xml中package的name属性值 -->
3.     <package name="struts-user" extends="struts">
4.         
5.         <action name="UserAction_login" class="userAction" method="login"></action>
6.         <action name="UserAction_insert" class="userAction" method="insert"></action>
7.         <action name="UserAction_update" class="userAction" method="update"></action>
8.         <action name="UserAction_delete" class="userAction" method="delete"></action>
9.         <action name="UserAction_queryById" class="userAction" method="queryById"></action> 
10.         <action name="UserAction_queryByLike" class="userAction" method="queryByLike"></action>
11.         <action name="UserAction_queryAll" class="userAction" method="queryAll">
12.             <result>/user/user_list.jsp</result>
13.         </action>
14.         
15.     </package>
16. </struts>

(2)struts.xml(引入了struts-user.xml)

1. <struts>
2.  
3.     <include file="struts-user.xml"></include>
4.     <package name="struts" extends="struts-default">
5.         <global-results>
6.             <result type="redirect-action">UserAction_queryAll</result>
7.         </global-results>
8.     </package>
9.     
10. </struts>