Package org.bson

Class RawBsonDocument

java.lang.Object

org.bson.BsonValue

org.bson.BsonDocument

org.bson.RawBsonDocument

All Implemented Interfaces:

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

java.util.Map.Entry<K extends java.lang.Object,V extends java.lang.Object>

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	append(java.lang.String key, BsonValue value)	Put the given key and value into this document, and return the document.
void	clear()
BsonDocument	clone()
boolean	containsKey(java.lang.Object key)
boolean	containsValue(java.lang.Object value)
<T> T	decode(Codec<T> codec)	Decode this into a document.
<T> T	decode(Decoder<T> decoder)	Decode this into a document.
java.util.Set<java.util.Map.Entry<java.lang.String,BsonValue>>	entrySet()
boolean	equals(java.lang.Object o)
BsonValue	get(java.lang.Object key)
ByteBuf	getByteBuffer()	Returns a ByteBuf that wraps the byte array, with the proper byte order.
java.lang.String	getFirstKey()	Gets the first key in the document.
int	hashCode()
boolean	isEmpty()
java.util.Set<java.lang.String>	keySet()
static RawBsonDocument	parse(java.lang.String json)	Parses a string in MongoDB Extended JSON format to a RawBsonDocument
BsonValue	put(java.lang.String key, BsonValue value)
void	putAll(java.util.Map<? extends java.lang.String,? extends BsonValue> m)
BsonValue	remove(java.lang.Object key)
int	size()
java.lang.String	toJson()	Gets a JSON representation of this document using the JsonMode.STRICT output mode, and otherwise the default settings of JsonWriterSettings.Builder.
java.lang.String	toJson(JsonWriterSettings settings)	Gets a JSON representation of this document using the given JsonWriterSettings.
java.util.Collection<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 interface java.util.Map

compute, computeIfAbsent, computeIfPresent, entry, forEach, getOrDefault, merge, of, of, of, of, of, of, of, of, of, of, of, ofEntries, putIfAbsent, remove, replace, replace, replaceAll

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

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 RawBsonDocument parse(java.lang.String 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

MongoDB Extended JSON

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()

Overrides:

clear in class BsonDocument

put

public BsonValue put(java.lang.String key,
                     BsonValue value)

Overrides:

put in class BsonDocument

append

public BsonDocument append(java.lang.String 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(java.util.Map<? extends java.lang.String,? extends BsonValue> m)

Overrides:

putAll in class BsonDocument

remove

public BsonValue remove(java.lang.Object key)

Overrides:

remove in class BsonDocument

isEmpty

public boolean isEmpty()

Overrides:

isEmpty in class BsonDocument

size

public int size()

Overrides:

size in class BsonDocument

entrySet

public java.util.Set<java.util.Map.Entry<java.lang.String,BsonValue>> entrySet()

Overrides:

entrySet in class BsonDocument

values

public java.util.Collection<BsonValue> values()

Overrides:

values in class BsonDocument

keySet

public java.util.Set<java.lang.String> keySet()

Overrides:

keySet in class BsonDocument

getFirstKey

public java.lang.String 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(java.lang.Object key)

Overrides:

containsKey in class BsonDocument

containsValue

public boolean containsValue(java.lang.Object value)

Overrides:

containsValue in class BsonDocument

get

public BsonValue get(java.lang.Object key)

Overrides:

get in class BsonDocument

toJson

public java.lang.String 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 java.lang.String 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(java.lang.Object o)

Overrides:

equals in class BsonDocument

hashCode

public int hashCode()

Overrides:

hashCode in class BsonDocument

clone

public BsonDocument clone()

Overrides:

clone in class BsonDocument