org.odpi.openmetadata.accessservices.connectedasset.handlers

Class RepositoryHandler

java.lang.Object

org.odpi.openmetadata.accessservices.connectedasset.handlers.RepositoryHandler

public class RepositoryHandler
extends Object

RepositoryHandler is responsible for retrieving instances from the open metadata repositories and converting the repository service exceptions into this access service's exceptions.

Constructor Summary

Constructors

Constructor and Description
RepositoryHandler(String serviceName, String serverName, OMRSRepositoryConnector repositoryConnector) Constructor takes information about the repository and context of request for error logging.

Method Summary

Modifier and Type	Method and Description
List<Relationship>	getRelationshipsOfACertainType(List<Relationship> retrievedRelationships, String typeName) Scan the complete list of relationships and extract those that match the supplied type name.
List<Relationship>	retrieveAllRelationships(String userId, String entityTypeName, String entityGUID, int startingElement, int pageSize) Returns the list of relationships attached to the identified asset entity from the open metadata repositories.
EntityDetail	retrieveEntity(String userId, String typeName, String guid) Returns the entity object corresponding to the supplied asset GUID.
List<Relationship>	retrieveRelationships(String userId, String entityTypeName, String entityGUID, String relationshipTypeGUID, int startingElement, int pageSize) Returns the list of relationships attached to the identified asset entity from the open metadata repositories.

Methods inherited from class java.lang.Object

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

Constructor Detail

RepositoryHandler

public RepositoryHandler(String serviceName,
                         String serverName,
                         OMRSRepositoryConnector repositoryConnector)

Constructor takes information about the repository and context of request for error logging.

Parameters:

serviceName - name of this service

serverName - name of this server

repositoryConnector - connector to the property server.

Method Detail

getRelationshipsOfACertainType

public List<Relationship> getRelationshipsOfACertainType(List<Relationship> retrievedRelationships,
                                                         String typeName)

Scan the complete list of relationships and extract those that match the supplied type name.

Parameters:

retrievedRelationships - full list of relationships attached to the asset.

typeName - relationship type name

Returns:

list of selected relationships (or empty list)

retrieveEntity

public EntityDetail retrieveEntity(String userId,
                                   String typeName,
                                   String guid)
                            throws InvalidParameterException,
                                   UnrecognizedGUIDException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Returns the entity object corresponding to the supplied asset GUID.

Parameters:

userId - userId of user making request.

typeName - name of the type that the retrieved entity is expected to be for.

guid - the unique id for the entity within the property server.

Returns:

Connection retrieved from the property server

Throws:

InvalidParameterException - one of the parameters is null or invalid.

UnrecognizedGUIDException - the supplied GUID is not recognized by the metadata repository.

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

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

retrieveAllRelationships

public List<Relationship> retrieveAllRelationships(String userId,
                                                   String entityTypeName,
                                                   String entityGUID,
                                                   int startingElement,
                                                   int pageSize)
                                            throws InvalidParameterException,
                                                   UnrecognizedGUIDException,
                                                   PropertyServerException,
                                                   UserNotAuthorizedException

Returns the list of relationships attached to the identified asset entity from the open metadata repositories.

Parameters:

userId - userId of user making request.

entityTypeName - type of entity that these relationships are connected to.

entityGUID - the unique id for the starting entity within the property server.

startingElement - starting element to return (may be so many elements that paging is needed).

pageSize - Maximum number of elements to return (may be so many elements that paging is needed).

Returns:

relationships retrieved from the property server

Throws:

InvalidParameterException - one of the parameters is null or invalid.

UnrecognizedGUIDException - the supplied GUID is not recognized by the metadata repository.

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

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

retrieveRelationships

public List<Relationship> retrieveRelationships(String userId,
                                                String entityTypeName,
                                                String entityGUID,
                                                String relationshipTypeGUID,
                                                int startingElement,
                                                int pageSize)
                                         throws InvalidParameterException,
                                                UnrecognizedGUIDException,
                                                PropertyServerException,
                                                UserNotAuthorizedException

Returns the list of relationships attached to the identified asset entity from the open metadata repositories.

Parameters:

userId - userId of user making request.

entityTypeName - type of entity that these relationships are connected to.

entityGUID - the unique id for the starting entity within the property server.

startingElement - starting element to return (may be so many elements that paging is needed).

pageSize - Maximum number of elements to return (may be so many elements that paging is needed).

Returns:

relationships retrieved from the property server

Throws:

InvalidParameterException - one of the parameters is null or invalid.

UnrecognizedGUIDException - the supplied GUID is not recognized by the metadata repository.

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

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