Package org.bson
Interface BsonWriter
- All Known Implementing Classes:
AbstractBsonWriter
,BsonBinaryWriter
,BsonDocumentWriter
,JsonWriter
public interface BsonWriter
An interface for writing a logical BSON document using a push-oriented API.
- Since:
- 3.0
-
Method Summary
Modifier and TypeMethodDescriptionvoid
flush()
Flushes any pending data to the output destination.void
pipe
(BsonReader reader) Reads a single document from a BsonReader and writes it to this.void
writeBinaryData
(String name, BsonBinary binary) Writes a BSON Binary data element to the writer.void
writeBinaryData
(BsonBinary binary) Writes a BSON Binary data element to the writer.void
writeBoolean
(boolean value) Writes a BSON Boolean to the writer.void
writeBoolean
(String name, boolean value) Writes a BSON Boolean element to the writer.void
writeDateTime
(long value) Writes a BSON DateTime to the writer.void
writeDateTime
(String name, long value) Writes a BSON DateTime element to the writer.void
writeDBPointer
(String name, BsonDbPointer value) Writes a BSON DBPointer element to the writer.void
writeDBPointer
(BsonDbPointer value) Writes a BSON DBPointer to the writer.void
writeDecimal128
(String name, Decimal128 value) Writes a BSON Decimal128 element to the writer.void
writeDecimal128
(Decimal128 value) Writes a BSON Decimal128 to the writer.void
writeDouble
(double value) Writes a BSON Double to the writer.void
writeDouble
(String name, double value) Writes a BSON Double element to the writer.void
Writes the end of a BSON array to the writer.void
Writes the end of a BSON document to the writer.void
writeInt32
(int value) Writes a BSON Int32 to the writer.void
writeInt32
(String name, int value) Writes a BSON Int32 element to the writer.void
writeInt64
(long value) Writes a BSON Int64 to the writer.void
writeInt64
(String name, long value) Writes a BSON Int64 element to the writer.void
writeJavaScript
(String code) Writes a BSON JavaScript to the writer.void
writeJavaScript
(String name, String code) Writes a BSON JavaScript element to the writer.void
Writes a BSON JavaScript to the writer (call WriteStartDocument to start writing the scope).void
writeJavaScriptWithScope
(String name, String code) Writes a BSON JavaScript element to the writer (call WriteStartDocument to start writing the scope).void
Writes a BSON MaxKey to the writer.void
writeMaxKey
(String name) Writes a BSON MaxKey element to the writer.void
Writes a BSON MinKey to the writer.void
writeMinKey
(String name) Writes a BSON MinKey element to the writer.void
Writes the name of an element to the writer.void
Writes a BSON null to the writer.void
Writes a BSON null element to the writer.void
writeObjectId
(String name, ObjectId objectId) Writes a BSON ObjectId element to the writer.void
writeObjectId
(ObjectId objectId) Writes a BSON ObjectId to the writer.void
writeRegularExpression
(String name, BsonRegularExpression regularExpression) Writes a BSON regular expression element to the writer.void
writeRegularExpression
(BsonRegularExpression regularExpression) Writes a BSON regular expression to the writer.void
Writes the start of a BSON array to the writer.void
writeStartArray
(String name) Writes the start of a BSON array element to the writer.void
Writes the start of a BSON document to the writer.void
writeStartDocument
(String name) Writes the start of a BSON document element to the writer.void
writeString
(String value) Writes a BSON String to the writer.void
writeString
(String name, String value) Writes a BSON String element to the writer.void
writeSymbol
(String value) Writes a BSON Symbol to the writer.void
writeSymbol
(String name, String value) Writes a BSON Symbol element to the writer.void
writeTimestamp
(String name, BsonTimestamp value) Writes a BSON Timestamp element to the writer.void
writeTimestamp
(BsonTimestamp value) Writes a BSON Timestamp to the writer.void
Writes a BSON undefined to the writer.void
writeUndefined
(String name) Writes a BSON undefined element to the writer.
-
Method Details
-
flush
void flush()Flushes any pending data to the output destination. -
writeBinaryData
Writes a BSON Binary data element to the writer.- Parameters:
binary
- The Binary data.
-
writeBinaryData
Writes a BSON Binary data element to the writer.- Parameters:
name
- The name of the element.binary
- The Binary data value.
-
writeBoolean
void writeBoolean(boolean value) Writes a BSON Boolean to the writer.- Parameters:
value
- The Boolean value.
-
writeBoolean
Writes a BSON Boolean element to the writer.- Parameters:
name
- The name of the element.value
- The Boolean value.
-
writeDateTime
void writeDateTime(long value) Writes a BSON DateTime to the writer.- Parameters:
value
- The number of milliseconds since the Unix epoch.
-
writeDateTime
Writes a BSON DateTime element to the writer.- Parameters:
name
- The name of the element.value
- The number of milliseconds since the Unix epoch.
-
writeDBPointer
Writes a BSON DBPointer to the writer.- Parameters:
value
- The DBPointer to write
-
writeDBPointer
Writes a BSON DBPointer element to the writer.- Parameters:
name
- The name of the element.value
- The DBPointer to write
-
writeDouble
void writeDouble(double value) Writes a BSON Double to the writer.- Parameters:
value
- The Double value.
-
writeDouble
Writes a BSON Double element to the writer.- Parameters:
name
- The name of the element.value
- The Double value.
-
writeEndArray
void writeEndArray()Writes the end of a BSON array to the writer. -
writeEndDocument
void writeEndDocument()Writes the end of a BSON document to the writer. -
writeInt32
void writeInt32(int value) Writes a BSON Int32 to the writer.- Parameters:
value
- The Int32 value.
-
writeInt32
Writes a BSON Int32 element to the writer.- Parameters:
name
- The name of the element.value
- The Int32 value.
-
writeInt64
void writeInt64(long value) Writes a BSON Int64 to the writer.- Parameters:
value
- The Int64 value.
-
writeInt64
Writes a BSON Int64 element to the writer.- Parameters:
name
- The name of the element.value
- The Int64 value.
-
writeDecimal128
Writes a BSON Decimal128 to the writer.- Parameters:
value
- The Decimal128 value.- Since:
- 3.4
-
writeDecimal128
Writes a BSON Decimal128 element to the writer.- Parameters:
name
- The name of the element.value
- The Decimal128 value.- Since:
- 3.4
-
writeJavaScript
Writes a BSON JavaScript to the writer.- Parameters:
code
- The JavaScript code.
-
writeJavaScript
Writes a BSON JavaScript element to the writer.- Parameters:
name
- The name of the element.code
- The JavaScript code.
-
writeJavaScriptWithScope
Writes a BSON JavaScript to the writer (call WriteStartDocument to start writing the scope).- Parameters:
code
- The JavaScript code.
-
writeJavaScriptWithScope
Writes a BSON JavaScript element to the writer (call WriteStartDocument to start writing the scope).- Parameters:
name
- The name of the element.code
- The JavaScript code.
-
writeMaxKey
void writeMaxKey()Writes a BSON MaxKey to the writer. -
writeMaxKey
Writes a BSON MaxKey element to the writer.- Parameters:
name
- The name of the element.
-
writeMinKey
void writeMinKey()Writes a BSON MinKey to the writer. -
writeMinKey
Writes a BSON MinKey element to the writer.- Parameters:
name
- The name of the element.
-
writeName
Writes the name of an element to the writer.- Parameters:
name
- The name of the element.
-
writeNull
void writeNull()Writes a BSON null to the writer. -
writeNull
Writes a BSON null element to the writer.- Parameters:
name
- The name of the element.
-
writeObjectId
Writes a BSON ObjectId to the writer.- Parameters:
objectId
- The ObjectId value.
-
writeObjectId
Writes a BSON ObjectId element to the writer.- Parameters:
name
- The name of the element.objectId
- The ObjectId value.
-
writeRegularExpression
Writes a BSON regular expression to the writer.- Parameters:
regularExpression
- the regular expression to write.
-
writeRegularExpression
Writes a BSON regular expression element to the writer.- Parameters:
name
- The name of the element.regularExpression
- The RegularExpression value.
-
writeStartArray
void writeStartArray()Writes the start of a BSON array to the writer.- Throws:
BsonSerializationException
- if maximum serialization depth exceeded.
-
writeStartArray
Writes the start of a BSON array element to the writer.- Parameters:
name
- The name of the element.
-
writeStartDocument
void writeStartDocument()Writes the start of a BSON document to the writer.- Throws:
BsonSerializationException
- if maximum serialization depth exceeded.
-
writeStartDocument
Writes the start of a BSON document element to the writer.- Parameters:
name
- The name of the element.
-
writeString
Writes a BSON String to the writer.- Parameters:
value
- The String value.
-
writeString
Writes a BSON String element to the writer.- Parameters:
name
- The name of the element.value
- The String value.
-
writeSymbol
Writes a BSON Symbol to the writer.- Parameters:
value
- The symbol.
-
writeSymbol
Writes a BSON Symbol element to the writer.- Parameters:
name
- The name of the element.value
- The symbol.
-
writeTimestamp
Writes a BSON Timestamp to the writer.- Parameters:
value
- The combined timestamp/increment value.
-
writeTimestamp
Writes a BSON Timestamp element to the writer.- Parameters:
name
- The name of the element.value
- The combined timestamp/increment value.
-
writeUndefined
void writeUndefined()Writes a BSON undefined to the writer. -
writeUndefined
Writes a BSON undefined element to the writer.- Parameters:
name
- The name of the element.
-
pipe
Reads a single document from a BsonReader and writes it to this.- Parameters:
reader
- The source.
-