com.google.gerrit.server

Class ChangeUtil

java.lang.Object

com.google.gerrit.server.ChangeUtil

public class ChangeUtil
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static com.google.common.collect.Ordering<PatchSet>	PS_ID_ORDER
static int	TOPIC_MAX_LENGTH

Method Summary

Modifier and Type	Method and Description
static void	ensureChangeIdIsCorrect(boolean requireChangeId, java.lang.String currentChangeId, java.lang.String newCommitMessage) Make sure that the change commit message has a correct footer.
static java.lang.String	messageUuid()
static PatchSet.Id	nextPatchSetId(PatchSet.Id id) Get the next patch set ID just looking at a single previous patch set ID.
static PatchSet.Id	nextPatchSetId(org.eclipse.jgit.lib.Repository git, PatchSet.Id id) Get the next patch set ID from scanning refs in the repo.
static PatchSet.Id	nextPatchSetIdFromAllRefsMap(java.util.Map<java.lang.String,org.eclipse.jgit.lib.Ref> allRefs, PatchSet.Id id) Get the next patch set ID from a previously-read map of all refs.
static PatchSet.Id	nextPatchSetIdFromChangeRefsMap(java.util.Map<java.lang.String,org.eclipse.jgit.lib.ObjectId> changeRefs, PatchSet.Id id) Get the next patch set ID from a previously-read map of refs below the change prefix.
static java.lang.String	status(Change c)

Methods inherited from class java.lang.Object

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

Field Detail

TOPIC_MAX_LENGTH

public static final int TOPIC_MAX_LENGTH

See Also:

Constant Field Values

PS_ID_ORDER

public static final com.google.common.collect.Ordering<PatchSet> PS_ID_ORDER

Method Detail

messageUuid

public static java.lang.String messageUuid()

Returns:

a new unique identifier for change message entities.

nextPatchSetIdFromAllRefsMap

public static PatchSet.Id nextPatchSetIdFromAllRefsMap(java.util.Map<java.lang.String,org.eclipse.jgit.lib.Ref> allRefs,
                                                       PatchSet.Id id)

Get the next patch set ID from a previously-read map of all refs.

Parameters:

allRefs - map of full ref name to ref.

id - previous patch set ID.

Returns:

next unused patch set ID for the same change, skipping any IDs whose corresponding ref names appear in the allRefs map.

nextPatchSetIdFromChangeRefsMap

public static PatchSet.Id nextPatchSetIdFromChangeRefsMap(java.util.Map<java.lang.String,org.eclipse.jgit.lib.ObjectId> changeRefs,
                                                          PatchSet.Id id)

Get the next patch set ID from a previously-read map of refs below the change prefix.

Parameters:

changeRefs - map of ref suffix to SHA-1, where the keys are ref names with the refs/changes/CD/ABCD/ prefix stripped. All refs should be under id's change ref prefix.

id - previous patch set ID.

Returns:

next unused patch set ID for the same change, skipping any IDs whose corresponding ref names appear in the changeRefs map.

nextPatchSetId

public static PatchSet.Id nextPatchSetId(PatchSet.Id id)

Get the next patch set ID just looking at a single previous patch set ID.

This patch set ID may or may not be available in the database; callers that want a previously-unused ID should use nextPatchSetIdFromAllRefsMap(java.util.Map<java.lang.String, org.eclipse.jgit.lib.Ref>, com.google.gerrit.reviewdb.client.PatchSet.Id) or nextPatchSetIdFromChangeRefsMap(java.util.Map<java.lang.String, org.eclipse.jgit.lib.ObjectId>, com.google.gerrit.reviewdb.client.PatchSet.Id).

Parameters:

id - previous patch set ID.

Returns:

next patch set ID for the same change, incrementing by 1.

nextPatchSetId

public static PatchSet.Id nextPatchSetId(org.eclipse.jgit.lib.Repository git,
                                         PatchSet.Id id)
                                  throws java.io.IOException

Get the next patch set ID from scanning refs in the repo.

Parameters:

git - repository to scan for patch set refs.

id - previous patch set ID.

Returns:

next unused patch set ID for the same change, skipping any IDs whose corresponding ref names appear in the repository.

Throws:

java.io.IOException

ensureChangeIdIsCorrect

public static void ensureChangeIdIsCorrect(boolean requireChangeId,
                                           java.lang.String currentChangeId,
                                           java.lang.String newCommitMessage)
                                    throws ResourceConflictException,
                                           BadRequestException

Make sure that the change commit message has a correct footer.

Parameters:

requireChangeId - true if Change-Id is a mandatory footer for the project

currentChangeId - current Change-Id value before the commit message is updated

newCommitMessage - new commit message for the change

Throws:

ResourceConflictException - if the new commit message has a missing or invalid Change-Id

BadRequestException - if the new commit message is null or empty

status

public static java.lang.String status(Change c)