Save This Page
Home » JBoss-5.1.0 » org.jboss.mx » interceptor » [javadoc | source]
org.jboss.mx.interceptor
public interface: Interceptor [javadoc | source] This interface defines MBean interceptors. All MBean interceptors must implement this interface.
Method from org.jboss.mx.interceptor.Interceptor Summary:
destroy,   getName,   init,   invoke,   isShared,   setLogger,   start,   stop
Method from org.jboss.mx.interceptor.Interceptor Detail:
 public  void destroy()
    This method is part of the interceptor lifecycle. It is called by the invoker durin the interceptor removal.

    For shared interceptors the lifecycle is driven by the MBean unregistration. This method is called after the MBean is registered to the server as part of the javax.management.MBeanRegistration#postDeregister execution.

    Concrete interceptor implementations can override this method to provide cleanup code that should be executed once the interceptor is no longer registered to the MBean server.

 public String getName()
    Returns the name of this interceptor. Notice that for shared interceptors this name must be unique among the shared interceptors in the MBean server.
 public  void init() throws Exception
    This method is part of the interceptor's lifecycle. It is called by the invoker during the initialization of the interceptor instance.

    For shared interceptors the lifecycle is driven by the MBean registration. This method is called before the MBean is registered to the server.

    Concrete interceptor implementations can override this method to provide initialization code that should be executed before the interceptor is registered.

    Any exception that is propagated from this method to its caller will cancel the interceptor registration.

 public Object invoke(Invocation invocation) throws Throwable
    The invoke method is called when the invocation object passes this interceptor.
 public boolean isShared()
    Returns true if this interceptor is shared by multiple invokers; false otherwise. Non-shared interceptors should always return false. Shared interceptors return false if they have not been registered to the MBean server yet. Shared interceptors must always return true after they have been registered to the server.
 public  void setLogger(Logger log)
    Called by the MBeanInvoker on a non-shared interceptors to set a logger reference for this interceptor. The interceptor implementation may use the invoker's logger for recording log information.

    Shared interceptors should set up their log facility through other means as they are invoked by several different MBean invokers. To access the log implementation of the originating invoker for a particular invocation, an interceptor may query they invocation context for invoker reference.

 public  void start()
    This method is part of the interceptor's lifecycle. It is called by the invoker during the interceptor initialization process.

    For shared interceptors the lifecycle is driven by the MBean registration. This method is called after the MBean is registered to the server as part of the javax.management.MBeanRegistration#postRegister execution.

    Concrete interceptor implementations can override this method to provide initialization code that should be executed once the MBean server and object name references for this interceptor have been resolved.

 public  void stop() throws Exception
    This method is part of the interceptor lifecycle. It is called by the invoker during the interceptor removal.

    For shared interceptors the lifecycle is driven by the MBean unregistration. This method is called after the MBean is registered to the server as part of the javax.management.MBeanRegistration#preDeregister execution.

    Concrete interceptor implementations can override this method to provide cleanup code that should be executed before the interceptor is unregistered.

    Any exception that is propagated from this method to its caller will cancel the interceptor unregistration.