1 /*
2  * Copyright (C) 2013 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package com.android.internal.os;
18 
19 import android.os.Handler;
20 import android.os.HandlerExecutor;
21 import android.os.HandlerThread;
22 import android.os.Looper;
23 import android.os.Trace;
24 
25 import java.util.concurrent.Executor;
26 
27 /**
28  * Shared singleton background thread for each process.
29  */
30 @android.ravenwood.annotation.RavenwoodKeepWholeClass
31 public final class BackgroundThread extends HandlerThread {
32     private static final long SLOW_DISPATCH_THRESHOLD_MS = 10_000;
33     private static final long SLOW_DELIVERY_THRESHOLD_MS = 30_000;
34     private static BackgroundThread sInstance;
35     private static Handler sHandler;
36     private static HandlerExecutor sHandlerExecutor;
37 
BackgroundThread()38     private BackgroundThread() {
39         super("android.bg", android.os.Process.THREAD_PRIORITY_BACKGROUND);
40     }
41 
ensureThreadLocked()42     private static void ensureThreadLocked() {
43         if (sInstance == null) {
44             sInstance = new BackgroundThread();
45             sInstance.start();
46             final Looper looper = sInstance.getLooper();
47             looper.setTraceTag(Trace.TRACE_TAG_SYSTEM_SERVER);
48             looper.setSlowLogThresholdMs(
49                     SLOW_DISPATCH_THRESHOLD_MS, SLOW_DELIVERY_THRESHOLD_MS);
50             sHandler = new Handler(sInstance.getLooper(), /*callback=*/ null, /* async=*/ false,
51                     /* shared=*/ true);
52             sHandlerExecutor = new HandlerExecutor(sHandler);
53         }
54     }
55 
get()56     public static BackgroundThread get() {
57         synchronized (BackgroundThread.class) {
58             ensureThreadLocked();
59             return sInstance;
60         }
61     }
62 
getHandler()63     public static Handler getHandler() {
64         synchronized (BackgroundThread.class) {
65             ensureThreadLocked();
66             return sHandler;
67         }
68     }
69 
getExecutor()70     public static Executor getExecutor() {
71         synchronized (BackgroundThread.class) {
72             ensureThreadLocked();
73             return sHandlerExecutor;
74         }
75     }
76 }
77