Class 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.
    • Constructor Detail

      • RepositoryProxyConfigurationClient

        public RepositoryProxyConfigurationClient​(java.lang.String adminUserId,
                                                  java.lang.String serverName,
                                                  java.lang.String serverPlatformRootURL)
                                           throws org.odpi.openmetadata.adminservices.ffdc.exception.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:
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.
      • RepositoryProxyConfigurationClient

        public RepositoryProxyConfigurationClient​(java.lang.String adminUserId,
                                                  java.lang.String serverName,
                                                  java.lang.String serverPlatformRootURL,
                                                  java.lang.String connectionUserId,
                                                  java.lang.String connectionPassword)
                                           throws org.odpi.openmetadata.adminservices.ffdc.exception.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:
        org.odpi.openmetadata.adminservices.ffdc.exception.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 org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
                                                 org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
                                                 org.odpi.openmetadata.adminservices.ffdc.exception.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:
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.
      • setRepositoryProxyConnection

        public void setRepositoryProxyConnection​(java.lang.String connectorProvider,
                                                 java.util.Map<java.lang.String,​java.lang.Object> additionalProperties)
                                          throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
                                                 org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
                                                 org.odpi.openmetadata.adminservices.ffdc.exception.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:
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.
      • setEventMapperConnection

        public void setEventMapperConnection​(Connection connection)
                                      throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
                                             org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
                                             org.odpi.openmetadata.adminservices.ffdc.exception.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:
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.
      • setEventMapperConnection

        public void setEventMapperConnection​(java.lang.String connectorProvider,
                                             java.lang.String eventSource,
                                             java.util.Map<java.lang.String,​java.lang.Object> additionalProperties)
                                      throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
                                             org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
                                             org.odpi.openmetadata.adminservices.ffdc.exception.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:
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.
        org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.