Java library for Backlog API version 2
Java
Latest commit 2657cb5 Dec 8, 2016 kim #30 fix to add query params

README.md

Backlog4j Build Status

Backlog4j is a Backlog binding library for Java. (英語の下に日本文が記載されています)

Backlog icon

Nulab developer icon

Update

Install

gradle

'com.nulab-inc:backlog4j:2.2.0'

maven

<dependency>
  <groupId>com.nulab-inc</groupId>
  <artifactId>backlog4j</artifactId>
  <version>2.2.0</version>
</dependency>

How to use

Make BacklogConfigure with your space id and your api key.

# If your space is in backlogtool.com
BacklogConfigure configure = new BacklogToolConfigure("yourSpaceId").apiKey("yourApiKey");

# If your space is in backlog.jp
BacklogConfigure configure = new BacklogJpConfigure("yourSpaceId").apiKey("yourApiKey");

And get the BacklogClient.

BacklogClient backlog = new BacklogClientFactory(configure).newClient();

Then call Backlog API method. Enjoy Backlog API!

Project project = backlog.getProject("PROJECT-KEY");

Documents

License

MIT License

Requires

  • Java 1.6

Backlog4j とは

Backlog4j は Backlog API 簡単にアクセスするためのJavaクライアントライブラリです。

インストール

gradle を利用する場合

'com.nulab-inc:backlog4j:2.2.0'

maven を利用する場合

<dependency>
  <groupId>com.nulab-inc</groupId>
  <artifactId>backlog4j</artifactId>
  <version>2.2.0</version>
</dependency>

使い方

基本的な使い方は以下の 2 ステップとなります。

  • BacklogConfigure を設定して BacklogClient オブジェクトを生成
  • Backlog API に従ったメソッド呼び出し

以下の例では スペースIDとAPIキーを用いて BacklogConfigure を設定しています。

# あなたのスペースが backlog.jp 内にある場合 
BacklogConfigure configure = new BacklogJpConfigure("yourSpaceId").apiKey("yourApiKey");

# あなたのスペースが backlogtool.com 内にある場合
BacklogConfigure configure = new BacklogToolConfigure("yourSpaceId").apiKey("yourApiKey");

続いて BacklogClient を生成します。

BacklogClient backlog = new BacklogClientFactory(configure).newClient();

そして、取得したいプロジェクトのキーを指定し、プロジェクト情報をAPI経由で取得します。

Project project = backlog.getProject("PROJECT-KEY");

Android でご使用の場合

proguard-rules に以下を追記して難読化の対象外とすることを推奨します。

#Backlog4j
-keep public class com.nulabinc.backlog4j.** {*;}

#Jackson(Backlog4j is using jackson)
-keepattributes *Annotation*,EnclosingMethod, Signature, InnerClasses
-keepnames class com.fasterxml.jackson.** { *; }
-dontwarn com.fasterxml.jackson.databind.**