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 inherited from class org.odpi.openmetadata.commonservices.repositoryhandler.RepositoryIterator

MAX_PAGE_SIZE

Constructor Summary

Constructors

Constructor

Description

RepositoryIteratorForEntities(RepositoryHandler repositoryHandler, org.odpi.openmetadata.commonservices.ffdc.InvalidParameterHandler invalidParameterHandler, String userId, String entityTypeGUID, String entityTypeName, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, List<String> limitResultsByClassification, Date asOfTime, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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
org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail	getNext()	Return the next entity.
abstract boolean	moreToReceive()	Determine if there is more to receive.

Methods inherited from class java.lang.Object

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

Constructor Details

RepositoryIteratorForEntities

public RepositoryIteratorForEntities(RepositoryHandler repositoryHandler,
 org.odpi.openmetadata.commonservices.ffdc.InvalidParameterHandler invalidParameterHandler,
 String userId,
 String entityTypeGUID,
 String entityTypeName,
 List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
 List<String> limitResultsByClassification,
 Date asOfTime,
 org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder,
 String sequencingPropertyName,
 boolean forLineage,
 boolean forDuplicateProcessing,
 int startingFrom,
 int pageSize,
 Date effectiveTime,
 String methodName)
                              throws org.odpi.openmetadata.frameworks.connectors.ffdc.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:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - when page size or start from parameters do not meet criteria

Method Details

moreToReceive

public abstract boolean moreToReceive()
                               throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

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

Returns:

boolean flag

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - the bean properties are invalid

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the repository is not allowing the user to access the metadata

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem in the repository

getNext

public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail getNext()
                                                                                                                             throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

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

Returns:

relationship or null

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - the bean properties are invalid

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the repository is not allowing the user to access the metadata

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem in the repository