2013年4月25日木曜日

Toastを表示したスレッドについて

AsyncQueryHandler という Content Resolver を経由してデータ取得を非同期に行う処理に関連して見つかりました。このAsyncQueryHandler クラスを調べると、コンストラクタでHandlerThread というインスタンスを生成してそれを使っていることがわかります。

AsyncQueryHandlerのコンストラクタ

public AsyncQueryHandler(ContentResolver cr) {
super();
mResolver = new WeakReference(cr);
synchronized (AsyncQueryHandler.class) {
if (sLooper == null) {
HandlerThread thread = new HandlerThread("AsyncQueryWorker");
thread.start();

sLooper = thread.getLooper();
}
}
mWorkerThreadHandler = createHandler(sLooper);
}


HandlerThreadとは?


このHandlerThreadがポイントなんだろうなと思ったので、これについて調べてみました。HandlerThread <http://developer.android.com/intl/ja/reference/android/os/HandlerThread.html> は内部にlooperを持つスレッドということのようです。looperってなんだったっけ?と思い出すと、スレッドの内部でメッセージキューを処理するものだったように思います(詳しくはAndroid のHandlerとは何か? <http://www.adamrocker.com/blog/261/what-is-the-handler-in-android.html> などを参考にしてください)。

次に、普通に別スレッドでToastを表示したときのエラーを確認すると、

Can't create handler inside thread that has not called Looper.prepare()


とログに出力されていると思います(『現在のスレッドではLooper.prepareが呼び出されていないのでHandlerが作れない』、の意味)。

それではと、Handlerのソースを見てみると、


public Handler() {
if (FIND_POTENTIAL_LEAKS) {
final Class klass = getClass();
if ((klass.isAnonymousClass() || klass.isMemberClass() || klass.isLocalClass()) &&
(klass.getModifiers() & Modifier.STATIC) == 0) {
Log.w(TAG, "The following Handler class should be static or leaks might occur: " +
klass.getCanonicalName());
}
}

mLooper = Looper.myLooper();
if (mLooper == null) {
throw new RuntimeException(
"Can't create handler inside thread that has not called Looper.prepare()");
}
mQueue = mLooper.mQueue;
mCallback = null;
}




とあり、Looperが無い場合はエラーで落としています。

Looper.mylooper() <http://developer.android.com/intl/ja/reference/android/os/Looper.html#myLooper%28%29> を見ると、実行中のスレッドのLooperインスタンスを取得するもののようです。また、Looper <http://developer.android.com/intl/ja/reference/android/os/Looper.html> の説明を見ると、通常のスレッドはlooperがないけど、prepare()を呼び出すことで、そのスレッドにlooperを準備するということのようです。

ということで、上記のエラーはlooperがないスレッドからToastを表示しようとして発生しており、一方HandlerThreadはlooperがあるので、問題なく表示できた、ということになりそうです。

(参考サイト)

* 別スレッドでキュー管理(Handler, Looper, HandlerThread) <http://daichan4649.hatenablog.jp/entry/20111004/1317724067>
* HandlerThreadとHandlerとLooperの関係 <http://d.hatena.ne.jp/kaw0909/20110410/1302418486>
* Handlerクラスの正しい使い方(Androidでスレッド間通信) <http://d.hatena.ne.jp/sankumee/20120329/1333021847>

Toastの振る舞い
では、Toastはどうなっているのかをみてみます。ToastのstaticメソッドのmakeTextを見ると、最初にToastオブジェクトを生成しています。

public static Toast makeText(Context context, CharSequence text, int duration) {
Toast result = new Toast(context);

LayoutInflater inflate = (LayoutInflater)
context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
View v = inflate.inflate(com.android.internal.R.layout.transient_notification, null);
TextView tv = (TextView)v.findViewById(com.android.internal.R.id.message);
tv.setText(text);

result.mNextView = v;
result.mDuration = duration;

return result;
}


Toastのコンストラクタの処理は下記の通りでした。

public Toast(Context context) {
mContext = context;
mTN = new TN();
mTN.mY = context.getResources().getDimensionPixelSize(
com.android.internal.R.dimen.toast_y_offset);
}


ここで、TNはprivate宣言された内部クラスであり、これを見ると、

private static class TN extends ITransientNotification.Stub {
final Runnable mShow = new Runnable() {
public void run() {
handleShow();
}
};

final Runnable mHide = new Runnable() {
public void run() {
handleHide();
// Don't do this in handleHide() because it is also invoked by handleShow()
mNextView = null;
}
};

private final WindowManager.LayoutParams mParams = new WindowManager.LayoutParams();
final Handler mHandler = new Handler();

int mGravity = Gravity.CENTER_HORIZONTAL | Gravity.BOTTOM;


とあるように、メンバ変数でHandlerを引数なしでnewしています。

どうもこのために、UIスレッド以外のlooperがないスレッドで、Toastを表示しようとするとnew Handler() の箇所でエラーになってるように思われます。


サンプルコード


上記のことから、Looper を持つスレッド上であれば、UI スレッドではなくてもToast が表示できるのではないかと推測されます。そこで、下記のようなサンプルコードを作成してみました。

package com.mori_soft.android.toasttest;

import android.os.Bundle;
import android.os.Handler;
import android.os.HandlerThread;
import android.app.Activity;
import android.util.Log;
import android.view.Menu;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;

public class MainActivity extends Activity {

@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

Button button1 = (Button) this.findViewById(R.id.button1);
Button button2 = (Button) this.findViewById(R.id.button2);
Button button3 = (Button) this.findViewById(R.id.button3);
Button button4 = (Button) this.findViewById(R.id.button4);

// ボタンを押したら、Toastを表示する


// (1)UIスレッドから直接呼び出しの場合
button1.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
displayToast();
}
});

// (2)別スレッドから呼び出しの場合(エラー発生)
button2.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
displayToastNotUiThread();
}
});

// (3)別スレッドからHandler経由で呼び出し場合(成功)
button3.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
displayToastThroughHandler();
}
});

// (4)別スレッドでの呼び出しの場合
button4.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
displayToastThroughHandlerThread();
}
});
}

private void displayToast() {
final long id = Thread.currentThread().getId();
final String thName = Thread.currentThread().getName();

Toast.makeText(MainActivity.this, "Toast displayed. thread id:" + id + ", name:" + thName, Toast.LENGTH_LONG).show();
Log.d("MainActivity", "Toast displayed. thread id:" + id + ", name:" + thName);
}

private void displayToastNotUiThread() {
new Thread(new Runnable() {
@Override
public void run() {
displayToast();
}
}, "TestThread#1").start();
}

private void displayToastThroughHandler() {
final Handler h = new Handler();
new Thread(new Runnable() {

@Override
public void run() {
Log.d("MainActivity", "thread run() called. thread name:" + Thread.currentThread().getName());
h.post(new Runnable() {
@Override
public void run() {
displayToast();
}
});
}
}, "TestThread#2").start();
}

private void displayToastThroughHandlerThread() {
final HandlerThread ht = new HandlerThread("TestThread#3");
ht.start();

Handler h = new Handler(ht.getLooper());
h.post(new Runnable() {
@Override
public void run() {
displayToast();
}
});

// 別スレッドを停止
//ht.quit();
}

@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.activity_main, menu);
return true;
}
}


Activityにボタンを4つ配置し、ボタンを押すと異なる方法でToastを表示するものです。Toast表示時にスレッドのidと名前を表示します。

(1)がUIスレッド、(2)が別スレッドだけどHandlerを使わないのでエラーになる方法、(3)が別スレッドからHandler経由で表示する方法、(4)が別スレッド上で表示する方法になります。

実験

では、試してみましょう。(1)はUIスレッドで、(3)は別スレッドからUIスレッドにToastを投げて表示します。どちらの場合もUIスレッド(mainスレッド)でToastが処理され、表示されます。一方、(3)の場合は実行時のログを見ると、
Handler#run()は別スレッド(スレッド名が、TestThread#2)で動いていますが、Toast表示処理はUIスレッドになっていることがわかります。

(2)は上記で示したようなエラーになります。(4)は下記画面に示すように、別スレッド(スレッド名がTestThread#3)上でToastが処理されていることがわかります。
このようにあっけないぐらい簡単に別スレッドから表示できました。

なお、上記のサンプルでは、HandlerThread#quit() を呼び出していませんが、適切なタイミングでquitを呼びスレッドを終了させるほうがよいと思います。

まだ疑問が・・・・
Toastを別スレッドで表示することができましたが、とはいえ、UIに関する処理をしているのに本当にこれで良いのか?なぜ別スレッドで処理できる?という疑問が残ります。

Toastの内部では、NotificationManagerService というサービスを呼出しており(呼び出す際の名称は"notification")、Toast#show()でこのサービスのキューに表示する情報を入れています。

なので、このあたりでよしなにやってくれてるんだろうと思うのですが、これ以上追いかけれませんでした。また、時間ができたら見てみたいと思います。

あと、現時点では、上記で見たようにLooper を持つ別スレッドでToastが表示できるとしても、これが効率的なやり方なのか、推奨のやり方なのかという点は正直よくわかりませんし、アプリの種類によってはうまくいかなかったりする可能性もないとは言い切れません。

なので、こういうことができた、という参考程度に捉えておいてもらえるとありがたいです。

なお、下記にもHandlerThraedを使ったToast表示の例が載ってました。

Can't create handler inside thread that has not called Looper.prepare() <http://stackoverflow.com/questions/3875184/cant-create-handler-inside-thread-that-has-not-called-looper-prepare>

0 件のコメント:

コメントを投稿