【Android】Handler、Looper源码分析

 1 class LooperThread extends Thread {
 2      public Handler mHandler;
 3 
 4      public void run() {
 5           Looper.prepare();
 6 
 7           mHandler = new Handler() {
 8              public void handleMessage(Message msg) {
 9                  // process incoming messages here
10               }
11          };
12          Looper.loop();
13      }
14 }

 1 /** Initialize the current thread as a looper.
 2       * This gives you a chance to create handlers that then reference
 3       * this looper, before actually starting the loop. Be sure to call
 4       * {@link #loop()} after calling this method, and end it by calling
 5       * {@link #quit()}.
 6       */
 7     public static void prepare() {
 8         prepare(true);
 9     }
10 
11     private static void prepare(boolean quitAllowed) {
12         if (sThreadLocal.get() != null) {
13             throw new RuntimeException("Only one Looper may be created per thread");
14         }
15         sThreadLocal.set(new Looper(quitAllowed));
16     }

1 private Looper(boolean quitAllowed) {
2      mQueue = new MessageQueue(quitAllowed);
3      mThread = Thread.currentThread();
4 }

 1 /**
 2      * Return the Looper object associated with the current thread.  Returns
 3      * null if the calling thread is not associated with a Looper.
 4      */
 5     public static Looper myLooper() {
 6         return sThreadLocal.get();
 7     }
 8 
 9     /** Returns the application‘s main looper, which lives in the main thread of the application.
10      */
11     public static Looper getMainLooper() {
12         synchronized (Looper.class) {
13             return sMainLooper;
14         }
15     }

 1     /**
 2      * Initialize the current thread as a looper, marking it as an
 3      * application‘s main looper. The main looper for your application
 4      * is created by the Android environment, so you should never need
 5      * to call this function yourself.  See also: {@link #prepare()}
 6      */
 7     public static void prepareMainLooper() {
 8         prepare(false);
 9         synchronized (Looper.class) {
10             if (sMainLooper != null) {
11                 throw new IllegalStateException("The main Looper has already been prepared.");
12             }
13             sMainLooper = myLooper();
14         }
15     }

 1     /**
 2      * Default constructor associates this handler with the {@link Looper} for the
 3      * current thread.
 4      *
 5      * If this thread does not have a looper, this handler won‘t be able to receive messages
 6      * so an exception is thrown.
 7      */
 8     public Handler() {
 9         this(null, false);
10     }
11     /**
12      * Use the {@link Looper} for the current thread with the specified callback interface
13      * and set whether the handler should be asynchronous.
14      *
15      * Handlers are synchronous by default unless this constructor is used to make
16      * one that is strictly asynchronous.
17      *
18      * Asynchronous messages represent interrupts or events that do not require global ordering
19      * with represent to synchronous messages.  Asynchronous messages are not subject to
20      * the synchronization barriers introduced by {@link MessageQueue#enqueueSyncBarrier(long)}.
21      *
22      * @param callback The callback interface in which to handle messages, or null.
23      * @param async If true, the handler calls {@link Message#setAsynchronous(boolean)} for
24      * each {@link Message} that is sent to it or {@link Runnable} that is posted to it.
25      *
26      * @hide
27      */
28     public Handler(Callback callback, boolean async) {
29         if (FIND_POTENTIAL_LEAKS) {
30             final Class<? extends Handler> klass = getClass();
31             if ((klass.isAnonymousClass() || klass.isMemberClass() || klass.isLocalClass()) &&
32                     (klass.getModifiers() & Modifier.STATIC) == 0) {
33                 Log.w(TAG, "The following Handler class should be static or leaks might occur: " +
34                     klass.getCanonicalName());
35             }
36         }
37 
38         mLooper = Looper.myLooper();
39         if (mLooper == null) {
40             throw new RuntimeException(
41                 "Can‘t create handler inside thread that has not called Looper.prepare()");
42         }
43         mQueue = mLooper.mQueue;
44         mCallback = callback;
45         mAsynchronous = async;
46     }

 1     /**
 2      * Use the provided {@link Looper} instead of the default one and take a callback
 3      * interface in which to handle messages.  Also set whether the handler
 4      * should be asynchronous.
 5      *
 6      * Handlers are synchronous by default unless this constructor is used to make
 7      * one that is strictly asynchronous.
 8      *
 9      * Asynchronous messages represent interrupts or events that do not require global ordering
10      * with represent to synchronous messages.  Asynchronous messages are not subject to
11      * the synchronization barriers introduced by {@link MessageQueue#enqueueSyncBarrier(long)}.
12      *
13      * @param looper The looper, must not be null.
14      * @param callback The callback interface in which to handle messages, or null.
15      * @param async If true, the handler calls {@link Message#setAsynchronous(boolean)} for
16      * each {@link Message} that is sent to it or {@link Runnable} that is posted to it.
17      *
18      * @hide
19      */
20     public Handler(Looper looper, Callback callback, boolean async) {
21         mLooper = looper;
22         mQueue = looper.mQueue;
23         mCallback = callback;
24         mAsynchronous = async;
25     }

 1     public final boolean sendMessage(Message msg)
 2     {
 3         return sendMessageDelayed(msg, 0);
 4     }
 5 
 6     public final boolean sendEmptyMessage(int what)
 7     {
 8         return sendEmptyMessageDelayed(what, 0);
 9     }
10 
11     public final boolean sendEmptyMessageDelayed(int what, long delayMillis) {
12         Message msg = Message.obtain();
13         msg.what = what;
14         return sendMessageDelayed(msg, delayMillis);
15     }
16 
17     public final boolean sendEmptyMessageAtTime(int what, long uptimeMillis) {
18         Message msg = Message.obtain();
19         msg.what = what;
20         return sendMessageAtTime(msg, uptimeMillis);
21     }
22 
23     public final boolean sendMessageDelayed(Message msg, long delayMillis)
24     {
25         if (delayMillis < 0) {
26             delayMillis = 0;
27         }
28         return sendMessageAtTime(msg, SystemClock.uptimeMillis() + delayMillis);
29     }
30 
31     /**
32      * Enqueue a message into the message queue after all pending messages
33      * before the absolute time (in milliseconds) <var>uptimeMillis</var>.
34      * <b>The time-base is {@link android.os.SystemClock#uptimeMillis}.</b>
35      * You will receive it in {@link #handleMessage}, in the thread attached
36      * to this handler.
37      * 
38      * @param uptimeMillis The absolute time at which the message should be
39      *         delivered, using the
40      *         {@link android.os.SystemClock#uptimeMillis} time-base.
41      *         
42      * @return Returns true if the message was successfully placed in to the 
43      *         message queue.  Returns false on failure, usually because the
44      *         looper processing the message queue is exiting.  Note that a
45      *         result of true does not mean the message will be processed -- if
46      *         the looper is quit before the delivery time of the message
47      *         occurs then the message will be dropped.
48      */
49     public boolean sendMessageAtTime(Message msg, long uptimeMillis) {
50         MessageQueue queue = mQueue;
51         if (queue == null) {
52             RuntimeException e = new RuntimeException(
53                     this + " sendMessageAtTime() called with no mQueue");
54             Log.w("Looper", e.getMessage(), e);
55             return false;
56         }
57         return enqueueMessage(queue, msg, uptimeMillis);
58     }

1     private boolean enqueueMessage(MessageQueue queue, Message msg, long uptimeMillis) {
2         msg.target = this;
3         if (mAsynchronous) {
4             msg.setAsynchronous(true);
5         }
6         return queue.enqueueMessage(msg, uptimeMillis);
7     }

 1  /**
 2      * Run the message queue in this thread. Be sure to call
 3      * {@link #quit()} to end the loop.
 4      */
 5     public static void loop() {
 6         final Looper me = myLooper();
 7         if (me == null) {
 8             throw new RuntimeException("No Looper; Looper.prepare() wasn‘t called on this thread.");
 9         }
10         final MessageQueue queue = me.mQueue;
11 
12         // Make sure the identity of this thread is that of the local process,
13         // and keep track of what that identity token actually is.
14         Binder.clearCallingIdentity();
15         final long ident = Binder.clearCallingIdentity();
16 
17         for (;;) {
18             Message msg = queue.next(); // might block
19             if (msg == null) {
20                 // No message indicates that the message queue is quitting.
21                 return;
22             }
23 
24             // This must be in a local variable, in case a UI event sets the logger
25             Printer logging = me.mLogging;
26             if (logging != null) {
27                 logging.println(">>>>> Dispatching to " + msg.target + " " +
28                         msg.callback + ": " + msg.what);
29             }
30 
31             msg.target.dispatchMessage(msg);
32 
33             if (logging != null) {
34                 logging.println("<<<<< Finished to " + msg.target + " " + msg.callback);
35             }
36 
37             // Make sure that during the course of dispatching the
38             // identity of the thread wasn‘t corrupted.
39             final long newIdent = Binder.clearCallingIdentity();
40             if (ident != newIdent) {
41                 Log.wtf(TAG, "Thread identity changed from 0x"
42                         + Long.toHexString(ident) + " to 0x"
43                         + Long.toHexString(newIdent) + " while dispatching to "
44                         + msg.target.getClass().getName() + " "
45                         + msg.callback + " what=" + msg.what);
46             }
47 
48             msg.recycle();
49         }
50     }

1    /*package*/ Handler target;  

1 msg.target = this;

 1 /**
 2      * Handle system messages here.
 3      */
 4     public void dispatchMessage(Message msg) {
 5         if (msg.callback != null) {
 6             handleCallback(msg);
 7         } else {
 8             if (mCallback != null) {
 9                 if (mCallback.handleMessage(msg)) {
10                     return;
11                 }
12             }
13             handleMessage(msg);
14         }
15     }

1 /**
2      * Subclasses must implement this to receive messages.
3      */
4     public void handleMessage(Message msg) {
5     }