public class HandlerThread extends Thread
Thread.State, Thread.UncaughtExceptionHandler
MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY
Constructor and Description |
---|
HandlerThread(String name) |
HandlerThread(String name,
int priority)
Constructs a HandlerThread.
|
Modifier and Type | Method and Description |
---|---|
Looper |
getLooper()
This method returns the Looper associated with this thread.
|
int |
getThreadId()
Returns the identifier of this thread.
|
protected void |
onLooperPrepared()
Call back method that can be explicitly overridden if needed to execute some
setup before Looper loops.
|
boolean |
quit()
Quits the handler thread's looper.
|
boolean |
quitSafely()
Quits the handler thread's looper safely.
|
void |
run()
If this thread was constructed using a separate
Runnable run object, then that
Runnable object's run method is called;
otherwise, this method does nothing and returns. |
activeCount, blockedOn, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, parkFor$, parkUntil$, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, unpark$, yield
public HandlerThread(String name)
protected void onLooperPrepared()
public void run()
Thread
Runnable
run object, then that
Runnable
object's run
method is called;
otherwise, this method does nothing and returns.
Subclasses of Thread
should override this method.
run
in interface Runnable
run
in class Thread
Thread.start()
,
Thread.stop()
,
Thread.Thread(ThreadGroup, Runnable, String)
public Looper getLooper()
public boolean quit()
Causes the handler thread's looper to terminate without processing any more messages in the message queue.
Any attempt to post messages to the queue after the looper is asked to quit will fail.
For example, the Handler.sendMessage(Message)
method will return false.
Using this method may be unsafe because some messages may not be delivered
before the looper terminates. Consider using quitSafely()
instead to ensure
that all pending work is completed in an orderly manner.
quitSafely()
public boolean quitSafely()
Causes the handler thread's looper to terminate as soon as all remaining messages in the message queue that are already due to be delivered have been handled. Pending delayed messages with due times in the future will not be delivered.
Any attempt to post messages to the queue after the looper is asked to quit will fail.
For example, the Handler.sendMessage(Message)
method will return false.
If the thread has not been started or has finished (that is if
getLooper()
returns null), then false is returned.
Otherwise the looper is asked to quit and true is returned.
public int getThreadId()