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 string in bytes between 0 and MAX_LENGTH (inclusive)
    • 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 string
      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 string. Repeated calls to this function may return the same array. This function will fail if this string's length is greater than 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