源码查看

转载： http://my.oschina.net/SEyanlei/blog/211997#OSC_h1_1
struts1.29,ActionServlet类名头注释翻译

/**
 * <p><strong>ActionServlet</strong> 
 * 提供了"控制器"的模型-视图-控制器(MVC)设计模式的web应用程序通常被称为"模式2"。
 * 这个术语起源于JavaServerPages规范中描述,版本0.92,
 * 保持至今(没有一个更好的名字)。</p>
 *
 * <p>一般来说,"模式2"应用程序架构如下:</p>
 * <ul>
 * <li>用户界面通常会与服务器创建页面,而不会包含任何业务逻辑。这些页面代表“视图”MVC架构的组件。</li>
 * <li>形式和超链接的用户界面需要业务逻辑，执行将提交一个请求URI映射到这个servlet。</li>
 * <li>可以有一个servlet类的实例,接收和处理所有的请求改变用户与应用程序的交互的状态吗?
 * 	          请求的servlet处理代表{ @link RequestProcessor}对象。
 * 	          这个组件代表了MVC架构的“控制器”组件。</li>
 * <li>The <code>RequestProcessor</code> 选择并调用一个{@link Action} 类来执行请求的业务逻辑,或代表响应到另一个资源。</li>
 * <li>The <code>Action</code> 类可以操纵的状态与用户应用程序的交互,通常通过创建或修改javabean被存储为请求或会话属性(取决于他们需要多长时间)。这样的javabean代表“模型”MVC架构的组件。</li>
 * <li>而不是直接生产的下一个页面的用户界面,
 *     <code>Action</code> 类通常返回一个{ @link ActionForward }表示
 *     哪些资源应该处理的响应。如果  the <code>Action</code>
 *     不返回null, the <code>RequestProcessor</code> forwards or
 *     redirects to 到指定的资源(利用
 *     <code>RequestDispatcher.forward</code> or <code>Response.sendRedirect</code>)
 *     以产生下一个页面的用户界面.</li>
 * </ul>
 *
 * <p>标准版的 <code>RequestsProcessor</code> 实现如下逻辑为每个传入的HTTP请求. 您可以覆盖这个功能的部分或全部通过子类化这个对象和实施自己的版本的处理。</p>
 * <ul>
 * <li>识别、从传入请求URI子字符串,将被用于选择一个行动过程。</li>
 * <li>使用该子字符串映射到相应的Java类名操作类(一个操作的<code>Action</code> 实现).
 *     </li>
 * <li>如果这是第一个请求为特定行动<code>Action</code> 类,实例化该类的一个实例并缓存以备将来使用。</li>
 * <li>选择填充属性的 <code>ActionForm</code> bean 与此相关的映射。</li>
 * <li>调用<code>execute</code> 方法在 <code>Action</code>类中, 传递的引用映射使用, 相关表单bean(如果有的话), 并请求和响应所传递给控制器的servlet容器(从而提供任何专业的属性映射本身以及ServletContext).
 *     </li>
 * </ul>
 *
 * <p>标准版的<code>ActionServlet</code> 是基于以下配置servlet初始化参数, 您将指定web应用程序部署描述符 (<code>/WEB-INF/web.xml</code>)
 * 为您的应用程序。子类专业这个servlet可以自由定义额外的初始化参数. </p>
 * <ul>
 * <li><strong>config</strong> - 以逗号分隔的相对路径的XML资源为默认模块包含配置信息。 (多个文件支持Struts 1.1)
 *     [/WEB-INF/struts-config.xml].</li>
 * <li><strong>config/${module}</strong> - 以逗号分隔的相对路径的XML资源
 *     包含模块的配置信息,
 *     将使用指定的前缀(/${module}). 这可以根据需要多次重复多个模块. (Since Struts 1.1)</li>
 * <li><strong>configFactory</strong> -这个类的名称
 *     <code>ModuleConfigFactory</code> 用来创建 实现
 *     <code>ModuleConfig</code> 的实例.
 *     [org.apache.struts.config.impl.DefaultModuleConfigFactory]
 * </li>
 * <li><strong>convertNull</strong> - 模拟的Struts 1.0行为当填充表单。
 * 		如果设置为真, 数字的Java包装器类类型
 *     (like <code>java.lang.Integer</code>) 将默认为null(而不是0).
 *     (Since Struts 1.1) [false] </li>
 * <li><strong>rulesets</strong> - 用逗号分隔的列表
 *    完全限定类名 <code>org.apache.commons.digester.RuleSet</code>
 *     实例应该添加到 <code>Digester</code> 
 *     将处理<code>struts-config.xml</code> 文件.  默认情况下,
 *     只有 <code>RuleSet</code> 为标准配置元素加载  (Since Struts 1.1)</li>
 * <li><strong>validating</strong> - 我们应该使用一个XML验证解析器来处理配置文件(强烈推荐)? [true]</li>
 * </ul>
 *
 * @version $Rev: 264684 $ $Date: 2005-08-30 04:08:01 +0100 (Tue, 30 Aug 2005) $
 */

此注释包括两部分信息：
1.为struts大概流程
2.struts在web.xml中配置的参数解释