Package com.amazon.ion

Interface IonClob

All Superinterfaces:
Cloneable, IonLob, IonValue
public interface IonClob extends IonValue, IonLob
An Ion clob value.

WARNING: This interface should not be implemented or extended by code outside of this library.

  • Method Details

    • newReader

      Reader newReader(Charset cs)
      Creates a new Reader that provides the value of this clob as text, decoding the raw bytes using a given character set.
      Parameters:
      cs - must not be null.
      Returns:
      a new reader positioned at the start of the clob, or null if this.isNullValue().

    • stringValue

      String stringValue(Charset cs)
      Gets the value of this clob as a Java String value, decoding the raw bytes using a given character set. This is a convenience wrapper around newReader(Charset).

      The behavior of this method when the clob bytes are not valid in the given charset is unspecified.

      Parameters:
      cs - must not be null.
      Returns:
      the decoded text, or null if this.isNullValue().

    • clone

      IonClob clone() throws UnknownSymbolException
      Description copied from interface: IonValue
      Creates a copy of this value and all of its children. The cloned value may use the same shared symbol tables, but it will have an independent local symbol table if necessary. The cloned value will be modifiable regardless of whether this instance IonValue.isReadOnly().

      The cloned value will be created in the context of the same ValueFactory as this instance; if you want a copy using a different factory, then use ValueFactory.clone(IonValue) instead.

      Specified by:
      clone in interface IonLob
      Specified by:
      clone in interface IonValue
      Throws:
      UnknownSymbolException - if any part of this value has unknown text but known Sid for its field name, annotation or symbol.