Deprecated API

Contents

• Interfaces
• Classes
• Exception Classes
• Methods
• Constructors
• Enum Constants

Deprecated Interfaces

Interface	Description
com.amazon.ion.impl.bin._Private_IonManagedWriter	This is a private API subject to change without notice.
com.amazon.ion.impl.bin._Private_IonRawWriter	This is a private API subject to change without notice.
com.amazon.ion.IonBinaryWriter	Use IonSystem.newBinaryWriter(OutputStream, SymbolTable...) instead.
com.amazon.ion.IonTextReader	Use TextSpan instead.
com.amazon.ion.RawValueSpanProvider	This is a private API subject to change without notice.

Deprecated Classes

Class	Description
com.amazon.ion.impl._Private_IonBinaryWriterImpl
com.amazon.ion.impl.bin._PrivateIon_HashTrampoline
com.amazon.ion.system.SystemFactory	Use the more configurable IonSystemBuilder instead.
com.amazon.ion.util.Printer	Use IonValue.writeTo(IonWriter) instead.
com.amazon.ion.util.Printer.PrinterVisitor	Use IonValue.writeTo(IonWriter) instead.

Deprecated Exception Classes

Exception Class	Description
com.amazon.ion.EmptySymbolException	this exception is not used as empty symbols are valid. In cases where null is used as the symbol value it was replaced by NullPointerException

Deprecated Methods

Method	Description
com.amazon.ion.impl._Private_CurriedValueFactory.newList(Collection<? extends IonValue>)
com.amazon.ion.impl._Private_CurriedValueFactory.newSexp(Collection<? extends IonValue>)
com.amazon.ion.impl._Private_IonBinaryWriterBuilder.buildLegacy()
com.amazon.ion.impl._Private_IonWriterBase.writeValue(IonValue)
com.amazon.ion.impl._Private_Utils.newLocalSymbolTableAsStructFactory(ValueFactory)	due to DOM entanglement. Streaming applications should use .
com.amazon.ion.IonBinaryWriter.byteSize()
com.amazon.ion.IonBinaryWriter.getBytes()
com.amazon.ion.IonBinaryWriter.getBytes(byte[], int, int)
com.amazon.ion.IonBinaryWriter.writeBytes(OutputStream)
com.amazon.ion.IonDatagram.getBytes(byte[])
com.amazon.ion.IonDatagram.getBytes(byte[], int)
com.amazon.ion.IonDatagram.toBytes()	Use IonDatagram.getBytes() instead, which is renamed for consistency with other interfaces.
com.amazon.ion.IonLoader.load(InputStream)	Will cause a memory leak when reading a gzipped stream. Use IonLoader.load(IonReader) instead.
com.amazon.ion.IonReader.getFieldId()	Use IonReader.getFieldNameSymbol() instead.
com.amazon.ion.IonReader.hasNext()	Applications should detect the end of the current level by checking for a null response from IonReader.next().
com.amazon.ion.IonSymbol.getSymbolId()	Use IonSymbol.symbolValue() instead.
com.amazon.ion.IonSystem.iterate(byte[])	Will cause a memory leak when reading a gzipped byte[]. Use IonSystem.iterate(IonReader) instead.
com.amazon.ion.IonSystem.iterate(InputStream)	Will cause a memory leak when reading a gzipped stream. Use IonSystem.iterate(IonReader) instead.
com.amazon.ion.IonSystem.newBinaryWriter()	Use IonSystem.newBinaryWriter(OutputStream, SymbolTable...) instead.
com.amazon.ion.IonSystem.newBinaryWriter(SymbolTable...)	Use IonSystem.newBinaryWriter(OutputStream, SymbolTable...) instead.
com.amazon.ion.IonValue.getFieldId()	Use IonValue.getFieldNameSymbol() instead.
com.amazon.ion.IonWriter.writeTimestampUTC(Date)	Use IonWriter.writeTimestamp(Timestamp.forDateZ(Date)) instead.
com.amazon.ion.IonWriter.writeValue(IonValue)	Use IonValue.writeTo(IonWriter) instead.
com.amazon.ion.system.SystemFactory.newSystem()	Use IonSystemBuilder.standard().build() instead.
com.amazon.ion.system.SystemFactory.newSystem(IonCatalog)	Use IonSystemBuilder.standard().withCatalog(catalog).build() instead.
com.amazon.ion.Timestamp.createFromUtcFields(Timestamp.Precision, int, int, int, int, int, int, BigDecimal, Integer)
com.amazon.ion.Timestamp.getFractionalSecond()
com.amazon.ion.Timestamp.getZFractionalSecond()	Use Timestamp.getZDecimalSecond() instead.
com.amazon.ion.ValueFactory.newList(Collection<? extends IonValue>)	This method can be invoked (accidentally and incorrectly) with an IonSequence! Use either ValueFactory.newList(IonValue...) or newList().addAll(Collection).
com.amazon.ion.ValueFactory.newSexp(Collection<? extends IonValue>)	This method can be invoked (accidentally and incorrectly) with an IonSequence! Use either ValueFactory.newSexp(IonValue...) or newSexp().addAll(Collection).

Deprecated Constructors

Constructor	Description
com.amazon.ion.Timestamp(int, int, int)	Use Timestamp.forDay(int, int, int) instead.
com.amazon.ion.Timestamp(int, int, int, int, int, int, Integer)	Use Timestamp.forSecond(int, int, int, int, int, int, Integer) instead.
com.amazon.ion.Timestamp(int, int, int, int, int, int, BigDecimal, Integer)	Use Timestamp.forSecond(int, int, int, int, int, BigDecimal, Integer) instead.
com.amazon.ion.Timestamp(int, int, int, int, int, Integer)	Use Timestamp.forMinute(int, int, int, int, int, Integer) instead.
com.amazon.ion.Timestamp(long, Integer)	Use Timestamp.forMillis(long, Integer) instead.
com.amazon.ion.Timestamp(BigDecimal, Integer)	Use Timestamp.forMillis(BigDecimal, Integer) instead.
com.amazon.ion.Timestamp(Calendar)	Use Timestamp.forCalendar(Calendar) instead.

Deprecated Enum Constants

Enum Constant	Description
com.amazon.ion.Timestamp.Precision.FRACTION