Package org.odpi.openmetadata.engineservices.governanceaction.handlers

Class GovernanceActionEngineHandler

java.lang.Object

org.odpi.openmetadata.governanceservers.enginehostservices.admin.GovernanceEngineHandler

org.odpi.openmetadata.engineservices.governanceaction.handlers.GovernanceActionEngineHandler

public class GovernanceActionEngineHandler
extends GovernanceEngineHandler

The GovernanceActionEngineHandler is responsible for running governance action services on demand. It is initialized with the configuration for the governance action services it supports along with the clients to the asset properties store and annotations store.

Field Summary

Fields inherited from class org.odpi.openmetadata.governanceservers.enginehostservices.admin.GovernanceEngineHandler

auditLog, configurationClient, engineActionClient, engineUserId, governanceEngineGUID, governanceEngineName, governanceEngineProperties, maxPageSize, serverName, serverUserId

Constructor Summary

Constructors

Constructor	Description
GovernanceActionEngineHandler(EngineConfig engineConfig, String localServerName, String partnerServerName, String partnerURLRoot, String serverUserId, GovernanceConfigurationClient configurationClient, GovernanceContextClient engineActionClient, GovernanceContextClient governanceContextClient, AuditLog auditLog, int maxPageSize)	Create a client-side object for calling a governance action engine.

Method Summary

Modifier and Type	Method	Description
void	publishWatchdogEvent(WatchdogGovernanceEvent watchdogGovernanceEvent)	Pass on the watchdog event to any governance service that supports them.
void	runGovernanceService(String engineActionGUID, String governanceRequestType, String requesterUserId, Date requestedStartDate, Map<String,String> requestParameters, List<RequestSourceElement> requestSourceElements, List<ActionTargetElement> actionTargetElements)	Run an instance of a governance action service in its own thread and return the handler (for disconnect processing).

Methods inherited from class org.odpi.openmetadata.governanceservers.enginehostservices.admin.GovernanceEngineHandler

executeEngineAction, getGovernanceEngineElement, getGovernanceEngineName, getServiceCache, getSummary, refreshConfig, refreshServiceConfig, restartGovernanceService, restartServices, startServiceExecutionThread, terminate, validateGovernanceEngineInitialized

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

GovernanceActionEngineHandler

public GovernanceActionEngineHandler(EngineConfig engineConfig,
 String localServerName,
 String partnerServerName,
 String partnerURLRoot,
 String serverUserId,
 GovernanceConfigurationClient configurationClient,
 GovernanceContextClient engineActionClient,
 GovernanceContextClient governanceContextClient,
 AuditLog auditLog,
 int maxPageSize)

Create a client-side object for calling a governance action engine. Notice there are two instances of the GovernanceContextClient. It is possible that they are pointing at different metadata server instances so do not consolidate them into one client (even if IntelliJ begs you to :)).

Parameters:

engineConfig - the unique identifier of the governance action engine.

localServerName - the name of the engine host server where the governance action engine is running

partnerServerName - name of partner server

partnerURLRoot - partner platform

serverUserId - user id for the server to use

configurationClient - client to retrieve the configuration

engineActionClient - client to control the execution of governance action requests

governanceContextClient - REST client for calls made by the governance action services

auditLog - logging destination

maxPageSize - maximum number of results that can be returned in a single request

Method Details

publishWatchdogEvent

public void publishWatchdogEvent(WatchdogGovernanceEvent watchdogGovernanceEvent)
                          throws InvalidParameterException

Pass on the watchdog event to any governance service that supports them.

Parameters:

watchdogGovernanceEvent - element describing the changing metadata data.

Throws:

InvalidParameterException - Vital fields of the governance action are not filled out

runGovernanceService

public void runGovernanceService(String engineActionGUID,
 String governanceRequestType,
 String requesterUserId,
 Date requestedStartDate,
 Map<String,String> requestParameters,
 List<RequestSourceElement> requestSourceElements,
 List<ActionTargetElement> actionTargetElements)
                          throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Run an instance of a governance action service in its own thread and return the handler (for disconnect processing).

Specified by:

runGovernanceService in class GovernanceEngineHandler

Parameters:

engineActionGUID - unique identifier of the engin action to run

governanceRequestType - governance request type to use when calling the governance engine

requesterUserId - original user requesting this governance service

requestedStartDate - date/time to start the governance action service

requestParameters - name-value properties to control the governance action service

requestSourceElements - metadata elements associated with the request to the governance action service

actionTargetElements - metadata elements that need to be worked on by the governance action service

Throws:

InvalidParameterException - one of the parameters is null or invalid.

UserNotAuthorizedException - access permissions problem

PropertyServerException - there was a problem detected by the governance action engine.