Package org.odpi.openmetadata.accessservices.assetcatalog.eventclient

Class AssetCatalogEventClient

java.lang.Object

org.odpi.openmetadata.accessservices.assetcatalog.eventclient.AssetCatalogEventClient

public class AssetCatalogEventClient
extends Object

AssetCatalogEventClient provides the implementation to manage the interaction with the server to set up a listener to support the receipt of inbound events from the Asset Catalog OMAS Out Topic.

Constructor Summary

Constructors

Constructor	Description
AssetCatalogEventClient(String serverName, String serverPlatformURLRoot, String callerId)	Create a new client with no authentication embedded in the HTTP request.
AssetCatalogEventClient(String serverName, String serverPlatformURLRoot, String userId, String password, String callerId)	Create a new client that passes userId and password in each HTTP request.
AssetCatalogEventClient(String serverName, String serverPlatformURLRoot, OCFRESTClient restClient, int maxPageSize, AuditLog auditLog, String callerId)	Create a new client that is to be used within an OMAG Server.

Method Summary

Modifier and Type	Method	Description
String	getConfigurationServerName()	Return the name of the server where configuration is supposed to be stored.
void	registerListener(String userId, AssetCatalogEventListener listener)	Register a listener object that will be passed each of the events published by the Asset Catalog OMAS.

Methods inherited from class java.lang.Object

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

Constructor Detail

AssetCatalogEventClient

public AssetCatalogEventClient(String serverName,
                               String serverPlatformURLRoot,
                               String callerId)
                        throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

callerId - unique identifier of the caller

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

AssetCatalogEventClient

public AssetCatalogEventClient(String serverName,
                               String serverPlatformURLRoot,
                               String userId,
                               String password,
                               String callerId)
                        throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

callerId - unique identifier of the caller

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

AssetCatalogEventClient

public AssetCatalogEventClient(String serverName,
                               String serverPlatformURLRoot,
                               OCFRESTClient restClient,
                               int maxPageSize,
                               AuditLog auditLog,
                               String callerId)
                        throws InvalidParameterException

Create a new client that is to be used within an OMAG Server.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

restClient - pre-initialized REST client

maxPageSize - pre-initialized parameter limit

auditLog - logging destination

callerId - unique identifier of the caller

Throws:

InvalidParameterException - there is a problem with the information about the remote OMAS

Method Detail

getConfigurationServerName

public String getConfigurationServerName()

Return the name of the server where configuration is supposed to be stored.

Returns:

server name

registerListener

public void registerListener(String userId,
                             AssetCatalogEventListener listener)
                      throws InvalidParameterException,
                             ConnectionCheckedException,
                             ConnectorCheckedException,
                             PropertyServerException,
                             UserNotAuthorizedException

Register a listener object that will be passed each of the events published by the Asset Catalog OMAS.

Parameters:

userId - calling user

listener - listener object

Throws:

InvalidParameterException - one of the parameters is null or invalid.

ConnectionCheckedException - there are errors in the configuration of the connection which is preventing the creation of a connector.

ConnectorCheckedException - there are errors in the initialization of the connector.

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

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