org.odpi.openmetadata.accessservices.assetlineage.handlers

Class HandlerHelper

java.lang.Object

org.odpi.openmetadata.accessservices.assetlineage.handlers.HandlerHelper

public class HandlerHelper
extends Object

The common handler provide common methods that is generic and reusable for other handlers.

Constructor Summary

Constructors

Constructor and Description
HandlerHelper(InvalidParameterHandler invalidParameterHandler, OMRSRepositoryHelper repositoryHelper, RepositoryHandler repositoryHandler, Set<String> lineageClassificationTypes) Construct the handler information needed to interact with the repository services

Method Summary

Modifier and Type	Method and Description
protected EntityDetail	addContextForRelationships(String userId, EntityDetail startEntity, String relationshipTypeName, Set<GraphContext> context) Adds the relationships context for an entity, based on the relationship type.
RelationshipsContext	buildContextForLineageClassifications(EntityDetail entityDetail) Builds the classification context for an entity
RelationshipsContext	buildContextForRelationships(String userId, String entityGUID, List<Relationship> relationships) Builds the relationships context for an entity
List<Classification>	filterLineageClassifications(List<Classification> classifications) Extract the lineage classifications from the list of classifications assigned
List<EntityDetail>	findEntitiesByType(String userId, String entityTypeName, SearchProperties searchProperties, FindEntitiesParameters findEntitiesParameters) Retrieves a list of entities based on the search criteria passed
EntityDetail	getEntityDetails(String userId, String entityDetailGUID, String entityTypeName) Fetch the entity using the identifier and the type name
SearchProperties	getSearchPropertiesAfterUpdateTime(Long time) Creat the search body for find entities searching entities updated after the given time
void	validateAsset(EntityDetail entityDetail, String methodName, List<String> supportedZones) Validate asset's GUID and it being in the specific supported zones.

Methods inherited from class java.lang.Object

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

Constructor Detail

HandlerHelper

public HandlerHelper(InvalidParameterHandler invalidParameterHandler,
                     OMRSRepositoryHelper repositoryHelper,
                     RepositoryHandler repositoryHandler,
                     Set<String> lineageClassificationTypes)

Construct the handler information needed to interact with the repository services

Parameters:

invalidParameterHandler - handler for invalid parameters

repositoryHelper - helper used by the converters

repositoryHandler - handler for calling the repository services

Method Detail

getEntityDetails

public EntityDetail getEntityDetails(String userId,
                                     String entityDetailGUID,
                                     String entityTypeName)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Fetch the entity using the identifier and the type name

Parameters:

userId - the user identifier

entityDetailGUID - the entity identifier

entityTypeName - the entity type name

Returns:

the entity

Throws:

InvalidParameterException - one of the parameters is null or invalid.

UserNotAuthorizedException - user not authorized to issue this request.

PropertyServerException - problem retrieving the entity.

findEntitiesByType

public List<EntityDetail> findEntitiesByType(String userId,
                                             String entityTypeName,
                                             SearchProperties searchProperties,
                                             FindEntitiesParameters findEntitiesParameters)
                                      throws UserNotAuthorizedException,
                                             PropertyServerException

Retrieves a list of entities based on the search criteria passed

Parameters:

userId - the user id

entityTypeName - the name of the entity type

searchProperties - searchProperties used in the filtering

findEntitiesParameters - filtering used to reduce the scope of the search

Returns:

a list with entities matching the supplied parameters;

Throws:

UserNotAuthorizedException - the user is not authorized to make this request.

PropertyServerException - something went wrong with the REST call stack.

filterLineageClassifications

public List<Classification> filterLineageClassifications(List<Classification> classifications)

Extract the lineage classifications from the list of classifications assigned

Parameters:

classifications - the list of available classifications

Returns:

a list of lineage classifications

getSearchPropertiesAfterUpdateTime

public SearchProperties getSearchPropertiesAfterUpdateTime(Long time)

Creat the search body for find entities searching entities updated after the given time

Parameters:

time - date in milliseconds after which the entities were updated

Returns:

the search properties having the condition updateTime greater than the provided time

buildContextForRelationships

public RelationshipsContext buildContextForRelationships(String userId,
                                                         String entityGUID,
                                                         List<Relationship> relationships)
                                                  throws UserNotAuthorizedException,
                                                         PropertyServerException,
                                                         InvalidParameterException

Builds the relationships context for an entity

Parameters:

userId - the unique identifier for the user

entityGUID - the guid of the entity

relationships - the list of relationships for which the context is built

Returns:

a set of GraphContext containing the lineage context for the relationships

Throws:

InvalidParameterException - the invalid parameter exception

PropertyServerException - the property server exception

UserNotAuthorizedException - the user not authorized exception

buildContextForLineageClassifications

public RelationshipsContext buildContextForLineageClassifications(EntityDetail entityDetail)

Builds the classification context for an entity

Parameters:

entityDetail - the entity for retrieving the classifications attached to it

Returns:

a set of GraphContext containing the lineage context for the classifications

addContextForRelationships

protected EntityDetail addContextForRelationships(String userId,
                                                  EntityDetail startEntity,
                                                  String relationshipTypeName,
                                                  Set<GraphContext> context)
                                           throws OCFCheckedExceptionBase

Adds the relationships context for an entity, based on the relationship type.

Parameters:

userId - the unique identifier for the user

startEntity - the start entity for the relationships

relationshipTypeName - the type of the relationship for which the context is built

context - the context to be updated

Throws:

OCFCheckedExceptionBase - checked exception for reporting errors found when using OCF connectors

validateAsset

public void validateAsset(EntityDetail entityDetail,
                          String methodName,
                          List<String> supportedZones)
                   throws InvalidParameterException

Validate asset's GUID and it being in the specific supported zones.

Parameters:

entityDetail - the entity detail

methodName - the method name

supportedZones - the supported zones

Throws:

InvalidParameterException - the invalid parameter exception