Interface LongString


public interface LongString
An object providing access to a LongString. This might be implemented to read directly from connection socket, depending on the size of the content to be read - long strings may contain up to 4Gb of content.
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final long
     
  • Method Summary

    Modifier and Type
    Method
    Description
    byte[]
    Get the content as a byte array.
    Get the content stream.
    long
     
    Get the content as a String.
  • Field Details

  • Method Details

    • length

      long length()
      Returns:
      the length of the LongString in bytes >= 0 invalid input: '<'= MAX_LENGTH
    • getStream

      DataInputStream getStream() throws IOException
      Get the content stream. Repeated calls to this function return the same stream, which may not support rewind.
      Returns:
      An input stream that reads the content of the LongString
      Throws:
      IOException - if an error is encountered
    • getBytes

      byte[] getBytes()
      Get the content as a byte array. This need not be a copy. Updates to the returned array may change the value of the LongString. Repeated calls to this function may return the same array. This function will fail if this.length() > Integer.MAX_VALUE, throwing an IllegalStateException.
      Returns:
      the array of bytes containing the content of the LongString
    • toString

      String toString()
      Get the content as a String. Uses UTF-8 as encoding.
      Overrides:
      toString in class Object
      Returns:
      he content of the LongString as a string