Model Components
The API functional model consists of the following core components:
cim1265
The API functional model consists of the following core components:
- LifeCycle interface-- Provides custom objects with access to user-defined properties defined in the Management Console. The properties can be applicable to a single custom object, to the entireCA Identity Managerenvironment, or both.Also provides a custom object with basic implementations for startup and shutdown methods, and optionally, access to the managed object providers.LifeCycle methods are called whenCA Identity Managerstarts up the environment and loads objects (including custom objects), and also when the environment is shut down. These methods give the custom object an opportunity to connect to and disconnect from external objects, and to perform any other startup and shutdown operations that it might require.The base adapter classes for the individualCA Identity ManagerAPIs implement the LifeCycle interface.
- ServiceProvider interface-- ProvidesCA Identity ManagerAPIs with access to services such as password and encryption operations.
- ProviderAccessor interface-- Makes theCA Identity Managerproviders available to custom objects. The providers allow direct access to managed object data.
- TaskInfo interface-- Provides information about the current task -- for example, task creation time, the name and unique identifier of the administrator who is executing the task, and the organization where the task is being executed.
- Logger interface-- Lets a custom object log messages directly to the application server log.
- IMContext interface-- Extends the TaskInfo, ServiceProvider, ProviderAccessor, and Logger interfaces, and makes the methods in these interfaces available to the ...Context objects in the individual APIs.
- IMPersistentContext interface-- Allows custom objects to persist user-defined data within a task session, as follows:
- Between business logic task handlers for a given task (Business Logic Task Handler API).
- Across different states of an event (Event Listener API).
- Between different scripts for a given workflow activity (Workflow API).
- Between different types of custom objects for a given task (various APIs).For example, user-defined data can be set by a business logic task handler during the synchronous phase of task processing, and then retrieved by an event listener during the asynchronous phase of the same task session (Business Logic Task Handler API, Event Listener API).
Note:The persisted user-defined data is defined within the IMPersistentContext object. It is not the same user-defined data that is defined in the Management Console for a particular custom object or for theCA Identity Managerenvironment. - EventContext interface-- Provides read/write access to the managed object attributes in an event, and lets you generate secondary events. APIs that can implement this interface are the Event Listener API and Workflow API.This interface extends IMPersistentContext, which extends IMContext. This interface also serves as the base interface for context objects in the Event Listener API.
- EventROContext interface-- Provides read/write access to events. APIs that can implement this interface are the Participant Resolver API and Notification Rule API.This interface extends IMContext.
The individual
CA Identity Manager
APIs typically have the following types of components:- Adapter object-- EachCA Identity ManagerAPI has a base class called an adapter. The API-specific adapter implements the LifeCycle and Logger interfaces.The custom objects you create with theCA Identity ManagerAPIs extend this base class. An adapter object contains base implementation methods inherited from LifeCycle for startup and shutdown operations, and also API-specific methods.
- Context object-- EachCA Identity ManagerAPI has an API-specific context object, which is passed into the API’s adapter object. The context object inherits core methods through IMContext, either directly or indirectly. Consequently, the API’s context object contains information about the current task, and also provides access to logging methods and otherCA Identity Managerservices, including managed object retrieval from the data store.
Note:
For more information about these components and all CA Identity Manager
APIs, see the Javadoc Reference.