Class ObjectInserter.Filter
- java.lang.Object
-
- org.eclipse.jgit.lib.ObjectInserter
-
- org.eclipse.jgit.lib.ObjectInserter.Filter
-
- All Implemented Interfaces:
AutoCloseable
- 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
Constructors Constructor Description Filter()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected byte[]
buffer()
Obtain a temporary buffer for use by the ObjectInserter or its subclass.void
close()
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.ObjectReader
newReader()
Open a reader for objects that may have been written by this inserter.-
Methods inherited from class org.eclipse.jgit.lib.ObjectInserter
digest, insert, insert, insert
-
-
-
-
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 classObjectInserter
- 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 classObjectInserter
- 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 classObjectInserter
- Parameters:
type
- type code of the object to store.data
- complete content of the object.off
- first position withindata
.len
- number of bytes to copy fromdata
.- 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 classObjectInserter
- Parameters:
objectType
- type code of the object to store.length
- number of bytes to scan fromin
.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 classObjectInserter
- Parameters:
formatter
- aTreeFormatter
object.- 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 classObjectInserter
- 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 classObjectInserter
- Parameters:
type
- type code of the object to store.data
- complete content of the object.off
- first position withindata
.len
- number of bytes to copy fromdata
.- 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 classObjectInserter
- Parameters:
objectType
- type code of the object to store.length
- number of bytes to copy fromin
.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 classObjectInserter
- 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.
-
newReader
public ObjectReader newReader()
Description copied from class:ObjectInserter
Open a reader for objects that may have been written by this inserter.The returned reader allows the calling thread to read back recently inserted objects without first calling
flush()
to make them visible to the repository. The returned reader should only be used from the same thread as the inserter. Objects written by this inserter may not be visible tothis.newReader().newReader()
.The returned reader should return this inserter instance from
ObjectReader.getCreatedFromInserter()
.Behavior is undefined if an insert method is called on the inserter in the middle of reading from an
ObjectStream
opened from this reader. For example, reading the remainder of the object may fail, or newly written data may even be corrupted. Interleaving whole object reads (including streaming reads) with inserts is fine, just not interleaving streaming partial object reads with inserts.- Specified by:
newReader
in classObjectInserter
- Returns:
- reader for any object, including an object recently inserted by this inserter since the last flush.
-
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 classObjectInserter
- Throws:
IOException
- the flush could not be completed; objects inserted thus far are in an indeterminate state.
-
close
public void close()
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:
close
in interfaceAutoCloseable
- Specified by:
close
in classObjectInserter
-
-