org.jboss.mx.interceptor
Interface Interceptor

All Known Subinterfaces:

SharedInterceptor (src)

All Known Implementing Classes:

AbstractInterceptor (src) , AbstractSharedInterceptor (src)

public interface Interceptor

This interface defines MBean interceptors. All MBean interceptors must implement this interface.

See Also:

AbstractInterceptor (src)

getName

public java.lang.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.

isShared

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.

Returns:

true if shared;false otherwise

invoke

public java.lang.Object invoke(Invocation (src)  invocation)
                        throws java.lang.Throwable

The invoke method is called when the invocation object passes this interceptor.

Throws:

java.lang.Throwable

setLogger

public void setLogger(Logger (src)  log)

Called by the MBeanInvoker (src) 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.

init

public void init()
          throws java.lang.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.

Throws:

java.lang.Exception - if you want to cancel the interceptor registration

start

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 MBeanRegistration.postRegister(java.lang.Boolean) 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.

stop

public void stop()
          throws java.lang.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 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.

Throws:

java.lang.Exception - if you want to cancel the interceptor unregistration

destroy

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 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.