Twitter4Jとは？

Twitter4J は TwitterAPI の Java ラッパです。
Twitter4J を使うと XML や HTTP に詳しくなくても容易に Twitter とインタラクトするアプリケーションを書くことが出来ます。

システム要件

OS: Java をサポートする Windows または Unix 系 OS
JVM: Java5 以降

使い方

twitter4j-1.1.5.jar をクラスパスに通して、好きなメソッドを呼び出してください。
Java が分かっていれば JavaDoc を見るのが早いです。
twitter4j.Twitter クラスが最初に見るべきクラスです。

コードサンプル

サンプルコードは src/twitter4j/examples/ 以下に配置されています。
それぞれ bin/className.cmd|sh で実行できます。

1. スタテータスの更新

Twitter.update() メソッドで"今なにをしているか"を更新することができます。
詳しくは twitter4j.examples.Update.java をご覧ください。

    Twitter twitter = new Twitter(twitterID,twitterPassword);
    Status status = twitter.update(latestStatus);
    System.out.println("Successfully updated the status to [" + status.getText() + "].");

2. タイムラインの取得

Twitter.get****Timeline() メソッドで友達、パブリック、または指定ユーザの最近のタイムラインを返します。
詳しくは twitter4j.examples.GetTimelines.java をご覧ください。

    Twitter twitter = new Twitter(twitterID,twitterPassword);
    statuses = twitter.getFriendsTimeline();
    System.out.println("Showing friends timeline.");
    for (Status status : statuses) {
        System.out.println(status.getUser().getName() + ":" +
                           status.getText());
    }

3. ダイレクトメッセージの送受信

Twitter.sendDirectMessage() / Twitter.getDirectMessages() メソッドでダイレクトメッセージの送受信ができます。
このメッセージは送信した相手にしか見えません。
詳しくは twitter4j.examples.Get/SendDirectMessage(s).java をご覧ください。

    Twitter twitter = new Twitter(senderID,senderPassword);
    sender.sendDirectMessage(recipientId,message);
    Twitter receiver = new Twitter(recipientId,recipientPassword);
    List messages = receiver.getDirectMessages();
    for (DirectMessage message : messages) {
        System.out.println("Sender:" + message.getSenderScreenName());
        System.out.println("Text:" + message.getText() + "\n");
    }

4. 非同期API

非同期APIを使うと実際のメソッドコールの終了を待たずして処理を続行することができます。
実際のメソッドコールは別のスレッドで行われ、処理の結果は TwitterListener インターフェースにて受信できます。
非同期 API を使うには Twitter クラスの替わりに twitter4j.AsyncTwitter クラスを使い、***Async() メソッドを twitter4j.TwitterListener のインスタンスと共に呼び出します。
詳しくは twitter4j.examples.AsyncUpdate.java をご覧ください。

    AsyncTwitter twitter = new AsyncTwitter(senderId,senderPassword);
    twitter.updateAsync(args[2], new TwitterAdapter() {
        @Override public void updated(Status status) {
        System.out.println("Successfully updated the status to [" +
                   status.getText() + "].");
        synchronized (lock) {
            lock.notify();
        }
        }
        @Override public void onException(TwitterException e, int method) {
        if (method == UPDATE) {
            e.printStackTrace();
            synchronized (lock) {
            lock.notify();
            }
        } else {
            synchronized (lock) {
            lock.notify();
            }
            throw new AssertionError("Should not happen");
        }
        }
    }
    );

ダウンロード

twitter4j-1.1.5.zip

ソースコード

アーカイブにはソースコードが含まれています。
プロジェクトのリポジトリには以下の URL からアクセスできます。
http://yusuke.homeip.net/fisheye/browse/svn/twitter4j/trunk
または以下のように subversion クライアントを使って最新のソースコードをチェックアウトすることもできます。

svn checkout http://yusuke.homeip.net/svn/twitter4j/trunk twitter4j

Maven 統合

Maven を使っている場合、pom.xml に以下のように記載すればご自身のプロジェクトに twitter4j を簡単に統合できます。

   <dependencies>
       <dependency>
           <groupId>net.homeip.yusuke</groupId>
           <artifactId>twitter4j</artifactId>
           <version>[1.1,)</version>
       </dependency>
       ...
   </dependencies>

メーリングリスト

Twitter4J に関する質問、バグレポート、リクエストなどありましたら以下のメーリングリストにお気軽にどうぞ。

Twitter4J Jに参加

メール アドレス:

このグループにアクセス

バグ、ロードマップなどについては Jira に登録してあります。
Jira へ

ライセンス

Twitter4J は BSD スタイルライセンスに基づいてリリースされています。

---

Copyright (c) 2007-2008, Yusuke Yamamoto
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of the Yusuke Yamamoto nor the
      names of its contributors may be used to endorse or promote products
      derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY Yusuke Yamamoto ``AS IS'' AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL Yusuke Yamamoto BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

価格

Twitter4J はどなたでも商標、非商用にかかわらず無償でご利用いただけます。
もし Twitter4J があなたの生活を豊かにしてくれると感じたならば、以下の PayPal バッジから寄付していただくことも可能です。