Package org.odpi.openmetadata.commonservices.repositoryhandler

Class RepositoryIteratorForEntities

java.lang.Object

org.odpi.openmetadata.commonservices.repositoryhandler.RepositoryIterator

org.odpi.openmetadata.commonservices.repositoryhandler.RepositoryIteratorForEntities

Direct Known Subclasses:

RepositoryRelatedEntitiesIterator

public abstract class RepositoryIteratorForEntities
extends RepositoryIterator

RepositoryIteratorForEntities is the shared interface of all repository helper iterators that retrieve entity details from the repository.

Field Summary

Fields

Modifier and Type	Field	Description
protected List<EntityDetail>	entitiesCache
protected final String	entityTypeGUID
protected final String	entityTypeName
protected final List<String>	limitResultsByClassification
protected final List<InstanceStatus>	limitResultsByStatus
protected final String	sequencingPropertyName

Fields inherited from class org.odpi.openmetadata.commonservices.repositoryhandler.RepositoryIterator

asOfTime, effectiveTime, forDuplicateProcessing, forLineage, invalidParameterHandler, MAX_PAGE_SIZE, methodName, pageSize, repositoryHandler, sequencingOrder, startingFrom, userId

Constructor Summary

Constructors

Constructor

Description

RepositoryIteratorForEntities(RepositoryHandler repositoryHandler, InvalidParameterHandler invalidParameterHandler, String userId, String entityTypeGUID, String entityTypeName, List<InstanceStatus> limitResultsByStatus, List<String> limitResultsByClassification, Date asOfTime, SequencingOrder sequencingOrder, String sequencingPropertyName, boolean forLineage, boolean forDuplicateProcessing, int startingFrom, int pageSize, Date effectiveTime, String methodName)

Constructor takes the parameters used to call the repository handler.

Method Summary

Modifier and Type	Method	Description
EntityDetail	getNext()	Return the next entity.
abstract boolean	moreToReceive()	Determine if there is more to receive.

Methods inherited from class java.lang.Object

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

Field Details

entityTypeGUID

protected final String entityTypeGUID

entityTypeName

protected final String entityTypeName

sequencingPropertyName

protected final String sequencingPropertyName

limitResultsByStatus

protected final List<InstanceStatus> limitResultsByStatus

limitResultsByClassification

protected final List<String> limitResultsByClassification

entitiesCache

protected List<EntityDetail> entitiesCache

Constructor Details

RepositoryIteratorForEntities

public RepositoryIteratorForEntities(RepositoryHandler repositoryHandler,
 InvalidParameterHandler invalidParameterHandler,
 String userId,
 String entityTypeGUID,
 String entityTypeName,
 List<InstanceStatus> limitResultsByStatus,
 List<String> limitResultsByClassification,
 Date asOfTime,
 SequencingOrder sequencingOrder,
 String sequencingPropertyName,
 boolean forLineage,
 boolean forDuplicateProcessing,
 int startingFrom,
 int pageSize,
 Date effectiveTime,
 String methodName)
                              throws InvalidParameterException

Constructor takes the parameters used to call the repository handler.

Parameters:

repositoryHandler - interface to the open metadata repositories.

invalidParameterHandler - invalid parameter handler

userId - user making the request

entityTypeGUID - identifier for the type of entity to retrieve

entityTypeName - name for the type of entity to retrieve

sequencingOrder - Enum defining how the results should be ordered.

sequencingPropertyName - name of property used to sequence the results - null means no sequencing

limitResultsByStatus - only return elements that have the requested status (null means all statuses

limitResultsByClassification - only return elements that have the requested classification(s)

asOfTime - Requests a historical query of the entity. Null means return the present values.

forLineage - the request is to support lineage retrieval this means entities with the Memento classification can be returned

forDuplicateProcessing - the request is for duplicate processing and so must not deduplicate

startingFrom - initial position in the stored list.

pageSize - maximum number of definitions to return on this call.

effectiveTime - the time that the retrieved elements must be effective for

methodName - name of calling method

Throws:

InvalidParameterException - when page size or start from parameters do not meet criteria

Method Details

moreToReceive

public abstract boolean moreToReceive()
                               throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Determine if there is more to receive. It will populate the iterator's cache with more content.

Returns:

boolean flag

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - the repository is not allowing the user to access the metadata

PropertyServerException - there is a problem in the repository

getNext

public EntityDetail getNext()
                     throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return the next entity. It returns null if nothing left to retrieve.

Returns:

relationship or null

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - the repository is not allowing the user to access the metadata

PropertyServerException - there is a problem in the repository