public interface ArmApplicationDefinition extends ArmInterface
ArmTransactionDefinition
and ArmMetricDefinition
objects with the application.
It has the following attributes, all of which are immutable:
null
or zero-length. A name should be chosen that is unique,
so generic names that might be used by a different development team,
such as "Payroll Application", should not be used. Names should not
contain trailing blank characters or consist of only blank characters.
ArmIdentityProperties
.
null
, is the same value passed to
ArmTransactionFactory.newArmApplicationDefinition(java.lang.String, org.opengroup.arm40.transaction.ArmIdentityProperties, org.opengroup.arm40.transaction.ArmID)
. The ID
value is bound to a unique combination of the application name,
any identity property names and values, and any context property names.
When provided, the ID may be used as a concise alias for the unique
combination. It may be null
.
destroy()
does not, of course, destroy the
ArmApplicationDefinition
object. It does signal to the
ARM implementation that the definition and all related definitions
(e.g., ArmTransactionDefinition
) within its scope are
no longer needed. The normal behavior would be for the ARM implementation
to release its references to all those objects. If the application also
releases its references, the objects would be eligible for garbage
collection. After destroy()
is called, no method on any
object that is scoped by the ArmApplicationDefinition
should
be called again. If a method is called, the results are unpredictable.
Objects implementing this interface are created using
ArmTransactionFactory.newArmApplicationDefinition(java.lang.String, org.opengroup.arm40.transaction.ArmIdentityProperties, org.opengroup.arm40.transaction.ArmID)
.Modifier and Type | Method and Description |
---|---|
void |
destroy()
Signal to the ARM implementation that the definition and all related
definitions within its scope are no longer needed.
|
ArmID |
getID() |
ArmIdentityProperties |
getIdentityProperties() |
java.lang.String |
getName() |
getErrorCode, getErrorMessage, setErrorCode
void destroy()
java.lang.String getName()
ArmIdentityProperties getIdentityProperties()
null
.
See the discussion in ArmIdentityProperties
.ArmID getID()
null
.