Package org.bson
Class AbstractBsonReader
- java.lang.Object
-
- org.bson.AbstractBsonReader
-
- All Implemented Interfaces:
java.io.Closeable
,java.lang.AutoCloseable
,BsonReader
- Direct Known Subclasses:
BsonBinaryReader
,BsonDocumentReader
,JsonReader
public abstract class AbstractBsonReader extends java.lang.Object implements BsonReader
Abstract base class for BsonReader implementations.- Since:
- 3.0
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
AbstractBsonReader.State
The state of a reader.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description void
close()
Closes the reader.BsonType
getCurrentBsonType()
java.lang.String
getCurrentName()
Gets the most recently read name.AbstractBsonReader.State
getState()
int
peekBinarySize()
Peeks the size of the binary data that the reader is positioned at.byte
peekBinarySubType()
Peeks the subtype of the binary data that the reader is positioned at.BsonBinary
readBinaryData()
Reads BSON Binary data from the reader.BsonBinary
readBinaryData(java.lang.String name)
Reads a BSON Binary data element from the reader.boolean
readBoolean()
Reads a BSON Boolean from the reader.boolean
readBoolean(java.lang.String name)
Reads a BSON Boolean element from the reader.abstract BsonType
readBsonType()
Reads a BSONType from the reader.long
readDateTime()
Reads a BSON DateTime from the reader.long
readDateTime(java.lang.String name)
Reads a BSON DateTime element from the reader.BsonDbPointer
readDBPointer()
Reads a BSON DBPointer from the reader.BsonDbPointer
readDBPointer(java.lang.String name)
Reads a BSON DBPointer element from the reader.Decimal128
readDecimal128()
Reads a BSON Decimal128 from the reader.Decimal128
readDecimal128(java.lang.String name)
Reads a BSON Decimal128 element from the reader.double
readDouble()
Reads a BSON Double from the reader.double
readDouble(java.lang.String name)
Reads a BSON Double element from the reader.void
readEndArray()
Reads the end of a BSON array from the reader.void
readEndDocument()
Reads the end of a BSON document from the reader.int
readInt32()
Reads a BSON Int32 from the reader.int
readInt32(java.lang.String name)
Reads a BSON Int32 element from the reader.long
readInt64()
Reads a BSON Int64 from the reader.long
readInt64(java.lang.String name)
Reads a BSON Int64 element from the reader.java.lang.String
readJavaScript()
Reads a BSON JavaScript from the reader.java.lang.String
readJavaScript(java.lang.String name)
Reads a BSON JavaScript element from the reader.java.lang.String
readJavaScriptWithScope()
Reads a BSON JavaScript with scope from the reader (call readStartDocument next to read the scope).java.lang.String
readJavaScriptWithScope(java.lang.String name)
Reads a BSON JavaScript with scope element from the reader (call readStartDocument next to read the scope).void
readMaxKey()
Reads a BSON MaxKey from the reader.void
readMaxKey(java.lang.String name)
Reads a BSON MaxKey element from the reader.void
readMinKey()
Reads a BSON MinKey from the reader.void
readMinKey(java.lang.String name)
Reads a BSON MinKey element from the reader.java.lang.String
readName()
Reads the name of an element from the reader.void
readName(java.lang.String name)
Reads the name of an element from the reader.void
readNull()
Reads a BSON null from the reader.void
readNull(java.lang.String name)
Reads a BSON null element from the reader.ObjectId
readObjectId()
Reads a BSON ObjectId from the reader.ObjectId
readObjectId(java.lang.String name)
Reads a BSON ObjectId element from the reader.BsonRegularExpression
readRegularExpression()
Reads a BSON regular expression from the reader.BsonRegularExpression
readRegularExpression(java.lang.String name)
Reads a BSON regular expression element from the reader.void
readStartArray()
Reads the start of a BSON array.void
readStartDocument()
Reads the start of a BSON document.java.lang.String
readString()
Reads a BSON String from the reader.java.lang.String
readString(java.lang.String name)
Reads a BSON string element from the reader.java.lang.String
readSymbol()
Reads a BSON symbol from the reader.java.lang.String
readSymbol(java.lang.String name)
Reads a BSON symbol element from the reader.BsonTimestamp
readTimestamp()
Reads a BSON timestamp from the reader.BsonTimestamp
readTimestamp(java.lang.String name)
Reads a BSON timestamp element from the reader.void
readUndefined()
Reads a BSON undefined from the reader.void
readUndefined(java.lang.String name)
Reads a BSON undefined element from the reader.void
skipName()
Skips the name (reader must be positioned on a name).void
skipValue()
Skips the value (reader must be positioned on a value).-
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.bson.BsonReader
getMark, mark, reset
-
-
-
-
Method Detail
-
getCurrentBsonType
public BsonType getCurrentBsonType()
- Specified by:
getCurrentBsonType
in interfaceBsonReader
- Returns:
- The current BsonType.
-
getCurrentName
public java.lang.String getCurrentName()
Description copied from interface:BsonReader
Gets the most recently read name.- Specified by:
getCurrentName
in interfaceBsonReader
- Returns:
- the most recently read name
-
getState
public AbstractBsonReader.State getState()
- Returns:
- The current state of the reader.
-
close
public void close()
Closes the reader.- Specified by:
close
in interfacejava.lang.AutoCloseable
- Specified by:
close
in interfaceBsonReader
- Specified by:
close
in interfacejava.io.Closeable
-
readBinaryData
public BsonBinary readBinaryData()
Description copied from interface:BsonReader
Reads BSON Binary data from the reader.- Specified by:
readBinaryData
in interfaceBsonReader
- Returns:
- A Binary.
-
peekBinarySubType
public byte peekBinarySubType()
Description copied from interface:BsonReader
Peeks the subtype of the binary data that the reader is positioned at. This operation is not permitted if the mark is already set.- Specified by:
peekBinarySubType
in interfaceBsonReader
- Returns:
- the subtype
- See Also:
BsonReader.mark()
-
peekBinarySize
public int peekBinarySize()
Description copied from interface:BsonReader
Peeks the size of the binary data that the reader is positioned at. This operation is not permitted if the mark is already set.- Specified by:
peekBinarySize
in interfaceBsonReader
- Returns:
- the size of the binary data
- See Also:
BsonReader.mark()
-
readBoolean
public boolean readBoolean()
Description copied from interface:BsonReader
Reads a BSON Boolean from the reader.- Specified by:
readBoolean
in interfaceBsonReader
- Returns:
- A Boolean.
-
readBsonType
public abstract BsonType readBsonType()
Description copied from interface:BsonReader
Reads a BSONType from the reader.- Specified by:
readBsonType
in interfaceBsonReader
- Returns:
- A BSONType.
-
readDateTime
public long readDateTime()
Description copied from interface:BsonReader
Reads a BSON DateTime from the reader.- Specified by:
readDateTime
in interfaceBsonReader
- Returns:
- The number of milliseconds since the Unix epoch.
-
readDouble
public double readDouble()
Description copied from interface:BsonReader
Reads a BSON Double from the reader.- Specified by:
readDouble
in interfaceBsonReader
- Returns:
- A Double.
-
readEndArray
public void readEndArray()
Description copied from interface:BsonReader
Reads the end of a BSON array from the reader.- Specified by:
readEndArray
in interfaceBsonReader
-
readEndDocument
public void readEndDocument()
Description copied from interface:BsonReader
Reads the end of a BSON document from the reader.- Specified by:
readEndDocument
in interfaceBsonReader
-
readInt32
public int readInt32()
Description copied from interface:BsonReader
Reads a BSON Int32 from the reader.- Specified by:
readInt32
in interfaceBsonReader
- Returns:
- An Int32.
-
readInt64
public long readInt64()
Description copied from interface:BsonReader
Reads a BSON Int64 from the reader.- Specified by:
readInt64
in interfaceBsonReader
- Returns:
- An Int64.
-
readDecimal128
public Decimal128 readDecimal128()
Description copied from interface:BsonReader
Reads a BSON Decimal128 from the reader.- Specified by:
readDecimal128
in interfaceBsonReader
- Returns:
- A Decimal128
-
readJavaScript
public java.lang.String readJavaScript()
Description copied from interface:BsonReader
Reads a BSON JavaScript from the reader.- Specified by:
readJavaScript
in interfaceBsonReader
- Returns:
- A string.
-
readJavaScriptWithScope
public java.lang.String readJavaScriptWithScope()
Description copied from interface:BsonReader
Reads a BSON JavaScript with scope from the reader (call readStartDocument next to read the scope).- Specified by:
readJavaScriptWithScope
in interfaceBsonReader
- Returns:
- A string.
-
readMaxKey
public void readMaxKey()
Description copied from interface:BsonReader
Reads a BSON MaxKey from the reader.- Specified by:
readMaxKey
in interfaceBsonReader
-
readMinKey
public void readMinKey()
Description copied from interface:BsonReader
Reads a BSON MinKey from the reader.- Specified by:
readMinKey
in interfaceBsonReader
-
readNull
public void readNull()
Description copied from interface:BsonReader
Reads a BSON null from the reader.- Specified by:
readNull
in interfaceBsonReader
-
readObjectId
public ObjectId readObjectId()
Description copied from interface:BsonReader
Reads a BSON ObjectId from the reader.- Specified by:
readObjectId
in interfaceBsonReader
- Returns:
- the
ObjectId
value
-
readRegularExpression
public BsonRegularExpression readRegularExpression()
Description copied from interface:BsonReader
Reads a BSON regular expression from the reader.- Specified by:
readRegularExpression
in interfaceBsonReader
- Returns:
- A regular expression.
-
readDBPointer
public BsonDbPointer readDBPointer()
Description copied from interface:BsonReader
Reads a BSON DBPointer from the reader.- Specified by:
readDBPointer
in interfaceBsonReader
- Returns:
- A DBPointer.
-
readStartArray
public void readStartArray()
Description copied from interface:BsonReader
Reads the start of a BSON array.- Specified by:
readStartArray
in interfaceBsonReader
-
readStartDocument
public void readStartDocument()
Description copied from interface:BsonReader
Reads the start of a BSON document.- Specified by:
readStartDocument
in interfaceBsonReader
-
readString
public java.lang.String readString()
Description copied from interface:BsonReader
Reads a BSON String from the reader.- Specified by:
readString
in interfaceBsonReader
- Returns:
- A String.
-
readSymbol
public java.lang.String readSymbol()
Description copied from interface:BsonReader
Reads a BSON symbol from the reader.- Specified by:
readSymbol
in interfaceBsonReader
- Returns:
- A string.
-
readTimestamp
public BsonTimestamp readTimestamp()
Description copied from interface:BsonReader
Reads a BSON timestamp from the reader.- Specified by:
readTimestamp
in interfaceBsonReader
- Returns:
- The combined timestamp/increment.
-
readUndefined
public void readUndefined()
Description copied from interface:BsonReader
Reads a BSON undefined from the reader.- Specified by:
readUndefined
in interfaceBsonReader
-
skipName
public void skipName()
Description copied from interface:BsonReader
Skips the name (reader must be positioned on a name).- Specified by:
skipName
in interfaceBsonReader
-
skipValue
public void skipValue()
Description copied from interface:BsonReader
Skips the value (reader must be positioned on a value).- Specified by:
skipValue
in interfaceBsonReader
-
readBinaryData
public BsonBinary readBinaryData(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON Binary data element from the reader.- Specified by:
readBinaryData
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A Binary.
-
readBoolean
public boolean readBoolean(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON Boolean element from the reader.- Specified by:
readBoolean
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A Boolean.
-
readDateTime
public long readDateTime(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON DateTime element from the reader.- Specified by:
readDateTime
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- The number of milliseconds since the Unix epoch.
-
readDouble
public double readDouble(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON Double element from the reader.- Specified by:
readDouble
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A Double.
-
readInt32
public int readInt32(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON Int32 element from the reader.- Specified by:
readInt32
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- An Int32.
-
readInt64
public long readInt64(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON Int64 element from the reader.- Specified by:
readInt64
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- An Int64.
-
readDecimal128
public Decimal128 readDecimal128(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON Decimal128 element from the reader.- Specified by:
readDecimal128
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A Decimal128
-
readJavaScript
public java.lang.String readJavaScript(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON JavaScript element from the reader.- Specified by:
readJavaScript
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A string.
-
readJavaScriptWithScope
public java.lang.String readJavaScriptWithScope(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON JavaScript with scope element from the reader (call readStartDocument next to read the scope).- Specified by:
readJavaScriptWithScope
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A string.
-
readMaxKey
public void readMaxKey(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON MaxKey element from the reader.- Specified by:
readMaxKey
in interfaceBsonReader
- Parameters:
name
- The name of the element.
-
readMinKey
public void readMinKey(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON MinKey element from the reader.- Specified by:
readMinKey
in interfaceBsonReader
- Parameters:
name
- The name of the element.
-
readName
public java.lang.String readName()
Description copied from interface:BsonReader
Reads the name of an element from the reader.- Specified by:
readName
in interfaceBsonReader
- Returns:
- The name of the element.
-
readName
public void readName(java.lang.String name)
Description copied from interface:BsonReader
Reads the name of an element from the reader.- Specified by:
readName
in interfaceBsonReader
- Parameters:
name
- The name of the element.
-
readNull
public void readNull(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON null element from the reader.- Specified by:
readNull
in interfaceBsonReader
- Parameters:
name
- The name of the element.
-
readObjectId
public ObjectId readObjectId(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON ObjectId element from the reader.- Specified by:
readObjectId
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- ObjectId.
-
readRegularExpression
public BsonRegularExpression readRegularExpression(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON regular expression element from the reader.- Specified by:
readRegularExpression
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A regular expression.
-
readDBPointer
public BsonDbPointer readDBPointer(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON DBPointer element from the reader.- Specified by:
readDBPointer
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A DBPointer.
-
readString
public java.lang.String readString(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON string element from the reader.- Specified by:
readString
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A String.
-
readSymbol
public java.lang.String readSymbol(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON symbol element from the reader.- Specified by:
readSymbol
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- A string.
-
readTimestamp
public BsonTimestamp readTimestamp(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON timestamp element from the reader.- Specified by:
readTimestamp
in interfaceBsonReader
- Parameters:
name
- The name of the element.- Returns:
- The combined timestamp/increment.
-
readUndefined
public void readUndefined(java.lang.String name)
Description copied from interface:BsonReader
Reads a BSON undefined element from the reader.- Specified by:
readUndefined
in interfaceBsonReader
- Parameters:
name
- The name of the element.
-
-