weblogic.wsee.deploy

Class WseeEjbModuleExtension

java.lang.Object

weblogic.application.ModuleExtension

weblogic.wsee.deploy.WseeEjbModuleExtension

All Implemented Interfaces:

UpdateListener

public class WseeEjbModuleExtension
extends ModuleExtension
implements UpdateListener

Excluded in public API Reference.

Nested Class Summary

Nested classes/interfaces inherited from interface weblogic.application.UpdateListener

UpdateListener.Registration

Field Summary

Fields

Modifier and Type	Field and Description
private static weblogic.diagnostics.debug.DebugLogger	debugLogger
private java.lang.String	moduleId
private java.lang.String	moduleURI
private WSEEEjbModule	wseeModule

Fields inherited from class weblogic.application.ModuleExtension

appCtx, extensibleModule, extensionCtx, modCtx

Constructor Summary

Constructors

Constructor and Description
WseeEjbModuleExtension(ModuleExtensionContext modExtCtx, ApplicationContextInternal appCtx, Module extensibleModule)

Method Summary

Modifier and Type	Method and Description
boolean	acceptURI(java.lang.String uri) Returns true if this UpdateListener recognizes this update uri
void	activateUpdate(java.lang.String uri) activateUpdate is called on Listener in the UPDATE PENDING state to activate a dynamic update.
private static void	debug(java.lang.String s)
private static void	debug(java.lang.String s, java.lang.Throwable t)
private boolean	myExtModulesURI(java.lang.String uri)
void	postActivate() Invoked after module has been activated
void	postDeactivate() Invoked after module has been deactivated
void	postPrepare(UpdateListener.Registration reg) Invoked after module has been prepared
void	preActivate() Invoked before module is activated
void	prepareUpdate(java.lang.String uri) prepareUpdate is called on Listener in the ACTIVE state to perform a dynamic update.
void	preUnprepare(UpdateListener.Registration reg) Invoked before module is unprepared
void	remove() Invoked after module has been removed
void	rollbackUpdate(java.lang.String uri) rollbackUpdate is called on Listeners in the UPDATE PENDING state to abort a pending dynamic update.
void	start() start is called on Module in the ACTIVATED state to perform any post-deployment initialization.
java.lang.String	toString()

Methods inherited from class weblogic.application.ModuleExtension

postAdminToProduction, postRefreshClassLoader, postUnprepare, preDeactivate, preForceProductionToAdmin, preGracefulProductionToAdmin, prePrepare, preRefreshClassLoader

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

debugLogger

private static final weblogic.diagnostics.debug.DebugLogger debugLogger

moduleId

private final java.lang.String moduleId

moduleURI

private final java.lang.String moduleURI

wseeModule

private WSEEEjbModule wseeModule

Constructor Detail

WseeEjbModuleExtension

public WseeEjbModuleExtension(ModuleExtensionContext modExtCtx,
                              ApplicationContextInternal appCtx,
                              Module extensibleModule)

Method Detail

postPrepare

public void postPrepare(UpdateListener.Registration reg)
                 throws ModuleException

Description copied from class: ModuleExtension

Invoked after module has been prepared

Overrides:

postPrepare in class ModuleExtension

Parameters:

reg - A module extension may register an update listener with reg to hear for dynamic update events

Throws:

ModuleException

preUnprepare

public void preUnprepare(UpdateListener.Registration reg)
                  throws ModuleException

Description copied from class: ModuleExtension

Invoked before module is unprepared

Overrides:

preUnprepare in class ModuleExtension

Parameters:

reg - Module extension must unregister an update listener with reg if the listener was registered during postPrepare

Throws:

ModuleException

preActivate

public void preActivate()
                 throws ModuleException

Description copied from class: ModuleExtension

Invoked before module is activated

Overrides:

preActivate in class ModuleExtension

Throws:

ModuleException

postActivate

public void postActivate()
                  throws ModuleException

Description copied from class: ModuleExtension

Invoked after module has been activated

Overrides:

postActivate in class ModuleExtension

Throws:

ModuleException

postDeactivate

public void postDeactivate()
                    throws ModuleException

Description copied from class: ModuleExtension

Invoked after module has been deactivated

Overrides:

postDeactivate in class ModuleExtension

Throws:

ModuleException

remove

public void remove()
            throws ModuleException

Description copied from class: ModuleExtension

Invoked after module has been removed

Overrides:

remove in class ModuleExtension

Throws:

ModuleException

start

public void start()
           throws ModuleException

Description copied from class: ModuleExtension

start is called on Module in the ACTIVATED state to perform any post-deployment initialization. It is equivalent to using a postStart ApplicationLifecycleListener.

If the start callback fails (by throwing a ModuleException or unchecked exception), the module remains in the ACTIVATED state and will then receive a deactivate callback

After start completes successfully, the module remains in the ACTIVATED state.

start callbacks should be used sparingly. If possible, module extensions should fail during the postPrepare callback rather than detecting errors in activate or start.

Overrides:

start in class ModuleExtension

Throws:

ModuleException - when start fails. The Deployment engine is responsible for logging this exception.

acceptURI

public boolean acceptURI(java.lang.String uri)

Description copied from interface: UpdateListener

Returns true if this UpdateListener recognizes this update uri

If the acceptURI returns true, the Application Container will call prepareUpdate and activateUpdate on this uri. If false is returned, the Application Container does not call this UpdateListener for this uri.

If no UpdateListener accepts this uri, the Application Container throws a DeploymentException indicating this update uri cannot be changed dynamically.

The uri is a relative path from the root of the application to some resource in the application. For EARs the uri is of the form, modulename/resource. Modulename must match the module's uri specified in the application.xml or weblogic-application.xml descriptor. For standalone modules the uri is just the resource path.

For XML modules such as JMS, JDBC and Interception modules, the resource must always be the module's descriptor. When app-scoped, the uri for the module is as specified in weblogic-application.xml.

For standalone XML modules the uri refers to the module's descriptor and may be ".", or the descriptor's path. The former case would imply an update operation involving a deployment plan. The latter case implies a partial redeploy, the provided path must resolve to the module descriptor specified in the application's AppDeploymentMBean.getSourcePath property.

Specified by:

acceptURI in interface UpdateListener

prepareUpdate

public void prepareUpdate(java.lang.String uri)
                   throws ModuleException

Description copied from interface: UpdateListener

prepareUpdate is called on Listener in the ACTIVE state to perform a dynamic update. The listener should perform as much validation as possible in prepareUpdate.

If the prepareUpdate callback fails by throwing a ModuleException or an unchecked exception, the Listener is transitioned back to the ACTIVE state. The Listener implementation should clean-up any internal state with regards to this update before throwing the exception.

After prepareUpdate completes successfully, the listener is in the UPDATE PENDING state.

Specified by:

prepareUpdate in interface UpdateListener

Throws:

ModuleException - when prepareUpdate fails. The Deployment engine is responsible for logging this exception.

activateUpdate

public void activateUpdate(java.lang.String uri)
                    throws ModuleException

Description copied from interface: UpdateListener

activateUpdate is called on Listener in the UPDATE PENDING state to activate a dynamic update. This method makes the update visible to the running listener. Ideally, the activateUpdate should NEVER fail. The Listener implementation should do all validation in prepareUpdate. This method throws no checked exceptions because failures should be avoided.

If the activateUpdate callback fails by throwing an unchecked exception, the application is unfortunately in a very bad state. The exception is propogated up the stack to the deployer and the application is taken down (undeployed).

After activateUpdate completes successfully, the listener is in the ACTIVE state.

Specified by:

activateUpdate in interface UpdateListener

Throws:

ModuleException

rollbackUpdate

public void rollbackUpdate(java.lang.String uri)

Description copied from interface: UpdateListener

rollbackUpdate is called on Listeners in the UPDATE PENDING state to abort a pending dynamic update. rollbackUpdate should NEVER fail. If an unchecked exception is thrown, the application is FORCED back to the ACTIVE state. Since the pending update should not have changed anything in the running Listener, this is presumed a safe transition.

After rollbackUpdate completes successfully, the listener is in the ACTIVE state.

Specified by:

rollbackUpdate in interface UpdateListener

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

myExtModulesURI

private boolean myExtModulesURI(java.lang.String uri)

debug

private static void debug(java.lang.String s)

debug

private static void debug(java.lang.String s,
                          java.lang.Throwable t)