Package org.apache.uima.collection.base_cpm

Interface BaseCollectionReader

All Superinterfaces:
Resource
All Known Subinterfaces:
CasDataCollectionReader, CollectionReader
All Known Implementing Classes:
CasDataCollectionReader_ImplBase, CollectionReader_ImplBase
public interface BaseCollectionReader extends Resource
The Base CollectionReader interface. Collection Readers should not implement this interface directly. Instead they should implement CollectionReader or CasDataCollectionReader. Most UIMA developers will prefer to use the former.

A consuming CollectionReader is one that removes each element from the collection as it is read. To find out whether a CollectionReader will consume elements in this way, call the isConsuming() method.

Users of a CollectionReader should always close it when they are finished using it.

  • Method Details

    • hasNext

      boolean hasNext() throws IOException, CollectionException
      Gets whether there are any elements remaining to be read from this CollectionReader.
      Returns:
      true if and only if there are more elements available from this CollectionReader.
      Throws:
      IOException - if an I/O failure occurs
      CollectionException - if there is some other problem with reading from the Collection

    • isConsuming

      boolean isConsuming()
      Gets whether this is a consuming CollectionReader. Consuming CollectionReaders remove each element from the Collection as it is read.
      Returns:
      true if and only if this is a consuming CollectionReader

    • getProgress

      Progress[] getProgress()
      Gets information about the number of entities and/or amount of data that has been read from this CollectionReader, and the total amount that remains (if that information is available).

      This method returns an array of Progress objects so that results can be reported using different units. For example, the CollectionReader could report progress in terms of the number of documents that have been read and also in terms of the number of bytes that have been read. In many cases, it will be sufficient to return just one Progress object.

      Returns:
      an array of Progress objects. Each object may have different units (for example number of entities or bytes).

    • close

      void close() throws IOException
      Closes this CollectionReader, after which it may no longer be used.
      Throws:
      IOException - if an I/O failure occurs

    • getProcessingResourceMetaData

      ProcessingResourceMetaData getProcessingResourceMetaData()
      Gets the metadata that describes this CasProcesor.
      Returns:
      an object containing all metadata for this CasProcessor