com.atlassian.jira.bc.issue.comment

Interface CommentService

All Known Implementing Classes:

DefaultCommentService

@PublicApi
public interface CommentService

This is the business layer component that must be used to access all Comment functionality. This will perform validation before it hands off to the CommentManager. Operations will not be performed if validation fails.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CommentService.CommentCreateValidationResult
static class	CommentService.CommentParameters
static class	CommentService.CommentUpdateValidationResult
static class	CommentService.CommentVisibility

Method Summary

Methods

Modifier and Type	Method and Description
Comment	create(ApplicationUser user, CommentService.CommentCreateValidationResult commentValidationResult, boolean dispatchEvent) Creates and persists a Comment on given Issue.
Comment	create(ApplicationUser user, Issue issue, String body, boolean dispatchEvent, ErrorCollection errorCollection) Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).
Comment	create(ApplicationUser user, Issue issue, String body, String groupLevel, Long roleLevelId, boolean dispatchEvent, ErrorCollection errorCollection) Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).
Comment	create(ApplicationUser user, Issue issue, String body, String groupLevel, Long roleLevelId, Date created, boolean dispatchEvent, ErrorCollection errorCollection) Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).
Comment	create(com.atlassian.crowd.embedded.api.User user, Issue issue, String body, boolean dispatchEvent, ErrorCollection errorCollection) Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).
Comment	create(com.atlassian.crowd.embedded.api.User user, Issue issue, String body, String groupLevel, Long roleLevelId, boolean dispatchEvent, ErrorCollection errorCollection) Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).
Comment	create(com.atlassian.crowd.embedded.api.User user, Issue issue, String body, String groupLevel, Long roleLevelId, Date created, boolean dispatchEvent, ErrorCollection errorCollection) Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).
void	delete(JiraServiceContext jiraServiceContext, Comment comment, boolean dispatchEvent) Deletes a comment and updates the issue's change history and updated date.
Comment	getCommentById(ApplicationUser user, Long commentId, ErrorCollection errorCollection)
Comment	getCommentById(com.atlassian.crowd.embedded.api.User user, Long commentId, ErrorCollection errorCollection) Deprecated. Use getCommentById(ApplicationUser user, Long commentId, ErrorCollection errorCollection) instead. Since v6.0.
List<Comment>	getCommentsForUser(ApplicationUser user, Issue issue) Will return a list of Comments for the given user Will return a list of Comments for the given user.
List<Comment>	getCommentsForUser(ApplicationUser currentUser, Issue issue, ErrorCollection errorCollection) Deprecated. Use getCommentsForUser(ApplicationUser currentUser, Issue issue) instead. Since v6.3.
List<Comment>	getCommentsForUser(com.atlassian.crowd.embedded.api.User currentUser, Issue issue, ErrorCollection errorCollection) Deprecated. Use getCommentsForUser(ApplicationUser currentUser, Issue issue) instead. Since v6.3.
List<Comment>	getCommentsForUserSince(ApplicationUser user, Issue issue, Date since) Will return a list of Comments that were created or updated since the provided date, for the given user.
MutableComment	getMutableComment(ApplicationUser user, Long commentId, ErrorCollection errorCollection)
MutableComment	getMutableComment(com.atlassian.crowd.embedded.api.User user, Long commentId, ErrorCollection errorCollection) Deprecated. Use getCommentById(com.atlassian.jira.user.ApplicationUser, Long, com.atlassian.jira.util.ErrorCollection) instead. Since v6.0.
boolean	hasPermissionToCreate(ApplicationUser user, Issue issue, ErrorCollection errorCollection)
boolean	hasPermissionToCreate(com.atlassian.crowd.embedded.api.User user, Issue issue, ErrorCollection errorCollection) Deprecated. Use hasPermissionToCreate(ApplicationUser user, Issue issue, ErrorCollection errorCollection) instead. Since v6.0.
boolean	hasPermissionToDelete(JiraServiceContext jiraServiceContext, Long commentId) Determines whether the user can delete a comment.
boolean	hasPermissionToEdit(ApplicationUser user, Comment comment, ErrorCollection errorCollection)
boolean	hasPermissionToEdit(JiraServiceContext jiraServiceContext, Long commentId) Determines whether the user can edit a comment.
boolean	hasPermissionToEdit(com.atlassian.crowd.embedded.api.User user, Comment comment, ErrorCollection errorCollection) Deprecated. Use hasPermissionToCreate(ApplicationUser user, Issue issue, ErrorCollection errorCollection) instead. Since v6.0.
boolean	isGroupVisibilityEnabled() Returns the flag that indicates whether group visiblity is enabled
boolean	isGroupVisiblityEnabled() Deprecated. Deprecated because of typo in signature. Use isGroupVisibilityEnabled(). Since 6.4
boolean	isProjectRoleVisibilityEnabled() Returns the flag that indicates whether project role visibility is enabled
boolean	isProjectRoleVisiblityEnabled() Deprecated. Deprecated because of typo in signature. Use isProjectRoleVisibilityEnabled(). Since 6.4
boolean	isValidAllCommentData(ApplicationUser user, Issue issue, String body, String groupLevel, String roleLevelId, ErrorCollection errorCollection) Deprecated. Use isValidAllCommentData(ApplicationUser, Issue, String, com.atlassian.jira.bc.issue.visibility.Visibility, ErrorCollection) instead. Since v6.4.
boolean	isValidAllCommentData(ApplicationUser user, Issue issue, String body, Visibility visibility, ErrorCollection errorCollection) Will call all other validate methods setting the appropriate errors in the errorCollection if any errors occur.
boolean	isValidAllCommentData(com.atlassian.crowd.embedded.api.User user, Issue issue, String body, String groupLevel, String roleLevelId, ErrorCollection errorCollection) Deprecated. Use isValidAllCommentData(ApplicationUser, Issue, String, com.atlassian.jira.bc.issue.visibility.Visibility, ErrorCollection) instead. Since v6.4.
boolean	isValidCommentBody(String body, ErrorCollection errorCollection) Validates that the body is a valid string, if not the appropriate error is added to the errorCollection.
boolean	isValidCommentBody(String body, ErrorCollection errorCollection, boolean allowEmpty) Validates that the body is a valid string, if not the appropriate error is added to the errorCollection.
boolean	isValidCommentData(ApplicationUser user, Issue issue, String groupLevel, String roleLevelId, ErrorCollection errorCollection) Deprecated. Use isValidCommentVisibility(ApplicationUser, Issue, com.atlassian.jira.bc.issue.visibility.Visibility, ErrorCollection) instead. Since v6.4.
boolean	isValidCommentData(com.atlassian.crowd.embedded.api.User user, Issue issue, String groupLevel, String roleLevelId, ErrorCollection errorCollection) Deprecated. Use isValidCommentVisibility(ApplicationUser, Issue, com.atlassian.jira.bc.issue.visibility.Visibility, ErrorCollection) instead. Since v6.4.
boolean	isValidCommentVisibility(ApplicationUser user, Issue issue, Visibility visibility, ErrorCollection errorCollection) This method validates if the comment has the correct role and group levels set.
void	update(ApplicationUser user, CommentService.CommentUpdateValidationResult updateCommentValidationResult, boolean dispatchEvent) Updates a Comment and sets the comments updated date to be now and the updatedAuthor to be the passed in user.
void	update(ApplicationUser user, MutableComment comment, boolean dispatchEvent, ErrorCollection errorCollection) Deprecated. use update(ApplicationUser, CommentUpdateValidationResult, boolean) instead.
void	update(com.atlassian.crowd.embedded.api.User user, MutableComment comment, boolean dispatchEvent, ErrorCollection errorCollection) Deprecated. use update(ApplicationUser, CommentUpdateValidationResult, boolean) instead.
CommentService.CommentCreateValidationResult	validateCommentCreate(ApplicationUser user, CommentService.CommentParameters commentParameters) Confirms the parameters to create a comment are valid and that the user has the permission to do so.
CommentService.CommentUpdateValidationResult	validateCommentUpdate(ApplicationUser user, Long commentId, CommentService.CommentParameters commentParameters) Confirms the parameters to update a comment are valid and that the updating user has the permission to do so.
void	validateCommentUpdate(ApplicationUser user, Long commentId, String body, String groupLevel, Long roleLevelId, ErrorCollection errorCollection) Deprecated. use validateCommentUpdate(ApplicationUser, Long, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters).
void	validateCommentUpdate(com.atlassian.crowd.embedded.api.User user, Long commentId, String body, String groupLevel, Long roleLevelId, ErrorCollection errorCollection) Deprecated. use validateCommentUpdate(ApplicationUser, Long, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters).

Method Detail

validateCommentCreate

CommentService.CommentCreateValidationResult validateCommentCreate(ApplicationUser user,
                                                                 @Nonnull
                                                                 CommentService.CommentParameters commentParameters)

Confirms the parameters to create a comment are valid and that the user has the permission to do so. This method will validate the raw input parameters. This method only validates the parameters and will not actually persist the changes, you must call create(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentCreateValidationResult, boolean) to persist the changes. If an error is encountered then the CommentService.CommentCreateValidationResult will contain the specific error message.

Parameters:

user - The ApplicationUser who will be performing the operation.

commentParameters - the comment parameters.

Returns:

validation result.

create

Comment create(ApplicationUser user,
             CommentService.CommentCreateValidationResult commentValidationResult,
             boolean dispatchEvent)

Creates and persists a Comment on given Issue.

Parameters:

user - The ApplicationUser who will be performing the operation.

commentValidationResult - the results of validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters).

dispatchEvent - whether or not you want to have an event dispatched on Comment creation

Returns:

the created Comment object, or null if no object created.

create

@Deprecated
Comment create(ApplicationUser user,
                        Issue issue,
                        String body,
                        String groupLevel,
                        Long roleLevelId,
                        Date created,
                        boolean dispatchEvent,
                        ErrorCollection errorCollection)

Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).

Creates and persists a Comment on the given Issue.

Parameters:

user - The ApplicationUser who will be performing the operation.

issue - The Issue you wish to associate the Comment with. This can not be null

body - The body of the comment

groupLevel - The group level visibility of the comment (null if roleLevelId specified)

roleLevelId - The role level visibility id of the comment (null if groupLevel specified)

created - The date of comment creation

dispatchEvent - whether or not you want to have an event dispatched on Comment creation

errorCollection - holder for any errors that were thrown attempting to create a comment

Returns:

the created Comment object, or null if no object created.

create

@Deprecated
Comment create(com.atlassian.crowd.embedded.api.User user,
                        Issue issue,
                        String body,
                        String groupLevel,
                        Long roleLevelId,
                        Date created,
                        boolean dispatchEvent,
                        ErrorCollection errorCollection)

Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).

Creates and persists a Comment on the given Issue.

Parameters:

user - The User who will be performing the operation.

issue - The Issue you wish to associate the Comment with. This can not be null

body - The body of the comment

groupLevel - The group level visibility of the comment (null if roleLevelId specified)

roleLevelId - The role level visibility id of the comment (null if groupLevel specified)

created - The date of comment creation

dispatchEvent - whether or not you want to have an event dispatched on Comment creation

errorCollection - holder for any errors that were thrown attempting to create a comment

Returns:

the created Comment object, or null if no object created.

create

@Deprecated
Comment create(ApplicationUser user,
                        Issue issue,
                        String body,
                        String groupLevel,
                        Long roleLevelId,
                        boolean dispatchEvent,
                        ErrorCollection errorCollection)

Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).

Creates and persists a Comment on the given Issue set with current date and time.

Parameters:

user - The ApplicationUser who will be performing the operation.

issue - The Issue you wish to associate the Comment with. This can not be null

body - The body of the comment

groupLevel - The group level visibility of the comment (null if roleLevelId specified)

roleLevelId - The role level visibility id of the comment (null if groupLevel specified)

dispatchEvent - whether or not you want to have an event dispatched on Comment creation

errorCollection - holder for any errors that were thrown attempting to create a comment

Returns:

the created Comment object, or null if no object created.

create

@Deprecated
Comment create(com.atlassian.crowd.embedded.api.User user,
                        Issue issue,
                        String body,
                        String groupLevel,
                        Long roleLevelId,
                        boolean dispatchEvent,
                        ErrorCollection errorCollection)

Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).

Creates and persists a Comment on the given Issue set with current date and time.

Parameters:

user - The User who will be performing the operation.

issue - The Issue you wish to associate the Comment with. This can not be null

body - The body of the comment

groupLevel - The group level visibility of the comment (null if roleLevelId specified)

roleLevelId - The role level visibility id of the comment (null if groupLevel specified)

dispatchEvent - whether or not you want to have an event dispatched on Comment creation

errorCollection - holder for any errors that were thrown attempting to create a comment

Returns:

the created Comment object, or null if no object created.

create

@Deprecated
Comment create(ApplicationUser user,
                        Issue issue,
                        String body,
                        boolean dispatchEvent,
                        ErrorCollection errorCollection)

Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).

Creates and persists a Comment on the given Issue set with current date and time, visible to all - no group level or role level restriction.

Parameters:

user - The ApplicationUser who will be performing the operation.

issue - The Issue you wish to associate the Comment with. This can not be null

body - The body of the comment

dispatchEvent - whether or not you want to have an event dispatched on Comment creation

errorCollection - holder for any errors that were thrown attempting to create a comment

Returns:

the created Comment object, or null if no object created.

create

@Deprecated
Comment create(com.atlassian.crowd.embedded.api.User user,
                        Issue issue,
                        String body,
                        boolean dispatchEvent,
                        ErrorCollection errorCollection)

Deprecated. use validateCommentCreate(ApplicationUser, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters) and create(ApplicationUser, CommentCreateValidationResult, boolean).

Creates and persists a Comment on the given Issue set with current date and time, visible to all - no group level or role level restriction.

Parameters:

user - The User who will be performing the operation.

issue - The Issue you wish to associate the Comment with. This can not be null

body - The body of the comment

dispatchEvent - whether or not you want to have an event dispatched on Comment creation

errorCollection - holder for any errors that were thrown attempting to create a comment

Returns:

the created Comment object, or null if no object created.

validateCommentUpdate

@Deprecated
void validateCommentUpdate(ApplicationUser user,
                                    Long commentId,
                                    String body,
                                    String groupLevel,
                                    Long roleLevelId,
                                    ErrorCollection errorCollection)

Deprecated. use validateCommentUpdate(ApplicationUser, Long, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters).

Confirms the parameters to update a comment are valid and that the updating user has the permission to do so. This method will validate the raw input parameters. This method only validates the parameters and will not actually persist the changes, you must call update(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.issue.comments.MutableComment, boolean, com.atlassian.jira.util.ErrorCollection) to persist the changes. If an error is encountered then the ErrorCollection will contain the specific error message.

Parameters:

user - The ApplicationUser who will be performing the operation and who will be the updatedAuthor.

commentId - The id of the comment to be updated. Permissions will be checked to ensure that the user has the right to update this comment. If the comment does not exist an error will be reported.

body - The body of the comment to be updated.

groupLevel - The group level visibility of the comment (null if roleLevelId specified)

roleLevelId - The role level visibility id of the comment (null if groupLevel specified)

errorCollection - holder for any errors that were thrown attempting to update a comment

validateCommentUpdate

@Deprecated
void validateCommentUpdate(com.atlassian.crowd.embedded.api.User user,
                                    Long commentId,
                                    String body,
                                    String groupLevel,
                                    Long roleLevelId,
                                    ErrorCollection errorCollection)

Deprecated. use validateCommentUpdate(ApplicationUser, Long, com.atlassian.jira.bc.issue.comment.CommentService.CommentParameters).

Confirms the parameters to update a comment are valid and that the updating user has the permission to do so. This method will validate the raw input parameters. This method only validates the parameters and will not actually persist the changes, you must call update(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.issue.comments.MutableComment, boolean, com.atlassian.jira.util.ErrorCollection) to persist the changes. If an error is encountered then the ErrorCollection will contain the specific error message.

Parameters:

user - The ApplicationUser who will be performing the operation and who will be the updatedAuthor.

commentId - The id of the comment to be updated. Permissions will be checked to ensure that the user has the right to update this comment. If the comment does not exist an error will be reported.

body - The body of the comment to be updated.

groupLevel - The group level visibility of the comment (null if roleLevelId specified)

roleLevelId - The role level visibility id of the comment (null if groupLevel specified)

errorCollection - holder for any errors that were thrown attempting to update a comment

validateCommentUpdate

CommentService.CommentUpdateValidationResult validateCommentUpdate(ApplicationUser user,
                                                                 Long commentId,
                                                                 CommentService.CommentParameters commentParameters)

Confirms the parameters to update a comment are valid and that the updating user has the permission to do so. This method will validate the raw input parameters. This method only validates the parameters and will not actually persist the changes, you must call update(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.issue.comments.MutableComment, boolean, com.atlassian.jira.util.ErrorCollection) to persist the changes. If an error is encountered then the ErrorCollection will contain the specific error message.

Parameters:

user - The ApplicationUser who will be performing the operation and who will be the updatedAuthor.

commentId - The id of the comment to be updated. Permissions will be checked to ensure that the user has the right to update this comment. If the comment does not exist an error will be reported.

commentParameters - the comment parameters.

update

@Deprecated
void update(ApplicationUser user,
                     MutableComment comment,
                     boolean dispatchEvent,
                     ErrorCollection errorCollection)

Deprecated. use update(ApplicationUser, CommentUpdateValidationResult, boolean) instead.

Updates a Comment and sets the comments updated date to be now and the updatedAuthor to be the passed in user.

Parameters:

user - the ApplicationUser who must have permission to update this comment and who will be used as the updateAuthor

comment - the object that contains the changes to the comment to persist.

dispatchEvent - whether or not you want to have an event dispatched on Comment update. If false then the issue will not be reindexed.

errorCollection - holder for any errors that were thrown attempting to update a comment

Throws:

IllegalArgumentException - if comment or its id is null

update

@Deprecated
void update(com.atlassian.crowd.embedded.api.User user,
                     MutableComment comment,
                     boolean dispatchEvent,
                     ErrorCollection errorCollection)

Deprecated. use update(ApplicationUser, CommentUpdateValidationResult, boolean) instead.

Updates a Comment and sets the comments updated date to be now and the updatedAuthor to be the passed in user.

Parameters:

user - the User who must have permission to update this comment and who will be used as the updateAuthor

comment - the object that contains the changes to the comment to persist.

dispatchEvent - whether or not you want to have an event dispatched on Comment update. If false then the issue will not be reindexed.

errorCollection - holder for any errors that were thrown attempting to update a comment

Throws:

IllegalArgumentException - if comment or its id is null

update

void update(ApplicationUser user,
          CommentService.CommentUpdateValidationResult updateCommentValidationResult,
          boolean dispatchEvent)

Updates a Comment and sets the comments updated date to be now and the updatedAuthor to be the passed in user.

Parameters:

user - the ApplicationUser who must have permission to update this comment and who will be used as the updateAuthor

updateCommentValidationResult - the comment parameters.

dispatchEvent - whether or not you want to have an event dispatched on Comment update. If false then the issue will not be reindexed.

getCommentsForUser

@Nonnull
List<Comment> getCommentsForUser(@Nullable
                                       ApplicationUser user,
                                       @Nonnull
                                       Issue issue)

Will return a list of Comments for the given user Will return a list of Comments for the given user.

Parameters:

user - the user to check permissions against ApplicationUser, or anonymous if null.

issue - the issue with associated comments. Must not be null.

Returns:

a possibly empty List of comments - will not be null.

getCommentsForUser

@Deprecated
List<Comment> getCommentsForUser(ApplicationUser currentUser,
                                          Issue issue,
                                          ErrorCollection errorCollection)

Deprecated. Use getCommentsForUser(ApplicationUser currentUser, Issue issue) instead. Since v6.3.

Will return a list of Comments for the given user.

Parameters:

currentUser - current ApplicationUser

issue - the issue with associated comments

errorCollection - holder for any errors that were thrown attempting to retrieve comments

Returns:

a List of comments

getCommentsForUser

@Deprecated
List<Comment> getCommentsForUser(com.atlassian.crowd.embedded.api.User currentUser,
                                          Issue issue,
                                          ErrorCollection errorCollection)

Deprecated. Use getCommentsForUser(ApplicationUser currentUser, Issue issue) instead. Since v6.3.

Will return a list of Comments for the given user.

Parameters:

currentUser - current User

issue - the issue with associated comments

errorCollection - holder for any errors that were thrown attempting to retrieve comments

Returns:

a List of comments

getCommentsForUserSince

@Nonnull
List<Comment> getCommentsForUserSince(@Nullable
                                            ApplicationUser user,
                                            @Nonnull
                                            Issue issue,
                                            @Nonnull
                                            Date since)

Will return a list of Comments that were created or updated since the provided date, for the given user.

Parameters:

user - the user to check permissions against ApplicationUser, or anonymous if null.

issue - the issue with associated comments. Must not be null.

since - only comments created or updated after this date will be returned. Must not be null.

Returns:

a possibly empty List of comments - will not be null.

Since:

v6.3

hasPermissionToCreate

boolean hasPermissionToCreate(ApplicationUser user,
                            Issue issue,
                            ErrorCollection errorCollection)

hasPermissionToCreate

@Deprecated
boolean hasPermissionToCreate(com.atlassian.crowd.embedded.api.User user,
                                       Issue issue,
                                       ErrorCollection errorCollection)

Deprecated. Use hasPermissionToCreate(ApplicationUser user, Issue issue, ErrorCollection errorCollection) instead. Since v6.0.

Has the correct permission to create a comment for the given issue.

Parameters:

user - The User who will be performing the operation.

issue - The Issue you wish to associate the Comment with. This can not be null.

errorCollection - holder for any errors that were thrown attempting permission checks

Returns:

true if permission check passes.

hasPermissionToEdit

boolean hasPermissionToEdit(ApplicationUser user,
                          Comment comment,
                          ErrorCollection errorCollection)

hasPermissionToEdit

@Deprecated
boolean hasPermissionToEdit(com.atlassian.crowd.embedded.api.User user,
                                     Comment comment,
                                     ErrorCollection errorCollection)

Deprecated. Use hasPermissionToCreate(ApplicationUser user, Issue issue, ErrorCollection errorCollection) instead. Since v6.0.

Determine whether the current user has the permission to edit the comment. In case of errors, add error messages to the error collection.

Passing in null comment or a comment with null ID will return false and an error message will be added to the error collection.

Passing in null error collection will throw NPE.

Parameters:

user - The User who will be performing the operation.

comment - The Comment you wish to edit.

errorCollection - holder for any errors that were thrown attempting permission checks

Returns:

true if the user has edit permission, false otherwise

isValidCommentBody

boolean isValidCommentBody(String body,
                         ErrorCollection errorCollection)

Validates that the body is a valid string, if not the appropriate error is added to the errorCollection. This method was added so the CommentSystemField can validate the body and set the appropriate error message.

Parameters:

body - comment body to validate

errorCollection - holder for any errors that can occur in process of validation

Returns:

true is the body is valid.

isValidCommentBody

boolean isValidCommentBody(String body,
                         ErrorCollection errorCollection,
                         boolean allowEmpty)

Validates that the body is a valid string, if not the appropriate error is added to the errorCollection. This method was added so the CommentSystemField can validate the body and set the appropriate error message.

Parameters:

body - comment body to validate

errorCollection - holder for any errors that can occur in process of validation

allowEmpty - indicates whether empty body is allowed

Returns:

true is the body is valid.

isValidCommentData

@Deprecated
boolean isValidCommentData(com.atlassian.crowd.embedded.api.User user,
                                    Issue issue,
                                    String groupLevel,
                                    String roleLevelId,
                                    ErrorCollection errorCollection)

Deprecated. Use isValidCommentVisibility(ApplicationUser, Issue, com.atlassian.jira.bc.issue.visibility.Visibility, ErrorCollection) instead. Since v6.4.

This method validates if the comment has the correct role and group levels set. If there is an error during validation the passed in errorCollection will contain the errors.

Parameters:

user - The User who will be performing the operation.

issue - issue to associate the comment with

groupLevel - comment group visibility level

roleLevelId - comment project role visibility level id

errorCollection - holder for any errors that can occur in process of validation

Returns:

true if the role and group level information has been set correctly for a comment

isValidCommentData

@Deprecated
boolean isValidCommentData(ApplicationUser user,
                                    Issue issue,
                                    String groupLevel,
                                    String roleLevelId,
                                    ErrorCollection errorCollection)

Deprecated. Use isValidCommentVisibility(ApplicationUser, Issue, com.atlassian.jira.bc.issue.visibility.Visibility, ErrorCollection) instead. Since v6.4.

isValidCommentVisibility

boolean isValidCommentVisibility(ApplicationUser user,
                               Issue issue,
                               Visibility visibility,
                               ErrorCollection errorCollection)

This method validates if the comment has the correct role and group levels set. If there is an error during validation the passed in errorCollection will contain the errors.

Parameters:

user - The User who will be performing the operation.

issue - issue to associate the comment with

visibility - comment visibility level

errorCollection - holder for any errors that can occur in process of validation

Returns:

true if the role and group level information has been set correctly for a comment

isValidAllCommentData

@Deprecated
boolean isValidAllCommentData(com.atlassian.crowd.embedded.api.User user,
                                       Issue issue,
                                       String body,
                                       String groupLevel,
                                       String roleLevelId,
                                       ErrorCollection errorCollection)

Deprecated. Use isValidAllCommentData(ApplicationUser, Issue, String, com.atlassian.jira.bc.issue.visibility.Visibility, ErrorCollection) instead. Since v6.4.

Will call all other validate methods setting the appropriate errors in the errorCollection if any errors occur.

Parameters:

user - The User who will be performing the operation.

issue - issue to associate the comment with

body - comment body

groupLevel - comment group visibility level

roleLevelId - comment project role visibility level id

errorCollection - holder for any errors that can occur in process of validarion

Returns:

true if validation passes

isValidAllCommentData

@Deprecated
boolean isValidAllCommentData(ApplicationUser user,
                                       Issue issue,
                                       String body,
                                       String groupLevel,
                                       String roleLevelId,
                                       ErrorCollection errorCollection)

Deprecated. Use isValidAllCommentData(ApplicationUser, Issue, String, com.atlassian.jira.bc.issue.visibility.Visibility, ErrorCollection) instead. Since v6.4.

isValidAllCommentData

boolean isValidAllCommentData(ApplicationUser user,
                            Issue issue,
                            String body,
                            Visibility visibility,
                            ErrorCollection errorCollection)

Will call all other validate methods setting the appropriate errors in the errorCollection if any errors occur.

Parameters:

user - The User who will be performing the operation.

issue - issue to associate the comment with

body - comment body

visibility - visibility level

errorCollection - holder for any errors that can occur in process of validarion

Returns:

true if validation passes

isGroupVisiblityEnabled

@Deprecated
boolean isGroupVisiblityEnabled()

Deprecated. Deprecated because of typo in signature. Use isGroupVisibilityEnabled(). Since 6.4

Returns the flag that indicates whether group visiblity is enabled

Returns:

true if enabled, false otherwise

isProjectRoleVisiblityEnabled

@Deprecated
boolean isProjectRoleVisiblityEnabled()

Deprecated. Deprecated because of typo in signature. Use isProjectRoleVisibilityEnabled(). Since 6.4

Returns the flag that indicates whether project role visibility is enabled

Returns:

true if enabled, false otherwise

isGroupVisibilityEnabled

boolean isGroupVisibilityEnabled()

Returns the flag that indicates whether group visiblity is enabled

Returns:

true if enabled, false otherwise

isProjectRoleVisibilityEnabled

boolean isProjectRoleVisibilityEnabled()

Returns the flag that indicates whether project role visibility is enabled

Returns:

true if enabled, false otherwise

getCommentById

Comment getCommentById(ApplicationUser user,
                     Long commentId,
                     ErrorCollection errorCollection)

getCommentById

Comment getCommentById(com.atlassian.crowd.embedded.api.User user,
                     Long commentId,
                     ErrorCollection errorCollection)

Deprecated. Use getCommentById(ApplicationUser user, Long commentId, ErrorCollection errorCollection) instead. Since v6.0.

Will return a comment for the passed in commentId. This will return null if the user does not have permission to view the comment

Parameters:

user - who is looking up the comment

commentId - the id representing the Comment you would like to retrieve.

errorCollection - holder for any errors that can occur in process of validation

Returns:

a Comment or null (if the user cannot browse the comment).

getMutableComment

MutableComment getMutableComment(ApplicationUser user,
                               Long commentId,
                               ErrorCollection errorCollection)

getMutableComment

MutableComment getMutableComment(com.atlassian.crowd.embedded.api.User user,
                               Long commentId,
                               ErrorCollection errorCollection)

Deprecated. Use getCommentById(com.atlassian.jira.user.ApplicationUser, Long, com.atlassian.jira.util.ErrorCollection) instead. Since v6.0.

Will return a MutableComment for the passed in commentId. This will return null if the user does not have permission to view the comment. The difference between this method and getCommentById(User, Long, ErrorCollection) is that this method returns a version of the Comment that we can set values on.

Parameters:

user - the current user.

commentId - the id that we use to find the comment object.

errorCollection - holder for any errors that can occur in process of validation

Returns:

the comment that is identified by the commentId.

hasPermissionToDelete

boolean hasPermissionToDelete(JiraServiceContext jiraServiceContext,
                            Long commentId)

Determines whether the user can delete a comment. Will return true when the following are satisfied:

• The user has the DELETE_COMMENT_ALL permission, or the user has the DELETE_COMMENT_OWN permission and is attempting to delete a comment they authored
• The issue is in an editable workflow state

Parameters:

jiraServiceContext - jiraServiceContext containing the user who wishes to delete a comment and the errorCollection that will contain any errors encountered when calling the method

commentId - the id of the target comment (cannot be null)

Returns:

true if the user has permission to delete the target comment, false otherwise

hasPermissionToEdit

boolean hasPermissionToEdit(JiraServiceContext jiraServiceContext,
                          Long commentId)

Determines whether the user can edit a comment. Will return true when the following are satisfied:

• The user has the comment edit all or comment edit own permission
• The issue is in an editable workflow state

Parameters:

jiraServiceContext - JIRA service context containing the user who wishes to edit a comment and the errorCollection that will contain any errors encountered when calling the method

commentId - the id of the target comment (cannot be null)

Returns:

true if the user has permission to edit the comment, false otherwise

delete

void delete(JiraServiceContext jiraServiceContext,
          Comment comment,
          boolean dispatchEvent)

Deletes a comment and updates the issue's change history and updated date. Expects that hasPermissionToDelete(com.atlassian.jira.bc.JiraServiceContext, Long) is successfully called first.

Parameters:

jiraServiceContext - containing the user who wishes to delete a comment and the errorCollection that will contain any errors encountered when calling the method

comment - the comment to delete (cannot be null)

dispatchEvent - a flag indicating whether to dispatch an issue updated event. If this flag is false then the issue will not be reindexed.