org.bson

Interface BSONCallback

All Known Subinterfaces:

DBCallback

All Known Implementing Classes:

BasicBSONCallback, DefaultDBCallback, EmptyBSONCallback, JSONCallback, LazyBSONCallback, LazyDBCallback, LazyWriteableDBCallback

public interface BSONCallback

A callback interface for describing the structure of a BSON document. Implementations of this define how to turn BSON read from MongoDB into Java objects. See the BSON Spec.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	arrayDone() Called the end of the array, and returns the completed array.
void	arrayStart() Signals the start of a BSON array.
void	arrayStart(java.lang.String name) Signals the start of a BSON array, with its field name.
BSONCallback	createBSONCallback() Factory method for BSONCallbacks.
java.lang.Object	get() Returns the finished top-level Document.
void	gotBinary(java.lang.String name, byte type, byte[] data) Called when reading a field with a binary value.
void	gotBinaryArray(java.lang.String name, byte[] data) Deprecated.
void	gotBoolean(java.lang.String name, boolean value) Called when reading a field with a Boolean value.
void	gotCode(java.lang.String name, java.lang.String code) Called when reading a field with a JavaScript value.
void	gotCodeWScope(java.lang.String name, java.lang.String code, java.lang.Object scope) Called when reading a field with a JavaScript with Scope value.
void	gotDate(java.lang.String name, long millis) Called when reading a field with a DateTime value.
void	gotDBRef(java.lang.String name, java.lang.String ns, ObjectId id) Invoked when BSONDecoder encountered a DBPointer(0x0c) type field in a byte sequence.
void	gotDouble(java.lang.String name, double value) Called when reading a field with a Double value.
void	gotInt(java.lang.String name, int value) Called when reading a field with an Int32 value.
void	gotLong(java.lang.String name, long value) Called when reading a field with an Int64 value.
void	gotMaxKey(java.lang.String name) Called when reading a field with a MaxKey value.
void	gotMinKey(java.lang.String name) Called when reading a field with a MinKey value.
void	gotNull(java.lang.String name) Called when reading a BSON field that exists but has a null value.
void	gotObjectId(java.lang.String name, ObjectId id) Called when reading a field with an ObjectID value.
void	gotRegex(java.lang.String name, java.lang.String pattern, java.lang.String flags) Called when reading a field with a Regex value.
void	gotString(java.lang.String name, java.lang.String value) Called when reading a field with a String value.
void	gotSymbol(java.lang.String name, java.lang.String value) Called when reading a field with a Symbol value.
void	gotTimestamp(java.lang.String name, int time, int inc) Called when reading a field with a Timestamp value.
void	gotUndefined(java.lang.String name) Called when reading a field with an Undefined value.
void	gotUUID(java.lang.String name, long part1, long part2) Called when reading a field with a UUID value.
java.lang.Object	objectDone() Called at the end of the document/array, and returns this object.
void	objectStart() Signals the start of a BSON document, which usually maps onto some Java object.
void	objectStart(boolean array) Deprecated. instead, use arrayStart() if array is true, and objectStart() if array is false
void	objectStart(java.lang.String name) Signals the start of a BSON document, which usually maps onto some Java object.
void	reset() Resets the callback, clearing all state.

Method Detail

objectStart

void objectStart()

Signals the start of a BSON document, which usually maps onto some Java object.

MongoDB documentation

MongoDB Documents

objectStart

void objectStart(java.lang.String name)

Signals the start of a BSON document, which usually maps onto some Java object.

Parameters:

name - the field name of the document.

MongoDB documentation

MongoDB Documents

objectStart

@Deprecated
void objectStart(boolean array)

Deprecated. instead, use arrayStart() if array is true, and objectStart() if array is false

Parameters:

array - true if this object is an array

objectDone

java.lang.Object objectDone()

Called at the end of the document/array, and returns this object.

Returns:

the Object that has been read from this section of the document.

reset

void reset()

Resets the callback, clearing all state.

get

java.lang.Object get()

Returns the finished top-level Document.

Returns:

the top level document read from the database.

createBSONCallback

BSONCallback createBSONCallback()

Factory method for BSONCallbacks.

Returns:

a new BSONCallback.

arrayStart

void arrayStart()

Signals the start of a BSON array.

MongoDB documentation

Arrays

arrayStart

void arrayStart(java.lang.String name)

Signals the start of a BSON array, with its field name.

Parameters:

name - the name of this array field

MongoDB documentation

Arrays

arrayDone

java.lang.Object arrayDone()

Called the end of the array, and returns the completed array.

Returns:

an Object representing the array that has been read from this section of the document.

gotNull

void gotNull(java.lang.String name)

Called when reading a BSON field that exists but has a null value.

Parameters:

name - the name of the field

gotUndefined

void gotUndefined(java.lang.String name)

Called when reading a field with an Undefined value.

Parameters:

name - the name of the field

gotMinKey

void gotMinKey(java.lang.String name)

Called when reading a field with a MinKey value.

Parameters:

name - the name of the field

gotMaxKey

void gotMaxKey(java.lang.String name)

Called when reading a field with a MaxKey value.

Parameters:

name - the name of the field

gotBoolean

void gotBoolean(java.lang.String name,
              boolean value)

Called when reading a field with a Boolean value.

Parameters:

name - the name of the field

value - the field's value

gotDouble

void gotDouble(java.lang.String name,
             double value)

Called when reading a field with a Double value.

Parameters:

name - the name of the field

value - the field's value

gotInt

void gotInt(java.lang.String name,
          int value)

Called when reading a field with an Int32 value.

Parameters:

name - the name of the field

value - the field's value

gotLong

void gotLong(java.lang.String name,
           long value)

Called when reading a field with an Int64 value.

Parameters:

name - the name of the field

value - the field's value

gotDate

void gotDate(java.lang.String name,
           long millis)

Called when reading a field with a DateTime value.

Parameters:

name - the name of the field

millis - the date and time in milliseconds

gotString

void gotString(java.lang.String name,
             java.lang.String value)

Called when reading a field with a String value.

Parameters:

name - the name of the field

value - the field's value

gotSymbol

void gotSymbol(java.lang.String name,
             java.lang.String value)

Called when reading a field with a Symbol value.

Parameters:

name - the name of the field

value - the field's value

gotRegex

void gotRegex(java.lang.String name,
            java.lang.String pattern,
            java.lang.String flags)

Called when reading a field with a Regex value.

Parameters:

name - the name of the field

pattern - the regex pattern

flags - the optional flags for the regular expression

MongoDB documentation

$regex

gotTimestamp

void gotTimestamp(java.lang.String name,
                int time,
                int inc)

Called when reading a field with a Timestamp value.

Parameters:

name - the name of the field

time - the time in seconds since epoch

inc - an incrementing ordinal for operations within a given second

MongoDB documentation

Timestamps

gotObjectId

void gotObjectId(java.lang.String name,
               ObjectId id)

Called when reading a field with an ObjectID value.

Parameters:

name - the name of the field

id - the object ID

gotDBRef

void gotDBRef(java.lang.String name,
            java.lang.String ns,
            ObjectId id)

Invoked when BSONDecoder encountered a DBPointer(0x0c) type field in a byte sequence.

Parameters:

name - the name of the field

ns - the namespace to which reference is pointing to

id - the if of the object to which reference is pointing to

gotBinaryArray

@Deprecated
void gotBinaryArray(java.lang.String name,
                             byte[] data)

Deprecated.

This method is not used.

Parameters:

name - the name of the field

data - the field's value

gotBinary

void gotBinary(java.lang.String name,
             byte type,
             byte[] data)

Called when reading a field with a binary value. Note that binary values have a subtype, which may determine how the value is processed.

Parameters:

name - the name of the field

type - one of the binary subtypes

data - the field's value

gotUUID

void gotUUID(java.lang.String name,
           long part1,
           long part2)

Called when reading a field with a UUID value. This is a binary value of subtype UuidLegacy.

Parameters:

name - the name of the field

part1 - the first part of the UUID

part2 - the second part of the UUID

gotCode

void gotCode(java.lang.String name,
           java.lang.String code)

Called when reading a field with a JavaScript value.

Parameters:

name - the name of the field

code - the JavaScript code

gotCodeWScope

void gotCodeWScope(java.lang.String name,
                 java.lang.String code,
                 java.lang.Object scope)

Called when reading a field with a JavaScript with Scope value.

Parameters:

name - the name of the field

code - the JavaScript code

scope - a document representing the scope for the code