com.filenet.api.core
Class RetrievingBatch

java.lang.Object
  extended by com.filenet.api.core.Batch
      extended by com.filenet.api.core.RetrievingBatch

public class RetrievingBatch
extends Batch

Creates a batch operation to retrieve objects. Once created, the batch operation is pending until you call the retrieveBatch method to perform the operation.

See Also:
BatchItemHandle, UpdatingBatch

Method Summary
 BatchItemHandle add(IndependentObject object, PropertyFilter filter)
          Adds an object reference to the batch to be retrieved by this instance.
static RetrievingBatch createRetrievingBatchInstance(Domain domain)
          Creates a new RetrievingBatch instance for the specified FileNet P8 domain.
 boolean hasExceptions()
          Indicates whether any of the batch items have an associated exception as a result of the batch retrieval operation.
 void retrieveBatch()
          Retrieve all of the objects referenced in this batch.
 
Methods inherited from class com.filenet.api.core.Batch
getBatchItemHandles
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createRetrievingBatchInstance

public static RetrievingBatch createRetrievingBatchInstance(Domain domain)
Creates a new RetrievingBatch instance for the specified FileNet P8 domain.

Parameters:
domain - A Domain object representing the FileNet P8 domain to use as the scope of this RetrievingBatch instance.
Returns:
The RetrievingBatch object created.

add

public BatchItemHandle add(IndependentObject object,
                           PropertyFilter filter)
Adds an object reference to the batch to be retrieved by this instance. The object is referenced by a BatchItemHandle instance, and the batch contains a list of BatchItemHandle instances.

Parameters:
object - An IndependentObject instance for the object to add.
filter - A PropertyFilter object that represents information for controlling which property values (and with what level of detail and recursion) to return. If null, this method returns values for all non-object properties and returns placeholders for all object-valued properties (PropertyEngineObject properties with a state of PropertyState.UNEVALUATED or PropertyState.REFERENCE); any subsequent attempts to access an object-valued property will cause an automatic round-trip to the server to fetch its value.
Returns:
A BatchItemHandle instance representing the object added to the batch.

hasExceptions

public boolean hasExceptions()
Indicates whether any of the batch items have an associated exception as a result of the batch retrieval operation.

Returns:
A boolean value of true if there is an exception associated with any batch item; false otherwise.

retrieveBatch

public void retrieveBatch()
Retrieve all of the objects referenced in this batch. Calling this method executes the pending batch retrieval operation.

Throws:
EngineRuntimeException - Thrown when there are no pending items in the batch.


© Copyright IBM Corporation 2006, 2008. All rights reserved.