Abstract

This guide contains detailed information about using how to stream bytes on top of BookKeeper. It essentially motivates and discusses the basic stream operations currently supported.

Summary

When using the BookKeeper API, an application has to split the data to write into entries, each entry being a byte array. This is natural for many applications. For example, when using BookKeeper for write-ahead logging, an application typically wants to write the modifications corresponding to a command or a transaction. Some other applications, however, might not have a natural boundary for entries, and may prefer to write and read streams of bytes. This is exactly the purpose of the stream API we have implemented on top of BookKeeper.

The stream API is implemented in the package Streaming , and it contains two main classes: LedgerOutputStream and LedgerInputStream . The class names are indicative of what they do.

Writing a stream of bytes

Class LedgerOutputStream implements two constructors and five public methods:

public LedgerOutputStream(LedgerHandle lh)

where:

public LedgerOutputStream(LedgerHandle lh, int size)

where:

Closing a stream. This call closes the stream by flushing the write buffer.

public void close()

which has no parameters.

Flushing a stream. This call essentially flushes the write buffer.

public synchronized void flush()

which has no parameters.

Writing bytes. There are three calls for writing bytes to a stream.

public synchronized void write(byte[] b)

where:

public synchronized void write(byte[] b, int off, int len)

where:

public synchronized void write(int b)

where:

Reading a stream of bytes

Class LedgerOutputStream implements two constructors and four public methods:

public LedgerInputStream(LedgerHandle lh) throws BKException, InterruptedException

where:

public LedgerInputStream(LedgerHandle lh, int size) throws BKException, InterruptedException

where:

Closing. There is one call to close an input stream, but the call is currently empty and the application is responsible for closing the ledger handle.

public void close()

which has no parameters.

Reading. There are three calls to read from the stream.

public synchronized int read() throws IOException

which has no parameters.

public synchronized int read(byte[] b) throws IOException

where:

public synchronized int read(byte[] b, int off, int len) throws IOException

where: