JIRA插件开发（二）

大家都知道，JIRA是一个优秀的问题跟踪系统。
但它不一定就能完全满足你的需要，比如导入Excel方式提交的BUG。
值得庆幸的是，JIRA提供了强大的插件开发功能，现说一说我的一点小经验。

准备： JIRA3.9,  JIRA SDK,  IDEA / Eclipse, 熟悉Java（废话）,  熟悉WebWork
资料： http://confluence.atlassian.com/display/JIRA/JIRA+Development+Hub
官方资料可能无法全部找到你想要的，这时你可以下载一些其它第三方插件来分析其源码。

最重要的一点，那就是反编译JIRA代码，直接查看之。
比如，你想查看 /secure/IssueNavigator.jspa 的代码
打开 WEB-INF/classes/actions.xml 查找 IssueNavigator ，如下：   

<action name="issue.IssueNavigator" alias="IssueNavigator">   
    <view name="success">/secure/views/navigator/navigator.jsp</view>   
    <view name="error">/secure/views/navigator/navigator.jsp</view>   
</action>   

 

表示其对应的类是  com.atlassian.jira.web.action.issue.IssueNavigator 反编译之即可。

以下说一说一些常用的方法：
JIRA提供各种 xxxManager 提口来实现各种操作
你可以通过 ComponentManager.getInstance().getXxx() 来得到其实例
也可以通过 ComponentManager.getComponentInstanceOfType(xxx.class) 来得到，非常方便。

比如：

JiraAuthenticationContext authenticationContext = ComponentManager.getInstance().getJiraAuthenticationContext();    
   
ProjectComponentManager pcm = (ProjectComponentManager)ComponentManager.getComponentInstanceOfType(ProjectComponentManager.class);   

例子：

public static User getCurrentUser() {        
    JiraAuthenticationContext authenticationContext = ComponentManager.getInstance().getJiraAuthenticationContext();        
    return authenticationContext == null ? null : authenticationContext.getUser();        
}        
       
public static Project getProject(long pid) {        
    return ComponentManager.getInstance().getProjectManager().getProjectObj(pid);        
}     
   
public static MutableIssue getIssueById(Long id) {    
    try {    
        IssueManager issueManager = ComponentManager.getInstance().getIssueManager();    
        return issueManager.getIssueObject(id);    
    } catch (Exception e) {    
        return null;    
    }    
}    

把邮件加入JIRA队列：

Email mail = new Email(toaddr);    
    
MailQueueItem item = new SingleMailQueueItem(mail);    
ManagerFactory.getMailQueue().addItem(item);    

另外你可以覆盖JIRA的Action，比如覆盖CreateSubTaskIssueDetails
让其在创建子任务时自动导入父任务的一些数据（如"所属模块"）。

<action name="jira.plugin.rstoolkit.webui.action.CreateSubTaskIssueDetails" alias="CreateSubTaskIssueDetails">   
    <view name="error">/secure/views/createsubtaskissue-details.jsp</view>   
    <view name="input">/secure/views/createsubtaskissue-details.jsp</view>   
    <view name="init">/rstoolkit/initsubtaskdetails.jsp</view>   
</action>   

实在不想打字，其它的一些就不一一列举了。