Top Deprecated By Reference
Ion Java 1.11.10

Deprecated API


No API in this release is deprecated for removal.

Deprecated Item Summary

SinceDeprecated Item and 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

Returns:

the size in bytes.
com.amazon.ion.IonBinaryWriter.byteSize
()

Returns:

the byte array with the writers output
com.amazon.ion.IonBinaryWriter.getBytes
()

Returns:

number of bytes written
com.amazon.ion.IonBinaryWriter.getBytes
(byte[]
users byte array to write into
bytes
,
int
initial offset in the array to write into
offset
,
int
maximum number of bytes to write
maxlen
)

Returns:

int length of bytes written
com.amazon.ion.IonBinaryWriter.writeBytes
(OutputStream
OutputStream to write the bytes to
userstream
)

Returns:

the number of bytes copied into dst.
com.amazon.ion.IonDatagram.getBytes
(byte[]
the array into which bytes are to be written.
dst
)

Returns:

the number of bytes copied into dst.
com.amazon.ion.IonDatagram.getBytes
(byte[]
the array into which bytes are to be written.
dst
,
int
the offset within the array of the first byte to be written; must be non-negative and no larger than dst.length
offset
)

Returns:

a new, non-empty byte array containing the encoded datagram.
com.amazon.ion.IonDatagram.toBytes
()

Use getBytes() instead, which is renamed for consistency with other interfaces.

Returns:

a datagram containing all the values on the input stream; not null.
com.amazon.ion.IonLoader.load
(InputStream
the stream from which to read Ion data.
ionData
)

Will cause a memory leak when reading a gzipped stream. Use IonLoader#load(IonReader) instead.

Returns:

the symbol ID of the field name, if the current value is a field within a struct. If the current value is not a field, or if the symbol ID cannot be determined, this method returns a value less than one.
com.amazon.ion.IonReader.getFieldId
()

Use getFieldNameSymbol() instead.

com.amazon.ion.IonReader.hasNext()

Applications should detect the end of the current level by checking for a null response from next().

Returns:

an integer greater than zero, if this value has an associated symbol table. Otherwise, return SymbolTable#UNKNOWN_SYMBOL_ID.
com.amazon.ion.IonSymbol.getSymbolId
()

Use symbolValue() instead.

Returns:

a new iterator instance.
com.amazon.ion.IonSystem.iterate
(InputStream
a stream of Ion data. The caller is responsible for closing the InputStream after iteration is complete.
ionData
)

Will cause a memory leak when reading a gzipped stream. Use IonSystem#iterate(IonReader) instead.

Returns:

a new iterator instance.
com.amazon.ion.IonSystem.iterate
(byte[]
may be either Ion binary data or (UTF-8) Ion text, or GZIPped Ion data. This method assumes ownership of the array and may modify it at will.
ionData
)

Will cause a memory leak when reading a gzipped byte[]. Use IonSystem#iterate(IonReader) instead.

Returns:

a new IonBinaryWriter instance; not null.
com.amazon.ion.IonSystem.newBinaryWriter
(SymbolTable...
a sequence of shared symbol tables
imports
)

Use newBinaryWriter(OutputStream, SymbolTable...) instead.

Returns:

the symbol ID of the field name, if this is part of an IonStruct. If this is not a field, or if the symbol ID cannot be determined, this method returns a value less than one.
com.amazon.ion.IonValue.getFieldId
()

Use getFieldNameSymbol() instead.

com.amazon.ion.IonWriter.writeTimestampUTC(Date
java.util Date holding the UTC timestamp; may be null to represent null.timestamp.
value
)

Use IonWriter.writeTimestamp(Timestamp.forDateZ(Date)) instead.

com.amazon.ion.IonWriter.writeValue(IonValue
may be null, in which case this method does nothing.
value
)

Use IonValue#writeTo(IonWriter) instead.

com.amazon.ion.RawValueSpanProvider

This is a private API subject to change without notice.

com.amazon.ion.Timestamp(int zyear, int zmonth, int zday)

Use forDay(int, int, int) instead.

com.amazon.ion.Timestamp(int year, int month, int day, int hour, int minute, Integer
the local offset from UTC, measured in minutes; may be null to represent an unknown local offset
offset
)

Use forMinute(int, int, int, int, int, Integer) instead.

com.amazon.ion.Timestamp(int year, int month, int day, int hour, int minute, int second, Integer
the local offset from UTC, measured in minutes; may be null to represent an unknown local offset.
offset
)

Use forSecond(int, int, int, int, int, int, Integer) instead.

com.amazon.ion.Timestamp(int year, int month, int day, int hour, int minute, int second, BigDecimal
the fractional seconds; must not be null; if negative, its absolute value is used
frac
,
Integer
the local offset from UTC, measured in minutes; may be null to represent an unknown local offset
offset
)

Use forSecond(int, int, int, int, int, BigDecimal, Integer) instead.

com.amazon.ion.Timestamp(BigDecimal
number of milliseconds (including any fractional milliseconds) from the epoch (1970-01-01T00:00:00.000Z); must not be null
millis
,
Integer
the local offset from UTC, measured in minutes; may be null to represent an unknown local offset
localOffset
)

Use forMillis(BigDecimal, Integer) instead.

com.amazon.ion.Timestamp(long
number of milliseconds from the epoch (1970-01-01T00:00:00.000Z)
millis
,
Integer
the local offset from UTC, measured in minutes; may be null to represent an unknown local offset.
localOffset
)

Use forMillis(long, Integer) instead.

com.amazon.ion.Timestamp.createFromUtcFields(Timestamp.Precision
the desired timestamp precision. The result may have a different precision if the input data isn't precise enough.
p
,
int zyear, int zmonth, int zday, int zhour, int zminute, int zsecond, BigDecimal frac, Integer
the local offset from UTC, measured in minutes; may be null to represent an unknown local offset.
offset
)

Returns:

a BigDecimal within the range [0, 1); null is returned if the Timestamp isn't precise to the fractional second
com.amazon.ion.Timestamp.getFractionalSecond
()

Returns:

a BigDecimal within the range [0, 1); null is returned if the Timestamp isn't precise to the fractional second
com.amazon.ion.Timestamp.getZFractionalSecond
()

Use getZDecimalSecond() instead.

com.amazon.ion.ValueFactory.newList(Collection<? extends IonValue>
the initial set of children. If null, then the new instance will have IonValue#isNullValue() == true.
values
)

This method can be invoked (accidentally and incorrectly) with an IonSequence! Use either newList(IonValue...) or newList().addAll(Collection).

com.amazon.ion.ValueFactory.newSexp(Collection<? extends IonValue>
the initial set of children. If null, then the new instance will have IonValue#isNullValue() == true.
values
)

This method can be invoked (accidentally and incorrectly) with an IonSequence! Use either newSexp(IonValue...) or newSexp().addAll(Collection).

Returns:

the symbol IDs of the annotations on the current value. If the current value has no annotations, this method returns an empty array.
com.amazon.ion.impl.IonReaderContinuableCore.getAnnotationIds
()

Returns:

the symbol ID of the field name, if the current value is a field within a struct. If the current value is not a field, or if the symbol ID cannot be determined, this method returns a value less than one.
com.amazon.ion.impl.IonReaderContinuableCore.getFieldId
()

Returns:

the symbol ID of the value. If the symbol ID cannot be determined, this method returns a value less than one.
com.amazon.ion.impl.IonReaderContinuableCore.symbolValueId
()

com.amazon.ion.impl.LocalSymbolTableAsStruct

Should not be used in new code without data demonstrating its benefits. Instead, use LocalSymbolTable.

com.amazon.ion.impl._Private_CurriedValueFactory.newList(Collection<? extends IonValue>
the initial set of children. If null, then the new instance will have IonValue#isNullValue() == true.
values
)

com.amazon.ion.impl._Private_CurriedValueFactory.newSexp(Collection<? extends IonValue>
the initial set of children. If null, then the new instance will have IonValue#isNullValue() == true.
values
)

com.amazon.ion.impl._Private_IonWriterBase.writeValue(IonValue
may be null, in which case this method does nothing.
value
)

com.amazon.ion.impl._Private_Utils.newLocalSymbolTableAsStructFactory(ValueFactory
the ValueFactory from which to construct the IonStruct representation of the LST
imageFactory
)

due to DOM entanglement. Streaming applications should use LocalSymbolTable#DEFAULT_LST_FACTORY.

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.impl.lite.IonSystemLite.newBinaryWriter(SymbolTable...
a sequence of shared symbol tables
imports
)

com.amazon.ion.system.SystemFactory

Use the more configurable IonSystemBuilder instead.

Returns:

a new IonSystem instance; not null.
com.amazon.ion.system.SystemFactory.newSystem
(IonCatalog
the catalog to use in the new system. If null, a new SimpleCatalog will be used.
catalog
)

Use IonSystemBuilder.standard().withCatalog(catalog).build() instead.

Deprecated Reference Summary

SinceItem with Deprecated Reference and Description
com.amazon.ion.IonSystem.newReader(String
must not be null.
ionText
)

IonTextReader is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.IonReaderContinuableTopLevelBinary.RawValueSpanProviderFacet

RawValueSpanProvider is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.IonReaderTextRawX

IonTextReader is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.IonReaderTextSystemX

IonReaderTextRawX is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.IonReaderTextUserX

IonReaderTextSystemX is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.IonReaderTextUserX.IonReaderTextSpan(IonReaderTextUserX reader)

IonReaderTextUserX is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl._Private_IonReaderBuilder.build(String
the source of the Ion text data. Must not be null.
ionText
)

IonTextReader is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl._Private_IonReaderFactory.makeReaderText(IonCatalog catalog, CharSequence chars, _Private_LocalSymbolTableFactory lstFactory)

IonTextReader is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl._Private_IonReaderFactory.makeReaderText(IonCatalog catalog, Reader chars, _Private_LocalSymbolTableFactory lstFactory)

IonTextReader is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter

_Private_IonManagedWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.symbols

IonRawBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.user

IonRawBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.getRawWriter()

_Private_IonRawWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.SymbolState.closeTable(IonRawBinaryWriter writer)

IonRawBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.UserState.afterStepOut(final IonManagedBinaryWriter self)

IonManagedBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.UserState.beforeStepIn(final IonManagedBinaryWriter self, final IonType type)

IonManagedBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.UserState.writeInt(final IonManagedBinaryWriter self, final long value)

IonManagedBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.UserState.writeInt(IonManagedBinaryWriter self, BigInteger value)

IonManagedBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.UserState.writeString(final IonManagedBinaryWriter self, final String value)

IonManagedBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonManagedBinaryWriter.UserState.writeSymbolToken(final IonManagedBinaryWriter self, final SymbolToken value)

IonManagedBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin.IonRawBinaryWriter

_Private_IonRawWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.bin._Private_IonManagedBinaryWriterBuilder.newLegacyWriter()

IonBinaryWriter is deprecated or references (maybe indirectly) at least one deprecated element.

Returns:

the _Private_IonRawWriter responsible for writing this IonManagedWriter's user values.
com.amazon.ion.impl.bin._Private_IonManagedWriter.getRawWriter
()

_Private_IonRawWriter is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.impl.lite.IonSystemLite.newReader(String
must not be null.
ionText
)

IonTextReader is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.system.IonReaderBuilder.build(String
the source of the Ion text data. Must not be null.
ionText
)

IonTextReader is deprecated or references (maybe indirectly) at least one deprecated element.

com.amazon.ion.util.Printer._print(IonValue value, Printer.PrinterVisitor pv)

Printer.PrinterVisitor is deprecated or references (maybe indirectly) at least one deprecated element.

Returns:

the visitor to invoke for printing.
com.amazon.ion.util.Printer.makeVisitor
(Printer.Options
is a fresh copy of the Printer's options instance, not null.
options
,
Appendable
is not null.
out
)

Printer.PrinterVisitor is deprecated or references (maybe indirectly) at least one deprecated element.