当前位置：首页 > Java

java如何使用jiraapi

2026-03-21 13:50:01Java

使用 Jira API 的 Java 实现

准备工作

确保项目中包含必要的依赖库。推荐使用 Atlassian 官方提供的 jira-rest-java-client 或其他 HTTP 客户端库（如 Apache HttpClient 或 OkHttp）。

Maven 依赖示例：

<dependency>
    <groupId>com.atlassian.jira</groupId>
    <artifactId>jira-rest-java-client-core</artifactId>
    <version>5.2.0</version>
</dependency>

认证配置

Jira API 通常需要 Basic Authentication 或 OAuth 认证。以下是 Basic Auth 的示例代码：

import java.net.URI;
import com.atlassian.jira.rest.client.api.JiraRestClient;
import com.atlassian.jira.rest.client.internal.async.AsynchronousJiraRestClientFactory;

String username = "your-username";
String password = "your-api-token"; // 或密码
String jiraUrl = "https://your-jira-instance.atlassian.net";

JiraRestClient restClient = new AsynchronousJiraRestClientFactory()
    .createWithBasicHttpAuthentication(URI.create(jiraUrl), username, password);

常见操作示例

获取 Issue 信息

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

String issueKey = "PROJ-123";
Issue issue = restClient.getIssueClient().getIssue(issueKey).claim();
System.out.println("Summary: " + issue.getSummary());

创建 Issue

import com.atlassian.jira.rest.client.api.domain.input.IssueInput;
import com.atlassian.jira.rest.client.api.domain.input.IssueInputBuilder;

IssueInput newIssue = new IssueInputBuilder(
    "PROJ", // 项目键
    1L // Issue 类型 ID
).setSummary("New Issue via API")
 .setDescription("Description here")
 .build();

restClient.getIssueClient().createIssue(newIssue).claim();

搜索 Issues

import com.atlassian.jira.rest.client.api.SearchResult;

String jql = "project = PROJ AND status = Open";
SearchResult results = restClient.getSearchClient().searchJql(jql).claim();
results.getIssues().forEach(issue -> System.out.println(issue.getKey()));

关闭资源

使用完毕后关闭客户端以释放资源：

restClient.close();

替代方案（原生 HTTP 请求）

如果不使用官方客户端库，可以通过原生 HTTP 请求调用 API：

java如何使用jiraapi

import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.impl.client.BasicCredentialsProvider;

CredentialsProvider credsProvider = new BasicCredentialsProvider();
credsProvider.setCredentials(
    AuthScope.ANY,
    new UsernamePasswordCredentials(username, password)
);

try (CloseableHttpClient httpClient = HttpClients.custom()
        .setDefaultCredentialsProvider(credsProvider)
        .build()) {
    HttpGet request = new HttpGet(jiraUrl + "/rest/api/2/issue/PROJ-123");
    String response = EntityUtils.toString(httpClient.execute(request).getEntity());
    System.out.println(response);
}