ArmErrorCallback

An error callback interface to be implemented by the application. (optional)

The use of ArmErrorCallback is optional.

ArmErrorCallback is different from all the other ARM interfaces because instead of the ARM implementation creating objects that implement the interface, the application creates an object that implements it. The application can create an ArmErrorCallback and register it with the setErrorCallback() method of one of the ARM factory classes. If the registration is accepted, anytime a method results in an error, the ARM implementation:

Sets the object's error code. This error code can be retrieved with the getErrorCode() method of ArmInterface, from which all other ARM interfaces with methods derive.
Calls errorCodeSet() in ArmErrorCallback, if an ArmErrorCallback has been successfully registered.
Returns the error code if the method that caused the error returns an error code.

There are no expected or required behaviors for the implementation of errorCodeSet().

Examples of things a callback method may do are:

Nothing.
Log an error. This would be a common behavior during program debug.
Reset the error code to zero, or set it to some other value. This is a way for an error handling policy to be implemented centrally, and communicated to the rest of the application code.
Author: ARM Working Group of The Open Group

Method Summary
void	errorCodeSet(ArmInterface errorObject, String interfaceName, String methodName) Callback method called by the ARM implementation.

Callback method called by the ARM implementation. All parameters must contain non-null values.

Parameters: errorObject a reference to the ARM implementation's object that detected the error. The callback method can use the getErrorCode() of errorObject to get the error code value, which will be negative. interfaceName the name of an interface in one of the ARM specification packages. methodName the name of a method in that interface.

Interface ArmErrorCallback

Method Detail

errorCodeSet