org.opengroup.arm40.tranreport.ArmTranReportFactory Interface Reference
[ARM 4.0 Factories]

Provides methods to create instances of the classes in the org.opengroup.arm40.tranreport package. More...

Inheritance diagram for org.opengroup.arm40.tranreport.ArmTranReportFactory:
org.opengroup.arm40.transaction.ArmInterface

List of all members.

Public Member Functions

ArmApplicationRemote newArmApplicationRemote (ArmApplicationDefinition definition, String group, String instance, String[] contextValues, ArmSystemAddress systemAddress)
 Creates an ArmApplicationRemote.
ArmSystemAddress newArmSystemAddress (short format, byte[] addressBytes, ArmID id)
 Creates an ArmSystemAddress from the specified format and the input byte array.
ArmSystemAddress newArmSystemAddress (short format, byte[] addressBytes, int offset, ArmID id)
 Creates an ArmSystemAddress from the specified format and the input byte array.
ArmSystemAddress newArmSystemAddress (short format, byte[] addressBytes, int offset, int length, ArmID id)
 Creates an ArmSystemAddress from the specified format and the input byte array.
ArmTranReport newArmTranReport (ArmApplication app, ArmTransactionDefinition definition)
 Creates an object that represents an instance of a transaction.
boolean setErrorCallback (ArmErrorCallback errorCallback)
 Registers an error callback for objects created through this factory.

Static Public Attributes

static final String propertyKey = "Arm40.ArmTranReportFactory"
 name of system property holding the implementation class name.

Detailed Description

Provides methods to create instances of the classes in the org.opengroup.arm40.tranreport package.

An error callback method can be registered for objects created with this factory (see setErrorCallback(ArmErrorCallback)). For additional details about error handling philosophy see the description of org.opengroup.arm40.transaction.ArmTransactionFactory.

Semantics of the factory methods are provided in the description of the individual methods below.

ArmTranReportFactory is instantiated using a class loader. The actual name of the factory implementation class is obtained from the system property whose name is provided in the propertyKey constant.

Author:
ARM Working Group of The Open Group

Member Function Documentation

ArmApplicationRemote org.opengroup.arm40.tranreport.ArmTranReportFactory.newArmApplicationRemote ( ArmApplicationDefinition  definition,
String  group,
String  instance,
String[]  contextValues,
ArmSystemAddress  systemAddress 
)

Creates an ArmApplicationRemote.

If systemAddress is null, the addressing information for the local system is used.

See also:
org.opengroup.arm40.transaction.ArmApplication
Parameters:
definition metadata describing the type of the ARM application. Must not be null.
group Name of the group the application belongs to. May be null.
instance Name this application instance is given. May be null.
contextValues An array of strings providing the value parts of (name,value) context properties. May be null.
systemAddress address of the remote system the application is executing on.
Returns:
a new ArmApplicationRemote instance.
ArmSystemAddress org.opengroup.arm40.tranreport.ArmTranReportFactory.newArmSystemAddress ( short  format,
byte[]  addressBytes,
ArmID  id 
)

Creates an ArmSystemAddress from the specified format and the input byte array.

See the ArmSystemAddress description for more details about the parameters. The length of the address data is the length of addressBytes, if not restricted otherwise through the format parameter.

Parameters:
format the address format.
addressBytes a byte array containig the address data.
id An optional 16-byte ID associated with the identity of the ArmSystemAddress.
Returns:
a new ArmSystemAddress
ArmSystemAddress org.opengroup.arm40.tranreport.ArmTranReportFactory.newArmSystemAddress ( short  format,
byte[]  addressBytes,
int  offset,
int  length,
ArmID  id 
)

Creates an ArmSystemAddress from the specified format and the input byte array.

See the ArmSystemAddress description for more details about the parameters. The length of the address data is length, if not restricted otherwise through the format parameter.

Parameters:
format the address format.
addressBytes a byte array containig the address data.
id An optional 16-byte ID associated with the identity of the ArmSystemAddress.
offset start of the address bytes within the array.
length the number of bytes of valid address data.
Returns:
a new ArmSystemAddress
ArmSystemAddress org.opengroup.arm40.tranreport.ArmTranReportFactory.newArmSystemAddress ( short  format,
byte[]  addressBytes,
int  offset,
ArmID  id 
)

Creates an ArmSystemAddress from the specified format and the input byte array.

See the ArmSystemAddress description for more details about the parameters. The length of the address data is the length of addressBytes, if not restricted otherwise through the format parameter.

Parameters:
format the address format.
addressBytes a byte array containig the address data.
id An optional 16-byte ID associated with the identity of the ArmSystemAddress.
offset start of the address bytes within the array.
Returns:
a new ArmSystemAddress
ArmTranReport org.opengroup.arm40.tranreport.ArmTranReportFactory.newArmTranReport ( ArmApplication  app,
ArmTransactionDefinition  definition 
)

Creates an object that represents an instance of a transaction.

The metadata is supplied in an ArmTransactionDefinition object. It is scoped by an application instance, represented by ArmApplication (or its subclass, ArmApplicationRemote).

Parameters:
app the application instance the transaction belongs to.
definition the metadata describing the type of the transaction.
Returns:
a new ArmTranReport instance.
boolean org.opengroup.arm40.tranreport.ArmTranReportFactory.setErrorCallback ( ArmErrorCallback  errorCallback  ) 

Registers an error callback for objects created through this factory.

See the error handling philosophy comment in the description of org.opengroup.arm40.transaction.ArmTransactionFactory.

Parameters:
errorCallback an application object implementing the ArmErrorCallback interface.
Returns:
true if registration is accepted.

The documentation for this interface was generated from the following file:
  • org/opengroup/arm40/tranreport/ArmTranReportFactory.java