Class AsyncMultiReader

Method Details

• add

  public AsyncMultiReader add(DataReader... readers)

  Adds source readers, each read on its own thread that also opens and closes it; must be called before open().

• isFailOnException

  public boolean isFailOnException()

  Indicates if a source reader failure stops all reading and is rethrown by DataReader.read() (default is true) instead of only being kept for getException().

• setFailOnException

  public AsyncMultiReader setFailOnException(boolean failOnException)

  Indicates if a source reader failure stops all reading and is rethrown by DataReader.read() (default is true) instead of only being kept for getException().

• getException

  public Throwable getException()

  Returns the first exception thrown by a source reader or null if none failed.

• open

  public void open() throws DataException

  Description copied from class: DataEndpoint

  Makes this endpoint ready for reading or writing.

  Overrides:

  open in class DataEndpoint

  Throws:

  DataException

• close

  public void close() throws DataException

  Description copied from class: DataEndpoint

  Indicates that this endpoint has finished reading or writing.

  Overrides:

  close in class DataEndpoint

  Throws:

  DataException

• readImpl

  protected Record readImpl() throws Throwable

  Description copied from class: DataReader

  Overridden by subclasses to read the next record from this DataReader. The default implementation of DataReader.read() now insures that this method will not be called again after it returns a null.

  If no record is available, null will be returned.

  Contract for subclasses (see also docs/authoring/DataReader.md):

  • Return null exactly once to signal end-of-stream.
  • Do not call this method directly — DataReader.read() is the template method that wraps exceptions, increments the record count, and tracks lineage.
  • Do not call DataEndpoint.incrementRecordCount() here; DataReader.read() already does.
  • Throw raw exceptions; DataReader.read() wraps them via exception(throwable).

  Specified by:

  readImpl in class DataReader

  Throws:

  Throwable

• onTheadFinished

  protected void onTheadFinished(AsyncMultiReader.ReaderThread finishedThread)

  Called by each AsyncMultiReader.ReaderThread as it ends; signals the end of input once all have finished, or at the first failure when isFailOnException() is true.

• addExceptionProperties

  public DataException addExceptionProperties(DataException exception)

  Description copied from class: Endpoint

  Adds this endpoint's current state to a DataException. Since this method is called whenever an exception is thrown, subclasses should override it to add their specific information.

  Overrides:

  addExceptionProperties in class DataReader