关于struts-config.xml中“plug-in”元素的问题

问题描述：

< plug - in className = " org.apache.struts.validator.ValidatorPlugIn " >
     < set - property property = " pathnames "  value = " /WEB-INF/validator-rules.xml,/WEB-INF/validator/validation.xml "   />
     < set - property property = " stopOnFirstError "  value = " true "   />
   </ plug - in >
其中 < set - property property = " stopOnFirstError "  value = " true "   /> 是什么意思？？？

再比如：

  < plug - in className = " org.apache.struts.validator.ValidatorPlugIn " >
         < set - property property = " pathnames "
            value = "  /WEB-INF/validator-rules.xml,/WEB-INF/validation.xml "   />
     </ plug - in >
     < plug - in
        className = " org.springframework.web.struts.ContextLoaderPlugIn " >
         < set - property property = " contextConfigLocation "
            value = " /WEB-INF/classes/applicationContext.xml "   />
     </ plug - in >

创建一个实现了org.apache.struts.action.PlugIn接口的类文件并在struts - config.xml中设置plug - in元素。以下代码片段显示了一个plug - in生命声明和一个自定义的set - property子元素：

< plug - in className = " com.oreilly.strutsckbk.CustomPlugin "   >

   < set - property property = " customData "

                   value = " Hello from the plugin " />

</ plug - in >

n   细节讨论：

Struts提供一个 PlugIn接口能使你在启动应用程序时为你提供自定义的操作。其源代码如下：

package  org.apache.struts.action;

 

import  javax.servlet.ServletException;

import  org.apache.struts.config.ModuleConfig;

 

public   interface  PlugIn  {

    void destroy();

    void init(ActionServlet servlet, ModuleConfig config)

        throws ServletException;

}

要实现一个plug - in，你只需要实现这个接口并在struts - config.xml文件的中声明plug - in元素。子类必须实现方法destroy()和init()。init()在ActionServlet启动时实例化plug - in过程中执行，当ActionServlet结束时执行destroy(),一般情况下是应用程序关闭。通过在plug - in元素中设置set - property元素，可以向PlugIn类传递参数。

所有set - property元素都在init()方法执行之前被执行，这样就可以在init()方法中使用这些由set - property设置的参数了。

Struts将ActionServlet的引用和ModuleConfig参数传递给init()方法。ActionServlet使的init()方法中可以将数据保存到ServletContext中。ActionServlet还可以使你能够访问更多的J2EE组件如java sources、message队列等。ModuleConfig可以让你访问当前的模块配置信息。

n   举例说明：

你需要定义一个plug - in记录应用程序何时运行的及运行了多久。

TimeTracker.java:

package  com.yourcompany.struts.plugin;

 

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子类TimeTrackerPlugin。TimeTrackerPlugi将TimeTracker保存在ServletContext中，键名由由plug - in元素的set - propery子元素指定：

TimeTrackerPlugin.java:

package  com.yourcompany.struts.plugin;

 

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( ) {

    }

}

struts - config.xml:

   < plug - in className = " com.yourcompany.struts.plugin.TimeTrackerPlugin " >

     < set - property property = " contextKey "  value = " timeTracker " />

   </ plug - in >

 

你可以使用如下的JSP片段访问TimTracker，并显示关于应用程序运行时间的信息。

 

n   你也可以在web.xml中配置一个Servlet实现plug - in的功能将load - on - startup值设置为一个较低的值如1。他将在应用程序启动是自动加载并执行。容器在实例化Servlet后将调用此Servlet的init()方法。比较而言，使用plug - in有更多的优势：

1 .  一般情况下Struts应用程序设置好web.xml后，在开发过程中不许要改动他的内容。在web.xml中增加servlet意味着增加了一个维护对象。

2 .  plug - in接口提供了访问struts应用程序特有的信息的能力。

plug - in的声明周期跟ActionSerlvet的生命周期一致。他可以保证你的struts应用程序需要的信息可用。