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

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`Object`	`arrayDone()` Called the end of the array, and returns the completed array.
`void`	`arrayStart()` Signals the start of a BSON array.
`void`	`arrayStart(String name)` Signals the start of a BSON array, with its field name.
`BSONCallback`	`createBSONCallback()` Factory method for BSONCallbacks.
`Object`	`get()` Returns the finished top-level Document.
`void`	`gotBinary(String name, byte type, byte[] data)` Called when reading a field with a binary value.
`void`	`gotBinaryArray(String name, byte[] data)` Deprecated.
`void`	`gotBoolean(String name, boolean value)` Called when reading a field with a Boolean value.
`void`	`gotCode(String name, String code)` Called when reading a field with a JavaScript value.
`void`	`gotCodeWScope(String name, String code, Object scope)` Called when reading a field with a JavaScript with Scope value.
`void`	`gotDate(String name, long millis)` Called when reading a field with a DateTime value.
`void`	`gotDBRef(String name, String ns, ObjectId id)` Invoked when `BSONDecoder` encountered a DBPointer(0x0c) type field in a byte sequence.
`void`	`gotDouble(String name, double value)` Called when reading a field with a Double value.
`void`	`gotInt(String name, int value)` Called when reading a field with an Int32 value.
`void`	`gotLong(String name, long value)` Called when reading a field with an Int64 value.
`void`	`gotMaxKey(String name)` Called when reading a field with a MaxKey value.
`void`	`gotMinKey(String name)` Called when reading a field with a MinKey value.
`void`	`gotNull(String name)` Called when reading a BSON field that exists but has a null value.
`void`	`gotObjectId(String name, ObjectId id)` Called when reading a field with an ObjectID value.
`void`	`gotRegex(String name, String pattern, String flags)` Called when reading a field with a Regex value.
`void`	`gotString(String name, String value)` Called when reading a field with a String value.
`void`	`gotSymbol(String name, String value)` Called when reading a field with a Symbol value.
`void`	`gotTimestamp(String name, int time, int inc)` Called when reading a field with a Timestamp value.
`void`	`gotUndefined(String name)` Called when reading a field with an Undefined value.
`void`	`gotUUID(String name, long part1, long part2)` Called when reading a field with a `UUID` value.
`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(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(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
```
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
```
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(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
```
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(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(String name)
```
    Called when reading a field with an Undefined value.
    
    Parameters:
    
    name - the name of the field
  - gotMinKey
```
void gotMinKey(String name)
```
    Called when reading a field with a MinKey value.
    
    Parameters:
    
    name - the name of the field
  - gotMaxKey
```
void gotMaxKey(String name)
```
    Called when reading a field with a MaxKey value.
    
    Parameters:
    
    name - the name of the field
  - gotBoolean
```
void gotBoolean(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(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(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(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(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(String name,
               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(String name,
               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(String name,
              String pattern,
              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(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(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(String name,
              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(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(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(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(String name,
             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(String name,
                   String code,
                   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

Interface BSONCallback

Method Summary

Method Detail

objectStart

objectStart

objectStart

objectDone

reset

get

createBSONCallback

arrayStart

arrayStart

arrayDone

gotNull

gotUndefined

gotMinKey

gotMaxKey

gotBoolean

gotDouble

gotInt

gotLong

gotDate

gotString

gotSymbol

gotRegex

gotTimestamp

gotObjectId

gotDBRef

gotBinaryArray

gotBinary

gotUUID

gotCode

gotCodeWScope