jira二次开发经验分享最近在折腾Jira的二次开发，说实话，二次开发需要对系统的架构有一定的了解才好下手。虽然Jira

最近在折腾Jira的二次开发，说实话，二次开发需要对系统的架构有一定的了解才好下手。虽然Jira这个产品很完善，官方有很详细的文档供开发者参考，但小弟还是花了不少时间研究，开发了近一个月的时间，现在把一些用到的知识和问题整理出来，与大家分享。

这次开发主要是做一个中间件，用来连接jira系统和其他系统从而实现系统之间的相互的通信，如创建一个问题(Issue)，对jira里一些问题(即Issue)信息的修改，流程步骤(workflowstep)的改变，添加与更新字段(Field)和自定义字段(customerField)的等等。这里用到了jira-rest-java-client包来实现对jira的访问。

部分操作Jira的代码：

001 import java.net.URI;

002 import java.net.URISyntaxException;

003 import java.util.ArrayList;

004 import java.util.List;

005 import com.atlassian.jira.rest.client.JiraRestClient;

006 import com.atlassian.jira.rest.client.NullProgressMonitor;

007 import com.atlassian.jira.rest.client.domain.BasicIssue;

008 import com.atlassian.jira.rest.client.domain.BasicProject;

009 import com.atlassian.jira.rest.client.domain.Issue;

010 import com.atlassian.jira.rest.client.domain.User;

011 import com.atlassian.jira.rest.client.domain.input.FieldInput;

012 import com.atlassian.jira.rest.client.domain.input.IssueInput;

013 import com.atlassian.jira.rest.client.domain.input.IssueInputBuilder;

014 import com.atlassian.jira.rest.client.internal.jersey.JerseyJiraRestClientFactory;

015

016 public class jira {

017

018

019 staticJerseyJiraRestClientFactory factory =new JerseyJiraRestClientFactory();

020 staticNullProgressMonitor pm =newNullProgressMonitor();

021 staticString uri="http://localhost:8100";

022 staticString user="gfjira";

023 staticString pwd="123456";

024 /**

025 * @param args

026 */

027 publicstaticvoid main(String[] args) {

028 // TODO Auto-generated method stub

029

030

031 }

032 publicstaticvoid getIssue(String issueKey) throws URISyntaxException{

033

034 URI jiraServerUri =newURI(uri);

035 JiraRestClient restClient = factory.createWithBasicHttpAuthentication(

036 jiraServerUri, user, pwd);

037 //get issue through issueKey

038 Issue issue = restClient.getIssueClient().getIssue(issueKey, pm);

039 //grab user info

040 User usr = restClient.getUserClient().getUser(user, pm);

041 System.out.println(usr);

042 System.out.println(issue);

043 }

044

045 //

046 /*

047 * create the issue

048 * @param Issue type : 1L:bug; 2L:new requirement; 3L:task; 4L.improvement

049 * @param projectName:such as "GTP",the project short name

050 * @param Longid:such as 10000

051 * @param Summary:topic

052 * @param Description:

053 */

054 public static void createIssue(String projectName,String issueType,String description,String summary)throwsURISyntaxException{

055 //JerseyJiraRestClientFactory factory = new JerseyJiraRestClientFactory();

056 URI jiraServerUri =newURI(uri);

057 JiraRestClient restClient = factory.createWithBasicHttpAuthentication(

058 jiraServerUri, user, pwd);

059 IssueInputBuilder issueBuilder =newIssueInputBuilder( "ProjectKey",

060 Long.valueOf(issueType));

061

062

063 finalURI projectUri =newURI(

064 "http://localhost:8100/rest/api/2/project/IT");

065 BasicProject bporject =newBasicProject(projectUri, projectName, "",

066 (long)10000);

067 issueBuilder.setProject(bporject);

068 issueBuilder.setDescription(description);

069 issueBuilder.setSummary(summary);

070

071

072 IssueInput issueInput = issueBuilder.build();

073 BasicIssue bIssue = restClient.getIssueClient().createIssue(issueInput,

074 pm);

075 // print the newly created issuekey

076 System.out.println(bIssue.getKey());

077 } <SPAN></SPAN>publicstaticvoid updateIssueField(String key,String field,String value)throwsURISyntaxException{

078

079

080 URI jiraServerUri =newURI(uri);

081 JiraRestClient restClient = factory.createWithBasicHttpAuthentication(

082 jiraServerUri, user, pwd);

083 //get the issue through issuekey

084 Issue issue = restClient.getIssueClient().getIssue(key, pm);

085 //update the default field environment,if the field is defined by self,pls use the filed<SPAN></SPAN> FieldInput fieldinput = new FieldInput("environment", value);

086 List<FieldInput> fields =newArrayList<FieldInput>();

087 fields.add(fieldinput);

088 restClient.getIssueClient().update(issue, fields, pm);

089 }

090

091

092 public static void changeIssueStatus(String issuekey)throwsURISyntaxException

093 {

094

095

096 URI jiraServerUri =newURI(uri);

097 JiraRestClient restClient = factory

098 .createWithBasicHttpAuthentication(jiraServerUri, user,

099 pwd);

100 Issue issue = restClient.getIssueClient().getIssue(issuekey, pm);

101 //the number 3 is involed below picture,you can focus on the red rectangular

102 TransitionInput tinput=newTransitionInput(3 );

103 restClient.getIssueClient().transition(issue,

104 tinput, pm);

105 } }

就上面这段代码都折腾了我好久，特别是jira-rest-java-client的版本问题，最新的版本找不到需要的函数，却在旧的版本(1.1.m02，这个版本很奇葩吧)里有需要的函数，该死的官方没有说清楚，害得我一个一个的测试。这里想说的是changeIssueStatus这个方法，issue的workflow是不可以随便改变的，必须按照流程图的顺序进行改变，其实就是提供一个id值，图中红色的区域可查到具体的id值，比如当前issue的状态是open，要改变成resolved的状态，就要"5"这个值，即

`1`	`TransitionInput tinput=` `newTransitionInput(5);`

同理，要改变成closed，就用"2"这个值

`1`	`TransitionInput tinput=` `newTransitionInput(2);`

既然是二次开发，系统就少不了前端开发，那就要用到javascript了，考虑到Jira系统自身的复杂和以后版本升级带来的问题，所以没有对源码的js进行修改，而是利用了jira里提供的一个customer field，他可以让我们往里面添加html,css,javascript，而且是基于Jquery的，虽然称不上完美，但是还勉强能实现需求的功能。

暂时整理出这么多，希望各位大侠能多喷多给意见:D

Atlassian 发布了21 篇原创文章 · 获赞 24 · 访问量 84万+ 私信关注