Handler 【中文翻译小组】

最新推荐文章于 2021-05-27 18:17:54 发布

lihuaok

最新推荐文章于 2021-05-27 18:17:54 发布

阅读量654

点赞数

分类专栏： Android

本文链接：https://blog.csdn.net/lihuaok/article/details/104194533

版权

Android 专栏收录该内容

8 篇文章 0 订阅

订阅专栏

Handler

Kotlin |Java

public class Handler extends Object

java.lang.Object
↳	android.os.Handler

Known direct subclasses

AsyncQueryHandler, AsyncQueryHandler.WorkerHandler, HttpAuthHandler, SslErrorHandler

A Handler allows you to send and process Message and Runnable objects associated with a thread's MessageQueue.

Handler 允许您发送和处理与线程的MessageQueue关联的Message和Runnable对象。

Each Handler instance is associated with a single thread and that thread's message queue.

每个Handler实例都与一个线程和该线程的消息队列关联。

When you create a new Handler,

创建新的Handler时，

it is bound to the thread / message queue of the thread that is creating it -- from that point on,

它将绑定到正在创建它的线程的线程/消息队列中-从那时起，

it will deliver messages and runnables to that message queue and execute them as they come out of the message queue.

它将把消息和可运行对象传递到该消息队列，并在它们从消息中出来时执行它们队列。

There are two main uses for a Handler:

Handler有两个主要用途：

(1) to schedule messages and runnables to be executed at some point in the future;

（1）计划消息和可运行文件在将来某个时间执行；

and (2) to enqueue an action to be performed on a different thread than your own.

（2）将要在不同线程上执行的操作排队。

Scheduling messages is accomplished with the post(Runnable), postAtTime(java.lang.Runnable, long),postDelayed(Runnable, Object, long), sendEmptyMessage(int), sendMessage(Message), sendMessageAtTime(Message, long), and sendMessageDelayed(Message, long) methods.

调度消息是通过以下方法完成的：post(Runnable)、postAtTime(java.lang.Runnable，Long)、postDelayed(Runnable，Object，Long)、EsendEmptyMessage(Int)、EsendMessage(Message)、EsendMessageAtTime(message，Long)和EsendMessageDelayed(message，Long)。

The post versions allow you to enqueue Runnable objects to be called by the message queue when they are received;

POST消息版本允许您将接收到的可运行对象入队，以供消息队列调用Runnable objects；

the sendMessageversions allow you to enqueue a Message object containing a bundle of data that will be processed by the Handler's handleMessage(Message) method (requiring that you implement a subclass of Handler).

EsendMessagversions允许您将包含将由Handler的handleMessage(Message)方法，处理的数据包的消息对象入队。

(要求您实现Handler的子类)。

When posting or sending to a Handler,

在发送或发送到处理程序时，

you can either allow the item to be processed as soon as the message queue is ready to do so,

您可以在消息队列准备好时立即处理该项，

or specify a delay before it gets processed or absolute time for it to be processed.

也可以指定处理该项之前的延迟或处理该项的绝对时间。
The latter two allow you to implement timeouts, ticks, and other timing-based behavior.

后两种方法允许您实现超时、计时和其他基于计时的行为。

When a process is created for your application,

为应用程序创建进程时，

its main thread is dedicated to running a message queue that takes care of managing the top-level application objects (activities, broadcast receivers, etc) and any windows they create.

其主线程专用于运行消息队列，该队列负责管理顶级应用程序对象（活动、广播接收器等）及其创建的任何窗口。

You can create your own threads, and communicate back with the main application thread through a Handler.

您可以创建自己的线程，并通过处理程序与主应用程序线程进行通信。

This is done by calling the same post or sendMessage methods as before,

这是通过调用与以前相同的post或sendMessage方法来完成的，

but from your new thread.

但要从新线程调用。

The given Runnable or Message will then be scheduled in the Handler's message queue and processed when appropriate.

给定的Runnable或消息将被安排在处理程序的消息队列中，并在适当时进行处理。

Summary

Nested classes
`interface`	`Handler.Callback` Callback interface you can use when instantiating a Handler 在实例化Handler时可以使用回调接口， to avoid having to implement your own subclass of Handler. 以避免必须实现自己的Handler子类。

Nested classes

interface

Handler.Callback

Callback interface you can use when instantiating a Handler

在实例化Handler时可以使用回调接口，

to avoid having to implement your own subclass of Handler.

以避免必须实现自己的Handler子类。

Public constructors
`Handler()` Default constructor associates this handler with the `Looper` for the current thread. 默认的构造器，将当前线程的 handler 与 Looper 相关联
`Handler(Handler.Callback callback)` Constructor associates this handler with the `Looper` for the current thread and takes a callback interface in which you can handle messages. 多了一个回调接口，用来处理回调的 messages
`Handler(Looper looper)` Use the provided `Looper` instead of the default one. 用提供的 looper 代替默认的
`Handler(Looper looper, Handler.Callback callback)` Use the provided `Looper` instead of the default one and take a callback interface in which to handle messages. 回调 looper 和 messages

Public constructors

Handler()

Default constructor associates this handler with the Looper for the current thread.

默认的构造器，将当前线程的 handler 与 Looper 相关联

Handler(Handler.Callback callback)

Constructor associates this handler with the Looper for the current thread and takes a callback interface in which you can handle messages.

多了一个回调接口，用来处理回调的 messages

Handler(Looper looper)

Use the provided Looper instead of the default one.

用提供的 looper 代替默认的

Handler(Looper looper, Handler.Callback callback)

Use the provided Looper instead of the default one and take a callback interface in which to handle messages.

回调 looper 和 messages

Public methods
`static Handler`	`createAsync(Looper looper, Handler.Callback callback)` Create a new Handler whose posted messages and runnables are not subject to synchronization barriers such as display vsync. 创建一个新的处理程序, 其发布的 messages 和 runnables 不受同步屏障 (如显示 vsync) 的限制。
`static Handler`	`createAsync(Looper looper)` Create a new Handler whose posted messages and runnables are not subject to synchronization barriers such as display vsync.
`void`	`dispatchMessage(Message msg)` Handle system messages here.
`final void`	`dump(Printer pw, String prefix)`
`final Looper`	`getLooper()`
`String`	`getMessageName(Message message)` Returns a string representing the name of the specified message.
`void`	`handleMessage(Message msg)` Subclasses must implement this to receive messages.
`final boolean`	`hasCallbacks(Runnable r)` Check if there are any pending posts of messages with callback r in the message queue.
`final boolean`	`hasMessages(int what)` Check if there are any pending posts of messages with code 'what' in the message queue.
`final boolean`	`hasMessages(int what, Object object)` Check if there are any pending posts of messages with code 'what' and whose obj is 'object' in the message queue.
`final Message`	`obtainMessage(int what, Object obj)` Same as `obtainMessage()`, except that it also sets the what and obj members of the returned Message.
`final Message`	`obtainMessage()` Returns a new `Message` from the global message pool.
`final Message`	`obtainMessage(int what, int arg1, int arg2)` Same as `obtainMessage()`, except that it also sets the what, arg1 and arg2 members of the returned Message.
`final Message`	`obtainMessage(int what, int arg1, int arg2, Object obj)` Same as `obtainMessage()`, except that it also sets the what, obj, arg1,and arg2 values on the returned Message.
`final Message`	`obtainMessage(int what)` Same as `obtainMessage()`, except that it also sets the what member of the returned Message.
`final boolean`	`post(Runnable r)` Causes the Runnable r to be added to the message queue.
`final boolean`	`postAtFrontOfQueue(Runnable r)` Posts a message to an object that implements Runnable.
`final boolean`	`postAtTime(Runnable r, long uptimeMillis)` Causes the Runnable r to be added to the message queue, to be run at a specific time given by uptimeMillis.
`final boolean`	`postAtTime(Runnable r, Object token, long uptimeMillis)` Causes the Runnable r to be added to the message queue, to be run at a specific time given by uptimeMillis.
`final boolean`	`postDelayed(Runnable r, long delayMillis)` Causes the Runnable r to be added to the message queue, to be run after the specified amount of time elapses.
`final boolean`	`postDelayed(Runnable r, Object token, long delayMillis)` Causes the Runnable r to be added to the message queue, to be run after the specified amount of time elapses.
`final void`	`removeCallbacks(Runnable r)` Remove any pending posts of Runnable r that are in the message queue.
`final void`	`removeCallbacks(Runnable r, Object token)` Remove any pending posts of Runnable r with Object token that are in the message queue.
`final void`	`removeCallbacksAndMessages(Object token)` Remove any pending posts of callbacks and sent messages whose obj is token.
`final void`	`removeMessages(int what)` Remove any pending posts of messages with code 'what' that are in the message queue.
`final void`	`removeMessages(int what, Object object)` Remove any pending posts of messages with code 'what' and whose obj is 'object' that are in the message queue.
`final boolean`	`sendEmptyMessage(int what)` Sends a Message containing only the what value.
`final boolean`	`sendEmptyMessageAtTime(int what, long uptimeMillis)` Sends a Message containing only the what value, to be delivered at a specific time.
`final boolean`	`sendEmptyMessageDelayed(int what, long delayMillis)` Sends a Message containing only the what value, to be delivered after the specified amount of time elapses.
`final boolean`	`sendMessage(Message msg)` Pushes a message onto the end of the message queue after all pending messages before the current time.
`final boolean`	`sendMessageAtFrontOfQueue(Message msg)` Enqueue a message at the front of the message queue, to be processed on the next iteration of the message loop.
`boolean`	`sendMessageAtTime(Message msg, long uptimeMillis)` Enqueue a message into the message queue after all pending messages before the absolute time (in milliseconds) uptimeMillis.
`final boolean`	`sendMessageDelayed(Message msg, long delayMillis)` Enqueue a message into the message queue after all pending messages before (current time + delayMillis).
`String`	`toString()` Returns a string representation of the object.

Inherited methods
From class `java.lang.Object`

Parameters
`looper`	`Looper`: The looper, must not be null. This value must never be `null`.
`callback`	`Handler.Callback`: The callback interface in which to handle messages, or null. This value may be `null`.

Parameters
`looper`	`Looper`: the Looper that the new Handler should be bound to This value must never be `null`.
`callback`	`Handler.Callback`: This value must never be `null`.

Parameters
`pw`	`Printer`: This value must never be `null`.
`prefix`	`String`: This value must never be `null`.

Parameters
`what`	`int`: Value to assign to the returned Message.what field.
`obj`	`Object`: Value to assign to the returned Message.obj field. This value may be `null`.

Parameters
`what`	`int`: Value to assign to the returned Message.what field.
`arg1`	`int`: Value to assign to the returned Message.arg1 field.
`arg2`	`int`: Value to assign to the returned Message.arg2 field.

Parameters
`r`	`Runnable`: The Runnable that will be executed. This value must never be `null`.
`uptimeMillis`	`long`: The absolute time at which the callback should run, using the `SystemClock.uptimeMillis()` time-base.

Parameters
`r`	`Runnable`: The Runnable that will be executed. This value must never be `null`.
`token`	`Object`: An instance which can be used to cancel `r` via `removeCallbacksAndMessages(Object)`. This value may be `null`.
`uptimeMillis`	`long`: The absolute time at which the callback should run, using the `SystemClock.uptimeMillis()` time-base.

Parameters
`r`	`Runnable`: The Runnable that will be executed. This value must never be `null`.
`delayMillis`	`long`: The delay (in milliseconds) until the Runnable will be executed.

Parameters
`r`	`Runnable`: This value must never be `null`.
`token`	`Object`: This value may be `null`.

Parameters
`msg`	`Message`: This value must never be `null`.
`uptimeMillis`	`long`: The absolute time at which the message should be delivered, using the `SystemClock.uptimeMillis()` time-base.

Handler 【中文翻译小组】

Handler

Summary

Nested classes

Public constructors

Public methods

Inherited methods

Public constructors

Handler

Handler

Handler

Handler

Public methods

createAsync

createAsync

dispatchMessage

dump

getLooper

getMessageName

handleMessage

hasCallbacks

hasMessages

hasMessages

obtainMessage

obtainMessage

obtainMessage

obtainMessage

obtainMessage

post

postAtFrontOfQueue

postAtTime

postAtTime

postDelayed

postDelayed

removeCallbacks

removeCallbacks

removeCallbacksAndMessages

removeMessages

removeMessages

sendEmptyMessage

sendEmptyMessageAtTime

sendEmptyMessageDelayed

sendMessage

sendMessageAtFrontOfQueue

sendMessageAtTime

sendMessageDelayed

toString