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:

RepositoryEntitiesIterator, RepositoryFindEntitiesIterator, RepositoryRelatedEntitiesIterator, RepositorySelectedEntitiesIterator

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 String	entityTypeGUID
protected String	entityTypeName
protected String	sequencingPropertyName

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

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

Constructor Summary

Constructors

Constructor	Description
RepositoryIteratorForEntities(RepositoryHandler repositoryHandler, InvalidParameterHandler invalidParameterHandler, String userId, String entityTypeGUID, String entityTypeName, 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 Detail

entityTypeGUID

protected String entityTypeGUID

entityTypeName

protected String entityTypeName

sequencingPropertyName

protected String sequencingPropertyName

entitiesCache

protected List<EntityDetail> entitiesCache

Constructor Detail

RepositoryIteratorForEntities

public RepositoryIteratorForEntities(RepositoryHandler repositoryHandler,
                                     InvalidParameterHandler invalidParameterHandler,
                                     String userId,
                                     String entityTypeGUID,
                                     String entityTypeName,
                                     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

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

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 Detail

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