MarkdownとQiitaの練習として投稿します。この内容は私のブログ記事と同等の内容です。[追記]2か所の更新は大変なので、Qiitaのみ更新としました。
Androidアプリ作成でTwitterを使用する際に欠かせないTwitter4Jですが、アプリの連携(認証認可)処理を適当に処理を書いていくとNetworkOnMainThreadExceptionが発生します。onCreateなどのメインスレッドでHttpURLConnectionなどの通信をする処理がある場合に発生する例外です。
今日はこの例外を避けつつ、アプリ連携を実現する方法の一つをご紹介します。
アプリ連携の方法
今回は、アプリ外のブラウザでPINを入力して連携する方法で作ってみました。他にはWebViewを用いてアプリ内のブラウザで処理する方法(WebViewの脆弱性に注意)や、コールバックURLを用いて処理する方法があります。
| PIN | コールバックURL | |
|---|---|---|
| 外部ブラウザ | 今回はここ | (intent-filterを使用) |
| アプリ内のブラウザ | (省略) | (WebViewでURLを監視等) |
[追記]マルチユーザー環境でブラウザ類をすべて制限すると、外部ブラウザでの連携ができなくなりますね…
連携のためのコード8行
連携のための一連の処理を見てみます。
// 準備
Twitter twitter = new TwitterFactory().getInstance();
twitter.setOAuthConsumer(consumerKey, consumerSecret);
twitter.setOAuthAccessToken(null);
RequestToken requestToken = twitter.getOAuthRequestToken(); // ここで通信
// このURLでブラウザで認証
String url = requestToken.getAuthorizationURL();
ここでユーザーが認証してPINコードを得ます。
// PIN入力
AccessToken accessToken = twitter.getOAuthAccessToken(pin); // ここでも通信
// トークンの取得。これらを保管しておく。
String token = accessToken.getToken();
String tokenSecret = accessToken.getTokenSecret();
これらのコード中に通信が発生する箇所が2つあります。これらをLoaderとLoaderManager.LoaderCallbacksを使用して別のスレッドにしてみました。
[追記]Android Support Libraryを使用するようにして、Android2.x系にも対応しました。
解決のためのコード例
リクエストトークンを取得する
まず、リクエストトークンを取得するところ(Twitter#getOAuthRequestToken())を切り出すために、AsyncTaskLoaderを継承したクラスを作成します。バインドするのはRequestTokenです。コンストラクタでTwitterを渡し、loadInBackground()でリクエストトークン取得を実行します。実行の戻り値をそのまま返します。
public class TwitterOAuthRequestTokenLoader extends AsyncTaskLoader<RequestToken> {
private Twitter mTwitter;
public TwitterOAuthRequestTokenLoader(Context context, Twitter twitter) {
super(context);
mTwitter = twitter;
}
@Override
public RequestToken loadInBackground() {
RequestToken requestToken = null;
try {
requestToken = mTwitter.getOAuthRequestToken();
} catch (TwitterException e) {
requestToken = null;
}
return requestToken;
}
}
上のローダークラスを実行し、結果を処理するために、今度はLoaderCallbacksを実装したコールバッククラスを作成します。こちらもコンストラクタでAPIキーをセットしたTwitterを渡し、[onCreateLoader()](http://developer.android.com/reference/android/support/v4/app/LoaderManager.LoaderCallbacks.html#onCreateLoader(int, android.os.Bundle))でそのままローダークラスのインスタンス生成時に渡します。[onLoadFinished()](http://developer.android.com/reference/android/support/v4/app/LoaderManager.LoaderCallbacks.html#onLoadFinished(android.support.v4.content.Loader, D))の第2引数のRequestTokenが処理結果なので、RequestToken#getAuthorizationURL()でTwitter認証のURLを取得し、ブラウザへIntentで渡します。ユーザーはここで認証し、PINコードを得ます。
public class TwitterOAuthRequestTokenCallbacks implements LoaderCallbacks<RequestToken> {
private Context mContext;
private Twitter mTwitter;
public TwitterOAuthRequestTokenCallbacks(Context context, Twitter twitter) {
mContext = context;
mTwitter = twitter;
}
@Override
public Loader<RequestToken> onCreateLoader(int id, Bundle args) {
Loader<RequestToken> loader = new TwitterOAuthRequestTokenLoader(mContext, mTwitter);
loader.startLoading();
return loader;
}
@Override
public void onLoadFinished(Loader<RequestToken> arg0, RequestToken requestToken) {
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(requestToken.getAuthorizationURL()));
mContext.startActivity(intent);
}
}
アクセストークンを取得する
ブラウザが表示され、ユーザーが認証をすると、PINが表示されます。
PINからアクセストークンを取得するところ(Twitter#getOAuthAccessToken())についても上記のリクエストトークンを取得する場合と同様です。
使う
TwitterはConsumer keyを設定して用意しておきます。
mTwitter = new TwitterFactory().getInstance();
mTwitter.setOAuthConsumer(KEY), KEY_SECRET);
mTwitter.setOAuthAccessToken(null);
あとはコールバッククラスのインスタンスを生成し、
FragmentActivity#getLoaderManager()でLoaderManagerを取得し、[LoaderManager#initLoader()](http://developer.android.com/reference/android/support/v4/app/LoaderManager.html#initLoader(int, android.os.Bundle, android.support.v4.app.LoaderManager.LoaderCallbacks))にコールバッククラスを指定するだけです。
LoaderManager.LoaderCallbacks<RequestToken> requestTokenCallbacks = new TwitterOAuthRequestTokenCallbacks(this, mTwitter);
getSupportLoaderManager().initLoader(0, null, requestTokenCallbacks);
[追記]上記のように2.x系の互換性のためにAndroid Support Library内のLoaderを使用するように変更する場合は、LoaderManagerの不一致があるので、Activityは継承先をFragmentActivityに変更する必要があります。
サンプルプロジェクト
この方法でアプリ連携を行うアプリのプロジェクトをGitHubに置きました。