com.bea.wlai.management.deployment
Interface AdapterDeploymentMBean

All Superinterfaces:

weblogic.management.configuration.ConfigurationMBean, javax.management.DynamicMBean, javax.management.MBeanRegistration, javax.management.NotificationBroadcaster, weblogic.management.WebLogicMBean

public interface AdapterDeploymentMBean

extends weblogic.management.configuration.ConfigurationMBean

MBean for managing Adapter deployment properties

Field Summary

Fields inherited from interface weblogic.management.configuration.ConfigurationMBean

CACHING_STUB_SVUID, DEFAULT_EMPTY_BYTE_ARRAY

Method Summary

void	autoSuspend() Internal use.
String	getAdapterID() ID of the Adapter this MBean represents as a string (derived from appName and getDescriptor().getQualifiedName().toString()).
Boolean	getAllowPoolToShrink(String factoryName) Is the pool for the named connection factory allowed to shrink in cases where it is sitting idle?
String	getAppName() Name of the J2EE application that contains the Adapter instance this MBean represents
Boolean	getAutoSuspendEnabled() Indicates if the auto-suspend feature is enabled for this adapter instance.
Integer	getAutoSuspendTimeout() The number of seconds AI should allow an auto-suspend to last.
Object	getCauseOfCurrentState() The throwable/exception or String explanation that caused the Adapter to be in the current state (‘Deploy Failed’ and ‘Suspended’ only) or null if the AppView is in none of these states.
String[]	getConnectionFactoryPolicy(String factoryName) Get a list of names of roles allowed to obtain connections from the named connection factory.
Properties	getConnectionFactoryProperties(String factoryName) Get the list of properties for named connection factory.
Integer	getDeployState() Logical status of this Adapter instance (‘Deployed’, ‘Undeployed’, ‘Deploying’, ‘Undeploying’, ‘Deploy Failed’, ‘Suspended’, ‘Suspending’ and ‘Resuming’).
String	getDescription() Description of this Adapter instance or null if none was given.
IAdapterDescriptor	getDescriptor() This attribute holds all the metadata known about the Adapter instance and can be serialized to/from an XML document (is also Serializable).
String[]	getInboundMessagingTargets() List of server (not cluster) names on which the inbound messaging section of the adapter instance will be activated.
String	getInheritedConnectionFactoryPolicy(String factoryName) Get a policy expression string inherited from the parent resource of the named connection factory.
Integer	getMaxPoolSize(String factoryName) Get the maximum number of connections to maintain in the pool for the named connection factory.
Integer	getMinPoolSize(String factoryName) Get the minimum number of connections to maintain in the pool for the named connection factory.
Properties	getProperties() Get the list of properties for this adapter instance.
String[]	getServerList() The list of servers (managed server names) on which this adapter instance is present (in some state that may be Deploying, Resuming, Undeploying, etc.).
Long	getTimeInCurrentState() The number of milliseconds this Adapter instance has been in its current state.
PrincipalMap	getWLSToEISPrincipalMap(String factoryName) Mappings from WLS user name to EIS user name and password.
boolean	isAutoSuspended() Was this Adapter instance auto-suspended.
String[]	listDependentApplicationViews() List all ApplicationViews (by ID) that depend on this adapter instance.
void	redeploy() Requests the transition of the Adapter instance into the undeployed state, immediately followed by a transition to the deployed state, on all servers in the serverList attribute.
void	resume() Requests the transition of the Adapter instance into the deployed state on all servers in the serverList attribute.
void	setAllowPoolToShrink(String factoryName, Boolean allow) Set whether the named connection factory pool is allowed to shrink.
void	setAutoSuspendEnabled(Boolean newValue) Set the auto-suspend as enabled or disabled for this adapter instance.
void	setAutoSuspendTimeout(Integer newValue) Get the number of seconds AI should allow an auto-suspend to last.
void	setConnectionFactoryPolicy(String factoryName, String[] roles) Set the list of names of roles allowed to obtain connections from the named connection factory.
void	setConnectionFactoryProperties(String factoryName, Properties props) Set the connection properties for the named connection factory.
void	setInboundMessagingTargets(String[] newValue) Set the targets for the inbound messaging component of this adapter instance.
void	setMaxPoolSize(String factoryName, Integer size) Set the maximum number of connections to maintain in the pool for the named connection factory * @param factoryName the name of the connection factory (within this adapter instance) for which the max pool size is being set.
void	setMinPoolSize(String factoryName, Integer size) Set the minimum pool size for the named connection factory.
void	setProperties(Properties props) Set the properties for this adapter instance.
void	setWLSToEISPrincipalMap(String factoryName, PrincipalMap newValue) Set the principal map to use for the named connection factory.
void	suspend() Requests the transition of the Adapter instance into the suspended state on all servers in the serverList attribute.

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean

freezeCurrentValue, getAttributeStringValue, getComments, getNotes, getSetFields, getXml, getXmlConverter, isDefaultedMBean, isPersistenceEnabled, preDeregister, registerConfigMBean, restoreDefaultValue, setComments, setDefaultedMBean, setNotes, setPersistenceEnabled, touch, unRegisterConfigMBean

Methods inherited from interface weblogic.management.WebLogicMBean

getMBeanInfo, getName, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setName, setParent

Methods inherited from interface javax.management.DynamicMBean

getAttribute, getAttributes, invoke, setAttribute, setAttributes

Methods inherited from interface javax.management.MBeanRegistration

postDeregister, postRegister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Method Detail

getDeployState

public Integer getDeployState()

Logical status of this Adapter instance (‘Deployed’, ‘Undeployed’, ‘Deploying’, ‘Undeploying’, ‘Deploy Failed’, ‘Suspended’, ‘Suspending’ and ‘Resuming’).

getCauseOfCurrentState

public Object getCauseOfCurrentState()

The throwable/exception or String explanation that caused the Adapter to be in the current state (‘Deploy Failed’ and ‘Suspended’ only) or null if the AppView is in none of these states.

getTimeInCurrentState

public Long getTimeInCurrentState()

The number of milliseconds this Adapter instance has been in its current state.

getAdapterID

public String getAdapterID()

ID of the Adapter this MBean represents as a string (derived from appName and getDescriptor().getQualifiedName().toString()). Note, the QualifiedName is available via the descriptor attribute.

getAppName

public String getAppName()

Name of the J2EE application that contains the Adapter instance this MBean represents

getDescriptor

public IAdapterDescriptor getDescriptor()

This attribute holds all the metadata known about the Adapter instance and can be serialized to/from an XML document (is also Serializable). The descriptors (IConnectionFactoryDescriptor) for each connection factory in the adapter instance are available from this object. NOTE: The property set on the IAdapterDescriptor and the individual IConnectionFactoryDescriptors within it are writeable. Any change to these properties will require a redeploy of the adapter instance for them to take effect.

getServerList

public String[] getServerList()

The list of servers (managed server names) on which this adapter instance is present (in some state that may be Deploying, Resuming, Undeploying, etc.).

isAutoSuspended

public boolean isAutoSuspended()

Was this Adapter instance auto-suspended. If the Adapter instance is not in the suspended state, this returns false. The cause of the auto-suspend is available via getCauseOfCurrentState().

getDescription

public String getDescription()

Description of this Adapter instance or null if none was given. Note, available via the descriptor attribute as well, but separated out for efficient summary display.

getWLSToEISPrincipalMap

public PrincipalMap getWLSToEISPrincipalMap(String factoryName)

Mappings from WLS user name to EIS user name and password. If the client using the named connection factory has container-managed sign-on enabled, having a non-null, non-empty wlsToEISPrincipalMap will cause the connection factory to authenticate connections using the mapped EIS user name anytime the current user within WLS has a WLS user name for which there is a mapping. NOTE: This property is persistent. It will be stored in the WLS credential mapper just like the WLS console stores principal maps for RAR deployments.

Parameters:

factoryName - The name of the connection factory (within this adapter instance) for which the PrincipalMap is being obtained.

setWLSToEISPrincipalMap

public void setWLSToEISPrincipalMap(String factoryName,
                                    PrincipalMap newValue)

Set the principal map to use for the named connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the PrincipalMap is being set.

newValue - The new PrincipalMap to assign to the named connection factory.

See Also:

getWLSToEISPrincipalMap(String factoryName)

getProperties

public Properties getProperties()

Get the list of properties for this adapter instance. The use of any given property, and the number and type of individual properties is adapter specific. However, in general, properties on the adapter instance are used to configure overall adapter instance behavior, and to configure inbound messaging (including the EIS instance from which messages will be delivered).

setProperties

public void setProperties(Properties props)

Set the properties for this adapter instance.

Parameters:

props - The new properties for this adapter instance

See Also:

getProperties()

getMinPoolSize

public Integer getMinPoolSize(String factoryName)

Get the minimum number of connections to maintain in the pool for the named connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the min pool size is being retrieved.

setMinPoolSize

public void setMinPoolSize(String factoryName,
                           Integer size)

Set the minimum pool size for the named connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the min pool size is being set.

See Also:

getMinPoolSize(String factoryName)

getMaxPoolSize

public Integer getMaxPoolSize(String factoryName)

Get the maximum number of connections to maintain in the pool for the named connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the max pool size is being retrieved.

setMaxPoolSize

public void setMaxPoolSize(String factoryName,
                           Integer size)

Set the maximum number of connections to maintain in the pool for the named connection factory * @param factoryName the name of the connection factory (within this adapter instance) for which the max pool size is being set.

See Also:

getMaxPoolSize(String factoryName)

getAllowPoolToShrink

public Boolean getAllowPoolToShrink(String factoryName)

Is the pool for the named connection factory allowed to shrink in cases where it is sitting idle?

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the pool shrink value is being retrieved.

setAllowPoolToShrink

public void setAllowPoolToShrink(String factoryName,
                                 Boolean allow)

Set whether the named connection factory pool is allowed to shrink.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the pool shrink value is being set.

See Also:

getAllowPoolToShrink(String factoryName)

getConnectionFactoryProperties

public Properties getConnectionFactoryProperties(String factoryName)

Get the list of properties for named connection factory. The use of any given property, and the number and type of individual properties is adapter specific. However, in general, properties on the connection factory are used to configure connection properties for connections that will be created by and stored in the connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the properties are being retrieved.

setConnectionFactoryProperties

public void setConnectionFactoryProperties(String factoryName,
                                           Properties props)

Set the connection properties for the named connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the properties are being set.

See Also:

getConnectionFactoryProperties(String factoryName)

getInboundMessagingTargets

public String[] getInboundMessagingTargets()

List of server (not cluster) names on which the inbound messaging section of the adapter instance will be activated. If this property is null or empty, the inbound messaging section of the adapter instance will be initialized on all servers on which this adapter instance is deployed. Note, specifying a server/cluster name in this list that is not also in the serverList property has no effect. In other words, the servers/clusters on which to activate the inbound messaging section of the adapter instance is the union of the serverList and inboundMessagingTargets properties.

setInboundMessagingTargets

public void setInboundMessagingTargets(String[] newValue)
                                throws javax.management.InvalidAttributeValueException

Set the targets for the inbound messaging component of this adapter instance. The targets list is a comma-separated list, and has no effect if this adapter instance has not been configured for inbound messaging at design-time.

Parameters:

newValue - A comma-separated list of targets on which to activate inbound messaging for this adapter instance.

Throws:

javax.management.InvalidAttributeValueException

See Also:

getInboundMessagingTargets(), IAdapterDescriptor.isInboundMessagingEnabled()

getAutoSuspendEnabled

public Boolean getAutoSuspendEnabled()

Indicates if the auto-suspend feature is enabled for this adapter instance. If so, this adapter instance may be auto-suspended if requested by its inbound messaging section.

setAutoSuspendEnabled

public void setAutoSuspendEnabled(Boolean newValue)

Set the auto-suspend as enabled or disabled for this adapter instance.

See Also:

getAutoSuspendEnabled()

getAutoSuspendTimeout

public Integer getAutoSuspendTimeout()

The number of seconds AI should allow an auto-suspend to last. After this number of seconds, the adapter instance will be resumed. Specify –1 to indicate an infinite suspend timeout.

setAutoSuspendTimeout

public void setAutoSuspendTimeout(Integer newValue)

Get the number of seconds AI should allow an auto-suspend to last.

See Also:

getAutoSuspendTimeout()

suspend

public void suspend()

Requests the transition of the Adapter instance into the suspended state on all servers in the serverList attribute.

autoSuspend

public void autoSuspend()

Internal use. Causes adapter instance to be suspended, and indicates it was auto-suspended.

resume

public void resume()

Requests the transition of the Adapter instance into the deployed state on all servers in the serverList attribute.

redeploy

public void redeploy()

Requests the transition of the Adapter instance into the undeployed state, immediately followed by a transition to the deployed state, on all servers in the serverList attribute. This will allow changes to the metadata for the adapter instance to be picked up by the newly deployed adapter instance.

getConnectionFactoryPolicy

public String[] getConnectionFactoryPolicy(String factoryName)

Get a list of names of roles allowed to obtain connections from the named connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the policy is being retrieved.

setConnectionFactoryPolicy

public void setConnectionFactoryPolicy(String factoryName,
                                       String[] roles)

Set the list of names of roles allowed to obtain connections from the named connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the policy is being set.

roles - An array of role names that are allowed to obtain connections from the named connection factory.

See Also:

getConnectionFactoryPolicy(String factoryName)

getInheritedConnectionFactoryPolicy

public String getInheritedConnectionFactoryPolicy(String factoryName)

Get a policy expression string inherited from the parent resource of the named connection factory.

Parameters:

factoryName - the name of the connection factory (within this adapter instance) for which the inherited policy is being retrieved.

listDependentApplicationViews

public String[] listDependentApplicationViews()

List all ApplicationViews (by ID) that depend on this adapter instance.