| Modifier and Type | Field and Description |
|---|---|
| protected byte[] | buffer
Raw unparsed commit body of the commit. |
| pack-priv int | |
| pack-priv int | |
| pack-priv static final RevCommit[] | |
| protected RevCommit[] | parents
Avoid accessing this field directly. |
| private static final int | |
| protected RevTree | tree
Tree reference of the commit. |
| Access | Constructor and Description |
|---|---|
| protected |
| Modifier and Type | Method and Description |
|---|---|
| public void | |
| pack-priv static void | |
| private static FIFORevQueue | |
| private static void | |
| private static FIFORevQueue | |
| private static FIFORevQueue | |
| public final void | |
| public final PersonIdent | Returns: identity of the author (name, email) and the time the commit was made by the author; null if no author line was found.Parse the author identity from the raw buffer. |
| public ChangedPathFilter | Returns: the changed path filterA revwalk to load the commit graph (if available) rw)Get the changed path filter of the commit. |
| public final PersonIdent | Returns: identity of the committer (name, email) and the time the commit was made by the committer; null if no committer line was found.Parse the committer identity from the raw buffer. |
| public final int | |
| public final Charset | Returns: the preferred encoding ofgetRawBuffer().Determine the encoding of the commit message buffer. |
| public final String | Returns: the preferred encoding ofgetRawBuffer(); or null.Determine the encoding of the commit message buffer. |
| public final String | Returns: the first line of the decoded commit message as a string; nevernull.Parse the commit message and return its first line, i.e., everything up to but not including the first newline, if any. |
| public final List | Returns: ordered list of footer lines; empty list if no footers found.Parse the footer lines (e.g. "Signed-off-by") for machine processing. |
| public final List | Returns: values of footers with key ofkeyName, ordered by their
order of appearance. Duplicates may be returned if the same
footer appeared more than once. Empty list if no footers appear
with the specified key, or there are no footers at all.footer key to find values of, case-insensitive. keyName)Get the values of all footer lines with the given key. |
| public final List | Returns: values of footers with key ofkeyName, ordered by their
order of appearance. Duplicates may be returned if the same
footer appeared more than once. Empty list if no footers appear
with the specified key, or there are no footers at all.footer key to find values of, case-insensitive. key)Get the values of all footer lines with the given key. |
| public final String | Returns: decoded commit message as a string. Never null.Parse the complete commit message and decode it to a string. |
| pack-priv int | Returns: the generation numberGet the distance of the commit from the root, as defined in
Generation number is
|
| public RevCommit | Returns: the specified parent.parent index to obtain. Must be in the range 0 through
nth)getParentCount()-1.Get the nth parent from this commit's parent list. |
| public int | Returns: number of parents; always a positive value but can be 0.Get the number of parent commits listed in this commit. |
| public RevCommit[] | Returns: the array of parents.Obtain an array of all parents (NOTE - THIS IS NOT A COPY). |
| public final byte[] | Returns: the raw unparsed commit body. This is NOT A COPY. Altering the contents of this buffer may alter the walker's knowledge of this commit, and the results it produces.Obtain the raw unparsed commit body (NOTE - THIS IS NOT A COPY). |
| public final byte[] | Returns: contents of the gpg signature; null if the commit was not signed.Parse the gpg signature from the raw buffer. |
| public final String | Returns: decoded commit message as a string. Never null. The returned string does not contain any LFs, even if the first paragraph spanned multiple lines. Embedded LFs are converted to spaces.Parse the commit message and return the first "line" of it. |
| public final RevTree | |
| public final int | |
| pack-priv static boolean | |
| public static RevCommit | Returns: the parsed commit, in an isolated revision pool that is not available to the caller.the canonical formatted commit to be parsed. raw)Parse a commit from its canonical format. |
| public static RevCommit | Returns: the parsed commit, in an isolated revision pool that is not available to the caller.the revision pool to allocate the commit within. The commit's
tree and parent pointers will be obtained from this pool. rw, byte[] the canonical formatted commit to be parsed. This buffer will
be retained by the returned raw)RevCommit and must not be
modified by the caller.Parse a commit from its canonical format. |
| pack-priv void | |
| pack-priv void | |
| pack-priv void | |
| public void | |
| private static void | |
| public String | toString()
Overrides org. Returns a string representation of the object. |
| buffer | back to summary |
|---|---|
| protected byte[] buffer Raw unparsed commit body of the commit. Populated only
after
| |
| commitTime | back to summary |
|---|---|
| pack-priv int commitTime | |
| inDegree | back to summary |
|---|---|
| pack-priv int inDegree | |
| NO_PARENTS | back to summary |
|---|---|
| pack-priv static final RevCommit[] NO_PARENTS | |
| parents | back to summary |
|---|---|
| protected RevCommit[] parents Avoid accessing this field directly. Use method
| |
| STACK_DEPTH | back to summary |
|---|---|
| private static final int STACK_DEPTH | |
| tree | back to summary |
|---|---|
| protected RevTree tree Tree reference of the commit.
| |
| RevCommit | back to summary |
|---|---|
| protected RevCommit(AnyObjectId id) Create a new commit reference.
| |
| carry | back to summary |
|---|---|
| public void carry(RevFlag flag) Carry a RevFlag set on this commit to its parents. If this commit is parsed, has parents, and has the supplied flag set on it we automatically add it to the parents, grand-parents, and so on until an unparsed commit or a commit with no parents is discovered. This permits applications to force a flag through the history chain when necessary.
| |
| carryFlags | back to summary |
|---|---|
| pack-priv static void carryFlags(RevCommit c, int carry) | |
| carryFlags1 | back to summary |
|---|---|
| private static FIFORevQueue carryFlags1(RevCommit c, int carry, int depth) | |
| carryOneStep | back to summary |
|---|---|
| private static void carryOneStep(FIFORevQueue q, int carry, RevCommit c) | |
| defer | back to summary |
|---|---|
| private static FIFORevQueue defer(RevCommit c) | |
| defer | back to summary |
|---|---|
| private static FIFORevQueue defer(FIFORevQueue q, int carry, RevCommit[] pList, int i) | |
| disposeBody | back to summary |
|---|---|
| public final void disposeBody() Discard the message buffer to reduce memory usage.
After discarding the memory usage of the
| |
| getAuthorIdent | back to summary |
|---|---|
| public final PersonIdent getAuthorIdent() Parse the author identity from the raw buffer. This method parses and returns the content of the author line, after taking the commit's character set into account and decoding the author name and email address. This method is fairly expensive and produces a new PersonIdent instance on each invocation. Callers should invoke this method only if they are certain they will be outputting the result, and should cache the return value for as long as necessary to use all information from it.
RevFilter implementations should try to use
| |
| getChangedPathFilter | back to summary |
|---|---|
| public ChangedPathFilter getChangedPathFilter(RevWalk rw) Get the changed path filter of the commit. This is null when there is no commit graph file, the commit is not in the commit graph file, or the commit graph file was generated without changed path filters.
| |
| getCommitterIdent | back to summary |
|---|---|
| public final PersonIdent getCommitterIdent() Parse the committer identity from the raw buffer. This method parses and returns the content of the committer line, after taking the commit's character set into account and decoding the committer name and email address. This method is fairly expensive and produces a new PersonIdent instance on each invocation. Callers should invoke this method only if they are certain they will be outputting the result, and should cache the return value for as long as necessary to use all information from it.
RevFilter implementations should try to use
| |
| getCommitTime | back to summary |
|---|---|
| public final int getCommitTime() Time from the "committer " line of the buffer.
| |
| getEncoding | back to summary |
|---|---|
| public final Charset getEncoding() Determine the encoding of the commit message buffer. Locates the "encoding" header (if present) and then returns the proper character set to apply to this buffer to evaluate its contents as character data.
If no encoding header is present
| |
| getEncodingName | back to summary |
|---|---|
| public final String getEncodingName() Determine the encoding of the commit message buffer. Locates the "encoding" header (if present) and returns its value. Due to corruption in the wild this may be an invalid encoding name that is not recognized by any character encoding library. If no encoding header is present, null.
| |
| getFirstMessageLine | back to summary |
|---|---|
| public final String getFirstMessageLine() Parse the commit message and return its first line, i.e., everything up to but not including the first newline, if any.
| |
| getFooterLines | back to summary |
|---|---|
| public final List Parse the footer lines (e.g. "Signed-off-by") for machine processing. This method splits all of the footer lines out of the last paragraph of the commit message, providing each line as a key-value pair, ordered by the order of the line's appearance in the commit message itself.
A footer line's key must match the pattern
| |
| getFooterLines | back to summary |
|---|---|
| public final List Get the values of all footer lines with the given key.
| |
| getFooterLines | back to summary |
|---|---|
| public final List Get the values of all footer lines with the given key.
| |
| getFullMessage | back to summary |
|---|---|
| public final String getFullMessage() Parse the complete commit message and decode it to a string. This method parses and returns the message portion of the commit buffer, after taking the commit's character set into account and decoding the buffer using that character set. This method is a fairly expensive operation and produces a new string on each invocation.
| |
| getGeneration | back to summary |
|---|---|
| pack-priv int getGeneration() Get the distance of the commit from the root, as defined in
Generation number is
| |
| getParent | back to summary |
|---|---|
| public RevCommit getParent(int nth) Get the nth parent from this commit's parent list.
| |
| getParentCount | back to summary |
|---|---|
| public int getParentCount() Get the number of parent commits listed in this commit.
| |
| getParents | back to summary |
|---|---|
| public RevCommit[] getParents() Obtain an array of all parents (NOTE - THIS IS NOT A COPY). This method is exposed only to provide very fast, efficient access to this commit's parent list. Applications relying on this list should be very careful to ensure they do not modify its contents during their use of it.
| |
| getRawBuffer | back to summary |
|---|---|
| public final byte[] getRawBuffer() Obtain the raw unparsed commit body (NOTE - THIS IS NOT A COPY). This method is exposed only to provide very fast, efficient access to this commit's message buffer within a RevFilter. Applications relying on this buffer should be very careful to ensure they do not modify its contents during their use of it.
| |
| getRawGpgSignature | back to summary |
|---|---|
| public final byte[] getRawGpgSignature() Parse the gpg signature from the raw buffer. This method parses and returns the raw content of the gpgsig lines. This method is fairly expensive and produces a new byte[] instance on each invocation. Callers should invoke this method only if they are certain they will need, and should cache the return value for as long as necessary to use all information from it.
RevFilter implementations should try to use
| |
| getShortMessage | back to summary |
|---|---|
| public final String getShortMessage() Parse the commit message and return the first "line" of it. The first line is everything up to the first pair of LFs. This is the "oneline" format, suitable for output in a single line display. This method parses and returns the message portion of the commit buffer, after taking the commit's character set into account and decoding the buffer using that character set. This method is a fairly expensive operation and produces a new string on each invocation.
| |
| getTree | back to summary |
|---|---|
| public final RevTree getTree() Get a reference to this commit's tree.
| |
| getType | back to summary |
|---|---|
| public final int getType() Implements abstract org. Doc from org. Get Git object type. See
| |
| hasLF | back to summary |
|---|---|
| pack-priv static boolean hasLF(byte[] r, int b, int e) | |
| parse | back to summary |
|---|---|
| public static RevCommit parse(byte[] raw) Parse a commit from its canonical format.
This method constructs a temporary revision pool, parses the commit as
supplied, and returns it to the caller. Since the commit was built inside
of a private revision pool its parent pointers will be initialized, but
will not have their headers loaded.
Applications are discouraged from using this API. Callers usually need
more than one commit. Use
| |
| parse | back to summary |
|---|---|
| public static RevCommit parse(RevWalk rw, byte[] raw) throws IOException Parse a commit from its canonical format. This method inserts the commit directly into the caller supplied revision pool, making it appear as though the commit exists in the repository, even if it doesn't. The repository under the pool is not affected.
The body of the commit (message, author, committer) is always retained in
the returned
| |
| parseBody | back to summary |
|---|---|
| pack-priv void parseBody(RevWalk walk) throws MissingObjectException, IncorrectObjectTypeException, IOException Implements abstract org.
| |
| parseCanonical | back to summary |
|---|---|
| pack-priv void parseCanonical(RevWalk walk, byte[] raw) throws IOException | |
| parseHeaders | back to summary |
|---|---|
| pack-priv void parseHeaders(RevWalk walk) throws MissingObjectException, IncorrectObjectTypeException, IOException Implements abstract org.
| |
| reset | back to summary |
|---|---|
| public void reset() Reset this commit to allow another RevWalk with the same instances.
Subclasses must call | |
| slowCarryFlags | back to summary |
|---|---|
| private static void slowCarryFlags(FIFORevQueue q, int carry) | |
| toString | back to summary |
|---|---|
| public String toString() Overrides org. Doc from java. Returns a string representation of the object.
Satisfying this method's contract implies a non- | |