Ion Java 1.11.10 · com.amazon.ion.impl._Private_CurriedValueFactory

Modifier and Type	Field and Description
private final ValueFactory	myFactory

Access	Constructor and Description
protected	_Private_CurriedValueFactory(ValueFactory must not be null. factory)

Method Summary

Modifier and Type	Method and Description
public <T extends IonValue> T	clone(T the value to copy. value) Implements com.amazon.ion.ValueFactory.clone. Creates a deep copy of an Ion value.
protected abstract void	handle(IonValue was just constructed by `myFactory`. newValue) Subclasses override this to do something with each newly-constructed value.
public IonBlob	newBlob(byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.blob` value. value) Implements com.amazon.ion.ValueFactory.newBlob. Constructs a new Ion `blob` instance, copying bytes from an array.
public IonBlob	newBlob(byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.blob` value. value, int the offset within the array of the first byte to copy; must be non-negative and no larger than `bytes.length`. offset, int the number of bytes to be copied from the given array; must be non-negative and no larger than `bytes.length - offset`. length) Implements com.amazon.ion.ValueFactory.newBlob. Constructs a new Ion `blob`, copying bytes from part of an array.
public IonBool	newBool(boolean the new `bool`'s value. value) Implements com.amazon.ion.ValueFactory.newBool. Constructs a new `bool` instance with the given value.
public IonBool	newBool(Boolean the new `bool`'s value. may be `null` to make `null.bool`. value) Implements com.amazon.ion.ValueFactory.newBool. Constructs a new `bool` instance with the given value.
public IonClob	newClob(byte[] the data for the new clob, to be copied from the given array into the new instance. May be `null` to create a `null.clob` value. value) Implements com.amazon.ion.ValueFactory.newClob. Constructs a new Ion `clob` instance from a byte array.
public IonClob	newClob(byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.clob` value. value, int the offset within the array of the first byte to copy; must be non-negative an no larger than `bytes.length`. offset, int the number of bytes to be copied from the given array; must be non-negative an no larger than `bytes.length - offset`. length) Implements com.amazon.ion.ValueFactory.newClob. Constructs a new Ion `clob`, copying bytes from part of an array.
public IonDecimal	newDecimal(long value) Implements com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `long`.
public IonDecimal	newDecimal(double value) Implements com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `double`.
public IonDecimal	newDecimal(BigInteger value) Implements com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `BigInteger`.
public IonDecimal	newDecimal(BigDecimal value) Implements com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `BigDecimal`.
public IonList	newEmptyList() Implements com.amazon.ion.ValueFactory.newEmptyList. Constructs a new empty (not null) `list` instance.
public IonSexp	newEmptySexp() Implements com.amazon.ion.ValueFactory.newEmptySexp. Constructs a new empty (not null) `sexp` instance.
public IonStruct	newEmptyStruct() Implements com.amazon.ion.ValueFactory.newEmptyStruct. Constructs a new empty (not null) `struct` instance.
public IonFloat	newFloat(long value) Implements com.amazon.ion.ValueFactory.newFloat. Constructs a new Ion `float` instance from a Java `long`.
public IonFloat	newFloat(double value) Implements com.amazon.ion.ValueFactory.newFloat. Constructs a new Ion `float` instance from a Java `double`.
public IonInt	newInt(int the new int's value. value) Implements com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value.
public IonInt	newInt(long the new int's value. value) Implements com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value.
public IonInt	newInt(Number the new int's value; may be `null` to make `null.int`. value) Implements com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value.
public IonList	newList(Collection<? extends IonValue> the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. values) Implements com.amazon.ion.ValueFactory.newList. Deprecated Constructs a new `list` with given children.
public IonList	newList(IonSequence the initial child of the new list. firstChild) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with the given child.
public IonList	newList(IonValue... the initial sequence of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. values) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with the given children.
public IonList	newList(int[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. values) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given `int` children.
public IonList	newList(long[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. values) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given `long` child elements.
public IonNull	newNull() Implements com.amazon.ion.ValueFactory.newNull. Constructs a new `null.null` instance.
public IonValue	newNull(IonType must not be Java null, but it may be `IonType#NULL`. type) Implements com.amazon.ion.ValueFactory.newNull. Constructs a new Ion null value with the given type.
public IonBlob	newNullBlob() Implements com.amazon.ion.ValueFactory.newNullBlob. Constructs a new `null.blob` instance.
public IonBool	newNullBool() Implements com.amazon.ion.ValueFactory.newNullBool. Constructs a new `null.bool` instance.
public IonClob	newNullClob() Implements com.amazon.ion.ValueFactory.newNullClob. Constructs a new `null.clob` instance.
public IonDecimal	newNullDecimal() Implements com.amazon.ion.ValueFactory.newNullDecimal. Constructs a new `null.decimal` instance.
public IonFloat	newNullFloat() Implements com.amazon.ion.ValueFactory.newNullFloat. Constructs a new `null.float` instance.
public IonInt	newNullInt() Implements com.amazon.ion.ValueFactory.newNullInt. Constructs a new `null.int` instance.
public IonList	newNullList() Implements com.amazon.ion.ValueFactory.newNullList. Constructs a new `null.list` instance.
public IonSexp	newNullSexp() Implements com.amazon.ion.ValueFactory.newNullSexp. Constructs a new `null.sexp` instance.
public IonString	newNullString() Implements com.amazon.ion.ValueFactory.newNullString. Constructs a new `null.string` instance.
public IonStruct	newNullStruct() Implements com.amazon.ion.ValueFactory.newNullStruct. Constructs a new `null.struct` instance.
public IonSymbol	newNullSymbol() Implements com.amazon.ion.ValueFactory.newNullSymbol. Constructs a new `null.symbol` instance.
public IonTimestamp	newNullTimestamp() Implements com.amazon.ion.ValueFactory.newNullTimestamp. Constructs a new `null.timestamp` instance.
public IonSexp	newSexp(Collection<? extends IonValue> the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. values) Implements com.amazon.ion.ValueFactory.newSexp. Deprecated Constructs a new `sexp` with given child elements.
public IonSexp	newSexp(IonSequence the initial child of the new sexp. firstChild) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with the given child.
public IonSexp	newSexp(IonValue... the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. values) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given child elements.
public IonSexp	newSexp(int[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. values) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given `int` child values.
public IonSexp	newSexp(long[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. values) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given `long` child elements.
public IonString	newString(String the text of the new string; may be `null` to make `null.string`. value) Implements com.amazon.ion.ValueFactory.newString. Constructs a new Ion string with the given value.
public IonSymbol	newSymbol(String the text of the symbol; may be `null` to make `null.symbol`. value) Implements com.amazon.ion.ValueFactory.newSymbol. Constructs a new Ion symbol with the given value.
public IonSymbol	newSymbol(SymbolToken the text and/or SID of the symbol; may be `null` to make `null.symbol`. value) Implements com.amazon.ion.ValueFactory.newSymbol. Constructs a new Ion symbol with the given symbol token.
public IonTimestamp	newTimestamp(Timestamp may be `null` to make `null.timestamp`. value) Implements com.amazon.ion.ValueFactory.newTimestamp. Constructs a new `timestamp` instance with the given value.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

myFactory	back to summary
private final ValueFactory myFactory

_Private_CurriedValueFactory	back to summary
protected _Private_CurriedValueFactory(ValueFactory factory) Parameters factory:ValueFactory must not be null.

Method Detail

clone back to summary

clone	back to summary
public <T extends IonValue> T clone(T value) throws IonException Implements com.amazon.ion.ValueFactory.clone. Doc from com.amazon.ion.ValueFactory.clone. Creates a deep copy of an Ion value. This method can properly clone `IonDatagram`s. The given value can be in the context of any `ValueFactory`, and the result will be in the context of this one. This allows you to shift data from one factory instance to another. Parameters value:T the value to copy. Returns:T a deep copy of value, with no container. Exceptions IonException: if there's a problem creating the clone.

public <T extends IonValue> T clone(T value) throws IonException

Implements com.amazon.ion.ValueFactory.clone.

Doc from com.amazon.ion.ValueFactory.clone.

Creates a deep copy of an Ion value. This method can properly clone IonDatagrams.

The given value can be in the context of any ValueFactory, and the result will be in the context of this one. This allows you to shift data from one factory instance to another.

Parameters

value:T: the value to copy.

Returns:T

a deep copy of value, with no container.

Exceptions

IonException:: if there's a problem creating the clone.

handle back to summary

handle	back to summary
protected abstract void handle(IonValue newValue) Subclasses override this to do something with each newly-constructed value. Parameters newValue:IonValue was just constructed by `myFactory`.

protected abstract void handle(IonValue newValue)

Subclasses override this to do something with each newly-constructed value.

Parameters

newValue:IonValue: was just constructed by myFactory.

newBlob back to summary

newBlob	back to summary
public IonBlob newBlob(byte[] value) Implements com.amazon.ion.ValueFactory.newBlob. Doc from com.amazon.ion.ValueFactory.newBlob. Constructs a new Ion `blob` instance, copying bytes from an array. Parameters value:byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.blob` value.

public IonBlob newBlob(byte[] value)

Implements com.amazon.ion.ValueFactory.newBlob.

Doc from com.amazon.ion.ValueFactory.newBlob.

Constructs a new Ion blob instance, copying bytes from an array.

Parameters

value:byte[]: the data for the new blob, to be copied from the given array into the new instance. May be null to create a null.blob value.

newBlob back to summary

newBlob	back to summary
public IonBlob newBlob(byte[] value, int offset, int length) Implements com.amazon.ion.ValueFactory.newBlob. Doc from com.amazon.ion.ValueFactory.newBlob. Constructs a new Ion `blob`, copying bytes from part of an array. This method copies `length` bytes from the given array into the new value, starting at the given offset in the array. Parameters value:byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.blob` value. offset:int the offset within the array of the first byte to copy; must be non-negative and no larger than `bytes.length`. length:int the number of bytes to be copied from the given array; must be non-negative and no larger than `bytes.length - offset`.

public IonBlob newBlob(byte[] value, int offset, int length)

Implements com.amazon.ion.ValueFactory.newBlob.

Doc from com.amazon.ion.ValueFactory.newBlob.

Constructs a new Ion blob, copying bytes from part of an array.

This method copies length bytes from the given array into the new value, starting at the given offset in the array.

Parameters

value:byte[]: the data for the new blob, to be copied from the given array into the new instance. May be null to create a null.blob value.
offset:int: the offset within the array of the first byte to copy; must be non-negative and no larger than bytes.length.
length:int: the number of bytes to be copied from the given array; must be non-negative and no larger than bytes.length - offset.

newBool back to summary

newBool	back to summary
public IonBool newBool(boolean value) Implements com.amazon.ion.ValueFactory.newBool. Doc from com.amazon.ion.ValueFactory.newBool. Constructs a new `bool` instance with the given value. Parameters value:boolean the new `bool`'s value. Returns:IonBool a bool with `IonBool#booleanValue() == value`.

public IonBool newBool(boolean value)

Implements com.amazon.ion.ValueFactory.newBool.

Doc from com.amazon.ion.ValueFactory.newBool.

Constructs a new bool instance with the given value.

Parameters

value:boolean: the new bool's value.

Returns:IonBool

a bool with IonBool#booleanValue() == value.

newBool back to summary

newBool	back to summary
public IonBool newBool(Boolean value) Implements com.amazon.ion.ValueFactory.newBool. Doc from com.amazon.ion.ValueFactory.newBool. Constructs a new `bool` instance with the given value. Parameters value:Boolean the new `bool`'s value. may be `null` to make `null.bool`.

public IonBool newBool(Boolean value)

Implements com.amazon.ion.ValueFactory.newBool.

Doc from com.amazon.ion.ValueFactory.newBool.

Constructs a new bool instance with the given value.

Parameters

value:Boolean: the new bool's value. may be null to make null.bool.

newClob back to summary

newClob	back to summary
public IonClob newClob(byte[] value) Implements com.amazon.ion.ValueFactory.newClob. Doc from com.amazon.ion.ValueFactory.newClob. Constructs a new Ion `clob` instance from a byte array. Parameters value:byte[] the data for the new clob, to be copied from the given array into the new instance. May be `null` to create a `null.clob` value.

public IonClob newClob(byte[] value)

Implements com.amazon.ion.ValueFactory.newClob.

Doc from com.amazon.ion.ValueFactory.newClob.

Constructs a new Ion clob instance from a byte array.

Parameters

value:byte[]: the data for the new clob, to be copied from the given array into the new instance. May be null to create a null.clob value.

newClob back to summary

newClob	back to summary
public IonClob newClob(byte[] value, int offset, int length) Implements com.amazon.ion.ValueFactory.newClob. Doc from com.amazon.ion.ValueFactory.newClob. Constructs a new Ion `clob`, copying bytes from part of an array. This method copies `length` bytes from the given array into the new value, starting at the given offset in the array. Parameters value:byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.clob` value. offset:int the offset within the array of the first byte to copy; must be non-negative an no larger than `bytes.length`. length:int the number of bytes to be copied from the given array; must be non-negative an no larger than `bytes.length - offset`.

public IonClob newClob(byte[] value, int offset, int length)

Implements com.amazon.ion.ValueFactory.newClob.

Doc from com.amazon.ion.ValueFactory.newClob.

Constructs a new Ion clob, copying bytes from part of an array.

This method copies length bytes from the given array into the new value, starting at the given offset in the array.

Parameters

value:byte[]: the data for the new blob, to be copied from the given array into the new instance. May be null to create a null.clob value.
offset:int: the offset within the array of the first byte to copy; must be non-negative an no larger than bytes.length.
length:int: the number of bytes to be copied from the given array; must be non-negative an no larger than bytes.length - offset.

newDecimal back to summary

newDecimal	back to summary
public IonDecimal newDecimal(long value) Implements com.amazon.ion.ValueFactory.newDecimal. Doc from com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `long`.

public IonDecimal newDecimal(long value)

Implements com.amazon.ion.ValueFactory.newDecimal.

Doc from com.amazon.ion.ValueFactory.newDecimal.

Constructs a new Ion decimal instance from a Java long.

newDecimal back to summary

newDecimal	back to summary
public IonDecimal newDecimal(double value) Implements com.amazon.ion.ValueFactory.newDecimal. Doc from com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `double`. Note that this does not generate the exact decimal representation of the `double`'s binary floating-point value as via `BigDecimal#BigDecimal(double)`, but instead uses the more predictable behavior of matching the double's string representation as via `BigDecimal#valueOf(double)`.

public IonDecimal newDecimal(double value)

Implements com.amazon.ion.ValueFactory.newDecimal.

Doc from com.amazon.ion.ValueFactory.newDecimal.

Constructs a new Ion decimal instance from a Java double.

Note that this does not generate the exact decimal representation of the double's binary floating-point value as via BigDecimal#BigDecimal(double), but instead uses the more predictable behavior of matching the double's string representation as via BigDecimal#valueOf(double).

newDecimal back to summary

newDecimal	back to summary
public IonDecimal newDecimal(BigInteger value) Implements com.amazon.ion.ValueFactory.newDecimal. Doc from com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `BigInteger`.

public IonDecimal newDecimal(BigInteger value)

Implements com.amazon.ion.ValueFactory.newDecimal.

Doc from com.amazon.ion.ValueFactory.newDecimal.

Constructs a new Ion decimal instance from a Java BigInteger.

newDecimal back to summary

newDecimal	back to summary
public IonDecimal newDecimal(BigDecimal value) Implements com.amazon.ion.ValueFactory.newDecimal. Doc from com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `BigDecimal`. To create negative zero values, pass a `Decimal`.

public IonDecimal newDecimal(BigDecimal value)

Implements com.amazon.ion.ValueFactory.newDecimal.

Doc from com.amazon.ion.ValueFactory.newDecimal.

Constructs a new Ion decimal instance from a Java BigDecimal. To create negative zero values, pass a Decimal.

newEmptyList back to summary

newEmptyList	back to summary
public IonList newEmptyList() Implements com.amazon.ion.ValueFactory.newEmptyList. Doc from com.amazon.ion.ValueFactory.newEmptyList. Constructs a new empty (not null) `list` instance.

public IonList newEmptyList()

Implements com.amazon.ion.ValueFactory.newEmptyList.

Doc from com.amazon.ion.ValueFactory.newEmptyList.

Constructs a new empty (not null) list instance.

newEmptySexp back to summary

newEmptySexp	back to summary
public IonSexp newEmptySexp() Implements com.amazon.ion.ValueFactory.newEmptySexp. Doc from com.amazon.ion.ValueFactory.newEmptySexp. Constructs a new empty (not null) `sexp` instance.

public IonSexp newEmptySexp()

Implements com.amazon.ion.ValueFactory.newEmptySexp.

Doc from com.amazon.ion.ValueFactory.newEmptySexp.

Constructs a new empty (not null) sexp instance.

newEmptyStruct back to summary

newEmptyStruct	back to summary
public IonStruct newEmptyStruct() Implements com.amazon.ion.ValueFactory.newEmptyStruct. Doc from com.amazon.ion.ValueFactory.newEmptyStruct. Constructs a new empty (not null) `struct` instance.

public IonStruct newEmptyStruct()

Implements com.amazon.ion.ValueFactory.newEmptyStruct.

Doc from com.amazon.ion.ValueFactory.newEmptyStruct.

Constructs a new empty (not null) struct instance.

newFloat back to summary

newFloat	back to summary
public IonFloat newFloat(long value) Implements com.amazon.ion.ValueFactory.newFloat. Doc from com.amazon.ion.ValueFactory.newFloat. Constructs a new Ion `float` instance from a Java `long`.

public IonFloat newFloat(long value)

Implements com.amazon.ion.ValueFactory.newFloat.

Doc from com.amazon.ion.ValueFactory.newFloat.

Constructs a new Ion float instance from a Java long.

newFloat back to summary

newFloat	back to summary
public IonFloat newFloat(double value) Implements com.amazon.ion.ValueFactory.newFloat. Doc from com.amazon.ion.ValueFactory.newFloat. Constructs a new Ion `float` instance from a Java `double`.

public IonFloat newFloat(double value)

Implements com.amazon.ion.ValueFactory.newFloat.

Doc from com.amazon.ion.ValueFactory.newFloat.

Constructs a new Ion float instance from a Java double.

newInt back to summary

newInt	back to summary
public IonInt newInt(int value) Implements com.amazon.ion.ValueFactory.newInt. Doc from com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value. Parameters value:int the new int's value.

public IonInt newInt(int value)

Implements com.amazon.ion.ValueFactory.newInt.

Doc from com.amazon.ion.ValueFactory.newInt.

Constructs a new int instance with the given value.

Parameters

value:int: the new int's value.

newInt back to summary

newInt	back to summary
public IonInt newInt(long value) Implements com.amazon.ion.ValueFactory.newInt. Doc from com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value. Parameters value:long the new int's value.

public IonInt newInt(long value)

Implements com.amazon.ion.ValueFactory.newInt.

Doc from com.amazon.ion.ValueFactory.newInt.

Constructs a new int instance with the given value.

Parameters

value:long: the new int's value.

newInt back to summary

newInt	back to summary
public IonInt newInt(Number value) Implements com.amazon.ion.ValueFactory.newInt. Doc from com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value. The integer portion of the number is used, any fractional portion is ignored. Parameters value:Number the new int's value; may be `null` to make `null.int`.

public IonInt newInt(Number value)

Implements com.amazon.ion.ValueFactory.newInt.

Doc from com.amazon.ion.ValueFactory.newInt.

Constructs a new int instance with the given value. The integer portion of the number is used, any fractional portion is ignored.

Parameters

value:Number: the new int's value; may be null to make null.int.

newList back to summary

newList	back to summary
public IonList newList(Collection<? extends IonValue> values) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Deprecated Constructs a new `list` with given children. Parameters values:Collection<? extends IonValue> the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Annotations @Deprecated Exceptions ContainedValueException: if any value in `values` has `IonValue#getContainer() != null`. NullPointerException: if any value in `values` is null.

public IonList newList(Collection<? extends IonValue> values) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Deprecated

Constructs a new list with given children.

Parameters

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

Annotations

@Deprecated

Exceptions

ContainedValueException:: if any value in values has IonValue#getContainer() != null.
NullPointerException:: if any value in values is null.

newList back to summary

newList	back to summary
public IonList newList(IonSequence firstChild) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with the given child. This method is temporary until `newList(Collection)` is removed. It's sole purpose is to avoid the doomed attempt to add all of the parameter's children to the new list; that will always throw `ContainedValueException`. Parameters firstChild:IonSequence the initial child of the new list. Exceptions ContainedValueException: if `child` has `IonValue#getContainer() != null`. NullPointerException: if `child` is null.

public IonList newList(IonSequence firstChild) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with the given child.

This method is temporary until newList(Collection) is removed. It's sole purpose is to avoid the doomed attempt to add all of the parameter's children to the new list; that will always throw ContainedValueException.

Parameters

firstChild:IonSequence: the initial child of the new list.

Exceptions

ContainedValueException:: if child has IonValue#getContainer() != null.
NullPointerException:: if child is null.

newList back to summary

newList	back to summary
public IonList newList(IonValue... values) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with the given children. Some edge cases are worth examples: factory.newList(); // returns [] factory.newList((IonValue[]) null); // returns null.list For clarity, applications should prefer `newEmptyList()` and `newNullList()` instead. Parameters values:IonValue[] the initial sequence of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Exceptions ContainedValueException: if any child has `IonValue#getContainer() != null`. NullPointerException: if any child is null.

public IonList newList(IonValue... values) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with the given children.

Some edge cases are worth examples:

    factory.newList();                     // returns []
    factory.newList((IonValue[]) null);    // returns null.list

For clarity, applications should prefer newEmptyList() and newNullList() instead.

Parameters

values:IonValue[]: the initial sequence of children. If null, then the new instance will have IonValue#isNullValue() == true.

Exceptions

ContainedValueException:: if any child has IonValue#getContainer() != null.
NullPointerException:: if any child is null.

newList back to summary

newList	back to summary
public IonList newList(int[] values) Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given `int` children. Parameters values:int[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. Returns:IonList a new list where each element is an `IonInt`.

public IonList newList(int[] values)

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with given int children.

Parameters

values:int[]: the initial set of child values. If null, then the new instance will have IonValue#isNullValue() == true. Otherwise, the resulting sequence will contain new IonInts with the given values.

Returns:IonList

a new list where each element is an IonInt.

newList back to summary

newList	back to summary
public IonList newList(long[] values) Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given `long` child elements. Parameters values:long[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. Returns:IonList a new list where each element is an `IonInt`.

public IonList newList(long[] values)

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with given long child elements.

Parameters

values:long[]: the initial set of child values. If null, then the new instance will have IonValue#isNullValue() == true. Otherwise, the resulting sequence will contain new IonInts with the given values.

Returns:IonList

a new list where each element is an IonInt.

newNull back to summary

newNull	back to summary
public IonNull newNull() Implements com.amazon.ion.ValueFactory.newNull. Doc from com.amazon.ion.ValueFactory.newNull. Constructs a new `null.null` instance.

public IonNull newNull()

Implements com.amazon.ion.ValueFactory.newNull.

Doc from com.amazon.ion.ValueFactory.newNull.

Constructs a new null.null instance.

newNull back to summary

newNull	back to summary
public IonValue newNull(IonType type) Implements com.amazon.ion.ValueFactory.newNull. Doc from com.amazon.ion.ValueFactory.newNull. Constructs a new Ion null value with the given type. Parameters type:IonType must not be Java null, but it may be `IonType#NULL`. Returns:IonValue a new value such that `IonValue#isNullValue()` is `true`.

public IonValue newNull(IonType type)

Implements com.amazon.ion.ValueFactory.newNull.

Doc from com.amazon.ion.ValueFactory.newNull.

Constructs a new Ion null value with the given type.

Parameters

type:IonType: must not be Java null, but it may be IonType#NULL.

Returns:IonValue

a new value such that IonValue#isNullValue() is true.

newNullBlob back to summary

newNullBlob	back to summary
public IonBlob newNullBlob() Implements com.amazon.ion.ValueFactory.newNullBlob. Doc from com.amazon.ion.ValueFactory.newNullBlob. Constructs a new `null.blob` instance.

public IonBlob newNullBlob()

Implements com.amazon.ion.ValueFactory.newNullBlob.

Doc from com.amazon.ion.ValueFactory.newNullBlob.

Constructs a new null.blob instance.

newNullBool back to summary

newNullBool	back to summary
public IonBool newNullBool() Implements com.amazon.ion.ValueFactory.newNullBool. Doc from com.amazon.ion.ValueFactory.newNullBool. Constructs a new `null.bool` instance.

public IonBool newNullBool()

Implements com.amazon.ion.ValueFactory.newNullBool.

Doc from com.amazon.ion.ValueFactory.newNullBool.

Constructs a new null.bool instance.

newNullClob back to summary

newNullClob	back to summary
public IonClob newNullClob() Implements com.amazon.ion.ValueFactory.newNullClob. Doc from com.amazon.ion.ValueFactory.newNullClob. Constructs a new `null.clob` instance.

public IonClob newNullClob()

Implements com.amazon.ion.ValueFactory.newNullClob.

Doc from com.amazon.ion.ValueFactory.newNullClob.

Constructs a new null.clob instance.

newNullDecimal back to summary

newNullDecimal	back to summary
public IonDecimal newNullDecimal() Implements com.amazon.ion.ValueFactory.newNullDecimal. Doc from com.amazon.ion.ValueFactory.newNullDecimal. Constructs a new `null.decimal` instance.

public IonDecimal newNullDecimal()

Implements com.amazon.ion.ValueFactory.newNullDecimal.

Doc from com.amazon.ion.ValueFactory.newNullDecimal.

Constructs a new null.decimal instance.

newNullFloat back to summary

newNullFloat	back to summary
public IonFloat newNullFloat() Implements com.amazon.ion.ValueFactory.newNullFloat. Doc from com.amazon.ion.ValueFactory.newNullFloat. Constructs a new `null.float` instance.

public IonFloat newNullFloat()

Implements com.amazon.ion.ValueFactory.newNullFloat.

Doc from com.amazon.ion.ValueFactory.newNullFloat.

Constructs a new null.float instance.

newNullInt back to summary

newNullInt	back to summary
public IonInt newNullInt() Implements com.amazon.ion.ValueFactory.newNullInt. Doc from com.amazon.ion.ValueFactory.newNullInt. Constructs a new `null.int` instance.

public IonInt newNullInt()

Implements com.amazon.ion.ValueFactory.newNullInt.

Doc from com.amazon.ion.ValueFactory.newNullInt.

Constructs a new null.int instance.

newNullList back to summary

newNullList	back to summary
public IonList newNullList() Implements com.amazon.ion.ValueFactory.newNullList. Doc from com.amazon.ion.ValueFactory.newNullList. Constructs a new `null.list` instance.

public IonList newNullList()

Implements com.amazon.ion.ValueFactory.newNullList.

Doc from com.amazon.ion.ValueFactory.newNullList.

Constructs a new null.list instance.

newNullSexp back to summary

newNullSexp	back to summary
public IonSexp newNullSexp() Implements com.amazon.ion.ValueFactory.newNullSexp. Doc from com.amazon.ion.ValueFactory.newNullSexp. Constructs a new `null.sexp` instance.

public IonSexp newNullSexp()

Implements com.amazon.ion.ValueFactory.newNullSexp.

Doc from com.amazon.ion.ValueFactory.newNullSexp.

Constructs a new null.sexp instance.

newNullString back to summary

newNullString	back to summary
public IonString newNullString() Implements com.amazon.ion.ValueFactory.newNullString. Doc from com.amazon.ion.ValueFactory.newNullString. Constructs a new `null.string` instance.

public IonString newNullString()

Implements com.amazon.ion.ValueFactory.newNullString.

Doc from com.amazon.ion.ValueFactory.newNullString.

Constructs a new null.string instance.

newNullStruct back to summary

newNullStruct	back to summary
public IonStruct newNullStruct() Implements com.amazon.ion.ValueFactory.newNullStruct. Doc from com.amazon.ion.ValueFactory.newNullStruct. Constructs a new `null.struct` instance.

public IonStruct newNullStruct()

Implements com.amazon.ion.ValueFactory.newNullStruct.

Doc from com.amazon.ion.ValueFactory.newNullStruct.

Constructs a new null.struct instance.

newNullSymbol back to summary

newNullSymbol	back to summary
public IonSymbol newNullSymbol() Implements com.amazon.ion.ValueFactory.newNullSymbol. Doc from com.amazon.ion.ValueFactory.newNullSymbol. Constructs a new `null.symbol` instance.

public IonSymbol newNullSymbol()

Implements com.amazon.ion.ValueFactory.newNullSymbol.

Doc from com.amazon.ion.ValueFactory.newNullSymbol.

Constructs a new null.symbol instance.

newNullTimestamp back to summary

newNullTimestamp	back to summary
public IonTimestamp newNullTimestamp() Implements com.amazon.ion.ValueFactory.newNullTimestamp. Doc from com.amazon.ion.ValueFactory.newNullTimestamp. Constructs a new `null.timestamp` instance.

public IonTimestamp newNullTimestamp()

Implements com.amazon.ion.ValueFactory.newNullTimestamp.

Doc from com.amazon.ion.ValueFactory.newNullTimestamp.

Constructs a new null.timestamp instance.

newSexp back to summary

newSexp	back to summary
public IonSexp newSexp(Collection<? extends IonValue> values) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Deprecated Constructs a new `sexp` with given child elements. Parameters values:Collection<? extends IonValue> the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Annotations @Deprecated Exceptions ContainedValueException: if any value in `values` has `IonValue#getContainer() != null`. NullPointerException: if any value in `values` is null.

public IonSexp newSexp(Collection<? extends IonValue> values) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Deprecated

Constructs a new sexp with given child elements.

Parameters

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

Annotations

@Deprecated

Exceptions

ContainedValueException:: if any value in values has IonValue#getContainer() != null.
NullPointerException:: if any value in values is null.

newSexp back to summary

newSexp	back to summary
public IonSexp newSexp(IonSequence firstChild) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with the given child. This method is temporary until `newSexp(Collection)` is removed. It's sole purpose is to avoid the doomed attempt to add all of the parameter's children to the new sequence; that will always throw `ContainedValueException`. Parameters firstChild:IonSequence the initial child of the new sexp. Exceptions ContainedValueException: if `child` has `IonValue#getContainer() != null`. NullPointerException: if `child` is null.

public IonSexp newSexp(IonSequence firstChild) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with the given child.

This method is temporary until newSexp(Collection) is removed. It's sole purpose is to avoid the doomed attempt to add all of the parameter's children to the new sequence; that will always throw ContainedValueException.

Parameters

firstChild:IonSequence: the initial child of the new sexp.

Exceptions

ContainedValueException:: if child has IonValue#getContainer() != null.
NullPointerException:: if child is null.

newSexp back to summary

newSexp	back to summary
public IonSexp newSexp(IonValue... values) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given child elements. Some edge cases are worth examples: factory.newSexp(); // returns () factory.newSexp((IonValue[]) null); // returns null.sexp For clarity, applications should prefer `newEmptySexp()` and `newNullSexp()` instead. Parameters values:IonValue[] the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Exceptions ContainedValueException: if any child has `IonValue#getContainer() != null`. NullPointerException: if any child is null.

public IonSexp newSexp(IonValue... values) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with given child elements.

Some edge cases are worth examples:

    factory.newSexp();                     // returns ()
    factory.newSexp((IonValue[]) null);    // returns null.sexp

For clarity, applications should prefer newEmptySexp() and newNullSexp() instead.

Parameters

values:IonValue[]: the initial set of children. If null, then the new instance will have IonValue#isNullValue() == true.

Exceptions

ContainedValueException:: if any child has IonValue#getContainer() != null.
NullPointerException:: if any child is null.

newSexp back to summary

newSexp	back to summary
public IonSexp newSexp(int[] values) Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given `int` child values. Parameters values:int[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. Returns:IonSexp a new sexp where each element is an `IonInt`.

public IonSexp newSexp(int[] values)

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with given int child values.

Parameters

values:int[]: the initial set of child values. If null, then the new instance will have IonValue#isNullValue() == true. Otherwise, the resulting sequence will contain new IonInts with the given values.

Returns:IonSexp

a new sexp where each element is an IonInt.

newSexp back to summary

newSexp	back to summary
public IonSexp newSexp(long[] values) Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given `long` child elements. Parameters values:long[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. Returns:IonSexp a new sexp where each element is an `IonInt`.

public IonSexp newSexp(long[] values)

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with given long child elements.

Parameters

values:long[]: the initial set of child values. If null, then the new instance will have IonValue#isNullValue() == true. Otherwise, the resulting sequence will contain new IonInts with the given values.

Returns:IonSexp

a new sexp where each element is an IonInt.

newString back to summary

newString	back to summary
public IonString newString(String value) Implements com.amazon.ion.ValueFactory.newString. Doc from com.amazon.ion.ValueFactory.newString. Constructs a new Ion string with the given value. Parameters value:String the text of the new string; may be `null` to make `null.string`.

public IonString newString(String value)

Implements com.amazon.ion.ValueFactory.newString.

Doc from com.amazon.ion.ValueFactory.newString.

Constructs a new Ion string with the given value.

Parameters