第2.1式. 用插件来进行应用初始化
问题
在应用启动时需要装入应用初始化数据到context 中。
动作要领
创建一个类，实现org.apache.struts.action.PlugIn接口，并且在struts-config.xml文件中指定plug-in元素。下面的XML 片断展示了一个plug-in 声明以及一个嵌套的set-property元素来设置定制属性：
<plug-in className="com.oreilly.strutsckbk.CustomPlugin" > <set-property property="customData" value="Hello from the plugin"/> </plug-in>
动作变化
Struts提供了一个PlugIn接口，你可以用它来创建在应用启动时初始化的定制服务。PlugIn接口的Java源代码示于 . (为了清晰起见，去除了JavaDoc 文档)
Example 2-1. Struts PlugIn 接口
package org.apache.struts.action; import javax.servlet.ServletException; import org.apache.struts.config.ModuleConfig; public interface PlugIn { public void destroy( ); public void init(ActionServlet servlet, ModuleConfig config) throws ServletException; }
为了实现一个plug-in，只需要实现这个接口并且在struts-config.xml文件中声明这个plug-in 实现。有两个方法必须被实现：即init()和destroy( ), 它们在插件的生命周期中被调用。Struts 在启动ActionServlet时实例化plug-in 之后调用init( )。Struts则在ActionServlet被销毁时调用destroy()方法，通常是在一个用服务器停止时。首先，这个 plug-in 特征似乎是很单纯和有限的。然而，通过使用Struts的另外一个特征，即set-property元素，你可以将特殊的信息传递到plug-in中。这种能力增强了这些类的灵活性。
| set-property 元素被几乎所有定义 Struts 实体的元素所支持，比如 form-bean, action-mapping, action, 以及 plug-in 。 set-property 元素有两个属性： name 和 value 。 Struts 调用 name 属性的值指定的 property 的 setter 方法，将 property 设置为 value 属性的字符串值。 |
对给定plug-in的所有set-property元素都将在调用plug-in的init( )方法之前进行处理。这允许plug-in 在init( )方法中使用属性的值。
| 如果对一个 plug-in 使用多个 set-property 元素， Struts 不能保证它们被调用的顺序。每个 setter 方法都应该独立于其他任何方法。 |
Struts 将对ActionServlet和plug-in的ModuleConfig的引用作为引数传递给init( )方法。ActionServlet允许访问ServletContext来进行应用范围的对象存储。ActionServlet还可以允许你访问更多高级的容器管理的J2EE 组件，比如数据源和消息队列。ModuleConfig允许你访问定义plug-in 的模块的Struts配置。
| 每个 Struts 应用至少有一个模块：默认模块。如果你不熟悉模块，我们将在第 2.5 式中讲解之。 |
为了更具体一些，请考虑一个简单的，但仍然相关的例子。你需要定义一个plug-in，它可以使你决定应用何时启动，以及它启动和运行了多长时间。你可以使用下面所示的类跟踪和报告你的应用的运行时间。
Example 2-2. Application uptime tracker 对象
package com.oreilly.strutsckbk; import java.util.Date; public class TimeTracker { private long startUpTimeMillis; private Date startedOn; public TimeTracker( ) { startUpTimeMillis = System.currentTimeMillis( ); startedOn = new Date( ); } public long getUptime( ) { return System.currentTimeMillis( ) - startUpTimeMillis; } public Date getStartedOn( ) { return startedOn; } }
创建一个PlugIn接口的实现，比如 所示，它实例化了TimeTracker。plug-in 通过plug-in 属性的值将TimeTracker实例保存在ServletContext中。你可以使用这个值来从Servlet上下文中获取TimeTracker实例。虽然这个值是硬编码的，使用属性也提供了更大的灵活性。
Example 2-3. Time tracker plugin
package com.oreilly.strutsckbk; import javax.servlet.ServletException; import org.apache.struts.action.ActionServlet; import org.apache.struts.action.PlugIn; import org.apache.struts.config.ModuleConfig; public class TimeTrackerPlugin implements PlugIn { private String contextKey; public void setContextKey(String key) { this.contextKey = key; } public void init(ActionServlet servlet, ModuleConfig conf) throws ServletException { servlet.getServletContext( ).setAttribute(contextKey, new TimeTracker( )); } public void destroy( ) { } }
现在你已经有了为plug-in 创建的类，你可以通过在struts-config.xml中加入plug-in元素来将其集成到Struts 应用中。
<plug-in className="com.oreilly.strutsckbk.TimeTrackerPlugin"> <set-property property="contextKey" value="timeTracker"/> </plug-in>
plug-in 在servlet 上下文中存储了time tracker对象。可以访问TimeTracker来显示关于应用启动运行时间的信息，下面是相关的JSP 片断：
<h4>Continuously running since <bean:write name="timeTracker" property="startedOn" format="MM/dd/yyyy HH:mm"/> for <bean:write name="timeTracker" property="uptime"/> milliseconds! </h4>
你可以使用一个servlet 来载入像Struts plug-in之类的初始化数据。具有load-on-startup初始化参数的servlet，应将其设置为较低的数值，比如1, 一保证它们在应用启动时载入。容器在实例化Servlet之后将调用servlet的init( )方法。但是Struts plug-in 方式由多个优点。首先，大多数Struts 应用在其初始化设置后不需要修改web.xml文件。必须在web.xml中声明额外的Servlet意味着要维护额外的文件。其次，如果需要PlugIn接口提供对特定Struts信息的访问。最后，因为plug-in 的生命周期紧随ActionServlet的生命周期，所以可以保证在你的Struts应用所需时数据有效。
相关招式
第2.8式展示了set-property元素的另一种用法。Struts 文档中关于plug-in 的信息可以访问 .
你也可以使用一个Servlet 上下文listener 来载入初始化数据。