Package com.google.gerrit.server

Class CommentsUtil

java.lang.Object

com.google.gerrit.server.CommentsUtil

public class CommentsUtil
extends Object

Utility functions to manipulate Comments.

Field Summary

Fields

Modifier and Type	Field	Description
static final com.google.common.collect.Ordering<CommentInfo>	COMMENT_INFO_ORDER
static final com.google.common.collect.Ordering<Comment>	COMMENT_ORDER

Method Summary

Modifier and Type	Method	Description
void	deleteCommentByRewritingHistory(ChangeUpdate update, Comment.Key commentKey, String newMessage)
void	deleteHumanComments(ChangeUpdate update, Iterable<HumanComment> comments)
Optional<org.eclipse.jgit.lib.ObjectId>	determineCommitId(Change change, PatchSet patchset, short side)	Determines the SHA-1 of the commit referenced by the (change, patchset, side) triple.
static String	extractMessageId(String tag)
static PatchSet.Id	getCommentPsId(Change.Id changeId, Comment comment)
Optional<HumanComment>	getPublishedHumanComment(ChangeNotes notes, Comment.Key key)
Optional<HumanComment>	getPublishedHumanComment(ChangeNotes notes, String uuid)
Optional<RobotComment>	getRobotComment(ChangeNotes notes, String uuid)
static void	linkCommentsToChangeMessages(List<? extends CommentInfo> comments, List<ChangeMessage> changeMessages, boolean skipAutoGeneratedMessages)	This method populates the "changeMessageId" field of the comments parameter based on timestamp matching.
HumanComment	newHumanComment(ChangeNotes changeNotes, CurrentUser currentUser, Instant when, String path, PatchSet.Id psId, short side, String message, Boolean unresolved, String parentUuid)
RobotComment	newRobotComment(ChangeContext ctx, String path, PatchSet.Id psId, short side, String message, String robotId, String robotRunId)
List<HumanComment>	publishedByChangeFile(ChangeNotes notes, String file)
List<HumanComment>	publishedByPatchSet(ChangeNotes notes, PatchSet.Id psId)
List<HumanComment>	publishedHumanCommentsByChange(ChangeNotes notes)
void	putHumanComments(ChangeUpdate update, Comment.Status status, Iterable<HumanComment> comments)
void	putRobotComments(ChangeUpdate update, Iterable<RobotComment> comments)
List<RobotComment>	robotCommentsByChange(ChangeNotes notes)
List<RobotComment>	robotCommentsByPatchSet(ChangeNotes notes, PatchSet.Id psId)
void	setCommentCommitId(Comment c, Change change, PatchSet ps)
static <T extends Comment> List<T>	sort(List<T> comments)

Methods inherited from class java.lang.Object

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

Field Details

COMMENT_ORDER

public static final com.google.common.collect.Ordering<Comment> COMMENT_ORDER

COMMENT_INFO_ORDER

public static final com.google.common.collect.Ordering<CommentInfo> COMMENT_INFO_ORDER

Method Details

getCommentPsId

public static PatchSet.Id getCommentPsId(Change.Id changeId,
 Comment comment)

extractMessageId

public static String extractMessageId(String tag)

newHumanComment

public HumanComment newHumanComment(ChangeNotes changeNotes,
 CurrentUser currentUser,
 Instant when,
 String path,
 PatchSet.Id psId,
 short side,
 String message,
 Boolean unresolved,
 String parentUuid)

newRobotComment

public RobotComment newRobotComment(ChangeContext ctx,
 String path,
 PatchSet.Id psId,
 short side,
 String message,
 String robotId,
 String robotRunId)

getPublishedHumanComment

public Optional<HumanComment> getPublishedHumanComment(ChangeNotes notes,
 Comment.Key key)

getPublishedHumanComment

public Optional<HumanComment> getPublishedHumanComment(ChangeNotes notes,
 String uuid)

publishedHumanCommentsByChange

public List<HumanComment> publishedHumanCommentsByChange(ChangeNotes notes)

robotCommentsByChange

public List<RobotComment> robotCommentsByChange(ChangeNotes notes)

getRobotComment

public Optional<RobotComment> getRobotComment(ChangeNotes notes,
 String uuid)

publishedByChangeFile

public List<HumanComment> publishedByChangeFile(ChangeNotes notes,
 String file)

publishedByPatchSet

public List<HumanComment> publishedByPatchSet(ChangeNotes notes,
 PatchSet.Id psId)

robotCommentsByPatchSet

public List<RobotComment> robotCommentsByPatchSet(ChangeNotes notes,
 PatchSet.Id psId)

linkCommentsToChangeMessages

public static void linkCommentsToChangeMessages(List<? extends CommentInfo> comments,
 List<ChangeMessage> changeMessages,
 boolean skipAutoGeneratedMessages)

This method populates the "changeMessageId" field of the comments parameter based on timestamp matching. The comments objects will be modified.

Each comment will be matched to the nearest next change message in timestamp

Parameters:

comments - the list of comments

changeMessages - list of change messages

putHumanComments

public void putHumanComments(ChangeUpdate update,
 Comment.Status status,
 Iterable<HumanComment> comments)

putRobotComments

public void putRobotComments(ChangeUpdate update,
 Iterable<RobotComment> comments)

deleteHumanComments

public void deleteHumanComments(ChangeUpdate update,
 Iterable<HumanComment> comments)

deleteCommentByRewritingHistory

public void deleteCommentByRewritingHistory(ChangeUpdate update,
 Comment.Key commentKey,
 String newMessage)

setCommentCommitId

public void setCommentCommitId(Comment c,
 Change change,
 PatchSet ps)

determineCommitId

public Optional<org.eclipse.jgit.lib.ObjectId> determineCommitId(Change change,
 PatchSet patchset,
 short side)

Determines the SHA-1 of the commit referenced by the (change, patchset, side) triple.

Parameters:

change - the change to which the commit belongs

patchset - the patchset to which the commit belongs

side - the side indicating which commit of the patchset to take. 1 is the patchset commit, 0 the parent commit (or auto-merge for changes representing merge commits); -x the xth parent commit of a merge commit

Returns:

the commit SHA-1 or an empty Optional if the side isn't available for the given change/patchset

Throws:

com.google.gerrit.exceptions.StorageException - if the SHA-1 is unavailable for an unknown reason

sort

public static <T extends Comment> List<T> sort(List<T> comments)