Package org.odpi.openmetadata.frameworks.opengovernance.connectorcontext

Class NotificationManagerClient

java.lang.Object

org.odpi.openmetadata.frameworks.openmetadata.connectorcontext.ConnectorContextClientBase

org.odpi.openmetadata.frameworks.opengovernance.connectorcontext.NotificationManagerClient

public class NotificationManagerClient
extends ConnectorContextClientBase

NotificationHandler is the handler for managing notifications for notification types.

Field Summary

Fields inherited from class org.odpi.openmetadata.frameworks.openmetadata.connectorcontext.ConnectorContextClientBase

asOfTimeDefault, auditLog, connectorGUID, connectorUserId, egeriaRelease, externalSourceGUID, externalSourceIsHome, externalSourceName, forDuplicateProcessing, forLineage, governanceZonesFilterDefault, limitResultsByStatusDefault, localServerName, localServiceName, maxPageSize, parentContext, propertyHelper, sequencingOrderDefault, sequencingPropertyDefault, useCurrentEffectiveTime

Constructor Summary

Constructors

Constructor	Description
NotificationManagerClient(ConnectorContextBase parentContext, String localServerName, String localServiceName, String connectorUserId, String connectorGUID, String externalSourceGUID, String externalSourceName, OpenMetadataClient openMetadataClient, OpenGovernanceClient openGovernanceClient, AuditLog auditLog, int maxPageSize)	Constructor for connector context client.

Method Summary

Modifier and Type	Method	Description
List<OpenMetadataRootElement>	getMonitoredResources(String notificationTypeGUID, QueryOptions queryOptions)	Return the list of resources linked to the supplied notification type.
List<OpenMetadataRootElement>	getNotificationSubscribers(String notificationTypeGUID, QueryOptions queryOptions)	Return the list of subscribers linked to the supplied notification type.
void	notifySubscribers(String notificationTypeGUID, Map<String,ClassificationProperties> initialClassifications, NotificationProperties firstNotificationProperties, NotificationProperties nextNotificationProperties, NotificationProperties lastNotificationProperties, Map<String,String> requestParameters, String actionRequesterGUID, List<NewActionTarget> actionTargets)	Create a notification/action for the subscribers.

Methods inherited from class org.odpi.openmetadata.frameworks.openmetadata.connectorcontext.ConnectorContextClientBase

getAdditionalProperties, getConnectorGUID, getDeleteOptions, getDisplayName, getDisplayName, getDisplayName, getEffectiveTime, getEgeriaRelease, getGetOptions, getMakeAnchorOptions, getMaxPagingSize, getMetadataSourceOptions, getNewElementProperties, getQualifiedName, getQueryOptions, getQueryOptions, getQueryOptions, getQueryOptions, getSearchOptions, getSearchOptions, getSearchOptions, getUpdateOptions, isForDuplicateProcessing, isForLineage, isUseCurrentEffectiveTime, publishElement, setAsOfTimeDefault, setEffectiveTimeDefault, setExternalSource, setExternalSourceIsHome, setForDuplicateProcessing, setForLineage, setGovernanceZonesFilterDefault, setLimitResultsByStatusDefault, setSequencingOrderDefault, setUseCurrentEffectiveTime, withdrawElement

Methods inherited from class java.lang.Object

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

Constructor Details

NotificationManagerClient

public NotificationManagerClient(ConnectorContextBase parentContext,
 String localServerName,
 String localServiceName,
 String connectorUserId,
 String connectorGUID,
 String externalSourceGUID,
 String externalSourceName,
 OpenMetadataClient openMetadataClient,
 OpenGovernanceClient openGovernanceClient,
 AuditLog auditLog,
 int maxPageSize)

Constructor for connector context client.

Parameters:

parentContext - connector's context

localServerName - local server where this client is running - used for error handling

localServiceName - local service that his connector is hosted by - used for error handling

connectorUserId - the userId to use with all requests for open metadata

connectorGUID - the unique identifier that represents this connector in open metadata

externalSourceGUID - unique identifier of the software server capability for the source of metadata

externalSourceName - unique name of the software server capability for the source of metadata

openMetadataClient - client to access open metadata

openGovernanceClient - client to access open governance services

auditLog - logging destination

maxPageSize - max number of elements that can be returned on a query

Method Details

getMonitoredResources

public List<OpenMetadataRootElement> getMonitoredResources(String notificationTypeGUID,
 QueryOptions queryOptions)
                                                    throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Return the list of resources linked to the supplied notification type.

Parameters:

notificationTypeGUID - unique identifier of the notification type

queryOptions - options to control the query

Returns:

list of resources to monitor

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - a problem retrieving information from the property server(s).

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

notifySubscribers

public void notifySubscribers(String notificationTypeGUID,
 Map<String,ClassificationProperties> initialClassifications,
 NotificationProperties firstNotificationProperties,
 NotificationProperties nextNotificationProperties,
 NotificationProperties lastNotificationProperties,
 Map<String,String> requestParameters,
 String actionRequesterGUID,
 List<NewActionTarget> actionTargets)
                       throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Create a notification/action for the subscribers.

Parameters:

notificationTypeGUID - unique identifier of the cause for the action to be raised

initialClassifications - initial classifications to add to the action

firstNotificationProperties - properties for the first notification sent to this subscriber by this governance service instance

nextNotificationProperties - properties for a follow-on notification sent to this subscriber by this governance service instance

lastNotificationProperties - properties for the last notification sent to this subscriber by this governance service instance

requestParameters - firstNotificationProperties to pass to the next governance service

actionRequesterGUID - unique identifier of the source of the action

actionTargets - the list of elements that should be acted upon

Throws:

InvalidParameterException - the completion status is null

UserNotAuthorizedException - the governance action service is not authorized to update the governance action service status

PropertyServerException - a problem connecting to the metadata store

getNotificationSubscribers

public List<OpenMetadataRootElement> getNotificationSubscribers(String notificationTypeGUID,
 QueryOptions queryOptions)
                                                         throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Return the list of subscribers linked to the supplied notification type.

Parameters:

notificationTypeGUID - unique identifier of the notification type

queryOptions - options to control the query

Returns:

list of resources to monitor

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - a problem retrieving information from the property server(s).

UserNotAuthorizedException - the requesting user is not authorized to issue this request.