Package org.bson

Class RawBsonDocument

org.bson.BsonValue

org.bson.BsonDocument

org.bson.RawBsonDocument

All Implemented Interfaces:

, , <,BsonValue>, Bson

public final class RawBsonDocument
extends BsonDocument

An immutable BSON document that is represented using only the raw bytes.

Since:

3.0

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.

< extends , extends >

Constructor Summary

Constructors

Constructor	Description
RawBsonDocument(byte[] bytes)	Constructs a new instance with the given byte array.
RawBsonDocument(byte[] bytes, int offset, int length)	Constructs a new instance with the given byte array, offset, and length.
RawBsonDocument(T document, Codec<T> codec)	Construct a new instance from the given document and codec for the document type.

Method Summary

Modifier and Type	Method	Description
BsonDocument	key, BsonValue value)	Put the given key and value into this document, and return the document.
void	clear()
BsonDocument	clone()
boolean	key)
boolean	value)
<T> T	decode(Codec<T> codec)	Decode this into a document.
<T> T	decode(Decoder<T> decoder)	Decode this into a document.
<<,BsonValue>>	entrySet()
boolean	o)
BsonValue	key)
ByteBuf	getByteBuffer()	Returns a ByteBuf that wraps the byte array, with the proper byte order.
	getFirstKey()	Gets the first key in the document.
int	hashCode()
boolean	isEmpty()
<>	keySet()
static RawBsonDocument	json)	Parses a string in MongoDB Extended JSON format to a RawBsonDocument
BsonValue	key, BsonValue value)
void	<? extends ,? extends BsonValue> m)
BsonValue	key)
int	size()
	toJson()	Gets a JSON representation of this document using the JsonMode.STRICT output mode, and otherwise the default settings of JsonWriterSettings.Builder.
	toJson(JsonWriterSettings settings)	Gets a JSON representation of this document using the given JsonWriterSettings.
<BsonValue>	values()

Methods inherited from class org.bson.BsonDocument

asBsonReader, get, getArray, getArray, getBinary, getBinary, getBoolean, getBoolean, getBsonType, getDateTime, getDateTime, getDecimal128, getDecimal128, getDocument, getDocument, getDouble, getDouble, getInt32, getInt32, getInt64, getInt64, getNumber, getNumber, getObjectId, getObjectId, getRegularExpression, getRegularExpression, getString, getString, getTimestamp, getTimestamp, isArray, isBinary, isBoolean, isDateTime, isDecimal128, isDocument, isDouble, isInt32, isInt64, isNull, isNumber, isObjectId, isString, isTimestamp, toBsonDocument, toString

Methods inherited from class org.bson.BsonValue

asArray, asBinary, asBoolean, asDateTime, asDBPointer, asDecimal128, asDocument, asDouble, asInt32, asInt64, asJavaScript, asJavaScriptWithScope, asNumber, asObjectId, asRegularExpression, asString, asSymbol, asTimestamp, isArray, isBinary, isBoolean, isDateTime, isDBPointer, isDecimal128, isDocument, isDouble, isInt32, isInt64, isJavaScript, isJavaScriptWithScope, isNull, isNumber, isObjectId, isRegularExpression, isString, isSymbol, isTimestamp

Methods inherited from class java.lang.

, , , , , ,

Methods inherited from interface java.util.

, , , , , , , , , ,

Constructor Detail

RawBsonDocument

public RawBsonDocument(byte[] bytes)

Constructs a new instance with the given byte array. Note that it does not make a copy of the array, so do not modify it after passing it to this constructor.

Parameters:

bytes - the bytes representing a BSON document. Note that the byte array is NOT copied, so care must be taken not to modify it after passing it to this construction, unless of course that is your intention.

RawBsonDocument

public RawBsonDocument(byte[] bytes,
                       int offset,
                       int length)

Constructs a new instance with the given byte array, offset, and length. Note that it does not make a copy of the array, so do not modify it after passing it to this constructor.

Parameters:

bytes - the bytes representing a BSON document. Note that the byte array is NOT copied, so care must be taken not to modify it after passing it to this construction, unless of course that is your intention.

offset - the offset into the byte array

length - the length of the subarray to use

Since:

3.3

RawBsonDocument

public RawBsonDocument(T document,
                       Codec<T> codec)

Construct a new instance from the given document and codec for the document type.

Type Parameters:

T - the BSON type that the codec encodes/decodes

Parameters:

document - the document to transform

codec - the codec to facilitate the transformation

Method Detail

parse

public static  json)

Parses a string in MongoDB Extended JSON format to a RawBsonDocument

Parameters:

json - the JSON string

Returns:

a corresponding RawBsonDocument object

Since:

3.3

See Also:

JsonReader

MongoDB documentation

getByteBuffer

public ByteBuf getByteBuffer()

Returns a ByteBuf that wraps the byte array, with the proper byte order. Any changes made to the returned will be reflected in the underlying byte array owned by this instance.

Returns:

a byte buffer that wraps the byte array owned by this instance.

decode

public <T> T decode(Codec<T> codec)

Decode this into a document.

Type Parameters:

T - the BSON type that the codec encodes/decodes

Parameters:

codec - the codec to facilitate the transformation

Returns:

the decoded document

decode

public <T> T decode(Decoder<T> decoder)

Decode this into a document.

Type Parameters:

T - the BSON type that the codec encodes/decodes

Parameters:

decoder - the decoder to facilitate the transformation

Returns:

the decoded document

Since:

3.6

clear

public void clear()

Specified by:

in interface <,BsonValue>

Overrides:

clear in class BsonDocument

put

public  key,
                     BsonValue value)

Specified by:

in interface <,BsonValue>

Overrides:

put in class BsonDocument

append

public  key,
                           BsonValue value)

Description copied from class: BsonDocument

Put the given key and value into this document, and return the document.

Overrides:

append in class BsonDocument

Parameters:

key - the key

value - the value

Returns:

this

putAll

public void putAll(<? extends ,? extends BsonValue> m)

Specified by:

in interface <,BsonValue>

Overrides:

putAll in class BsonDocument

remove

public  key)

Specified by:

in interface <,BsonValue>

Overrides:

remove in class BsonDocument

isEmpty

public boolean isEmpty()

Specified by:

in interface <,BsonValue>

Overrides:

isEmpty in class BsonDocument

size

public int size()

Specified by:

in interface <,BsonValue>

Overrides:

size in class BsonDocument

entrySet

public <<,BsonValue>> entrySet()

Specified by:

in interface <,BsonValue>

Overrides:

entrySet in class BsonDocument

values

public <BsonValue> values()

Specified by:

in interface <,BsonValue>

Overrides:

values in class BsonDocument

keySet

public <> keySet()

Specified by:

in interface <,BsonValue>

Overrides:

keySet in class BsonDocument

getFirstKey

public  getFirstKey()

Description copied from class: BsonDocument

Gets the first key in the document.

Overrides:

getFirstKey in class BsonDocument

Returns:

the first key in the document

containsKey

public boolean containsKey( key)

Specified by:

in interface <,BsonValue>

Overrides:

containsKey in class BsonDocument

containsValue

public boolean containsValue( value)

Specified by:

in interface <,BsonValue>

Overrides:

containsValue in class BsonDocument

get

public  key)

Specified by:

in interface <,BsonValue>

Overrides:

get in class BsonDocument

toJson

public  toJson()

Description copied from class: BsonDocument

Gets a JSON representation of this document using the JsonMode.STRICT output mode, and otherwise the default settings of JsonWriterSettings.Builder.

Overrides:

toJson in class BsonDocument

Returns:

a JSON representation of this document

See Also:

BsonDocument.toJson(JsonWriterSettings), JsonWriterSettings

toJson

public  toJson(JsonWriterSettings settings)

Description copied from class: BsonDocument

Gets a JSON representation of this document using the given JsonWriterSettings.

Overrides:

toJson in class BsonDocument

Parameters:

settings - the JSON writer settings

Returns:

a JSON representation of this document

equals

public boolean equals( o)

Specified by:

in interface <,BsonValue>

Overrides:

equals in class BsonDocument

hashCode

public int hashCode()

Specified by:

in interface <,BsonValue>

Overrides:

hashCode in class BsonDocument

clone

public BsonDocument clone()

Overrides:

clone in class BsonDocument