Developing a governance notification plug-in

A WSRR governance notification plug-in is written as a Java™ class that implements the com.ibm.serviceregistry.governance.ServiceRegistryGovernanceNotifier interface, the com.ibm.serviceregistry.governance.ServiceRegistryGovernanceNotifier2 interface, or the com.ibm.serviceregistry.governance.ServiceRegistryGovernanceNotifier3 interface.

The ServiceRegistryGovernanceNotifier2 and ServiceRegistryGovernanceNotifier3 interfaces extend the original ServiceRegistryGovernanceNotifier interface and provide additional functionality.

The ServiceRegistryGovernanceNotifier interface extends the base WSRR ServiceRegistryNotifier interface and the notifier plug-in class must therefore implement the create(), update() and delete() methods described previously, although you can choose to do nothing for these operations. In addition, one extra method, transition(), must be implemented in respect of the ServiceRegistryGovernanceNotifier interface, and a further three methods, makeGovernable(), removeGovernance() and validate(), in respect of the ServiceRegistryGovernanceNotifier2 interface. Implementing the ServiceRegistryGovernanceNotifier3 interface requires a stageChanged method. These methods have a void return type, because they are invoked after a WSRR operation has completed.

Each method includes a Boolean success parameter and a ServiceRegistryException exception parameter. If the corresponding operation completes successfully, the success parameter will be true and the exception parameter will be null. If the operation fails, the success parameter will be false and the exception parameter will contain the exception that caused the failure.

The governance notification plug-ins are invoked only for objects that are currently part of a governed lifecycle.