i_runlevellistener.java

java开源的企业总线.xmlBlaster

/*------------------------------------------------------------------------------
Name:      I_RunlevelListener.java
Project:   xmlBlaster.org
Copyright: xmlBlaster.org, see xmlBlaster-LICENSE file
Comment:   Listens on run level changes
------------------------------------------------------------------------------*/
package org.xmlBlaster.engine.runlevel;


/**
 * Listens on run level change events, for example shutdown is runlevel 0, up and running is runlevel 9. 
 * <p>
 * Implement this interface if you want to receive run level change events.
 * @see org.xmlBlaster.engine.runlevel.RunlevelManager
 * @see <a href="http://www.xmlblaster.org/xmlBlaster/doc/requirements/engine.runlevel.html">engine.runlevel requirement</a>
 * @author Marcel Ruff
 * @since 0.79f
 */
public interface I_RunlevelListener extends java.util.EventListener {
   /**
    * A human readable name of the listener for logging. 
    */
   public String getName();

   /**
    * Invoked on run level change, see for example RunlevelManager.RUNLEVEL_HALTED and RunlevelManager.RUNLEVEL_RUNNING
    * @param from The current runlevel
    * @param to The runlevel we want to switch to
    * @param force If true force the change even if messages are lost
    */
   public void runlevelChange(int from, int to, boolean force) throws org.xmlBlaster.util.XmlBlasterException;
}