org.opengroup.arm40.transaction
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.
null
, is the same value passed to
ArmTransactionFactory. 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
.
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.
Method Summary | |
---|---|
void | destroy()
Signal to the ARM implementation that the definition and all related
definitions within its scope are no longer needed. |
ArmIdentityProperties | getIdentityProperties() |
ArmID | getID() |
String | getName() |
Returns: an object describing the identity property metadata
associated with this application, or null
.
See the discussion in ArmIdentityProperties.
Returns: a 16-byte ID associated with the identity of this
application definition, or null
.
Returns: the name of this application.