|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
MBean for managing properties of a particular type of process. This mbean exposes
certain configurable properties of a process type and allows them to be dynamically changed.
There is one instance of ProcessConfigurationMBean for each service type.
Use ProcessRuntimeMBean
to manage instances of a process.
Field Summary | |
static long |
CACHING_STUB_SVUID
The magic number that is used to generate the serialVersionUID of the generated MBean Stub (xxxMBean_Stub). |
Fields inherited from interface weblogic.management.configuration.ConfigurationMBean |
DEFAULT_EMPTY_BYTE_ARRAY |
Method Summary | |
long |
getActivationTime()
Return the activation time in seconds since 1/1/1970 GMT. |
String |
getAppName()
Returns the application name where this process is deployed. |
ArchivingPolicy |
getArchivingPolicy()
Returns the archiving policy for this process. |
boolean |
getB2BInboundFlag()
get flag on whether a process type whose instance will be started by a B2B(either ebXML or RN) message. |
boolean |
getB2BOutboundFlag()
get flag on whether a process type has a B2B(either ebXML or RN) control. |
String |
getCallbackClassName()
Returns the class name for the client callback if there is any. |
Set |
getControlCallbackPolicy(String controlId)
Returns the callback authorization policy for a given control. |
long |
getDeactivationTime()
Returns the deactivation time in seconds since 1/1/1970 GMT. |
String |
getDeploymentId()
Return id which is different for each deployment of this process. |
String |
getDescription()
Returns the description for this process type. |
String |
getDisplayName()
Returns the display name. |
String |
getEjbModuleName()
Returns the ejb module name for this jpd. |
String[] |
getExternalCallbackControls()
Returns the names of all controls in this process which are externall callback targets. |
String |
getFlowTag()
Returns the flow definiton in String format. |
String |
getInheritedPolicy(String methodName)
Returns the effective authorization policy expression for the given method when no policy has been explicitly assigned to the method. |
Map |
getMethodControlInfo()
Return info about a method's associated control. |
Set |
getMethodPolicy(String methodName)
Returns the method authorization policy. |
ProcessNodeInfo[] |
getNodes()
Returns an array of all the nodes in the process definition. |
ProcessNodeInfo[] |
getNodes(int type)
Returns an array of nodes of a certain type. |
Set |
getProcessPolicy()
Returns the process-level authorization policy. |
ProcessVariable |
getProcessVariable(String varName)
Returns the type information for the given process variable. |
ProcessVariable[] |
getProcessVariables()
Returns type information about process variables (excluding controls, callbacks, and other special variables). |
String |
getPublicURI()
Returns the public URI of this process type. |
String |
getRelativeEJBPath()
Returns the relative EJB path where the ejb for this process resides. |
String |
getRunAs()
Returns the run-as attribute for this process. |
String |
getServiceURI()
Returns the service of the process type represented by this MBean. |
URL |
getServiceURL()
Returns the service URL for this process. |
long |
getSLA()
Returns the SLA in milliseconds. |
double |
getSLAWarningThreshold()
Returns the SLA warning threshold as fraction of the actual SLAin milliseconds. |
TrackingLevel |
getTrackingLevel()
Returns the tracking level for this process. |
String |
getTypeName()
Returns the type name (name of the class implementing this process). |
VariableTracking |
getVariableTracking()
Returns the variable tracking level for this process. |
String |
getWebappName()
Returns the name of the webapp where this process is deployed. |
boolean |
hasDeclarativeAuthorization()
Returns true if: 1) there is a roles-allowed annotation at the class level, 2) there is a callback-roles-allowed annotation at the class level or, 3) there is a roles-allowed annotation on at least one method in this process. |
boolean |
isExecutionPolicyModifiable()
Returns false if there is a common:security annotation on the jpd file, otherwise returns true. |
boolean |
isRunnable()
Returns whether the process is runnable. |
boolean |
isServiceExists()
Returns whether the process represented by this MBean has been compiled and a disp structure exists for it. |
boolean |
isSinglePrincipalRequired()
Returns true iff this process requires that all incoming client requests come from the same principal. |
boolean |
isStateless()
Returns whether the process is stateless. |
boolean |
isVersioned()
Returns true if this process is part of a version group. |
void |
resetState()
Re-initializes the MBean state. |
void |
setActivationAttributes(boolean runnable,
long activationTime,
long deactivationTime)
Set all activation attributes for the process. |
void |
setActivationTime(long time)
Set the activation time in seconds since 1/1/1970 GMT. |
void |
setArchivingPolicy(ArchivingPolicy archivingPolicy)
Sets the archiving policy for this process type. |
void |
setControlCallbackPolicy(String controlId,
Set roles)
Sets the callback authorization policy for a given control. |
void |
setDeactivationTime(long time)
Set the deactivation time in seconds since 1/1/1970 GMT. |
void |
setDisplayName(String displayName)
Sets the display name. |
void |
setMethodPolicy(String methodName,
Set roles)
Sets the method authorization policy. |
void |
setProcessPolicy(Set roles)
Sets the process-level authorization policy. |
void |
setRunAs(String runAs)
Sets the run-as attribute for this process. |
void |
setRunnable(boolean runnable)
Enable or disable process. |
void |
setSinglePrincipalRequired(boolean flag)
Sets the single-principal flag for this process. |
void |
setSLA(long sla)
Sets the SLA. |
void |
setSLAWarningThreshold(double ratio)
Sets the SLA warning threshold. |
void |
setTrackingLevel(TrackingLevel trackingLevel)
Sets the tracking level for this process type. |
void |
setVariableTracking(VariableTracking variableTrackingLevel)
Sets the variable tracking level for this process type. |
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 |
Field Detail |
public static final long CACHING_STUB_SVUID
- remove an existing method.
- change the signature of an existing "getter" or "setter" method.
- change the signature of an existing "boolean getter", i.e, "boolean isEnabled()"
Otherwise you don't need to change this value. For instance you can add new methods, or you can change the signature of methods that don't start with "get", "set" or "is". If you are in doubt then change the SVUID. It is a good idea to increment this value when changing.
Method Detail |
public String getServiceURI()
public URL getServiceURL() throws ProcessNotFoundException
ProcessNotFoundException
public long getSLA() throws javax.management.MBeanException
javax.management.MBeanException
public double getSLAWarningThreshold() throws javax.management.MBeanException
javax.management.MBeanException
public String getDescription() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic String getDisplayName() throws javax.management.MBeanException
javax.management.MBeanException
public TrackingLevel getTrackingLevel() throws javax.management.MBeanException
javax.management.MBeanException
public ArchivingPolicy getArchivingPolicy() throws javax.management.MBeanException
javax.management.MBeanException
public VariableTracking getVariableTracking() throws javax.management.MBeanException
javax.management.MBeanException
public String getAppName() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic String getWebappName() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic String getRelativeEJBPath() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic String getTypeName() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic ProcessVariable[] getProcessVariables() throws javax.management.MBeanException, ProcessNotFoundException
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
public ProcessVariable getProcessVariable(String varName) throws javax.management.MBeanException, ProcessNotFoundException
varName
- name of the variable
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
public String getFlowTag() throws ProcessNotFoundException, ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic String getPublicURI()
public void setActivationAttributes(boolean runnable, long activationTime, long deactivationTime)
runnable
- is this process runnable?activationTime
- time from which the process will be active.
(in seconds since 1/1/1970 GMT)deactivationTime
- time at which the process cease to be active.
(in seconds since 1/1/1970 GMT)public long getActivationTime()
public void setActivationTime(long time)
time
- time in seconds since 1/1/1970 GMT.public long getDeactivationTime()
public void setDeactivationTime(long time)
time
- deactivation time in seconds since 1/1/1970public boolean isRunnable()
public void setRunnable(boolean runnable)
public boolean isStateless() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic boolean isVersioned()
true
if this process is part of a version group.
public boolean isServiceExists()
public ProcessNodeInfo[] getNodes() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic ProcessNodeInfo[] getNodes(int type) throws ProcessNotFoundException
type
- the type of the nodes to be returned. Types are defined in com.bea.wli.bpm.common.NodeTypes
ProcessNotFoundException
- if the process is not foundpublic void setSLA(long sla) throws javax.management.MBeanException
sla
- SLA in milliseconds. A value that is less than or equal to 0 unsets the SLA
javax.management.MBeanException
public void setSLAWarningThreshold(double ratio) throws javax.management.MBeanException
ratio
- SLA warning threshold as a fraction of actual SLA. A value that is less than
or equal to 0 unsets the SLA warning.
javax.management.MBeanException
public void setDisplayName(String displayName) throws javax.management.MBeanException
javax.management.MBeanException
public void setTrackingLevel(TrackingLevel trackingLevel) throws javax.management.MBeanException, javax.management.InvalidAttributeValueException, ProcessNotFoundException
trackingLevel
- the new tracking level.
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
javax.management.InvalidAttributeValueException
public void setVariableTracking(VariableTracking variableTrackingLevel) throws javax.management.MBeanException, javax.management.InvalidAttributeValueException, ProcessNotFoundException
variableTrackingLevel
- the new variable tracking level.
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
javax.management.InvalidAttributeValueException
public void setArchivingPolicy(ArchivingPolicy archivingPolicy) throws javax.management.MBeanException, javax.management.InvalidAttributeValueException
archivingPolicy
- the new archiving policy.
javax.management.MBeanException
javax.management.InvalidAttributeValueException
public String getCallbackClassName() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic Map getMethodControlInfo() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic String getDeploymentId() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic boolean hasDeclarativeAuthorization() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic Set getProcessPolicy() throws javax.management.MBeanException, ProcessNotFoundException
setMethodPolicy(java.lang.String, java.util.Set)
).
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
public void setProcessPolicy(Set roles) throws javax.management.MBeanException, ProcessNotFoundException
setMethodPolicy(java.lang.String, java.util.Set)
).
Calling this method with an empty array clears the process policy.
If there are any roles-allowed annotations on the jpd file,
authorization policies cannot be dynamically set.
NOTE: when changing the process policy, any roles in the new
process policy which were not present in the overwritten
process policy are automatically added to all method
policies. On the other hand, dropping roles from the process
policy does not cause any side-effect on the method policies.
roles
- an array of role names.
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
- if policies are read-only.public Set getMethodPolicy(String methodName) throws javax.management.MBeanException, ProcessNotFoundException, NoSuchMethodException
methodName
-
ProcessNotFoundException
- if the process is not found
NoSuchMethodException
- if there is no method by the given name.
javax.management.MBeanException
public String getInheritedPolicy(String methodName) throws javax.management.MBeanException, ProcessNotFoundException, NoSuchMethodException
methodName
-
ProcessNotFoundException
- if the process is not found
NoSuchMethodException
- if there is no method by the given name.
javax.management.MBeanException
public void setMethodPolicy(String methodName, Set roles) throws javax.management.MBeanException, ProcessNotFoundException, NoSuchMethodException
methodName
- roles
- an array of role names, or an empty array.
javax.management.MBeanException
- if policies are read-only
NoSuchMethodException
- or if there is no method by the given name.
ProcessNotFoundException
- if the process is not foundpublic String[] getExternalCallbackControls() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic Set getControlCallbackPolicy(String controlId) throws javax.management.MBeanException, ProcessNotFoundException
controlId
- the id of an external callback target control on this process.
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
- if there is any other error getting the policypublic void setControlCallbackPolicy(String controlId, Set roles) throws javax.management.MBeanException, ProcessNotFoundException
controlId
- the id of an external callback target control on this process.roles
- the set of roles authorized at the control callback points.
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
- if policies are read-only, or if there
is no externall callback target control by the given controlId.public boolean isExecutionPolicyModifiable() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic String getRunAs() throws javax.management.MBeanException, ProcessNotFoundException
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
public void setRunAs(String runAs) throws javax.management.MBeanException, ProcessNotFoundException
null
argument
represents the "callers-identity" execution policy (this is the default policy).
Note that if there is a common:security
annotation on the jpd file, then the run-as attribute is read-only and
any attempt to call this method will throw an exception.
runAs
- either "<start-user>", a WLS username or null.
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
- if the argument is invalid or if there is a
common:security annotation in the jpd file.public boolean isSinglePrincipalRequired() throws javax.management.MBeanException, ProcessNotFoundException
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
public void setSinglePrincipalRequired(boolean flag) throws javax.management.MBeanException, ProcessNotFoundException
flag
- the new single-principal flag
ProcessNotFoundException
- if the process is not found
javax.management.MBeanException
- if there is already a single-principal annotation
on the jpd.public boolean getB2BInboundFlag() throws ProcessNotFoundException
ProcessNotFoundException
public boolean getB2BOutboundFlag() throws ProcessNotFoundException
ProcessNotFoundException
- if the process is not foundpublic void resetState() throws javax.management.MBeanException
javax.management.MBeanException
public String getEjbModuleName()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |