com.bea.wlcp.wlng.api.plugin.common
Class AbstractManagedPlugin

java.lang.Object
  com.bea.wlcp.wlng.api.plugin.ManagedPlugin
      com.bea.wlcp.wlng.api.plugin.common.AbstractManagedPlugin

All Implemented Interfaces:

ManagedPluginService, PluginInstance, PluginInstanceFactory, PluginService, PluginServiceLifecycle, com.incomit.slee.ServiceDeployable

Deprecated. Use ManagedPluginService instead. AbstractManagedPlugin is a helper class for implementing a PluginService. A plug-in that implements this interface will have one plug-in instance created if it registers any application facing or network facing interfaces.

public abstract class AbstractManagedPlugin

extends ManagedPlugin

implements com.incomit.slee.ServiceDeployable, ManagedPluginService

Field Summary

protected boolean	active Deprecated.
protected com.incomit.slee.ServiceContext	svcCtx Deprecated.
protected weblogic.workarea.WorkContextMap	wcm Deprecated.

Fields inherited from interface com.bea.wlcp.wlng.api.plugin.PluginInstance

MATCH_OPTIONAL, MATCH_REMOVE, MATCH_REQUIRED

Constructor Summary

AbstractManagedPlugin(java.lang.String[] supportedSchemes)
Deprecated.

Method Summary

void	activated() Deprecated.
ManagedPluginInstance	createInstance(java.lang.String pluginId) Deprecated.
void	deactivated() Deprecated.
void	doActivated() Deprecated.
void	doDeactivated() Deprecated.
void	doStarted() Deprecated.
void	doStopped() Deprecated.
java.lang.String	getId() Deprecated.
java.lang.String	getNetworkProtocol() Deprecated. Gives a descriptive name for the supported network protocol.
PluginPool	getPool() Deprecated.
abstract ServiceType	getServiceType() Deprecated.
void	handleForceSuspending() Deprecated. Called when a FORCE STOP/SHUTDOWN has been issued.
void	handleResuming() Deprecated.
void	handleSuspending(CompletionBarrier barrier) Deprecated.
void	init(java.lang.String id, PluginPool pool) Deprecated.
void	setServiceContext(com.incomit.slee.ServiceContext serviceContext) Deprecated.
void	started() Deprecated.
void	stopped() Deprecated.

Methods inherited from class com.bea.wlcp.wlng.api.plugin.ManagedPlugin

customMatch, customMatchCriteria, getNorthInterfaces, getSouthInterfaces, getSupportedSchemes, isActive, isConnected, isSchemeSupported, registerNorthInterface, registerNorthInterface, registerNorthInterfaceCallback, registerSouthInterface

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.bea.wlcp.wlng.api.plugin.PluginService

getSupportedSchemes

Field Detail

active

protected boolean active

Deprecated.

svcCtx

protected com.incomit.slee.ServiceContext svcCtx

Deprecated.

wcm

protected weblogic.workarea.WorkContextMap wcm

Deprecated.

Constructor Detail

AbstractManagedPlugin

public AbstractManagedPlugin(java.lang.String[] supportedSchemes)

Deprecated.

Method Detail

activated

public final void activated()
                     throws com.incomit.slee.ServiceDeploymentException

Deprecated.

Specified by:

activated in interface com.incomit.slee.ServiceDeployable

Throws:

com.incomit.slee.ServiceDeploymentException

createInstance

public ManagedPluginInstance createInstance(java.lang.String pluginId)
                                     throws DeploymentException

Deprecated.

Description copied from interface: PluginInstanceFactory

Creates a new instance for this plug-in.

Specified by:

createInstance in interface PluginInstanceFactory

Parameters:

pluginId - The id of the instance.

Returns:

A new plug-in instance.

Throws:

DeploymentException

deactivated

public final void deactivated()
                       throws com.incomit.slee.ServiceDeploymentException

Deprecated.

Specified by:

deactivated in interface com.incomit.slee.ServiceDeployable

Throws:

com.incomit.slee.ServiceDeploymentException

doActivated

public void doActivated()
                 throws DeploymentException

Deprecated.

Description copied from interface: PluginServiceLifecycle

The plug-in should continue activation and become visible without accepting traffic (register MBeans, etc).

Specified by:

doActivated in interface PluginServiceLifecycle

Throws:

DeploymentException - Exception during stop that will return the plug-in to STARTED state.

See Also:

PluginServiceLifecycle.doActivated().

doDeactivated

public void doDeactivated()
                   throws DeploymentException

Deprecated.

Description copied from interface: PluginServiceLifecycle

The plug-in should deactivate itself (unregister MBeans etc).

Specified by:

doDeactivated in interface PluginServiceLifecycle

Throws:

DeploymentException - Exception during deactivate that will return the plug-in to STARTED state.

See Also:

PluginServiceLifecycle.doDeactivated().

doStarted

public void doStarted()
               throws DeploymentException

Deprecated.

Description copied from interface: PluginServiceLifecycle

The plug-in should perform as much initialization as possible without being externally visible (read config data, create internal object, initialize stores, etc).

Specified by:

doStarted in interface PluginServiceLifecycle

Throws:

DeploymentException - Exception during start that will cause the plug-in to be returned to NEW state.

See Also:

PluginServiceLifecycle.doStarted().

doStopped

public void doStopped()
               throws DeploymentException

Deprecated.

Description copied from interface: PluginServiceLifecycle

The plug-in should clean up so it's available for garbage collection.

Specified by:

doStopped in interface PluginServiceLifecycle

Throws:

DeploymentException - Exception during stop that will return the plug-in to the NEW state.

See Also:

PluginServiceLifecycle.doStopped().

getId

public final java.lang.String getId()

Deprecated.

getNetworkProtocol

public java.lang.String getNetworkProtocol()

Deprecated.

Description copied from interface: PluginService

Gives a descriptive name for the supported network protocol. For example, "SMPP v3.4".

Specified by:

getNetworkProtocol in interface PluginService

Returns:

The supported network protocol.

getPool

public final PluginPool getPool()

Deprecated.

getServiceType

public abstract ServiceType getServiceType()

Deprecated.

Description copied from interface: PluginService

The plug-in must return its service type. It is used when registering the plug-in with the plug-in manager.

Specified by:

getServiceType in interface PluginService

Returns:

The service type

See Also:

PluginService.getServiceType().

handleForceSuspending

public void handleForceSuspending()

Deprecated.

Description copied from interface: PluginServiceLifecycle

Called when a FORCE STOP/SHUTDOWN has been issued. The plug-in shall make a best effort to close all network connections and clean up any resources used in order to minimize traffic loss. The plug-in transitions to the ACTIVE (ADMIN) state in which it should not process any traffic. It is up to the plug-in to transition all of its instances to the appropriate state.

Specified by:

handleForceSuspending in interface PluginServiceLifecycle

See Also:

PluginServiceLifecycle.handleForceSuspending().

handleResuming

public void handleResuming()
                    throws DeploymentException

Deprecated.

Description copied from interface: PluginServiceLifecycle

Transitions the plug-in from ACTIVE (ADMIN) to ACTIVE (RUNNING) state where it begins to accept traffic. The plug-in should begin the communication toward the network in a protocol-specfic way. It is up to the plug-in to transition all of its instances to the appropriate state.

Specified by:

handleResuming in interface PluginServiceLifecycle

Throws:

DeploymentException - This causes the current plug-in and others that are part of the same communication service to fail the transition into ACTIVE (RUNNING) state.

See Also:

PluginServiceLifecycle.handleResuming().

handleSuspending

public void handleSuspending(CompletionBarrier barrier)
                      throws DeploymentException

Deprecated.

Description copied from interface: PluginServiceLifecycle

Called in a normal re-deployment when the plug-in is taken from ACTIVE (RUNNING) to ACTIVE (ADMIN) state. Use the barrier to notify when all cleanup is done. The plug-in transitions to ADMIN state in which it should not process any traffic. It is up to the plug-in to transition all of its instances to the appropriate state. All the CompletionBarrierCllback objects must be obtained before this method returns. The actual completion can be signalled asynchronously.

Specified by:

handleSuspending in interface PluginServiceLifecycle

Parameters:

barrier - Used to register for a callback object that later should be called asynchronously to indicate that the plug-in has completed all in-flight traffic and is ready to be undeployed.

Throws:

DeploymentException - In case of internal errors.

See Also:

PluginServiceLifecycle.handleSuspending(com.bea.wlcp.wlng.api.plugin.CompletionBarrier).

init

public final void init(java.lang.String id,
                       PluginPool pool)

Deprecated.

Description copied from interface: PluginServiceLifecycle

Initializes the plug-in service with its id and a reference to its plug-in pool.

Specified by:

init in interface PluginServiceLifecycle

Parameters:

id - The id for this plug-in service.

pool - The pool associated with this plug-in. It can be used to retrieve registered plug-in instances.

setServiceContext

public final void setServiceContext(com.incomit.slee.ServiceContext serviceContext)

Deprecated.

Specified by:

setServiceContext in interface com.incomit.slee.ServiceDeployable

started

public final void started()
                   throws com.incomit.slee.ServiceDeploymentException

Deprecated.

Specified by:

started in interface com.incomit.slee.ServiceDeployable

Throws:

com.incomit.slee.ServiceDeploymentException

stopped

public final void stopped()
                   throws com.incomit.slee.ServiceDeploymentException

Deprecated.

Specified by:

stopped in interface com.incomit.slee.ServiceDeployable

Throws:

com.incomit.slee.ServiceDeploymentException