Java library for Backlog API version 2
Java
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Backlog4j Build Status

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

Nulab developer icon

Update

  • 2018/05/31 2.3.0 released
  • 2017/12/25 2.2.1 released
  • 2016/10/18 2.2.0 released
  • 2015/12/16 2.1.5 released
  • 2015/08/26 2.1.4 released
  • 2015/03/23 2.1.3 released
  • 2015/02/19 2.1.2 released https://github.com/nulab/backlog4j/releases

Install

gradle

'com.nulab-inc:backlog4j:2.3.0'

maven

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

How to use

Make BacklogConfigure with your space id and your api key.

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

# 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.3.0'

maven を利用する場合

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

使い方

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

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

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

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

# あなたのスペースが 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.**