Copy this object to the output stream.

For some object store implementations, this method may be more efficient than reading from openStream() into a temporary byte array, then writing to the destination stream.

The default implementation of this method is to copy with a temporary byte array for large objects, or to pass through the cached byte array for small objects.

Parameters

out:OutputStream

stream to receive the complete copy of this object's data. Caller is responsible for flushing or closing this stream after this method returns.

Exceptions

MissingObjectException:

the object no longer exists.

IOException:

the object store cannot be accessed, or the stream cannot be written to.

Obtain a copy of the bytes of this object.

Unlike getCachedBytes() this method returns an array that might be modified by the caller.

Returns:byte[]

the bytes of this object.

Exceptions

LargeObjectException:

if the object won't fit into a byte array, because isLarge() returns true. Callers should use openStream() instead to access the contents.

Obtain a copy of the bytes of this object. If the object size is less than or equal to sizeLimit this method will provide it as a byte array, even if isLarge() is true. This utility is useful for application code that absolutely must have the object as a single contiguous byte array in memory. Unlike getCachedBytes(int) this method returns an array that might be modified by the caller.

Parameters

sizeLimit:int

maximum number of bytes to return. If the object is larger than this limit, org.eclipse.jgit.errors.LargeObjectException will be thrown.

Returns:byte[]

the bytes of this object.

Exceptions

LargeObjectException:

if the object is bigger than sizeLimit, or if java.lang.OutOfMemoryError occurs during allocation of the result array. Callers should use openStream() instead to access the contents.

MissingObjectException:

the object is large, and it no longer exists.

IOException:

the object store cannot be accessed.

Obtain a reference to the (possibly cached) bytes of this object.

This method offers direct access to the internal caches, potentially saving on data copies between the internal cache and higher level code. Callers who receive this reference must not modify its contents. Changes (if made) will affect the cache but not the repository itself.

Returns:byte[]

the cached bytes of this object. Do not modify it.

Exceptions

LargeObjectException:

if the object won't fit into a byte array, because isLarge() returns true. Callers should use openStream() instead to access the contents.

Obtain a reference to the (possibly cached) bytes of this object. If the object size is less than or equal to sizeLimit this method will provide it as a byte array, even if isLarge() is true. This utility is useful for application code that absolutely must have the object as a single contiguous byte array in memory. This method offers direct access to the internal caches, potentially saving on data copies between the internal cache and higher level code. Callers who receive this reference must not modify its contents. Changes (if made) will affect the cache but not the repository itself.

Parameters

sizeLimit:int

maximum number of bytes to return. If the object size is larger than this limit and isLarge() is true, org.eclipse.jgit.errors.LargeObjectException will be thrown.

Returns:byte[]

the cached bytes of this object. Do not modify it.

Exceptions

LargeObjectException:

if the object is bigger than sizeLimit, or if java.lang.OutOfMemoryError occurs during allocation of the result array. Callers should use openStream() instead to access the contents.

MissingObjectException:

the object is large, and it no longer exists.

IOException:

the object store cannot be accessed.

Get size of object in bytes

Returns:long

size of object in bytes

Get Git in pack object type

Returns:int

Git in pack object type, see org.eclipse.jgit.lib.Constants.

Whether this object is too large to obtain as a byte array.

Returns:boolean

true if this object is too large to obtain as a byte array. Objects over a certain threshold should be accessed only by their openStream() to prevent overflowing the JVM heap.

Obtain an input stream to read this object's data.

Returns:ObjectStream

a stream of this object's data. Caller must close the stream when through with it. The returned stream is buffered with a reasonable buffer size.

Exceptions

MissingObjectException:

the object no longer exists.

IOException:

the object store cannot be accessed.