|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface PartitionManager
The PartitionManager interface provides the runtime support to create, remove, add, diable or remove a partition as the application developer requries. An instance is bound to the jndi space of a Partition Statless Session Bean. It allows partitions to be dynamically added and removed once the server is up and running.
Field Summary | |
---|---|
static int |
FAULT_GRACEFUL
The FAULT_GRACEFUL return value reflects that JVM is ok and this fault impacts this partition only. |
static int |
FAULT_PANIC
The FAULT_GRACEFUL return value reflects that JVM is compromized and should be dropped in total. |
static java.lang.String |
JNDI_NAME
This is the jndi name to find this instance in a partition handler EJB. |
Method Summary | |
---|---|
void |
addPartition(PartitionDefinition name)
This dynamically adds a new partition to the application with the specified name. |
PartitionDefinition |
createPartitionDefinition(java.lang.String partitionName)
This returns a partition definition with standard/default class. |
PartitionDefinition |
createPartitionDefinition(java.lang.String partitionName,
java.lang.String partitionClass,
PartitionScope scope)
This returns a partition definition with standard/default class. |
PartitionDefinition |
createPartitionDefinition(java.lang.String partitionName,
java.lang.String partitionClass,
PartitionScope scope,
java.util.Map attrMap)
This returns a partition definition with standard/default class. |
void |
disablePartition(java.lang.String name)
This dynamically disables a partition. |
java.lang.String |
getApplicationName()
This returns the application name used when installing the partitioned J2EE application. |
java.lang.String[] |
getPartitions()
This returns all the current partitions registered with an application. |
void |
removePartition(java.lang.String name)
This dynamically removes a partition from the application. |
void |
reportPartitionFault(java.lang.String partitionName,
int severity)
This can be called to report a fault with the operation of an active partition. |
void |
reportTransactionComplete(java.lang.String partitionName,
long responseTime_ms)
This should be called to inform the runtime when a transaction/operation completes on this partition. |
void |
reportTransactionFailed(java.lang.String partitionName)
This should be called to inform the runtime when a transaction/operation fails on this partition. |
void |
setHttpPartitionManager(com.ibm.websphere.http.wpf.interfaces.HttpPartitionManagerInterface manager)
This indicates to WPF that this application uses HTTP Partitioning. |
Field Detail |
---|
static final java.lang.String JNDI_NAME
static final int FAULT_GRACEFUL
static final int FAULT_PANIC
Method Detail |
---|
void addPartition(PartitionDefinition name)
name
- The new partition name.
java.lang.IllegalStateException
- If the calling application has no partition handler beanvoid removePartition(java.lang.String name) throws UnknownPartitionException
name
- The partition to remove.
java.lang.IllegalStateException
- If the calling application has no partition handler bean
UnknownPartitionException
- If this partition doesn't exist.void disablePartition(java.lang.String name) throws UnknownPartitionException
When the method is invoked, the partition will either enter a deactivated state or activate immediately on another cluster member capable of hosting the partition. The partition would be deactivated depending on the current policy settings, but by default activated on another cluster member if one is available. If partition is not automatically reactivated, wpfadmin can be used to enable the member once the administrator can review the logs and determine any action that should be done prior to reenabling the partition.
partitionUnloadEvent(...) is not called as the application will call this method and can clean as much as is possible prior to the ivocation.
name
- The partition to disable.
java.lang.IllegalStateException
- If the calling application has no partition handler bean
UnknownPartitionException
- If this partition doesn't exist.java.lang.String[] getPartitions()
java.lang.IllegalStateException
- If the calling application is not partitioned.java.lang.String getApplicationName()
void reportPartitionFault(java.lang.String partitionName, int severity)
partitionName
- The source partition detecting the fault.severity
- This needs to be one of FAULT_* report codes.
java.lang.IllegalStateException
- If the calling application has no partition handler beanvoid reportTransactionComplete(java.lang.String partitionName, long responseTime_ms)
partitionName
- the name of the partition.responseTime_ms
- the response time for the transaction.
java.lang.IllegalStateException
- If the calling application has no partition handler beanvoid reportTransactionFailed(java.lang.String partitionName)
partitionName
- PartitionDefinition createPartitionDefinition(java.lang.String partitionName) throws java.lang.IllegalArgumentException
partitionName
-
java.lang.IllegalArgumentException
- If the partition name is null.PartitionDefinition createPartitionDefinition(java.lang.String partitionName, java.lang.String partitionClass, PartitionScope scope) throws java.lang.IllegalArgumentException
partitionName
- The name of the partition.partitionClass
- The desired classification for it.scope
- Whether this partition is node or cluster scoped.
java.lang.IllegalArgumentException
- If any parameters are null.PartitionScope
PartitionDefinition createPartitionDefinition(java.lang.String partitionName, java.lang.String partitionClass, PartitionScope scope, java.util.Map attrMap) throws java.lang.IllegalArgumentException
partitionName
- The name of the partition.partitionClass
- The desired classification for it.scope
- Whether this partition is node or cluster scoped.Map
- of attributes (String key and value) pairs users can use associate for policy management.
java.lang.IllegalArgumentException
- If any parameters are null.PartitionScope
void setHttpPartitionManager(com.ibm.websphere.http.wpf.interfaces.HttpPartitionManagerInterface manager)
manager
- is the HttpPartitionManager instance.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |