software.amazon.ion

Interface IonBlob

All Superinterfaces:

Cloneable, IonLob, IonValue

public interface IonBlob
extends IonLob

An Ion blob value.

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

Field Summary

Fields inherited from interface software.amazon.ion.IonValue

EMPTY_ARRAY

Method Summary

Modifier and Type	Method and Description
IonBlob	clone() Creates a copy of this value and all of its children.
void	printBase64(Appendable out) Prints the content of this blob as Base64 text, without Ion's surrounding double-braces {{ }}.

Methods inherited from interface software.amazon.ion.IonLob

byteSize, getBytes, newInputStream, setBytes, setBytes

Methods inherited from interface software.amazon.ion.IonValue

accept, addTypeAnnotation, clearTypeAnnotations, equals, getContainer, getFieldName, getFieldNameSymbol, getSymbolTable, getSystem, getType, getTypeAnnotations, getTypeAnnotationSymbols, hashCode, hasTypeAnnotation, isNullValue, isReadOnly, makeReadOnly, removeFromContainer, removeTypeAnnotation, setTypeAnnotations, setTypeAnnotationSymbols, topLevelValue, toPrettyString, toString, toString, writeTo

Method Detail

printBase64

void printBase64(Appendable out)
          throws NullValueException,
                 IOException

Prints the content of this blob as Base64 text, without Ion's surrounding double-braces {{ }}.

Parameters:

out - will receive the Base64 content.

Throws:

NullValueException - if this.isNullValue().

NullPointerException - if out is null.

IOException - if there's a problem writing to the output stream.

clone

IonBlob 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.