org.bson

Interface BSONEncoder

All Known Implementing Classes:

BasicBSONEncoder, DefaultDBEncoder

public interface BSONEncoder

A BSONEncoder is a class which can be used to turn documents into byte arrays. The BSONEncoder walks down through the object graph and writes corresponding byte sequences into underlying OutputBuffer.

This class is a part of legacy API. Please check Encoder for a new one.

Method Summary

Modifier and Type	Method and Description
void	done() Free the resources.
byte[]	encode(BSONObject document) Encode a document into byte array.
int	putObject(BSONObject document) Encoder and write a document into underlying buffer.
void	set(OutputBuffer buffer) Sets the buffer to wrich the result of encoding will be written.

Method Detail

encode

byte[] encode(BSONObject document)

Encode a document into byte array. This is a shortcut method which creates a new OutputBuffer, invokes the other 3 methods in a corresponding sequence:

• set(org.bson.io.OutputBuffer)
• putObject(BSONObject)
• done()

and returns the contents of the OutputBuffer.

Parameters:

document - the document to be encoded

Returns:

a byte sequence

putObject

int putObject(BSONObject document)

Encoder and write a document into underlying buffer.

Parameters:

document - the document to be encoded

Returns:

number of bytes written

done

void done()

Free the resources.

set

void set(OutputBuffer buffer)

Sets the buffer to wrich the result of encoding will be written.

Parameters:

buffer - the buffer to be used to write a byte sequences to