2012年7月6日金曜日

Twitter OAuth View for Android using twitter4j

TwitterOAuthView is a WebView subclass dedicated to Twitter OAuth on Android.

    GitHub TwitterOAuthView
        https://github.com/TakahikoKawasaki/TwitterOAuthView
        [Javadoc] http://takahikokawasaki.github.com/TwitterOAuthView/index.html

Since it is implemented as a subclass of View, it can be integrated into the Android layout system seamlessly. This fact makes TwitterOAuthView an easily-reusable UI component.

Its usage is very simple. Just call start() method and receive its result via TwitterOAuthView.Listener.

    // Start Twitter OAuth process. Getting a request token, opening Twitter's
    // authorization page, and getting an access token are performed.
    view.start(CONSUMER_KEY, CONSUMER_SECRET, CALLBACK_URL, true, listener);

    // Definition of TwitterOAuthView.Listener interface.
    void onSuccess(TwitterOAuthView view, AccessToken accessToken);
    void onFailure(TwitterOAuthView view, TwitterOAuthView.Result result);

An example of Activity implementation using TwitterOAuthView can be found at GitHub TwitterOAuthView.

---

TwitterOAuthView は、Android での Twitter OAuth に特化した WebView のサブクラスです。

    GitHub TwitterOAuthView
        https://github.com/TakahikoKawasaki/TwitterOAuthView
        [Javadoc] http://takahikokawasaki.github.com/TwitterOAuthView/index.html

View のサブクラスとして実装されているので、Android のレイアウトシステムにシームレスに統合することができます。この事実により、TwitterOAuthView は簡単に再利用できる UI 部品となっています。

使い方はとてもシンプルです。start() メソッドを呼び、結果を TwitterOAuthView.Listener インターフェースで受け取るだけです。

    // Twitter OAuth プロセスを開始します。リクエストトークンの取得、Twitter 認証
    // ページのオープン、アクセストークンの取得が実行されます。
    view.start(CONSUMER_KEY, CONSUMER_SECRET, CALLBACK_URL, true, listener);

    // TwitterOAuthView.Listener インターフェースの定義
    void onSuccess(TwitterOAuthView view, AccessToken accessToken);
    void onFailure(TwitterOAuthView view, TwitterOAuthView.Result result);

TwitterOAuthView を用いた Activity 実装の例は GitHub TwitterOAuthView にあります。