Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Interfaces

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

Deprecated Classes

Class and Description
software.amazon.ion.system.SystemFactory Use the more configurable IonSystemBuilder instead.

Deprecated Exceptions

Exceptions and Description
software.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 and Description
software.amazon.ion.IonBinaryWriter.byteSize()
software.amazon.ion.Timestamp.createFromUtcFields(Timestamp.Precision, int, int, int, int, int, int, BigDecimal, Integer)
software.amazon.ion.IonBinaryWriter.getBytes()
software.amazon.ion.IonDatagram.getBytes(byte[])
software.amazon.ion.IonDatagram.getBytes(byte[], int)
software.amazon.ion.IonBinaryWriter.getBytes(byte[], int, int)
software.amazon.ion.IonValue.getFieldId() Use IonValue.getFieldNameSymbol() instead.
software.amazon.ion.IonReader.getFieldId() Use IonReader.getFieldNameSymbol() instead.
software.amazon.ion.Timestamp.getFractionalSecond()
software.amazon.ion.IonSymbol.getSymbolId() Use IonSymbol.symbolValue() instead.
software.amazon.ion.Timestamp.getZFractionalSecond() Use Timestamp.getZDecimalSecond() instead.
software.amazon.ion.IonReader.hasNext() Applications should detect the end of the current level by checking for a null response from IonReader.next().
software.amazon.ion.IonSystem.iterate(byte[]) Will cause a memory leak when reading a gzipped byte[]. Use IonSystem.iterate(IonReader) instead.
software.amazon.ion.IonSystem.iterate(InputStream) Will cause a memory leak when reading a gzipped stream. Use IonSystem.iterate(IonReader) instead.
software.amazon.ion.IonLoader.load(InputStream) Will cause a memory leak when reading a gzipped stream. Use IonLoader.load(IonReader) instead.
software.amazon.ion.IonSystem.newBinaryWriter() Use IonSystem.newBinaryWriter(OutputStream, SymbolTable...) instead.
software.amazon.ion.IonSystem.newBinaryWriter(SymbolTable...) Use IonSystem.newBinaryWriter(OutputStream, SymbolTable...) instead.
software.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).
software.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).
software.amazon.ion.system.SystemFactory.newSystem() Use IonSystemBuilder.standard().build() instead.
software.amazon.ion.system.SystemFactory.newSystem(IonCatalog) Use IonSystemBuilder.standard().withCatalog(catalog).build() instead.
software.amazon.ion.IonDatagram.toBytes() Use IonDatagram.getBytes() instead, which is renamed for consistency with other interfaces.
software.amazon.ion.IonBinaryWriter.writeBytes(OutputStream)
software.amazon.ion.IonWriter.writeTimestampUTC(Date) Use IonWriter.writeTimestamp(Timestamp.forDateZ(Date)) instead.
software.amazon.ion.IonWriter.writeValue(IonValue) Use IonValue.writeTo(IonWriter) instead.

Deprecated Constructors

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

Deprecated Enum Constants

Enum Constant and Description
software.amazon.ion.Timestamp.Precision.FRACTION