org.odpi.openmetadata.accessservices.assetcatalog.handlers

Class AssetCatalogHandler

java.lang.Object

org.odpi.openmetadata.accessservices.assetcatalog.handlers.AssetCatalogHandler

public class AssetCatalogHandler
extends Object

Asset Catalog Handler supports the lookup of the assets from the repositories. It runs on the server-side of the Asset Catalog OMAS, fetches the entities using the RepositoryHandler.

Constructor Summary

Constructors

Constructor and Description
AssetCatalogHandler(String serverUserName, String sourceName, InvalidParameterHandler invalidParameterHandler, RepositoryHandler repositoryHandler, OMRSRepositoryHelper repositoryHelper, RepositoryErrorHandler errorHandler, List<String> supportedZones, List<String> supportedTypesForSearch) Construct the handler information needed to interact with the repository services

Method Summary

Modifier and Type	Method and Description
AssetElements	buildContextByType(String userId, String entityGUID, String entityTypeDefName)
List<AssetDescription>	getEntitiesFromNeighborhood(String serverName, String userId, String assetGUID, SearchParameters searchParameters)
List<Classification>	getEntityClassificationByName(String userId, String assetGUID, String assetTypeName, String classificationName) Returns a list of the classification assigned to the given asset.
AssetDescription	getEntityDetails(String userId, String assetGUID, String assetTypeName) Return the requested entity and converting to Asset Catalog OMAS model
List<AssetDescription>	getIntermediateAssets(String userId, String startAssetGUID, String endAssetGUID)
List<Relationship>	getLinkingRelationshipsBetweenAssets(String serverName, String userId, String startAssetGUID, String endAssetGUID)
List<Relationship>	getRelationships(String userId, String assetGUID, String assetTypeName, String relationshipTypeName, Integer from, Integer pageSize)
List<Relationship>	getRelationshipsByEntityGUID(String userId, String assetGUID, String assetTypeName) Returns a list of the relationships for the given entity identifier.
List<Type>	getSupportedTypes(String userId, String typeName) Returns supported types for search with all sub-types.
List<AssetElements>	searchByType(String userId, String searchCriteria, SearchParameters searchParameters)

Methods inherited from class java.lang.Object

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

Constructor Detail

AssetCatalogHandler

public AssetCatalogHandler(String serverUserName,
                           String sourceName,
                           InvalidParameterHandler invalidParameterHandler,
                           RepositoryHandler repositoryHandler,
                           OMRSRepositoryHelper repositoryHelper,
                           RepositoryErrorHandler errorHandler,
                           List<String> supportedZones,
                           List<String> supportedTypesForSearch)

Construct the handler information needed to interact with the repository services

Parameters:

serverUserName - name of the local server

sourceName - name of the component

invalidParameterHandler - handler for managing parameter errors

repositoryHandler - manages calls to the repository services

repositoryHelper - provides utilities for manipulating the repository services objects

errorHandler - provides common validation routines for the other handler classes

supportedZones - configurable list of zones that Asset Catalog is allowed to serve Assets from

supportedTypesForSearch - configurable list of supported types used for search

Method Detail

getEntityDetails

public AssetDescription getEntityDetails(String userId,
                                         String assetGUID,
                                         String assetTypeName)
                                  throws InvalidParameterException,
                                         PropertyServerException,
                                         UserNotAuthorizedException

Return the requested entity and converting to Asset Catalog OMAS model

Parameters:

userId - user identifier that issues the call

assetGUID - the asset identifier

assetTypeName - the asset type name

Returns:

AssetDescription that contains the core properties of the entity and additional properties

Throws:

InvalidParameterException - is thrown by the OMAS when a parameter is null or an invalid value.

PropertyServerException - reporting errors when connecting to a metadata repository to retrieve properties about the connection and/or connector

UserNotAuthorizedException - is thrown by the OCF when a userId passed on a request is not authorized to perform the requested action.

getRelationshipsByEntityGUID

public List<Relationship> getRelationshipsByEntityGUID(String userId,
                                                       String assetGUID,
                                                       String assetTypeName)
                                                throws UserNotAuthorizedException,
                                                       PropertyServerException,
                                                       InvalidParameterException

Returns a list of the relationships for the given entity identifier. Relationship type name can be used for filtering.

Parameters:

userId - user identifier that issues the call

assetGUID - the asset identifier

assetTypeName - the asset type name

Returns:

a list of Relationships

Throws:

UserNotAuthorizedException - is thrown by the OCF when a userId passed on a request is not authorized to perform the requested action.

PropertyServerException - reporting errors when connecting to a metadata repository to retrieve properties about the connection and/or connector

InvalidParameterException - is thrown by the OMAG Service when a parameter is null or an invalid value.

getEntityClassificationByName

public List<Classification> getEntityClassificationByName(String userId,
                                                          String assetGUID,
                                                          String assetTypeName,
                                                          String classificationName)
                                                   throws InvalidParameterException,
                                                          PropertyServerException,
                                                          UserNotAuthorizedException

Returns a list of the classification assigned to the given asset. The filtering based on the classification name is possible.

Parameters:

userId - user identifier that issues the call

assetGUID - the asset identifier

assetTypeName - the asset type name

classificationName - the classification type name

Returns:

a list of Classifications assigned to the given asset

Throws:

InvalidParameterException - is thrown by the OMAG Service when a parameter is null or an invalid value.

PropertyServerException - reporting errors when connecting to a metadata repository to retrieve properties about the connection and/or connector

UserNotAuthorizedException - is thrown by the OCF when a userId passed on a request is not authorized to perform the requested action.

getLinkingRelationshipsBetweenAssets

public List<Relationship> getLinkingRelationshipsBetweenAssets(String serverName,
                                                               String userId,
                                                               String startAssetGUID,
                                                               String endAssetGUID)
                                                        throws InvalidParameterException,
                                                               PropertyServerException,
                                                               UserNotAuthorizedException,
                                                               AssetCatalogException

Parameters:

serverName - name of the local server

userId - user identifier that issues the call

startAssetGUID - the starting asset identifier

endAssetGUID - the ending asset identifier

Returns:

the linking relationship between the given assets

Throws:

AssetCatalogException - is thrown by the Asset Catalog OMAS when the asset passed on a request is not found in the repository

InvalidParameterException - is thrown by the OMAG Service when a parameter is null or an invalid value.

PropertyServerException - reporting errors when connecting to a metadata repository to retrieve properties about the connection and/or connector

UserNotAuthorizedException - is thrown by the OCF when a userId passed on a request is not authorized to perform the requested action.

getRelationships

public List<Relationship> getRelationships(String userId,
                                           String assetGUID,
                                           String assetTypeName,
                                           String relationshipTypeName,
                                           Integer from,
                                           Integer pageSize)
                                    throws UserNotAuthorizedException,
                                           PropertyServerException,
                                           InvalidParameterException

Parameters:

userId - user identifier that issues the call

assetGUID - the asset identifier

assetTypeName - the asset type name

relationshipTypeName - the relationship type name

from - offset

pageSize - limit the number of the assets returned

Returns:

the list of relationships for the given asset

Throws:

UserNotAuthorizedException - is thrown by the OCF when a userId passed on a request is not authorized to perform the requested action.

PropertyServerException - reporting errors when connecting to a metadata repository to retrieve properties about the connection and/or connector

InvalidParameterException - is thrown by the OMAG Service when a parameter is null or an invalid value.

getIntermediateAssets

public List<AssetDescription> getIntermediateAssets(String userId,
                                                    String startAssetGUID,
                                                    String endAssetGUID)
                                             throws InvalidParameterException,
                                                    PropertyServerException,
                                                    UserNotAuthorizedException,
                                                    AssetCatalogException

Parameters:

userId - user identifier that issues the call

startAssetGUID - the starting asset identifier

endAssetGUID - the ending asset identifier

Returns:

a list of the entities that connects the given assets from the request

Throws:

AssetCatalogException - is thrown by the Asset Catalog OMAS when the asset passed on a request is not found in the repository

InvalidParameterException - is thrown by the OMAG Service when a parameter is null or an invalid value.

PropertyServerException - reporting errors when connecting to a metadata repository to retrieve properties about the connection and/or connector

UserNotAuthorizedException - is thrown by the OCF when a userId passed on a request is not authorized to perform the requested action.

getEntitiesFromNeighborhood

public List<AssetDescription> getEntitiesFromNeighborhood(String serverName,
                                                          String userId,
                                                          String assetGUID,
                                                          SearchParameters searchParameters)
                                                   throws InvalidParameterException,
                                                          PropertyServerException,
                                                          UserNotAuthorizedException,
                                                          AssetCatalogException

Parameters:

serverName - name of the local server

userId - user identifier that issues the call

assetGUID - the asset identifier

searchParameters - additional parameters for searching and filtering

Returns:

a list of entities from the neighborhood of the given entity

Throws:

AssetCatalogException - is thrown by the Asset Catalog OMAS when the asset passed on a request is not found in the repository

InvalidParameterException - is thrown by the OMAG Service when a parameter is null or an invalid value.

PropertyServerException - reporting errors when connecting to a metadata repository to retrieve properties about the connection and/or connector

UserNotAuthorizedException - is thrown by the OCF when a userId passed on a request is not authorized to perform the requested action.

searchByType

public List<AssetElements> searchByType(String userId,
                                        String searchCriteria,
                                        SearchParameters searchParameters)
                                 throws UserNotAuthorizedException,
                                        FunctionNotSupportedException,
                                        InvalidParameterException,
                                        PropertyErrorException,
                                        TypeErrorException,
                                        PagingErrorException,
                                        InvalidParameterException,
                                        RepositoryErrorException

Parameters:

userId - user identifier that issues the call

searchCriteria - search criteria string used for finding the entities

searchParameters - additional parameters for searching and filtering

Returns:

a list of matching criteria entities

Throws:

UserNotAuthorizedException - - is thrown by an OMRS Connector when the supplied UserId is not permitted to perform a specific operation on the metadata collection.

FunctionNotSupportedException - - provides a checked exception for reporting that an OMRS repository connector does not support the method called

InvalidParameterException - - is thrown by an OMRS Connector when the parameters passed to a repository connector are not valid

PropertyErrorException - - is thrown by an OMRS Connector when the properties defined for a specific entity or relationship instance do not match the TypeDefs for the metadata collection.

TypeErrorException - - is thrown by an OMRS Connector when the requested type for an instance is not represented by a known TypeDef.

PagingErrorException - - is thrown by an OMRS Connector when the caller has passed invalid paging attributes on a search call.

InvalidParameterException - - is thrown by the OMAG Service when a parameter is null or an invalid value.

RepositoryErrorException - - there is a problem communicating with the metadata repository.

buildContextByType

public AssetElements buildContextByType(String userId,
                                        String entityGUID,
                                        String entityTypeDefName)
                                 throws UserNotAuthorizedException,
                                        PropertyServerException,
                                        InvalidParameterException

Parameters:

userId - user identifier that issues the call

entityGUID - the identifier of the entity

entityTypeDefName - the type name of the entity

Returns:

the context of the given entity

Throws:

UserNotAuthorizedException - - is thrown by the OCF when a userId passed on a request is not authorized to perform the requested action.

PropertyServerException - - provides a checked exception for reporting errors when connecting to a metadata repository to retrieve properties about the connection and/or connector.

InvalidParameterException - - is thrown by the OMAS when a parameter is null or an invalid value.

getSupportedTypes

public List<Type> getSupportedTypes(String userId,
                                    String typeName)

Returns supported types for search with all sub-types. If type name is provided, it returns the type itself and the list of sub-types for it

Parameters:

userId - user identifier that issues the call

typeName - optional type name

Returns:

a list of types