r-labs

redmine.org の "Rest_api_with_java":http://www.redmine.org/projects/redmine/wiki/Rest_api_with_java の日本語訳です。

h1. Java での REST API の使用法

h2. Jredmine

"Jredmine":http://maven-site.nuiton.org/jredmine/index.html というプラグインがあります。こちらは、RedmineのJredmine専用のプラグインと、対応するJavaのClientが提供されており、redmine redt apiよりも色々な機能があります。

h2. redmine-jconnector

"redmine-jconnector":https://code.google.com/p/redmine-jconnector/ (redmine 1.4 / REST API 有効時のみの対応です)

h2. Redmine Java API library from taskadapter¶

Redmine REST API でのアクセスに使える Java のライブラリには "Redmine Java API library from taskadapter¶":https://github.com/taskadapter/redmine-java-api があります。これはサードパーティ製のフリー(Apache 2 オープンソースライセンス)なライブラリです。(REST APIを有効にしたRedmine2.3までをサポートしています）

使用例:

<pre><code class="java">

import java.io.IOException;

import java.net.URISyntaxException;

import java.util.List;

import com.taskadapter.redmineapi.RedmineManager;

import com.taskadapter.redmineapi.bean.Issue;

public class Simple {

    private static String redmineHost = "https://www.hostedredmine.com";

    private static String apiAccessKey = "a3221bfcef5750219bd0a2df69519416dba17fc9";

    private static String projectKey = "taskconnector-test";

    private static Integer queryId = null; // any

    public static void main(String[] args) {

        RedmineManager mgr = new RedmineManager(redmineHost, apiAccessKey);

        try {

            tryGetIssues(mgr);

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

    private static void tryGetIssues(RedmineManager mgr) throws Exception {

        List<Issue> issues = mgr.getIssues(projectKey, queryId);

        for (Issue issue : issues) {

            System.out.println(issue.toString());

        }

    }

}

</code></pre>

チケットの作成

<pre><code class="java">

	Issue issueToCreate = new Issue();

	issueToCreate.setSubject("This is the summary line 123");

	Issue newIssue = mgr.createIssue(PROJECT_KEY, issueToCreate);

</code></pre>

ID を指定したチケットの取得

<pre><code class="java">

	Issue issue = mgr.getIssueById(123);

</code></pre>