Package org.apache.jackrabbit.commons.jackrabbit

Class SimpleReferenceBinary

java.lang.Object

org.apache.jackrabbit.commons.jackrabbit.SimpleReferenceBinary

All Implemented Interfaces:

Binary, ReferenceBinary

public class SimpleReferenceBinary
extends Object
implements ReferenceBinary

Constructor Summary

Constructors

Constructor	Description
SimpleReferenceBinary(String reference)

Method Summary

Modifier and Type	Method	Description
void	dispose()	Releases all resources associated with this Binary object and informs the repository that these resources may now be reclaimed.
String	getReference()	Returns a secure reference to this binary, or null if such a reference is not available.
long	getSize()	Returns the size of this Binary value in bytes.
InputStream	getStream()	Returns an InputStream representation of this value.
int	read(byte[] b, long position)	Reads successive bytes from the specified position in this Binary into the passed byte array until either the byte array is full or the end of the Binary is encountered.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleReferenceBinary

public SimpleReferenceBinary(String reference)

Method Detail

getReference

public String getReference()

Description copied from interface: ReferenceBinary

Returns a secure reference to this binary, or null if such a reference is not available.

Specified by:

getReference in interface ReferenceBinary

Returns:

binary reference, or null

getStream

public InputStream getStream()
                      throws RepositoryException

Description copied from interface: Binary

Returns an InputStream representation of this value. Each call to getStream() returns a new stream. The API consumer is responsible for calling close() on the returned stream.

If Binary.dispose() has been called on this Binary object, then this method will throw the runtime exception IllegalStateException.

Specified by:

getStream in interface Binary

Returns:

A stream representation of this value.

Throws:

RepositoryException - if an error occurs.

read

public int read(byte[] b,
                long position)
         throws IOException,
                RepositoryException

Description copied from interface: Binary

Reads successive bytes from the specified position in this Binary into the passed byte array until either the byte array is full or the end of the Binary is encountered.

If Binary.dispose() has been called on this Binary object, then this method will throw the runtime exception IllegalStateException.

Specified by:

read in interface Binary

Parameters:

b - the buffer into which the data is read.

position - the position in this Binary from which to start reading bytes.

Returns:

the number of bytes read into the buffer, or -1 if there is no more data because the end of the Binary has been reached.

Throws:

IOException - if an I/O error occurs.

RepositoryException - if another error occurs.

getSize

public long getSize()
             throws RepositoryException

Description copied from interface: Binary

Returns the size of this Binary value in bytes.

If Binary.dispose() has been called on this Binary object, then this method will throw the runtime exception IllegalStateException.

Specified by:

getSize in interface Binary

Returns:

the size of this value in bytes.

Throws:

RepositoryException - if an error occurs.

dispose

public void dispose()

Description copied from interface: Binary

Releases all resources associated with this Binary object and informs the repository that these resources may now be reclaimed. An application should call this method when it is finished with the Binary object.

Specified by:

dispose in interface Binary