Most visited

Recently visited

Results for

Added in API level 1

HandlerThread

public class HandlerThread
extends Thread

java.lang.Object
↳	java.lang.Thread
	↳	android.os.HandlerThread

方便的类，用于启动一个具有活套的新线程。然后可以使用循环来创建处理程序类。请注意，start（）仍然必须被调用。

Summary

Inherited constants

From class java.lang.Thread

Public constructors
`HandlerThread(String name)`
`HandlerThread(String name, int priority)` 构造一个HandlerThread。

Public methods
`Looper`	`getLooper()` 此方法返回与此线程关联的Looper。
`int`	`getThreadId()` 返回此线程的标识符。
`boolean`	`quit()` 退出处理程序线程的活套。
`boolean`	`quitSafely()` 安全地退出处理程序线程的活套。
`void`	`run()` 如果此线程是使用单独的`Runnable`运行对象构建的，则将`Runnable`对象的`run`方法; 否则，此方法不做任何事情并返回。

Protected methods
`void`	`onLooperPrepared()` 回调方法，如果需要在Looper循环之前执行一些设置，可以显式重写。

Inherited methods

From class java.lang.Thread

`static int`	`activeCount()` 返回当前线程 thread group及其子组中活动线程数的估计值。
`final void`	`checkAccess()` 确定当前正在运行的线程是否有权修改此线程。
`Object`	`clone()` 作为线程引发CloneNotSupportedException不能被有意克隆。
`int`	`countStackFrames()` 此方法在API级别1中已被弃用。此调用的定义取决于`suspend()` ，这已被弃用。此外，这次电话会议的结果从未明确定义。
`static Thread`	`currentThread()` 返回对当前正在执行的线程对象的引用。
`void`	`destroy()` 此方法在API级别1中已弃用。此方法最初设计用于在不进行任何清理的情况下销毁此线程。它保存的任何监视器都将保持锁定状态。但是，该方法从未实现过。如果如果要实施的话，那么它将会像`suspend()`容易出现死锁。如果目标线程在销毁时保留了关键系统资源的锁，则线程无法再次访问此资源。如果另一个线程试图锁定这个资源，会导致死锁。这种僵局通常表现为“冻结”的过程。有关更多信息，请参阅Why are Thread.stop, Thread.suspend and Thread.resume Deprecated? 。
`static void`	`dumpStack()` 将当前线程的堆栈跟踪打印到标准错误流。
`static int`	`enumerate(Thread[] tarray)` 将当前线程的线程组及其子线程组中的每个活动线程复制到指定的数组中。
`static Map<Thread, StackTraceElement[]>`	`getAllStackTraces()` 返回所有活动线程的堆栈跟踪图。
`ClassLoader`	`getContextClassLoader()` 返回此线程的上下文ClassLoader。
`static Thread.UncaughtExceptionHandler`	`getDefaultUncaughtExceptionHandler()` 返回由于未捕获的异常而导致线程突然终止时调用的默认处理程序。
`long`	`getId()` 返回此线程的标识符。
`final String`	`getName()` 返回此线程的名称。
`final int`	`getPriority()` 返回此线程的优先级。
`StackTraceElement[]`	`getStackTrace()` 返回表示此线程的堆栈转储的堆栈跟踪元素的数组。
`Thread.State`	`getState()` 返回此线程的状态。
`final ThreadGroup`	`getThreadGroup()` 返回此线程所属的线程组。
`Thread.UncaughtExceptionHandler`	`getUncaughtExceptionHandler()` 返回由于未捕获的异常而导致此线程突然终止时调用的处理函数。
`static boolean`	`holdsLock(Object obj)` 当且仅当当前线程持有指定对象上的监视器锁定时返回 `true` 。
`void`	`interrupt()` 中断此线程。
`static boolean`	`interrupted()` 测试当前线程是否被中断。
`final boolean`	`isAlive()` 测试此线程是否存在。
`final boolean`	`isDaemon()` 测试此线程是否为守护程序线程。
`boolean`	`isInterrupted()` 测试该线程是否被中断。
`final void`	`join()` 等待这个线程死亡。
`final void`	`join(long millis)` 此线程死亡最多等待 `millis`毫秒。
`final void`	`join(long millis, int nanos)` 最多等待 `millis`毫秒加上 `nanos`纳秒以使此线程死亡。
`final void`	`resume()` 此方法在API级别1中已弃用。此方法仅供与`suspend()`一起使用，该方法由于容易出现死锁`suspend()`推荐使用。有关更多信息，请参阅Why are Thread.stop, Thread.suspend and Thread.resume Deprecated? 。
`void`	`run()` 如果此线程是使用单独的`Runnable`运行对象构建的，则`Runnable`对象的`run`方法; 否则，此方法不做任何事情并返回。
`void`	`setContextClassLoader(ClassLoader cl)` 为此线程设置上下文ClassLoader。
`final void`	`setDaemon(boolean on)` 将此线程标记为 daemon线程或用户线程。
`static void`	`setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler eh)` 设置当线程由于未捕获的异常而突然终止时调用的缺省处理程序，并且没有为该线程定义其他处理程序。
`final void`	`setName(String name)` 将此线程的名称更改为等于参数 `name` 。
`final void`	`setPriority(int newPriority)` 改变这个线程的优先级。
`void`	`setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler eh)` 设置由于未捕获的异常而导致此线程突然终止时调用的处理函数。
`static void`	`sleep(long millis, int nanos)` 使当前正在执行的线程休眠（暂时停止执行）指定的毫秒数加上指定的纳秒数，这取决于系统定时器和调度程序的精度和准确性。
`static void`	`sleep(long millis)` 使系统定时器和调度程序的精确性和准确性，使当前正在执行的线程休眠（暂时停止执行）指定的毫秒数。
`void`	`start()` 导致此线程开始执行; Java虚拟机调用此线程的`run`方法。
`final void`	`stop()` 此方法在API级别1中已弃用。此方法本质上不安全。使用Thread.stop停止线程会导致它解锁所有已锁定的监视器（作为未检查的`ThreadDeath`异常传播堆栈的自然结果）。如果之前由这些监视器保护的任何对象处于不一致状态，则损坏的对象对其他线程可见，可能导致任意行为。 `stop`许多用途应该由代码替换，该代码只是修改某些变量以指示目标线程应该停止运行。目标线程应该定期检查这个变量，并且如果变量指示它将停止运行，则从其run方法有序地返回。如果目标线程等待很长时间（例如，在条件变量上），则应该使用`interrupt`方法来中断等待。有关更多信息，请参阅Why are Thread.stop, Thread.suspend and Thread.resume Deprecated? 。
`final void`	`stop(Throwable obj)` 此方法在API级别1中已弃用。此方法本质上不安全。有关详细信息，请参阅`stop()` 。这种方法的另一个危险是它可能被用来生成目标线程没有准备处理的异常（包括线程不可能抛出的检查异常，如果不是这种方法）。有关更多信息，请参阅Why are Thread.stop, Thread.suspend and Thread.resume Deprecated? 。
`final void`	`suspend()` 此方法在API级别1中已被弃用。此方法已被弃用，因为它本质上容易出现死锁。如果目标线程在监视器上保留一个锁定，以便在暂停时保护关键系统资源，则在目标线程恢复之前，线程无法访问此资源。如果在调用`resume`之前，将恢复目标线程的线程尝试锁定此监视器， `resume`导致死锁。这种僵局通常表现为“冻结”的过程。有关更多信息，请参阅Why are Thread.stop, Thread.suspend and Thread.resume Deprecated? 。
`String`	`toString()` 返回此线程的字符串表示形式，包括线程的名称，优先级和线程组。
`static void`	`yield()` 向调度程序提示当前线程愿意产生当前使用的处理器。

From class java.lang.Object

From interface java.lang.Runnable

Public constructors

HandlerThread

Added in API level 1

HandlerThread (String name)

Parameters
`name`	`String`

HandlerThread

Added in API level 1

HandlerThread (String name, 
                int priority)

构造一个HandlerThread。

Parameters
`priority`	`int`: The priority to run the thread at. The value supplied must be from `Process` and not from java.lang.Thread.

Public methods

getLooper

Added in API level 1

Looper getLooper ()

此方法返回与此线程关联的Looper。如果此线程未启动或出于任何原因isAlive（）返回false，则此方法将返回null。如果这个线程已经启动，这个方法会阻塞，直到活套已经初始化。

Returns
`Looper`	The looper.

getThreadId

Added in API level 1

int getThreadId ()

返回此线程的标识符。请参阅Process.myTid（）。

Returns
`int`

quit

Added in API level 5

boolean quit ()

退出处理程序线程的活套。

使处理程序线程的循环程序终止而不处理消息队列中的更多消息。

在循环者被要求退出后，任何尝试将消息发送到队列都将失败。例如， sendMessage(Message)方法将返回false。

使用这种方法可能是不安全的，因为一些消息可能不会在循环者终止之前传递。考虑使用quitSafely()来代替，以确保所有待处理的工作都以有序的方式完成。

Returns
`boolean`	True if the looper looper has been asked to quit or false if the thread had not yet started running.

也可以看看：

quitSafely()

quitSafely

Added in API level 18

boolean quitSafely ()

安全地退出处理程序线程的活套。

一旦消息队列中所有已发送的消息都已处理完毕，就立即终止处理程序线程的活套。未来的延迟邮件将在未来发送。

在循环者被要求退出后，任何尝试将消息发送到队列都将失败。例如， sendMessage(Message)方法将返回false。

如果线程尚未启动或已完成（即getLooper()返回null），则返回false。否则，活套要求退出并返回true。

Returns
`boolean`	True if the looper looper has been asked to quit or false if the thread had not yet started running.

run

Added in API level 1

void run ()

如果此线程是使用单独的Runnable运行对象构建的，则Runnable对象的run方法; 否则，此方法不做任何事情并返回。

Thread子类应该重写此方法。

Protected methods

onLooperPrepared

Added in API level 1

void onLooperPrepared ()

回调方法，如果需要在Looper循环之前执行一些设置，可以显式重写。

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

HandlerThread

Summary

Inherited constants

Public constructors

Public methods

Protected methods

Inherited methods

Public constructors

HandlerThread

HandlerThread

Public methods

getLooper

getThreadId

quit

quitSafely

run

Protected methods

onLooperPrepared