Programming Guide for Java › Business Logic Task Handler API › Calling Sequence › Example: Calling a Business Logic Task Handler

Example: Calling a Business Logic Task Handler

CA Identity Manager invokes any method implemented for a registered handler at the appropriate time. For example, this code fragment shows an implementation of the handleSetSubject() method to extract an administrator name before presenting the data to the user:

Example:

import com.netegrity.imapi.BLTHAdapter;
import com.netegrity.imapi.BLTHContext;
import com.netegrity.ims.exception.IMSException;

public class BLTHSetManager extends BLTHAdapter {
    public void handleSetSubject(BLTHContext blthContext) throws Exception {
        // get current administrator name
        String managerUniqueName = blthContext.getAdminUniqueName();
        if (managerUniqueName == null) {
            // this message will be presented on the screen
            IMSException imsEx = new IMSException();
            imsEx.addUserMessage("Failed to get administrator unique name");
            throw imsEx;
        }