org.hawkular.bus.common

Class BinaryData

java.lang.Object

java.io.InputStream

org.hawkular.bus.common.BinaryData

All Implemented Interfaces:

Closeable, AutoCloseable

public class BinaryData
extends InputStream

This is a "stream" that includes some in-memory data as well as another stream. The in-memory data (if not null or empty) will be read first. Once the in-memory data has been exhausted, any additional reads will read data from the input stream. This is used in the use-case that an input stream contained a JSON command (e.g. AbstractMessage) followed by additional binary data. The JSON parser may have read extra data over and beyond the actual JSON message data. In that case, the extra data the JSON parser read will be found in an in-memory byte array. That additional in-memory data byte array combined with the input stream that may contain even more data will both be stored in this object so both pieces of data can be accessed using the normal input stream API. This can also be used to prefix a binary blob (found in an input stream) with a byte array of in-memory data. In other words, this can be used to prepare a message that consists of a JSON-message followed by a large amount of data found in a stream.

Constructor Summary

Constructors

Constructor and Description
BinaryData(byte[] inMemoryData, InputStream streamData)

Method Summary

Modifier and Type	Method and Description
int	available()
void	close()
void	mark(int readlimit)
boolean	markSupported()
int	read()
int	read(byte[] b)
int	read(byte[] b, int off, int len)
void	reset()
void	setOnCloseAction(Runnable action) Provides custom action to run after close() finishes closing the stream.
long	skip(long n)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BinaryData

public BinaryData(byte[] inMemoryData,
                  InputStream streamData)

Method Detail

setOnCloseAction

public void setOnCloseAction(Runnable action)

Provides custom action to run after close() finishes closing the stream. This allows you to tell this object how it can clean up resources backing the stream.

Parameters:

action - the action or null if nothing should be done

read

public int read()
         throws IOException

Specified by:

read in class InputStream

Throws:

IOException

read

public int read(byte[] b)
         throws IOException

Overrides:

read in class InputStream

Throws:

IOException

read

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

Overrides:

read in class InputStream

Throws:

IOException

skip

public long skip(long n)
          throws IOException

Overrides:

skip in class InputStream

Throws:

IOException

available

public int available()
              throws IOException

Overrides:

available in class InputStream

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class InputStream

Throws:

IOException

mark

public void mark(int readlimit)

Overrides:

mark in class InputStream

reset

public void reset()
           throws IOException

Overrides:

reset in class InputStream

Throws:

IOException

markSupported

public boolean markSupported()

Overrides:

markSupported in class InputStream