org.odpi.openmetadata.commonservices.multitenant

Class OMASServiceInstanceHandler

java.lang.Object

org.odpi.openmetadata.commonservices.multitenant.OMAGServerServiceInstanceHandler

org.odpi.openmetadata.commonservices.multitenant.AuditableServerServiceInstanceHandler

org.odpi.openmetadata.commonservices.multitenant.OMASServiceInstanceHandler

Direct Known Subclasses:

OCFOMASServiceInstanceHandler

public class OMASServiceInstanceHandler
extends AuditableServerServiceInstanceHandler

OMASServiceInstanceHandler retrieves information from the instance map for the access service instances. The instance map is thread-safe. Instances are added and removed by the GovernanceProgramAdmin class.

Field Summary

Fields inherited from class org.odpi.openmetadata.commonservices.multitenant.OMAGServerServiceInstanceHandler

platformInstanceMap, serviceName

Constructor Summary

Constructors

Constructor and Description
OMASServiceInstanceHandler(String serviceName) Constructor

Method Summary

Modifier and Type	Method and Description
List<String>	getDefaultZones(String userId, String serverName, String serviceOperationName) Retrieve the default zones set up for this service instance.
RepositoryErrorHandler	getErrorHandler(String userId, String serverName, String serviceOperationName) Retrieve the handler for managing errors from the repository services.
RESTExceptionHandler	getExceptionHandler() Retrieve the exception handler that can package up common exceptions and pack them into a REST Response.
OMRSMetadataCollection	getMetadataCollection(String userId, String serverName, String serviceOperationName) Retrieve the metadata collection for the access service.
List<String>	getPublishZones(String userId, String serverName, String serviceOperationName) Retrieve the publish zones set up for this service instance.
OMRSRepositoryConnector	getRepositoryConnector(String userId, String serverName, String serviceOperationName) Retrieve the repository connector for the access service.
RepositoryHandler	getRepositoryHandler(String userId, String serverName, String serviceOperationName) Retrieve the repository handler for the access service.
List<String>	getSupportedZones(String userId, String serverName, String serviceOperationName) Retrieve the supported zones set up for this service instance.

Methods inherited from class org.odpi.openmetadata.commonservices.multitenant.AuditableServerServiceInstanceHandler

getAuditLog

Methods inherited from class org.odpi.openmetadata.commonservices.multitenant.OMAGServerServiceInstanceHandler

getServerSecurityVerifier, getServerServiceInstance, getServiceName, isServerActive, removeServerServiceInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

OMASServiceInstanceHandler

public OMASServiceInstanceHandler(String serviceName)

Constructor

Parameters:

serviceName - a descriptive name for the OMAS

Method Detail

getRepositoryConnector

public OMRSRepositoryConnector getRepositoryConnector(String userId,
                                                      String serverName,
                                                      String serviceOperationName)
                                               throws InvalidParameterException,
                                                      UserNotAuthorizedException,
                                                      PropertyServerException

Retrieve the repository connector for the access service.

Parameters:

userId - calling userId

serverName - name of the server tied to the request

serviceOperationName - name of the REST API call (typically the top-level methodName)

Returns:

repository connector for exclusive use by the requested instance

Throws:

InvalidParameterException - the server name is not known

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

PropertyServerException - the service name is not known or the repository connector is not available - indicating a logic error

getMetadataCollection

public OMRSMetadataCollection getMetadataCollection(String userId,
                                                    String serverName,
                                                    String serviceOperationName)
                                             throws InvalidParameterException,
                                                    UserNotAuthorizedException,
                                                    PropertyServerException

Retrieve the metadata collection for the access service.

Parameters:

userId - calling userId

serverName - name of the server tied to the request

serviceOperationName - name of the REST API call (typically the top-level methodName)

Returns:

metadata collection for exclusive use by the requested instance

Throws:

InvalidParameterException - the server name is not known

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

PropertyServerException - the service name is not known or the metadata collection is not available - indicating a logic error

getRepositoryHandler

public RepositoryHandler getRepositoryHandler(String userId,
                                              String serverName,
                                              String serviceOperationName)
                                       throws InvalidParameterException,
                                              UserNotAuthorizedException,
                                              PropertyServerException

Retrieve the repository handler for the access service. Provides an advanced API for the repository services.

Parameters:

userId - calling userId

serverName - name of the server tied to the request

serviceOperationName - name of the REST API call (typically the top-level methodName)

Returns:

repository handler

Throws:

InvalidParameterException - the server name is not known

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

PropertyServerException - the service name is not known or the metadata collection is not available - indicating a logic error

getErrorHandler

public RepositoryErrorHandler getErrorHandler(String userId,
                                              String serverName,
                                              String serviceOperationName)
                                       throws InvalidParameterException,
                                              UserNotAuthorizedException,
                                              PropertyServerException

Retrieve the handler for managing errors from the repository services.

Parameters:

userId - calling userId

serverName - name of the server tied to the request

serviceOperationName - name of the REST API call (typically the top-level methodName)

Returns:

repository error handler

Throws:

InvalidParameterException - the server name is not known

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

PropertyServerException - the service name is not known or the metadata collection is not available - indicating a logic error

getSupportedZones

public List<String> getSupportedZones(String userId,
                                      String serverName,
                                      String serviceOperationName)
                               throws InvalidParameterException,
                                      UserNotAuthorizedException,
                                      PropertyServerException

Retrieve the supported zones set up for this service instance.

Parameters:

userId - calling userId

serverName - name of the server tied to the request

serviceOperationName - name of the REST API call (typically the top-level methodName)

Returns:

list of governance zones

Throws:

InvalidParameterException - the server name is not known

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

PropertyServerException - the service name is not known or the metadata collection is not available - indicating a logic error

getDefaultZones

public List<String> getDefaultZones(String userId,
                                    String serverName,
                                    String serviceOperationName)
                             throws InvalidParameterException,
                                    UserNotAuthorizedException,
                                    PropertyServerException

Retrieve the default zones set up for this service instance.

Parameters:

userId - calling userId

serverName - name of the server tied to the request

serviceOperationName - name of the REST API call (typically the top-level methodName)

Returns:

list of governance zones

Throws:

InvalidParameterException - the server name is not known

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

PropertyServerException - the service name is not known or the metadata collection is not available - indicating a logic error

getPublishZones

public List<String> getPublishZones(String userId,
                                    String serverName,
                                    String serviceOperationName)
                             throws InvalidParameterException,
                                    UserNotAuthorizedException,
                                    PropertyServerException

Retrieve the publish zones set up for this service instance.

Parameters:

userId - calling userId

serverName - name of the server tied to the request

serviceOperationName - name of the REST API call (typically the top-level methodName)

Returns:

list of governance zones

Throws:

InvalidParameterException - the server name is not known

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

PropertyServerException - the service name is not known or the metadata collection is not available - indicating a logic error

getExceptionHandler

public RESTExceptionHandler getExceptionHandler()

Retrieve the exception handler that can package up common exceptions and pack them into a REST Response.

Returns:

exception handler object