com.bmc.arsys.api
Interface ExtendedClassCallbackHandler

public interface ExtendedClassCallbackHandler

ExtendedClassCallbackHandler interface described the callback methods that an implementing class can receive, if the class were to be registered as an extending class for an AR System Java API class. ExtendedClassRegistry for more details about the registration mechanism.
These callback methods will be invoked at appropriate times, by the Java API internal implementation, whenever it instantiates an an object of the extended type.
Implementing this interface is optional and is needed only if:

• the client program implements some extended classes for some Java API classes (such as ActiveLink, AttachmentInfo, AssignFilterApiInfo and any others in the com.bmc.arsys.api package)
• register such classes as extended classes with the Java API;
• and finally, intends to receive callbacks as Java API instantiates an object of the extended type

Method Summary

void	afterFieldSet(Field field) [OPTIONAL: The client programs can implement this method simply with empty body, just to fullfill the interface.] This method will be called by the Java API, once per field, after the API implementation initializes that field value of a given extended class.
void	afterFieldsSet(Class whichClazz) [OPTIONAL: The client programs can implement this method simply with empty body, just to fullfill the interface.] This method will be called by the Java API when it traverses up the class hierarchy of a given extended class, once per class in the hierarchy after the API implementation initializes members of that class.
void	afterInstanceConstructed() This method will be invoked after Java API instantiates an object of extended type and after finishing the initialization of it.
void	beforeFieldSet(Field field) [OPTIONAL: The client programs can implement this method simply with empty body, just to fullfill the interface.] This method will be called by the Java API, once per field, before the API implementation attempts to initialize that field value of a given extended class.
void	beforeFieldsSet(Class whichClazz) [OPTIONAL: The client programs can implement this method simply with empty body, just to fullfill the interface.] This method will be called by the Java API when it traverses up the class hierarchy of a given extended class, once per class in the hierarchy and before the API implementation initializes members of that class.

Method Detail

afterInstanceConstructed

void afterInstanceConstructed()

This method will be invoked after Java API instantiates an object of extended type and after finishing the initialization of it. Usually client programs may want to implement this method, so that they can know when the instantiated object is ready to use.

beforeFieldsSet

void beforeFieldsSet(Class whichClazz)

[OPTIONAL: The client programs can implement this method simply with empty body, just to fullfill the interface.]

This method will be called by the Java API when it traverses up the class hierarchy of a given extended class, once per class in the hierarchy and before the API implementation initializes members of that class.

Parameters:

whichClazz -

beforeFieldSet

void beforeFieldSet(Field field)

[OPTIONAL: The client programs can implement this method simply with empty body, just to fullfill the interface.]

This method will be called by the Java API, once per field, before the API implementation attempts to initialize that field value of a given extended class.

Parameters:

field -

afterFieldSet

void afterFieldSet(Field field)

[OPTIONAL: The client programs can implement this method simply with empty body, just to fullfill the interface.]

This method will be called by the Java API, once per field, after the API implementation initializes that field value of a given extended class.

Parameters:

field -

afterFieldsSet

void afterFieldsSet(Class whichClazz)

[OPTIONAL: The client programs can implement this method simply with empty body, just to fullfill the interface.]

This method will be called by the Java API when it traverses up the class hierarchy of a given extended class, once per class in the hierarchy after the API implementation initializes members of that class.

Parameters:

whichClazz -