Package org.odpi.openmetadata.adminservices.client

Class RepositoryProxyConfigurationClient

java.lang.Object

org.odpi.openmetadata.adminservices.client.OMAGServerConfigurationClient

org.odpi.openmetadata.adminservices.client.CohortMemberConfigurationClient

org.odpi.openmetadata.adminservices.client.RepositoryProxyConfigurationClient

public class RepositoryProxyConfigurationClient
extends CohortMemberConfigurationClient

RepositoryProxyConfigurationClient provides the configuration services for a repository proxy. This is a server that translates between the API/events of a third party metadata repository and the Open Metadata Repository Services (OMRS) API/events.

Field Summary

Fields inherited from class org.odpi.openmetadata.adminservices.client.OMAGServerConfigurationClient

adminUserId, invalidParameterHandler, nullRequestBody, restClient, serverName, serverPlatformRootURL

Constructor Summary

Constructors

Constructor	Description
RepositoryProxyConfigurationClient(String adminUserId, String serverName, String serverPlatformRootURL)	Create a new client with no authentication embedded in the HTTP request.
RepositoryProxyConfigurationClient(String adminUserId, String serverName, String serverPlatformRootURL, String connectionUserId, String connectionPassword)	Create a new client that passes a connection userId and password in each HTTP request.

Method Summary

Modifier and Type	Method	Description
void	setEventMapperConnection(String connectorProvider, String eventSource, Map<String,Object> additionalProperties)	Provide the connection to the local repository's event mapper if needed.
void	setEventMapperConnection(Connection connection)	Provide the connection to the third party repository's event mapper.
void	setRepositoryProxyConnection(String connectorProvider, Map<String,Object> additionalProperties)	Provide the connection to the third party metadata server repository connector that maps the OMRS RepositoryConnector API to the third party repository API.
void	setRepositoryProxyConnection(Connection connection)	Provide the connection to the third party metadata server repository connector that maps the OMRS RepositoryConnector API to the third party metadata server API.

Methods inherited from class org.odpi.openmetadata.adminservices.client.CohortMemberConfigurationClient

addCohortRegistration, addCohortRegistration, addStartUpOpenMetadataArchiveFile, addStartUpOpenMetadataArchiveList, clearCohortRegistration, clearLocalRepository, clearOpenMetadataArchives, getCohortTopicName, getDedicatedCohortTopicNames, getLocalMetadataCollectionId, overrideCohortTopicName, overrideInstancesCohortTopicName, overrideRegistrationCohortTopicName, overrideTypesCohortTopicName, setCohortConfig, setLocalMetadataCollectionId, setLocalMetadataCollectionName, setLocalRepositoryConfig

Methods inherited from class org.odpi.openmetadata.adminservices.client.OMAGServerConfigurationClient

addAuditLogDestination, addConsoleAuditLogDestination, addEventTopicAuditLogDestination, addFileAuditLogDestination, addSLF4JAuditLogDestination, clearAuditLogDestination, clearAuditLogDestinations, clearOMAGServerConfig, clearServerSecurityConnection, deployOMAGServerConfig, getOMAGServerConfig, getOMAGServerInstanceConfig, getServerClassification, getServerSecurityConnection, setAuditLogDestinations, setDefaultAuditLog, setEventBus, setMaxPageSize, setOMAGServerConfig, setOrganizationName, setServerDescription, setServerPassword, setServerSecurityConnection, setServerType, setServerURLRoot, setServerUserId, updateAuditLogDestination

Methods inherited from class java.lang.Object

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

Constructor Detail

RepositoryProxyConfigurationClient

public RepositoryProxyConfigurationClient(String adminUserId,
                                          String serverName,
                                          String serverPlatformRootURL)
                                   throws OMAGInvalidParameterException

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

Parameters:

adminUserId - administrator's (end user's) userId to associate with calls.

serverName - name of the server to connect to

serverPlatformRootURL - the network address of the server running the admin services

Throws:

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

RepositoryProxyConfigurationClient

public RepositoryProxyConfigurationClient(String adminUserId,
                                          String serverName,
                                          String serverPlatformRootURL,
                                          String connectionUserId,
                                          String connectionPassword)
                                   throws OMAGInvalidParameterException

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

Parameters:

adminUserId - administrator's (end user's) userId to associate with calls.

serverName - name of the server to connect to

serverPlatformRootURL - the network address of the server running the admin services

connectionUserId - caller's system userId embedded in all HTTP requests

connectionPassword - caller's system password embedded in all HTTP requests

Throws:

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

Method Detail

setRepositoryProxyConnection

public void setRepositoryProxyConnection(Connection connection)
                                  throws OMAGNotAuthorizedException,
                                         OMAGInvalidParameterException,
                                         OMAGConfigurationErrorException

Provide the connection to the third party metadata server repository connector that maps the OMRS RepositoryConnector API to the third party metadata server API.

Parameters:

connection - connection to the OMRS repository connector.

Throws:

OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

OMAGInvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

setRepositoryProxyConnection

public void setRepositoryProxyConnection(String connectorProvider,
                                         Map<String,Object> additionalProperties)
                                  throws OMAGNotAuthorizedException,
                                         OMAGInvalidParameterException,
                                         OMAGConfigurationErrorException

Provide the connection to the third party metadata server repository connector that maps the OMRS RepositoryConnector API to the third party repository API.

Parameters:

connectorProvider - connector provider class name to the OMRS repository connector.

additionalProperties - additional parameters to pass to the repository connector

Throws:

OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

OMAGInvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

setEventMapperConnection

public void setEventMapperConnection(Connection connection)
                              throws OMAGNotAuthorizedException,
                                     OMAGInvalidParameterException,
                                     OMAGConfigurationErrorException

Provide the connection to the third party repository's event mapper. The default value is null which means no event mapper. An event mapper is needed if the third party repository has additional APIs that can change the metadata in its repository without going through the open metadata and governance services. The event mapper detects changes to the third party repository and converts them to OMRS Events.

Parameters:

connection - connection to the OMRS repository event mapper.

Throws:

OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

OMAGInvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

setEventMapperConnection

public void setEventMapperConnection(String connectorProvider,
                                     String eventSource,
                                     Map<String,Object> additionalProperties)
                              throws OMAGNotAuthorizedException,
                                     OMAGInvalidParameterException,
                                     OMAGConfigurationErrorException

Provide the connection to the local repository's event mapper if needed. The default value is null which means no event mapper. An event mapper is needed if the third party repository has additional APIs that can change the metadata in its repository without going through the open metadata and governance services. The event mapper detects changes to the third party repository and converts them to OMRS Events.

Parameters:

connectorProvider - Java class name of the connector provider for the OMRS repository event mapper.

eventSource - topic name or URL to the native event source.

additionalProperties - additional properties for the event mapper connection

Throws:

OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

OMAGInvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.