com.atlassian.jira.service.util.handler
Class DefaultMessageHandlerContext

java.lang.Object
  extended by com.atlassian.jira.service.util.handler.DefaultMessageHandlerContext
All Implemented Interfaces:
MessageHandlerContext

@Internal
public class DefaultMessageHandlerContext
extends Object
implements MessageHandlerContext

This class has been made public only to allow easy unit testing by tests from other packages. This is the standard implementation which dispatches calls to appropriate JIRA managers.

Since:
v5.0

Constructor Summary
DefaultMessageHandlerContext(CommentManager commentManager, MessageHandlerExecutionMonitor monitor, IssueManager issueManager, AttachmentManager attachmentManager)
           
 
Method Summary
 ChangeItemBean createAttachment(File file, String filename, String contentType, com.atlassian.crowd.embedded.api.User author, Issue issue)
          Creates attachment (when run in real mode) or does nothing if run in dry run mode.
 Comment createComment(Issue issue, com.atlassian.crowd.embedded.api.User author, String body, boolean dispatchEvent)
          Creates a new issue comment in JIRA or a dummy comment in dry run mode
 Issue createIssue(com.atlassian.crowd.embedded.api.User reporter, Issue issue)
          Creates a new issue in JIRA or a dummy issue in dry run mode
 com.atlassian.crowd.embedded.api.User createUser(String username, String password, String email, String fullname, Integer userEventType)
          Creates user in JIRA or just dummy user if run in dry run mode
 MessageHandlerExecutionMonitor getMonitor()
           
 boolean isRealRun()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DefaultMessageHandlerContext

public DefaultMessageHandlerContext(CommentManager commentManager,
                                    MessageHandlerExecutionMonitor monitor,
                                    IssueManager issueManager,
                                    AttachmentManager attachmentManager)
Method Detail

createUser

public com.atlassian.crowd.embedded.api.User createUser(String username,
                                                        String password,
                                                        String email,
                                                        String fullname,
                                                        Integer userEventType)
                                                 throws PermissionException,
                                                        CreateException
Description copied from interface: MessageHandlerContext
Creates user in JIRA or just dummy user if run in dry run mode

Specified by:
createUser in interface MessageHandlerContext
Returns:
Throws:
PermissionException
CreateException

createComment

public Comment createComment(Issue issue,
                             com.atlassian.crowd.embedded.api.User author,
                             String body,
                             boolean dispatchEvent)
Description copied from interface: MessageHandlerContext
Creates a new issue comment in JIRA or a dummy comment in dry run mode

Specified by:
createComment in interface MessageHandlerContext
Returns:

createIssue

public Issue createIssue(@Nullable
                         com.atlassian.crowd.embedded.api.User reporter,
                         Issue issue)
                  throws CreateException
Description copied from interface: MessageHandlerContext
Creates a new issue in JIRA or a dummy issue in dry run mode

Specified by:
createIssue in interface MessageHandlerContext
Returns:
Throws:
CreateException

createAttachment

public ChangeItemBean createAttachment(File file,
                                       String filename,
                                       String contentType,
                                       com.atlassian.crowd.embedded.api.User author,
                                       Issue issue)
                                throws AttachmentException
Description copied from interface: MessageHandlerContext
Creates attachment (when run in real mode) or does nothing if run in dry run mode.

Specified by:
createAttachment in interface MessageHandlerContext
Returns:
a bean which should be passed later (if run in real mode) to IssueUpdater.doUpdate(com.atlassian.jira.issue.util.IssueUpdateBean, boolean)
Throws:
AttachmentException

isRealRun

public boolean isRealRun()
Specified by:
isRealRun in interface MessageHandlerContext
Returns:
true if the context works in production mode (when handlers are run from the service) or false if runs

getMonitor

public MessageHandlerExecutionMonitor getMonitor()
Specified by:
getMonitor in interface MessageHandlerContext
Returns:
place where message handler should report its progress and problems with processing the message. Depending on the run mode it will be either logged in the log file (when real run) or showed to the user in UI (when run in test mode via configuring handler from UI)


Copyright © 2002-2012 Atlassian. All Rights Reserved.