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 >    

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