com.atlassian.jira.bc.issue.worklog
Class DefaultWorklogService

java.lang.Object
  extended by com.atlassian.jira.bc.issue.worklog.DefaultWorklogService
All Implemented Interfaces:
WorklogService

public class DefaultWorklogService
extends Object
implements WorklogService

Default implemenation of the WorklogService.


Constructor Summary
DefaultWorklogService(WorklogManager worklogManager, PermissionManager permissionManager, VisibilityValidator visibilityValidator, ProjectRoleManager projectRoleManager, IssueManager issueManager, TimeTrackingConfiguration timeTrackingConfiguration, JiraDurationUtils jiraDurationUtils, GroupManager groupManager)
           
 
Method Summary
protected  Worklog create(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, Long newEstimate, boolean dispatchEvent)
           
 Worklog createAndAutoAdjustRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, boolean dispatchEvent)
          Persists a new Worklog on the given Issue.
 Worklog createAndRetainRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, boolean dispatchEvent)
          Persists a new Worklog on the given Issue.
 Worklog createWithManuallyAdjustedEstimate(JiraServiceContext jiraServiceContext, WorklogAdjustmentAmountResult worklogResult, boolean dispatchEvent)
          Persists a new Worklog on the given Issue.
 Worklog createWithNewRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogNewEstimateResult worklogResult, boolean dispatchEvent)
          Persists a new Worklog on the given Issue.
protected  boolean delete(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, Long newEstimate, boolean dispatchEvent)
           
 boolean deleteAndAutoAdjustRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, boolean dispatchEvent)
          Deletes the specified Worklog.
 boolean deleteAndRetainRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, boolean dispatchEvent)
          Deletes the specified Worklog.
 boolean deleteWithManuallyAdjustedEstimate(JiraServiceContext jiraServiceContext, WorklogAdjustmentAmountResult worklogResult, boolean dispatchEvent)
          Deletes the specified Worklog.
 boolean deleteWithNewRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogNewEstimateResult worklogNewEstimate, boolean dispatchEvent)
          Deletes the specified Worklog.
protected  Long getAutoAdjustNewEstimateOnUpdate(Issue issue, Long newTimeSpent, Long originalTimeSpent)
           
 Worklog getById(JiraServiceContext jiraServiceContext, Long id)
          Used to get a worklog by its id.
 List getByIssue(JiraServiceContext jiraServiceContext, Issue issue)
          Returns all child worklogs of a specified issue.
 List<Worklog> getByIssueVisibleToUser(JiraServiceContext jiraServiceContext, Issue issue)
          Returns all child worklogs of a specified issue that the provided user has permission to see.
protected  long getDurationForFormattedString(String timeSpent, JiraServiceContext jiraServiceContext)
           
protected  boolean hasDeleteAllPermission(com.atlassian.crowd.embedded.api.User user, Issue issue)
           
protected  boolean hasDeleteOwnPermission(com.atlassian.crowd.embedded.api.User user, Worklog worklog)
           
protected  boolean hasEditAllPermission(com.atlassian.crowd.embedded.api.User user, Issue issue)
           
protected  boolean hasEditOwnPermission(com.atlassian.crowd.embedded.api.User user, Worklog worklog)
           
 boolean hasPermissionToCreate(JiraServiceContext jiraServiceContext, Issue issue, boolean isEditableCheckRequired)
          Determines if the user has the Permissions.WORK_ISSUE permission, that timetracking is enabled in JIRA and that the associated issue is in an editable workflow state.
 boolean hasPermissionToDelete(JiraServiceContext jiraServiceContext, Worklog worklog)
          Determine whether the current user has the permission to delete the supplied worklog, timetracking is enabled in JIRA and that the associated issue is in an editable workflow state.
 boolean hasPermissionToUpdate(JiraServiceContext jiraServiceContext, Worklog worklog)
          Determine whether the current user has the permission to update the supplied worklog, timetracking is enabled in JIRA and that the associated issue is in an editable workflow state.
protected  Long increaseEstimate(Issue issue, Long amount)
           
 boolean isIssueInEditableWorkflowState(Issue issue)
          Will return true if the issue is in an editable workflow state.
protected  boolean isSameAuthor(com.atlassian.crowd.embedded.api.User user, Worklog worklog)
           
 boolean isTimeTrackingEnabled()
          Will return true if APKeys.JIRA_OPTION_TIMETRACKING is true, false otherwise.
protected  boolean isUserInGroup(com.atlassian.crowd.embedded.api.User user, String groupLevel)
           
protected  boolean isUserInRole(Long roleLevel, com.atlassian.crowd.embedded.api.User user, Issue issue)
           
protected  boolean isValidAdjustmentAmount(JiraServiceContext jiraServiceContext, String adjustmentAmount)
          Checks if the given String is a valid amount of time to change an estimate by.
protected  boolean isValidAdjustmentAmount(JiraServiceContext jiraServiceContext, String adjustmentAmount, String errorFieldPrefix)
          Checks if the given String is a valid amount of time to change an estimate by.
protected  boolean isValidNewEstimate(JiraServiceContext jiraServiceContext, String newEstimate)
           
protected  boolean isValidNewEstimate(JiraServiceContext jiraServiceContext, String newEstimate, String errorFieldPrefix)
           
protected  boolean isValidWorklogInputFields(JiraServiceContext jiraServiceContext, Issue issue, String timeSpent, Date startDate, String errorFieldPrefix)
           
protected  Long reduceEstimate(Issue issue, Long amount)
           
protected  Worklog update(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, Long newEstimate, boolean dispatchEvent)
           
 Worklog updateAndAutoAdjustRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, boolean dispatchEvent)
          Updates the provided Worklog.
 Worklog updateAndRetainRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogResult worklogResult, boolean dispatchEvent)
          Updates the provided Worklog.
 Worklog updateWithNewRemainingEstimate(JiraServiceContext jiraServiceContext, WorklogNewEstimateResult worklogResult, boolean dispatchEvent)
          Updates the provided Worklog.
 WorklogResult validateCreate(JiraServiceContext jiraServiceContext, WorklogInputParameters params)
          Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToCreate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.Issue,boolean) to create a worklog for this issue.
 WorklogAdjustmentAmountResult validateCreateWithManuallyAdjustedEstimate(JiraServiceContext jiraServiceContext, WorklogAdjustmentAmountInputParameters params)
          Determines whether worklogs are enabled in JIRA and if the user has the required permission as determined by calling WorklogService.hasPermissionToCreate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.Issue,boolean) to create a worklog for this issue.
 WorklogNewEstimateResult validateCreateWithNewEstimate(JiraServiceContext jiraServiceContext, WorklogNewEstimateInputParameters params)
          Determines whether worklogs are enabled in JIRA and if the user has the required permission as determined by calling WorklogService.hasPermissionToCreate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.Issue,boolean) to create a worklog for this issue.
 WorklogResult validateDelete(JiraServiceContext jiraServiceContext, Long worklogId)
          Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToDelete(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to delete a worklog for this issue.
 WorklogAdjustmentAmountResult validateDeleteWithManuallyAdjustedEstimate(JiraServiceContext jiraServiceContext, Long worklogId, String adjustmentAmount)
          Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToDelete(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to delete a worklog for this issue.
 WorklogNewEstimateResult validateDeleteWithNewEstimate(JiraServiceContext jiraServiceContext, Long worklogId, String newEstimate)
          Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToDelete(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to delete a worklog for this issue.
protected  Worklog validateParamsAndCreateWorklog(JiraServiceContext jiraServiceContext, Issue issue, String author, String groupLevel, String roleLevelId, String timeSpent, Date startDate, Long worklogId, String comment, Date created, Date updated, String updateAuthor, String errorFieldPrefix)
           
 WorklogResult validateUpdate(JiraServiceContext jiraServiceContext, WorklogInputParameters params)
          Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToUpdate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to update a worklog for this issue.
 WorklogNewEstimateResult validateUpdateWithNewEstimate(JiraServiceContext jiraServiceContext, WorklogNewEstimateInputParameters params)
          Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToUpdate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to update a worklog for this issue.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DefaultWorklogService

public DefaultWorklogService(WorklogManager worklogManager,
                             PermissionManager permissionManager,
                             VisibilityValidator visibilityValidator,
                             ProjectRoleManager projectRoleManager,
                             IssueManager issueManager,
                             TimeTrackingConfiguration timeTrackingConfiguration,
                             JiraDurationUtils jiraDurationUtils,
                             GroupManager groupManager)
Method Detail

validateDelete

public WorklogResult validateDelete(JiraServiceContext jiraServiceContext,
                                    Long worklogId)
Description copied from interface: WorklogService
Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToDelete(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to delete a worklog for this issue.

Specified by:
validateDelete in interface WorklogService
Parameters:
jiraServiceContext - containing the user who wishes to create a worklog and the errorCollection that will contain any errors in calling the method
worklogId - identifies the worklog that the update validation will occur against
Returns:
WorklogResult which can be passed to the delete methods if has permission and the data passed in is valid, null otherwise

validateDeleteWithNewEstimate

public WorklogNewEstimateResult validateDeleteWithNewEstimate(JiraServiceContext jiraServiceContext,
                                                              Long worklogId,
                                                              String newEstimate)
Description copied from interface: WorklogService
Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToDelete(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to delete a worklog for this issue.

Specified by:
validateDeleteWithNewEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the user who wishes to create a worklog and the errorCollection that will contain any errors in calling the method
worklogId - identifies the worklog that the delete validation will occur against
newEstimate - The value to change the issues remaining estimate to.
Returns:
Worklog which can be passed to the delete methods if has permission and the data passed in is valid, null otherwise

validateDeleteWithManuallyAdjustedEstimate

public WorklogAdjustmentAmountResult validateDeleteWithManuallyAdjustedEstimate(JiraServiceContext jiraServiceContext,
                                                                                Long worklogId,
                                                                                String adjustmentAmount)
Description copied from interface: WorklogService
Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToDelete(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to delete a worklog for this issue.

Specified by:
validateDeleteWithManuallyAdjustedEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the user who wishes to create a worklog and the errorCollection that will contain any errors in calling the method
worklogId - identifies the worklog that the delete validation will occur against
adjustmentAmount - The value to increase the issues remaining estimate by.
Returns:
Worklog which can be passed to the delete methods if has permission and the data passed in is valid, null otherwise

deleteWithNewRemainingEstimate

public boolean deleteWithNewRemainingEstimate(JiraServiceContext jiraServiceContext,
                                              WorklogNewEstimateResult worklogNewEstimate,
                                              boolean dispatchEvent)
Description copied from interface: WorklogService
Deletes the specified Worklog. This method will adjust the issues remaining estimate to be the new value which has been passed to this method, the old remaining estimate value will be lost.

Specified by:
deleteWithNewRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to update the supplied worklog and the ErrorCollection that will contain any errors encountered in calling the method
worklogNewEstimate - the Worklog and new estimate for the issue.
dispatchEvent - whether or not you want to have an event dispatched on Worklog delete @return the deleted Worklog object, or null if no object has been deleted.
Returns:
true if the Worklog was successfully deleted, false otherwise

deleteWithManuallyAdjustedEstimate

public boolean deleteWithManuallyAdjustedEstimate(JiraServiceContext jiraServiceContext,
                                                  WorklogAdjustmentAmountResult worklogResult,
                                                  boolean dispatchEvent)
Description copied from interface: WorklogService
Deletes the specified Worklog. This method will adjust the issues remaining estimate to be the new value which has been passed to this method, the old remaining estimate value will be lost.

Specified by:
deleteWithManuallyAdjustedEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to update the supplied worklog and the ErrorCollection that will contain any errors encountered in calling the method
worklogResult - the Worklog and adjustmentAmount for the issue.
dispatchEvent - whether or not you want to have an event dispatched on Worklog delete @return the deleted Worklog object, or null if no object has been deleted.
Returns:
true if the Worklog was successfully deleted, false otherwise

deleteAndRetainRemainingEstimate

public boolean deleteAndRetainRemainingEstimate(JiraServiceContext jiraServiceContext,
                                                WorklogResult worklogResult,
                                                boolean dispatchEvent)
Description copied from interface: WorklogService
Deletes the specified Worklog. This method will make no adjustment to the issues remaining estimate.

Specified by:
deleteAndRetainRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to update the supplied worklog and the ErrorCollection that will contain any errors encountered in calling the method
worklogResult - result of the call to WorklogService.validateDelete(com.atlassian.jira.bc.JiraServiceContext,Long) which contains the Worklog to delete
dispatchEvent - whether or not you want to have an event dispatched on Worklog delete
Returns:
true if the Worklog was successfully deleted, false otherwise

deleteAndAutoAdjustRemainingEstimate

public boolean deleteAndAutoAdjustRemainingEstimate(JiraServiceContext jiraServiceContext,
                                                    WorklogResult worklogResult,
                                                    boolean dispatchEvent)
Description copied from interface: WorklogService
Deletes the specified Worklog. This method will auto-adjust the issues remaining estimate by adding the time spent on the deleted worklog.

Specified by:
deleteAndAutoAdjustRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to update the supplied worklog and the ErrorCollection that will contain any errors encountered in calling the method
worklogResult - result of the call to WorklogService.validateDelete(com.atlassian.jira.bc.JiraServiceContext,Long) which contains the Worklog to delete
dispatchEvent - whether or not you want to have an event dispatched on Worklog delete
Returns:
true if the Worklog was successfully deleted, false otherwise

validateUpdate

public WorklogResult validateUpdate(JiraServiceContext jiraServiceContext,
                                    WorklogInputParameters params)
Description copied from interface: WorklogService
Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToUpdate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to update a worklog for this issue.

Specified by:
validateUpdate in interface WorklogService
Parameters:
jiraServiceContext - containing the user who wishes to create a worklog and the errorCollection that will contain any errors in calling the method
params - parameter object that contains all the values required to validate
Returns:
WorklogResult which can be passed to the update methods if has permission and the data passed in is valid, null otherwise

validateUpdateWithNewEstimate

public WorklogNewEstimateResult validateUpdateWithNewEstimate(JiraServiceContext jiraServiceContext,
                                                              WorklogNewEstimateInputParameters params)
Description copied from interface: WorklogService
Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToUpdate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.worklog.Worklog) to update a worklog for this issue.

Specified by:
validateUpdateWithNewEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the user who wishes to create a worklog and the errorCollection that will contain any errors in calling the method
params - parameter object that contains all the values required to validate
Returns:
WorklogResult which can be passed to the update methods if has permission and the data passed in is valid, null otherwise

updateWithNewRemainingEstimate

public Worklog updateWithNewRemainingEstimate(JiraServiceContext jiraServiceContext,
                                              WorklogNewEstimateResult worklogResult,
                                              boolean dispatchEvent)
Description copied from interface: WorklogService
Updates the provided Worklog. This method will adjust the issues remaining estimate to be the new value which has been passed to this method, the old remaining estimate value will be lost.

Specified by:
updateWithNewRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
worklogResult - the Worklog and new estimate for the issue.
dispatchEvent - whether or not you want to have an event dispatched on Worklog update @return the updated Worklog object, or null if no object has been updated.
Returns:
the updated Worklog object, or null if no object has been updated.

updateAndRetainRemainingEstimate

public Worklog updateAndRetainRemainingEstimate(JiraServiceContext jiraServiceContext,
                                                WorklogResult worklogResult,
                                                boolean dispatchEvent)
Description copied from interface: WorklogService
Updates the provided Worklog. This method will make no adjustment to the issues remaining estimate.

Specified by:
updateAndRetainRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to update the supplied worklog and the ErrorCollection that will contain any errors encountered in calling the method
worklogResult - result of the call to WorklogService.validateUpdate(com.atlassian.jira.bc.JiraServiceContext,WorklogInputParameters) which contains the Worklog to update
dispatchEvent - whether or not you want to have an event dispatched on Worklog update
Returns:
the updated Worklog object, or null if no object has been updated.

updateAndAutoAdjustRemainingEstimate

public Worklog updateAndAutoAdjustRemainingEstimate(JiraServiceContext jiraServiceContext,
                                                    WorklogResult worklogResult,
                                                    boolean dispatchEvent)
Description copied from interface: WorklogService
Updates the provided Worklog. This method will auto-adjust the issues remaining estimate based on the updated value of the time spent on the work.

Specified by:
updateAndAutoAdjustRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to update the worklog and the ErrorCollection that will contain any errors in calling the method
worklogResult - result of the call to WorklogService.validateUpdate(com.atlassian.jira.bc.JiraServiceContext,WorklogInputParameters) which contains the Worklog to update
dispatchEvent - whether or not you want to have an event dispatched on Worklog update
Returns:
the update Worklog object, or null if no object has been updated.

delete

protected boolean delete(JiraServiceContext jiraServiceContext,
                         WorklogResult worklogResult,
                         Long newEstimate,
                         boolean dispatchEvent)

update

protected Worklog update(JiraServiceContext jiraServiceContext,
                         WorklogResult worklogResult,
                         Long newEstimate,
                         boolean dispatchEvent)

validateCreate

public WorklogResult validateCreate(JiraServiceContext jiraServiceContext,
                                    WorklogInputParameters params)
Description copied from interface: WorklogService
Determines whether worklogs are enabled in JIRA and if the user has the required permissions as determined by calling WorklogService.hasPermissionToCreate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.Issue,boolean) to create a worklog for this issue.

Specified by:
validateCreate in interface WorklogService
Parameters:
jiraServiceContext - containing the user who wishes to create a worklog and the errorCollection that will contain any errors in calling the method
params - parameter object that contains all the values required to validate
Returns:
WorklogResult which can be passed to the create methods if has permission and the data passed in is valid, null otherwise

validateCreateWithNewEstimate

public WorklogNewEstimateResult validateCreateWithNewEstimate(JiraServiceContext jiraServiceContext,
                                                              WorklogNewEstimateInputParameters params)
Description copied from interface: WorklogService
Determines whether worklogs are enabled in JIRA and if the user has the required permission as determined by calling WorklogService.hasPermissionToCreate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.Issue,boolean) to create a worklog for this issue.

Specified by:
validateCreateWithNewEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the user who wishes to create a worklog and the errorCollection that will contain any errors in calling the method
params - parameter object that contains all the values required to validate
Returns:
WorklogNewEstimateResult the Worklog of which can be passed to the create methods if has permission and the data passed in is valid, null otherwise

validateCreateWithManuallyAdjustedEstimate

public WorklogAdjustmentAmountResult validateCreateWithManuallyAdjustedEstimate(JiraServiceContext jiraServiceContext,
                                                                                WorklogAdjustmentAmountInputParameters params)
Description copied from interface: WorklogService
Determines whether worklogs are enabled in JIRA and if the user has the required permission as determined by calling WorklogService.hasPermissionToCreate(com.atlassian.jira.bc.JiraServiceContext,com.atlassian.jira.issue.Issue,boolean) to create a worklog for this issue.

Specified by:
validateCreateWithManuallyAdjustedEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the user who wishes to create a worklog and the errorCollection that will contain any errors in calling the method
params - parameter object that contains all the values required to validate
Returns:
WorklogAdjustmentAmountResult the Worklog of which can be passed to the create methods if has permission and the data passed in is valid, null otherwise

createWithNewRemainingEstimate

public Worklog createWithNewRemainingEstimate(JiraServiceContext jiraServiceContext,
                                              WorklogNewEstimateResult worklogResult,
                                              boolean dispatchEvent)
Description copied from interface: WorklogService
Persists a new Worklog on the given Issue. This method will adjust the issues remaining estimate to be the new value which has been passed to this method, the old remaining estimate value will be lost.

Specified by:
createWithNewRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
worklogResult - the Worklog and new estimate for the issue.
dispatchEvent - whether or not you want to have an event dispatched on Worklog creation
Returns:
the created Worklog object or null if no object was created.
See Also:
WorklogService.validateCreateWithNewEstimate(com.atlassian.jira.bc.JiraServiceContext, WorklogNewEstimateInputParameters)

createWithManuallyAdjustedEstimate

public Worklog createWithManuallyAdjustedEstimate(JiraServiceContext jiraServiceContext,
                                                  WorklogAdjustmentAmountResult worklogResult,
                                                  boolean dispatchEvent)
Description copied from interface: WorklogService
Persists a new Worklog on the given Issue. This method will adjust the issues remaining estimate by reducing by the adjustmentAmount which has been passed to this method. Before calling this method, you must call validateCreateWithManuallyAdjustedEstimate() to ensure that the creation is OK.

Specified by:
createWithManuallyAdjustedEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
worklogResult - the Worklog and adjustmentAmount for the issue.
dispatchEvent - whether or not you want to have an event dispatched on Worklog creation
Returns:
the created Worklog object or null if no object was created.
See Also:
WorklogService.validateCreateWithManuallyAdjustedEstimate(com.atlassian.jira.bc.JiraServiceContext, com.atlassian.jira.bc.issue.worklog.WorklogAdjustmentAmountInputParameters)

createAndRetainRemainingEstimate

public Worklog createAndRetainRemainingEstimate(JiraServiceContext jiraServiceContext,
                                                WorklogResult worklogResult,
                                                boolean dispatchEvent)
Description copied from interface: WorklogService
Persists a new Worklog on the given Issue. This method will make no adjustment to the issues remaining estimate.

Specified by:
createAndRetainRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
worklogResult - the WorklogResult generated by the validate call
dispatchEvent - whether or not you want to have an event dispatched on Worklog creation @return the created Worklog object, or null if no object created.
Returns:
the created Worklog object or null if no object was created.

createAndAutoAdjustRemainingEstimate

public Worklog createAndAutoAdjustRemainingEstimate(JiraServiceContext jiraServiceContext,
                                                    WorklogResult worklogResult,
                                                    boolean dispatchEvent)
Description copied from interface: WorklogService
Persists a new Worklog on the given Issue. This method will auto-adjust the issues remaining estimate based on the value of the time spent on the work.

Specified by:
createAndAutoAdjustRemainingEstimate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
worklogResult - the WorklogResult generated by the validate call
dispatchEvent - whether or not you want to have an event dispatched on Worklog creation @return the created Worklog object, or null if no object created.
Returns:
the created Worklog object or null if no object was created.

hasPermissionToCreate

public boolean hasPermissionToCreate(JiraServiceContext jiraServiceContext,
                                     Issue issue,
                                     boolean isEditableCheckRequired)
Description copied from interface: WorklogService
Determines if the user has the Permissions.WORK_ISSUE permission, that timetracking is enabled in JIRA and that the associated issue is in an editable workflow state.

Specified by:
hasPermissionToCreate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
issue - the issue to add the worklog to
isEditableCheckRequired - set to true if we require the issue to be in an editable state. This should always be the case except when logging work on transition
Returns:
true if the user has permission to create a worklog on the specified issue, false otherwise

hasPermissionToUpdate

public boolean hasPermissionToUpdate(JiraServiceContext jiraServiceContext,
                                     Worklog worklog)
Description copied from interface: WorklogService
Determine whether the current user has the permission to update the supplied worklog, timetracking is enabled in JIRA and that the associated issue is in an editable workflow state.

In case of errors, add error messages to the error collection within the servicecontext.

Passing in null worklog or a worklog 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.

This method will return true if the user is a member of the worklog's group/role level (if specified) AND

and false otherwise.

Specified by:
hasPermissionToUpdate in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to update the worklog and the ErrorCollection that will contain any errors in calling the method
worklog - the Worklog the user wishes to update
Returns:
true if the user has permission to update the supplied worklog, false otherwise

hasPermissionToDelete

public boolean hasPermissionToDelete(JiraServiceContext jiraServiceContext,
                                     Worklog worklog)
Description copied from interface: WorklogService
Determine whether the current user has the permission to delete the supplied worklog, timetracking is enabled in JIRA and that the associated issue is in an editable workflow state.

In case of errors, add error messages to the error collection within the servicecontext.

Passing in null worklog or a worklog 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.

This method will return true if the user is a member of the worklog's group/role level (if specified) AND

and false otherwise.

Specified by:
hasPermissionToDelete in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to delete the worklog and the ErrorCollection that will contain any errors in calling the method
worklog - the Worklog the user wishes to delete
Returns:
true if the user has permission to delete the supplied worklog, false otherwise

getById

public Worklog getById(JiraServiceContext jiraServiceContext,
                       Long id)
Description copied from interface: WorklogService
Used to get a worklog by its id.

Specified by:
getById in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
id - uniquely identifies the worklog
Returns:
returns the worklog for the passed in id, null if not found.

getByIssue

public List getByIssue(JiraServiceContext jiraServiceContext,
                       Issue issue)
Description copied from interface: WorklogService
Returns all child worklogs of a specified issue.

Specified by:
getByIssue in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
issue - the specified parent issue (not null)
Returns:
a List of Worklogs, ordered by creation date. An empty List will be returned if none are found

getByIssueVisibleToUser

public List<Worklog> getByIssueVisibleToUser(JiraServiceContext jiraServiceContext,
                                             Issue issue)
Description copied from interface: WorklogService
Returns all child worklogs of a specified issue that the provided user has permission to see.

Specified by:
getByIssueVisibleToUser in interface WorklogService
Parameters:
jiraServiceContext - containing the User who wishes to create a worklog and the ErrorCollection that will contain any errors in calling the method
issue - the specified parent issue (not null)
Returns:
a List of Worklogs, ordered by creation date. An empty List will be returned if none are found

isTimeTrackingEnabled

public boolean isTimeTrackingEnabled()
Description copied from interface: WorklogService
Will return true if APKeys.JIRA_OPTION_TIMETRACKING is true, false otherwise.

Specified by:
isTimeTrackingEnabled in interface WorklogService
Returns:
true if enabled, false otherwise.

isIssueInEditableWorkflowState

public boolean isIssueInEditableWorkflowState(Issue issue)
Description copied from interface: WorklogService
Will return true if the issue is in an editable workflow state.

Specified by:
isIssueInEditableWorkflowState in interface WorklogService
Parameters:
issue - the issue to see if it is in an editable store
Returns:
true if editable, false otherwise

validateParamsAndCreateWorklog

protected Worklog validateParamsAndCreateWorklog(JiraServiceContext jiraServiceContext,
                                                 Issue issue,
                                                 String author,
                                                 String groupLevel,
                                                 String roleLevelId,
                                                 String timeSpent,
                                                 Date startDate,
                                                 Long worklogId,
                                                 String comment,
                                                 Date created,
                                                 Date updated,
                                                 String updateAuthor,
                                                 String errorFieldPrefix)

create

protected Worklog create(JiraServiceContext jiraServiceContext,
                         WorklogResult worklogResult,
                         Long newEstimate,
                         boolean dispatchEvent)

hasEditOwnPermission

protected boolean hasEditOwnPermission(com.atlassian.crowd.embedded.api.User user,
                                       Worklog worklog)

hasEditAllPermission

protected boolean hasEditAllPermission(com.atlassian.crowd.embedded.api.User user,
                                       Issue issue)

hasDeleteOwnPermission

protected boolean hasDeleteOwnPermission(com.atlassian.crowd.embedded.api.User user,
                                         Worklog worklog)

hasDeleteAllPermission

protected boolean hasDeleteAllPermission(com.atlassian.crowd.embedded.api.User user,
                                         Issue issue)

isSameAuthor

protected boolean isSameAuthor(com.atlassian.crowd.embedded.api.User user,
                               Worklog worklog)

getAutoAdjustNewEstimateOnUpdate

protected Long getAutoAdjustNewEstimateOnUpdate(Issue issue,
                                                Long newTimeSpent,
                                                Long originalTimeSpent)

reduceEstimate

protected Long reduceEstimate(Issue issue,
                              Long amount)

increaseEstimate

protected Long increaseEstimate(Issue issue,
                                Long amount)

isValidNewEstimate

protected boolean isValidNewEstimate(JiraServiceContext jiraServiceContext,
                                     String newEstimate)

isValidNewEstimate

protected boolean isValidNewEstimate(JiraServiceContext jiraServiceContext,
                                     String newEstimate,
                                     String errorFieldPrefix)

isValidAdjustmentAmount

protected boolean isValidAdjustmentAmount(JiraServiceContext jiraServiceContext,
                                          String adjustmentAmount)
Checks if the given String is a valid amount of time to change an estimate by.

Parameters:
jiraServiceContext - JiraServiceContext
adjustmentAmount - String with amount of time eg "3d 4h"
Returns:
true if this change is a valid time.

isValidAdjustmentAmount

protected boolean isValidAdjustmentAmount(JiraServiceContext jiraServiceContext,
                                          String adjustmentAmount,
                                          String errorFieldPrefix)
Checks if the given String is a valid amount of time to change an estimate by.

Parameters:
jiraServiceContext - JiraServiceContext
adjustmentAmount - String with amount of time eg "3d 4h"
errorFieldPrefix - the prefix for the error field
Returns:
true if this change is a valid time.

isValidWorklogInputFields

protected boolean isValidWorklogInputFields(JiraServiceContext jiraServiceContext,
                                            Issue issue,
                                            String timeSpent,
                                            Date startDate,
                                            String errorFieldPrefix)

getDurationForFormattedString

protected long getDurationForFormattedString(String timeSpent,
                                             JiraServiceContext jiraServiceContext)

isUserInGroup

protected boolean isUserInGroup(com.atlassian.crowd.embedded.api.User user,
                                String groupLevel)

isUserInRole

protected boolean isUserInRole(Long roleLevel,
                               com.atlassian.crowd.embedded.api.User user,
                               Issue issue)


Copyright © 2002-2012 Atlassian. All Rights Reserved.