Interface ByteIngest

All Known Subinterfaces:
Decoder
All Known Implementing Classes:
PackedDecode, PackedDecodeOverlay, StringIngest

public interface ByteIngest
An object that can ingest bytes from a stream in preparation for decoding
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    Clear any previous cached bytes.
    void
    Formal indicator that ingesting of bytes is complete and processing can begin
    void
    Ingest bytes from the stream up to (and including) the first 0 byte.
    boolean
     
    void
    open(int max, String source)
    Open the ingester for receiving bytes.
  • Method Details

    • clear

      void clear()
      Clear any previous cached bytes.
    • open

      void open(int max, String source)
      Open the ingester for receiving bytes. This establishes the description of the source of the bytes and maximum number of bytes that can be read
      Parameters:
      max - is the maximum number of bytes that can be read
      source - is the description of the byte source
    • ingestStream

      void ingestStream(InputStream inStream) throws IOException
      Ingest bytes from the stream up to (and including) the first 0 byte. This can be called multiple times to read in bytes in different chunks. An absolute limit is set on the number of bytes that can be ingested via the max parameter to a previous call to open(), otherwise an exception is thrown.
      Parameters:
      inStream - is the input stream to read from
      Throws:
      IOException - for errors reading from the stream
    • endIngest

      void endIngest() throws IOException
      Formal indicator that ingesting of bytes is complete and processing can begin
      Throws:
      IOException - for errors processing the underlying stream
    • isEmpty

      boolean isEmpty()
      Returns:
      true if no bytes have yet been ingested via ingestStream()