org.eclipse.jgit.lib
Class ObjectInserter.Filter

java.lang.Object
  org.eclipse.jgit.lib.ObjectInserter
      org.eclipse.jgit.lib.ObjectInserter.Filter

Enclosing class:

ObjectInserter

public abstract static class ObjectInserter.Filter
extends ObjectInserter

Wraps a delegate ObjectInserter.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jgit.lib.ObjectInserter

ObjectInserter.Filter, ObjectInserter.Formatter

Constructor Summary

ObjectInserter.Filter()

Method Summary

protected byte[]	buffer() Obtain a temporary buffer for use by the ObjectInserter or its subclass.
protected abstract ObjectInserter	delegate()
void	flush() Make all inserted objects visible.
ObjectId	idFor(int type, byte[] data) Compute the name of an object, without inserting it.
ObjectId	idFor(int type, byte[] data, int off, int len) Compute the name of an object, without inserting it.
ObjectId	idFor(int objectType, long length, InputStream in) Compute the name of an object, without inserting it.
ObjectId	idFor(TreeFormatter formatter) Compute the ObjectId for the given tree without inserting it.
ObjectId	insert(int type, byte[] data) Insert a single object into the store, returning its unique name.
ObjectId	insert(int type, byte[] data, int off, int len) Insert a single object into the store, returning its unique name.
ObjectId	insert(int objectType, long length, InputStream in) Insert a single object into the store, returning its unique name.
PackParser	newPackParser(InputStream in) Initialize a parser to read from a pack formatted stream.
void	release() Release any resources used by this inserter.

Methods inherited from class org.eclipse.jgit.lib.ObjectInserter

digest, insert, insert, insert

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectInserter.Filter

public ObjectInserter.Filter()

Method Detail

delegate

protected abstract ObjectInserter delegate()

Returns:

delegate ObjectInserter to handle all processing.

buffer

protected byte[] buffer()

Description copied from class: ObjectInserter

Obtain a temporary buffer for use by the ObjectInserter or its subclass.

This buffer is supplied by the ObjectInserter base class to itself and its subclasses for the purposes of pulling data from a supplied InputStream, passing it through a Deflater, or formatting the canonical format of a small object like a small tree or commit.

This buffer IS NOT for translation such as auto-CRLF or content filtering and must not be used for such purposes.

The returned buffer is small, around a few KiBs, and the size may change between versions of JGit. Callers using this buffer must always check the length of the returned array to ascertain how much space was provided.

There is a single buffer for each ObjectInserter, repeated calls to this method will (usually) always return the same buffer. If the caller needs more than one buffer, or needs a buffer of a larger size, it must manage that buffer on its own.

The buffer is usually on first demand for a buffer.

Overrides:

buffer in class ObjectInserter

Returns:

a temporary byte array for use by the caller.

idFor

public ObjectId idFor(int type,
                      byte[] data)

Description copied from class: ObjectInserter

Compute the name of an object, without inserting it.

Overrides:

idFor in class ObjectInserter

Parameters:

type - type code of the object to store.

data - complete content of the object.

Returns:

the name of the object.

idFor

public ObjectId idFor(int type,
                      byte[] data,
                      int off,
                      int len)

Description copied from class: ObjectInserter

Compute the name of an object, without inserting it.

Overrides:

idFor in class ObjectInserter

Parameters:

type - type code of the object to store.

data - complete content of the object.

off - first position within data.

len - number of bytes to copy from data.

Returns:

the name of the object.

idFor

public ObjectId idFor(int objectType,
                      long length,
                      InputStream in)
               throws IOException

Description copied from class: ObjectInserter

Compute the name of an object, without inserting it.

Overrides:

idFor in class ObjectInserter

Parameters:

objectType - type code of the object to store.

length - number of bytes to scan from in.

in - stream providing the object content. The caller is responsible for closing the stream.

Returns:

the name of the object.

Throws:

IOException - the source stream could not be read.

idFor

public ObjectId idFor(TreeFormatter formatter)

Description copied from class: ObjectInserter

Compute the ObjectId for the given tree without inserting it.

Overrides:

idFor in class ObjectInserter

Returns:

the computed ObjectId

insert

public ObjectId insert(int type,
                       byte[] data)
                throws IOException

Description copied from class: ObjectInserter

Insert a single object into the store, returning its unique name.

Overrides:

insert in class ObjectInserter

Parameters:

type - type code of the object to store.

data - complete content of the object.

Returns:

the name of the object.

Throws:

IOException - the object could not be stored.

insert

public ObjectId insert(int type,
                       byte[] data,
                       int off,
                       int len)
                throws IOException

Description copied from class: ObjectInserter

Insert a single object into the store, returning its unique name.

Overrides:

insert in class ObjectInserter

Parameters:

type - type code of the object to store.

data - complete content of the object.

off - first position within data.

len - number of bytes to copy from data.

Returns:

the name of the object.

Throws:

IOException - the object could not be stored.

insert

public ObjectId insert(int objectType,
                       long length,
                       InputStream in)
                throws IOException

Description copied from class: ObjectInserter

Insert a single object into the store, returning its unique name.

Specified by:

insert in class ObjectInserter

Parameters:

objectType - type code of the object to store.

length - number of bytes to copy from in.

in - stream providing the object content. The caller is responsible for closing the stream.

Returns:

the name of the object.

Throws:

IOException - the object could not be stored, or the source stream could not be read.

newPackParser

public PackParser newPackParser(InputStream in)
                         throws IOException

Description copied from class: ObjectInserter

Initialize a parser to read from a pack formatted stream.

Specified by:

newPackParser in class ObjectInserter

Parameters:

in - the input stream. The stream is not closed by the parser, and must instead be closed by the caller once parsing is complete.

Returns:

the pack parser.

Throws:

IOException - the parser instance, which can be configured and then used to parse objects into the ObjectDatabase.

flush

public void flush()
           throws IOException

Description copied from class: ObjectInserter

Make all inserted objects visible.

The flush may take some period of time to make the objects available to other threads.

Specified by:

flush in class ObjectInserter

Throws:

IOException - the flush could not be completed; objects inserted thus far are in an indeterminate state.

release

public void release()

Description copied from class: ObjectInserter

Release any resources used by this inserter.

An inserter that has been released can be used again, but may need to be released after the subsequent usage.

Specified by:

release in class ObjectInserter