Package org.bson
Interface BsonWriter
-
- All Known Implementing Classes:
AbstractBsonWriter,BsonBinaryWriter,BsonDocumentWriter,BsonWriterDecorator,ElementExtendingBsonWriter,FieldTrackingBsonWriter,JsonWriter,SplittablePayloadBsonWriter
public interface BsonWriterAn interface for writing a logical BSON document using a push-oriented API.- Since:
- 3.0
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidflush()Flushes any pending data to the output destination.voidpipe(BsonReader reader)Reads a single document from a BsonReader and writes it to this.voidwriteBinaryData(java.lang.String name, BsonBinary binary)Writes a BSON Binary data element to the writer.voidwriteBinaryData(BsonBinary binary)Writes a BSON Binary data element to the writer.voidwriteBoolean(boolean value)Writes a BSON Boolean to the writer.voidwriteBoolean(java.lang.String name, boolean value)Writes a BSON Boolean element to the writer.voidwriteDateTime(long value)Writes a BSON DateTime to the writer.voidwriteDateTime(java.lang.String name, long value)Writes a BSON DateTime element to the writer.voidwriteDBPointer(java.lang.String name, BsonDbPointer value)Writes a BSON DBPointer element to the writer.voidwriteDBPointer(BsonDbPointer value)Writes a BSON DBPointer to the writer.voidwriteDecimal128(java.lang.String name, Decimal128 value)Writes a BSON Decimal128 element to the writer.voidwriteDecimal128(Decimal128 value)Writes a BSON Decimal128 to the writer.voidwriteDouble(double value)Writes a BSON Double to the writer.voidwriteDouble(java.lang.String name, double value)Writes a BSON Double element to the writer.voidwriteEndArray()Writes the end of a BSON array to the writer.voidwriteEndDocument()Writes the end of a BSON document to the writer.voidwriteInt32(int value)Writes a BSON Int32 to the writer.voidwriteInt32(java.lang.String name, int value)Writes a BSON Int32 element to the writer.voidwriteInt64(long value)Writes a BSON Int64 to the writer.voidwriteInt64(java.lang.String name, long value)Writes a BSON Int64 element to the writer.voidwriteJavaScript(java.lang.String code)Writes a BSON JavaScript to the writer.voidwriteJavaScript(java.lang.String name, java.lang.String code)Writes a BSON JavaScript element to the writer.voidwriteJavaScriptWithScope(java.lang.String code)Writes a BSON JavaScript to the writer (call WriteStartDocument to start writing the scope).voidwriteJavaScriptWithScope(java.lang.String name, java.lang.String code)Writes a BSON JavaScript element to the writer (call WriteStartDocument to start writing the scope).voidwriteMaxKey()Writes a BSON MaxKey to the writer.voidwriteMaxKey(java.lang.String name)Writes a BSON MaxKey element to the writer.voidwriteMinKey()Writes a BSON MinKey to the writer.voidwriteMinKey(java.lang.String name)Writes a BSON MinKey element to the writer.voidwriteName(java.lang.String name)Writes the name of an element to the writer.voidwriteNull()Writes a BSON null to the writer.voidwriteNull(java.lang.String name)Writes a BSON null element to the writer.voidwriteObjectId(java.lang.String name, ObjectId objectId)Writes a BSON ObjectId element to the writer.voidwriteObjectId(ObjectId objectId)Writes a BSON ObjectId to the writer.voidwriteRegularExpression(java.lang.String name, BsonRegularExpression regularExpression)Writes a BSON regular expression element to the writer.voidwriteRegularExpression(BsonRegularExpression regularExpression)Writes a BSON regular expression to the writer.voidwriteStartArray()Writes the start of a BSON array to the writer.voidwriteStartArray(java.lang.String name)Writes the start of a BSON array element to the writer.voidwriteStartDocument()Writes the start of a BSON document to the writer.voidwriteStartDocument(java.lang.String name)Writes the start of a BSON document element to the writer.voidwriteString(java.lang.String value)Writes a BSON String to the writer.voidwriteString(java.lang.String name, java.lang.String value)Writes a BSON String element to the writer.voidwriteSymbol(java.lang.String value)Writes a BSON Symbol to the writer.voidwriteSymbol(java.lang.String name, java.lang.String value)Writes a BSON Symbol element to the writer.voidwriteTimestamp(java.lang.String name, BsonTimestamp value)Writes a BSON Timestamp element to the writer.voidwriteTimestamp(BsonTimestamp value)Writes a BSON Timestamp to the writer.voidwriteUndefined()Writes a BSON undefined to the writer.voidwriteUndefined(java.lang.String name)Writes a BSON undefined element to the writer.
-
-
-
Method Detail
-
flush
void flush()
Flushes any pending data to the output destination.
-
writeBinaryData
void writeBinaryData(BsonBinary binary)
Writes a BSON Binary data element to the writer.- Parameters:
binary- The Binary data.
-
writeBinaryData
void writeBinaryData(java.lang.String name, BsonBinary binary)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
void writeBoolean(java.lang.String name, boolean value)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
void writeDateTime(java.lang.String name, long value)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
void writeDBPointer(BsonDbPointer value)
Writes a BSON DBPointer to the writer.- Parameters:
value- The DBPointer to write
-
writeDBPointer
void writeDBPointer(java.lang.String name, BsonDbPointer value)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
void writeDouble(java.lang.String name, double value)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
void writeInt32(java.lang.String name, int value)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
void writeInt64(java.lang.String name, long value)Writes a BSON Int64 element to the writer.- Parameters:
name- The name of the element.value- The Int64 value.
-
writeDecimal128
void writeDecimal128(Decimal128 value)
Writes a BSON Decimal128 to the writer.- Parameters:
value- The Decimal128 value.- Since:
- 3.4
-
writeDecimal128
void writeDecimal128(java.lang.String name, Decimal128 value)Writes a BSON Decimal128 element to the writer.- Parameters:
name- The name of the element.value- The Decimal128 value.- Since:
- 3.4
-
writeJavaScript
void writeJavaScript(java.lang.String code)
Writes a BSON JavaScript to the writer.- Parameters:
code- The JavaScript code.
-
writeJavaScript
void writeJavaScript(java.lang.String name, java.lang.String code)Writes a BSON JavaScript element to the writer.- Parameters:
name- The name of the element.code- The JavaScript code.
-
writeJavaScriptWithScope
void writeJavaScriptWithScope(java.lang.String code)
Writes a BSON JavaScript to the writer (call WriteStartDocument to start writing the scope).- Parameters:
code- The JavaScript code.
-
writeJavaScriptWithScope
void writeJavaScriptWithScope(java.lang.String name, java.lang.String code)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
void writeMaxKey(java.lang.String name)
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
void writeMinKey(java.lang.String name)
Writes a BSON MinKey element to the writer.- Parameters:
name- The name of the element.
-
writeName
void writeName(java.lang.String name)
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
void writeNull(java.lang.String name)
Writes a BSON null element to the writer.- Parameters:
name- The name of the element.
-
writeObjectId
void writeObjectId(ObjectId objectId)
Writes a BSON ObjectId to the writer.- Parameters:
objectId- The ObjectId value.
-
writeObjectId
void writeObjectId(java.lang.String name, ObjectId objectId)Writes a BSON ObjectId element to the writer.- Parameters:
name- The name of the element.objectId- The ObjectId value.
-
writeRegularExpression
void writeRegularExpression(BsonRegularExpression regularExpression)
Writes a BSON regular expression to the writer.- Parameters:
regularExpression- the regular expression to write.
-
writeRegularExpression
void writeRegularExpression(java.lang.String name, BsonRegularExpression regularExpression)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
void writeStartArray(java.lang.String name)
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
void writeStartDocument(java.lang.String name)
Writes the start of a BSON document element to the writer.- Parameters:
name- The name of the element.
-
writeString
void writeString(java.lang.String value)
Writes a BSON String to the writer.- Parameters:
value- The String value.
-
writeString
void writeString(java.lang.String name, java.lang.String value)Writes a BSON String element to the writer.- Parameters:
name- The name of the element.value- The String value.
-
writeSymbol
void writeSymbol(java.lang.String value)
Writes a BSON Symbol to the writer.- Parameters:
value- The symbol.
-
writeSymbol
void writeSymbol(java.lang.String name, java.lang.String value)Writes a BSON Symbol element to the writer.- Parameters:
name- The name of the element.value- The symbol.
-
writeTimestamp
void writeTimestamp(BsonTimestamp value)
Writes a BSON Timestamp to the writer.- Parameters:
value- The combined timestamp/increment value.
-
writeTimestamp
void writeTimestamp(java.lang.String name, BsonTimestamp value)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
void writeUndefined(java.lang.String name)
Writes a BSON undefined element to the writer.- Parameters:
name- The name of the element.
-
pipe
void pipe(BsonReader reader)
Reads a single document from a BsonReader and writes it to this.- Parameters:
reader- The source.
-
-