IfxBSONObject (informix-jdbc 4.50.4.1 API)

java.lang.Object
- com.informix.jdbc.IfxBSONObject

All Implemented Interfaces:

java.sql.SQLData, java.util.Map<java.lang.String,java.lang.Object>, org.bson.BSONObject
```
public class IfxBSONObject
extends java.lang.Object
implements java.sql.SQLData, java.util.Map<java.lang.String,java.lang.Object>, org.bson.BSONObject
```
The IfxBSONObject is a hybrid of both the SQLData interface necessary to read and write BSON data with the Informix JDBC driver and the supporting API's for users to create/read/manipulate BSON documents This class is a split between the Raw BSON document (data stays as a byte array) and an editble document (data is

Nested Class Summary
- Nested classes/interfaces inherited from interface java.util.Map
  java.util.Map.Entry<K,V>

Field Summary

Fields
Modifier and Type	Field and Description
`protected org.bson.Document`	`bsonObject` The decoded BSON object.
`protected org.bson.RawBsonDocument`	`rawDocument`
`static org.bson.codecs.configuration.CodecRegistry`	`REGISTRY`

Constructor Summary

Constructors
Constructor and Description
`IfxBSONObject()` A no-arg constructor is required for SQLData to work.
`IfxBSONObject(byte[] bytes)` Constructs a new object from the specified BSON-encoded byte array.
`IfxBSONObject(byte[] bytes, boolean copyBytes)` Constructs a new object from the specified BSON-encoded byte array.
`IfxBSONObject(byte[] bytes, boolean copyBytes, org.bson.json.JsonMode jsonFormat)` Constructs a new object from the specified BSON-encoded byte array.
`IfxBSONObject(byte[] bytes, org.bson.json.JsonMode jsonFormat)` Constructs a new object from the specified BSON-encoded byte array.
`IfxBSONObject(org.bson.Document bsonObject)` Constructs a new object from the specified `BSONObject`.
`IfxBSONObject(org.bson.RawBsonDocument document)`
`IfxBSONObject(java.lang.String key, java.lang.Object value)` Constructs a new object with an initial key/value pair

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`IfxBSONObject`	`append(java.lang.String key, java.lang.Object value)` Append the key/value pair to this document Similar to {`put(String, Object)` but this method returns the class reference to make multiple appends easier to write
`void`	`clear()`
`boolean`	`containsField(java.lang.String s)`
`boolean`	`containsKey(java.lang.Object key)`
`boolean`	`containsKey(java.lang.String s)`
`boolean`	`containsValue(java.lang.Object value)`
`protected void`	`ensureBsonObject()`
`static IfxBSONObject`	`ensureIfxBSONObject(java.lang.Object o)` Ensures that the specified object is an `IfxBSONObject`.
`void`	`ensureRawDocument()`
`java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>>`	`entrySet()`
`boolean`	`equals(java.lang.Object o)`
`java.lang.Object`	`get(java.lang.Object key)`
`java.lang.Object`	`get(java.lang.String key)`
`boolean`	`getBoolean(java.lang.String key)` Returns the boolean value of the key in the document
`byte[]`	`getBytes()`
`org.bson.Document`	`getDocument()` Return the Map version of the Bson document This version takes more memory but is completely manipulatable as you would a Map This returns a reference to the document object contained in this object.
`IfxBSONObject`	`getDocument(java.lang.String key)` Returns a subdocument from this document
`double`	`getDouble(java.lang.String key)` Returns the double value of the key in the document
`java.lang.String`	`getFirstKey()` Return the first key from the document
`int`	`getInt(java.lang.String key)` Returns the int value of the key in the document
`org.bson.json.JsonMode`	`getJsonFormat()`
`long`	`getLong(java.lang.String key)` Returns the long value of the key in the document
`org.bson.RawBsonDocument`	`getRawDocument()` Return the reference to the raw document If you get this object, this is a reference only, if you decided to modify this object later or the raw document take care as they can become out of sync.
`java.lang.String`	`getSQLTypeName()`
`java.lang.String`	`getString(java.lang.String key)` Returns the string value of the key in the document
`int`	`hashCode()`
`boolean`	`isEmpty()`
`boolean`	`isRawDocument()` Returns whether we are currently a raw document or a fully exploded java map
`java.util.Set<java.lang.String>`	`keySet()`
`static IfxBSONObject`	`parse(java.lang.String json)`
`java.lang.Object`	`put(java.lang.String key, java.lang.Object v)`
`void`	`putAll(org.bson.BSONObject o)`
`void`	`putAll(java.util.Map m)`
`void`	`readSQL(java.sql.SQLInput stream, java.lang.String typeName)`
`java.lang.Object`	`remove(java.lang.Object key)`
`java.lang.Object`	`removeField(java.lang.String key)`
`void`	`setBSONObject(org.bson.BSONObject bsonObject)`
`void`	`setBytes(byte[] bytes)` Assigns the BSON-encoded byte array representation of a document.
`void`	`setDocument(org.bson.Document bsonObject)` Assigns the BSONObject this object represents.
`IfxBSONObject`	`setJsonFormat(org.bson.json.JsonMode mode)`
`void`	`setRawDocument(org.bson.RawBsonDocument doc)`
`int`	`size()`
`java.lang.String`	`toJson()` Returns a compact form of JSON Does not have a pretty-print or any extraneous whitespace
`java.util.Map<java.lang.String,java.lang.Object>`	`toMap()`
`java.lang.String`	`toString()`
`java.util.Collection<java.lang.Object>`	`values()`
`void`	`writeSQL(java.sql.SQLOutput stream)`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Field Detail
  - REGISTRY
```
public static final org.bson.codecs.configuration.CodecRegistry REGISTRY
```
  - rawDocument
```
protected org.bson.RawBsonDocument rawDocument
```
  - bsonObject
```
protected org.bson.Document bsonObject
```
    The decoded BSON object. When a method from BSONObject is called against an IfxBSONObject, the bsonObjectBytes are decoded and the bsonObject is created. If a BSONObject method that modifies the document is called, the bsonObjectBytes are set to null to indicate that they are no longer in-sync with the state of the document. If a BSONObject method that only reads from the document is called, the bsonObject is created and the bsonObjectBytes are left as-is (both will remain non-null as long as a BSONObject write method is not subsequently called).
- Constructor Detail
  - IfxBSONObject
```
public IfxBSONObject()
```
    A no-arg constructor is required for SQLData to work. Broadly speaking, this constructor should not be called.
  - IfxBSONObject
```
public IfxBSONObject(java.lang.String key,
                     java.lang.Object value)
```
    Constructs a new object with an initial key/value pair
    
    Parameters:
    
    key - String key
    
    value - Object value
  - IfxBSONObject
```
public IfxBSONObject(byte[] bytes)
```
    Constructs a new object from the specified BSON-encoded byte array.
    
    Parameters:
    
    bytes - the BSON-encoded document
  - IfxBSONObject
```
public IfxBSONObject(org.bson.RawBsonDocument document)
```
  - IfxBSONObject
```
public IfxBSONObject(byte[] bytes,
                     boolean copyBytes)
```
    Constructs a new object from the specified BSON-encoded byte array. Optionally, copies the input byte array to a new byte array.
    
    Parameters:
    
    bytes - the BSON-encoded document
    
    copyBytes - if true the byte array is copied
  - IfxBSONObject
```
public IfxBSONObject(byte[] bytes,
                     boolean copyBytes,
                     org.bson.json.JsonMode jsonFormat)
```
    Constructs a new object from the specified BSON-encoded byte array. Optionally, copies the input byte array to a new byte array.
    
    Parameters:
    
    bytes - the BSON-encoded document
    
    copyBytes - if true the byte array is copied
    
    jsonFormat - the JsonMode used to serialize the BSON object
  - IfxBSONObject
```
public IfxBSONObject(byte[] bytes,
                     org.bson.json.JsonMode jsonFormat)
```
    Constructs a new object from the specified BSON-encoded byte array.
    
    Parameters:
    
    bytes - the BSON-encoded document
    
    jsonFormat - the JsonMode used to serialize the BSON object
  - IfxBSONObject
```
public IfxBSONObject(org.bson.Document bsonObject)
```
    Constructs a new object from the specified BSONObject. It is generally preferable to use the method ensureIfxBSONObject(Object) as it inspects the object to see if it is already of type IfxBSONObject.
    
    Parameters:
    
    bsonObject -
- Method Detail
  - parse
```
public static IfxBSONObject parse(java.lang.String json)
```
  - getSQLTypeName
```
public java.lang.String getSQLTypeName()
                                throws java.sql.SQLException
```
    Specified by:
    
    getSQLTypeName in interface java.sql.SQLData
    
    Throws:
    
    java.sql.SQLException
  - readSQL
```
public void readSQL(java.sql.SQLInput stream,
                    java.lang.String typeName)
             throws java.sql.SQLException
```
    Specified by:
    
    readSQL in interface java.sql.SQLData
    
    Throws:
    
    java.sql.SQLException
  - writeSQL
```
public void writeSQL(java.sql.SQLOutput stream)
              throws java.sql.SQLException
```
    Specified by:
    
    writeSQL in interface java.sql.SQLData
    
    Throws:
    
    java.sql.SQLException
  - ensureRawDocument
```
public void ensureRawDocument()
```
  - ensureBsonObject
```
protected void ensureBsonObject()
```
  - getBytes
```
public byte[] getBytes()
```
  - setBytes
```
public void setBytes(byte[] bytes)
```
    Assigns the BSON-encoded byte array representation of a document. The bsonObject representation is assigned the value null.
    
    Parameters:
    
    bytes - the BSON-encoded byte array representation of a document
  - setRawDocument
```
public void setRawDocument(org.bson.RawBsonDocument doc)
```
  - setDocument
```
public void setDocument(org.bson.Document bsonObject)
```
    Assigns the BSONObject this object represents. The BSON-encoded byte array representation is assigned the value null.
    
    Parameters:
    
    bsonObject - the document
    
    Throws:
    
    java.lang.NullPointerException - if the bsonObject is null
  - setBSONObject
```
public void setBSONObject(org.bson.BSONObject bsonObject)
```
  - ensureIfxBSONObject
```
public static IfxBSONObject ensureIfxBSONObject(java.lang.Object o)
```
    Ensures that the specified object is an IfxBSONObject. If the object is already of type IfxBSONObject, the object is simply cast and returned. If the object implements the BSONObject interface, the appropriate constructor is called and the new object is returned.
    
    Parameters:
    
    o -
    
    Returns:
    
    Throws:
    
    java.lang.NullPointerException - if the specified object is null
    
    java.lang.IllegalArgumentException - if the object is not of type IfxBSONObject and does not implement the interface BSONObject
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - toJson
```
public java.lang.String toJson()
```
    Returns a compact form of JSON Does not have a pretty-print or any extraneous whitespace
    
    Returns:
    
    String a compact JSON representation of this document
  - put
```
public java.lang.Object put(java.lang.String key,
                            java.lang.Object v)
```
    Specified by:
    
    put in interface java.util.Map<java.lang.String,java.lang.Object>
    
    Specified by:
    
    put in interface org.bson.BSONObject
  - toMap
```
public java.util.Map<java.lang.String,java.lang.Object> toMap()
```
    Specified by:
    
    toMap in interface org.bson.BSONObject
  - containsKey
```
public boolean containsKey(java.lang.String s)
```
    Specified by:
    
    containsKey in interface org.bson.BSONObject
  - containsField
```
public boolean containsField(java.lang.String s)
```
    Specified by:
    
    containsField in interface org.bson.BSONObject
  - keySet
```
public java.util.Set<java.lang.String> keySet()
```
    Specified by:
    
    keySet in interface java.util.Map<java.lang.String,java.lang.Object>
    
    Specified by:
    
    keySet in interface org.bson.BSONObject
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in interface java.util.Map<java.lang.String,java.lang.Object>
    
    Overrides:
    
    hashCode in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object o)
```
    Specified by:
    
    equals in interface java.util.Map<java.lang.String,java.lang.Object>
    
    Overrides:
    
    equals in class java.lang.Object
  - size
```
public int size()
```
    Specified by:
    
    size in interface java.util.Map<java.lang.String,java.lang.Object>
  - isEmpty
```
public boolean isEmpty()
```
    Specified by:
    
    isEmpty in interface java.util.Map<java.lang.String,java.lang.Object>
  - containsKey
```
public boolean containsKey(java.lang.Object key)
```
    Specified by:
    
    containsKey in interface java.util.Map<java.lang.String,java.lang.Object>
  - containsValue
```
public boolean containsValue(java.lang.Object value)
```
    Specified by:
    
    containsValue in interface java.util.Map<java.lang.String,java.lang.Object>
  - get
```
public java.lang.Object get(java.lang.Object key)
```
    Specified by:
    
    get in interface java.util.Map<java.lang.String,java.lang.Object>
  - get
```
public java.lang.Object get(java.lang.String key)
```
    Specified by:
    
    get in interface org.bson.BSONObject
  - remove
```
public java.lang.Object remove(java.lang.Object key)
```
    Specified by:
    
    remove in interface java.util.Map<java.lang.String,java.lang.Object>
  - values
```
public java.util.Collection<java.lang.Object> values()
```
    Specified by:
    
    values in interface java.util.Map<java.lang.String,java.lang.Object>
  - entrySet
```
public java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>> entrySet()
```
    Specified by:
    
    entrySet in interface java.util.Map<java.lang.String,java.lang.Object>
  - putAll
```
public void putAll(java.util.Map m)
```
    Specified by:
    
    putAll in interface java.util.Map<java.lang.String,java.lang.Object>
    
    Specified by:
    
    putAll in interface org.bson.BSONObject
  - getDocument
```
public org.bson.Document getDocument()
```
    Return the Map version of the Bson document This version takes more memory but is completely manipulatable as you would a Map This returns a reference to the document object contained in this object. If you manipulate this document outside of the object you might need to create a new IfxBSONOBject
    
    Returns:
    
    Document this
  - getDocument
```
public IfxBSONObject getDocument(java.lang.String key)
```
    Returns a subdocument from this document
    
    Parameters:
    
    key - field to search for
    
    Returns:
    
    IfxBSONObject the resulting document
  - getRawDocument
```
public org.bson.RawBsonDocument getRawDocument()
```
    Return the reference to the raw document If you get this object, this is a reference only, if you decided to modify this object later or the raw document take care as they can become out of sync. The best practice is to create a new IfxBSONObject later if you modify the raw document outside of this class
    
    Returns:
    
    RawBsonDocument Raw document underlying object
  - append
```
public IfxBSONObject append(java.lang.String key,
                            java.lang.Object value)
```
    Append the key/value pair to this document Similar to {put(String, Object) but this method returns the class reference to make multiple appends easier to write
    
    Parameters:
    
    key - Key to set
    
    value - Object to set
    
    Returns:
    
    IfxBSONObject this object
  - getInt
```
public int getInt(java.lang.String key)
```
    Returns the int value of the key in the document
    
    Parameters:
    
    key - Key to lookup
    
    Returns:
    
    int the value of the key
  - getLong
```
public long getLong(java.lang.String key)
```
    Returns the long value of the key in the document
    
    Parameters:
    
    key - Key to lookup
    
    Returns:
    
    long the value of the key
  - getDouble
```
public double getDouble(java.lang.String key)
```
    Returns the double value of the key in the document
    
    Parameters:
    
    key - Key to lookup
    
    Returns:
    
    double the value of the key
  - getString
```
public java.lang.String getString(java.lang.String key)
```
    Returns the string value of the key in the document
    
    Parameters:
    
    key - Key to lookup
    
    Returns:
    
    string the value of the key
  - getBoolean
```
public boolean getBoolean(java.lang.String key)
```
    Returns the boolean value of the key in the document
    
    Parameters:
    
    key - Key to lookup
    
    Returns:
    
    boolean the value of the key
  - isRawDocument
```
public boolean isRawDocument()
```
    Returns whether we are currently a raw document or a fully exploded java map
    
    Returns:
    
    boolean true if we are are a raw document
  - getFirstKey
```
public java.lang.String getFirstKey()
```
    Return the first key from the document
    
    Returns:
    
    String the first key in the document
  - putAll
```
public void putAll(org.bson.BSONObject o)
```
    Specified by:
    
    putAll in interface org.bson.BSONObject
  - removeField
```
public java.lang.Object removeField(java.lang.String key)
```
    Specified by:
    
    removeField in interface org.bson.BSONObject
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface java.util.Map<java.lang.String,java.lang.Object>
  - setJsonFormat
```
public IfxBSONObject setJsonFormat(org.bson.json.JsonMode mode)
```
  - getJsonFormat
```
public org.bson.json.JsonMode getJsonFormat()
```

Nested classes/interfaces inherited from interface java.util.Map

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

REGISTRY

rawDocument

bsonObject

IfxBSONObject

IfxBSONObject

IfxBSONObject

IfxBSONObject

IfxBSONObject

IfxBSONObject

IfxBSONObject

IfxBSONObject

parse

getSQLTypeName

readSQL

writeSQL

ensureRawDocument

ensureBsonObject

getBytes

setBytes

setRawDocument

setDocument

setBSONObject

ensureIfxBSONObject

toString

toJson

put

toMap

containsKey

containsField

keySet

hashCode

equals

size

isEmpty

containsKey

containsValue

get

get

remove

values

entrySet

putAll

getDocument

getDocument

getRawDocument

append

getInt

getLong

getDouble

getString

getBoolean

isRawDocument

getFirstKey

putAll

removeField

clear

setJsonFormat

getJsonFormat