| /* |
| * Copyright (C) 2006 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package com.android.server.am; |
| |
| import android.app.IServiceConnection; |
| import android.app.PendingIntent; |
| import android.content.Context; |
| import android.util.proto.ProtoOutputStream; |
| import android.util.proto.ProtoUtils; |
| |
| import java.io.PrintWriter; |
| |
| /** |
| * Description of a single binding to a service. |
| */ |
| final class ConnectionRecord { |
| final AppBindRecord binding; // The application/service binding. |
| final ActivityRecord activity; // If non-null, the owning activity. |
| final IServiceConnection conn; // The client connection. |
| final int flags; // Binding options. |
| final int clientLabel; // String resource labeling this client. |
| final PendingIntent clientIntent; // How to launch the client. |
| String stringName; // Caching of toString. |
| boolean serviceDead; // Well is it? |
| |
| // Please keep the following two enum list synced. |
| private static int[] BIND_ORIG_ENUMS = new int[] { |
| Context.BIND_AUTO_CREATE, |
| Context.BIND_DEBUG_UNBIND, |
| Context.BIND_NOT_FOREGROUND, |
| Context.BIND_IMPORTANT_BACKGROUND, |
| Context.BIND_ABOVE_CLIENT, |
| Context.BIND_ALLOW_OOM_MANAGEMENT, |
| Context.BIND_WAIVE_PRIORITY, |
| Context.BIND_IMPORTANT, |
| Context.BIND_ADJUST_WITH_ACTIVITY, |
| Context.BIND_FOREGROUND_SERVICE_WHILE_AWAKE, |
| Context.BIND_FOREGROUND_SERVICE, |
| Context.BIND_TREAT_LIKE_ACTIVITY, |
| Context.BIND_VISIBLE, |
| Context.BIND_SHOWING_UI, |
| Context.BIND_NOT_VISIBLE, |
| }; |
| private static int[] BIND_PROTO_ENUMS = new int[] { |
| ConnectionRecordProto.AUTO_CREATE, |
| ConnectionRecordProto.DEBUG_UNBIND, |
| ConnectionRecordProto.NOT_FG, |
| ConnectionRecordProto.IMPORTANT_BG, |
| ConnectionRecordProto.ABOVE_CLIENT, |
| ConnectionRecordProto.ALLOW_OOM_MANAGEMENT, |
| ConnectionRecordProto.WAIVE_PRIORITY, |
| ConnectionRecordProto.IMPORTANT, |
| ConnectionRecordProto.ADJUST_WITH_ACTIVITY, |
| ConnectionRecordProto.FG_SERVICE_WHILE_AWAKE, |
| ConnectionRecordProto.FG_SERVICE, |
| ConnectionRecordProto.TREAT_LIKE_ACTIVITY, |
| ConnectionRecordProto.VISIBLE, |
| ConnectionRecordProto.SHOWING_UI, |
| ConnectionRecordProto.NOT_VISIBLE, |
| }; |
| |
| void dump(PrintWriter pw, String prefix) { |
| pw.println(prefix + "binding=" + binding); |
| if (activity != null) { |
| pw.println(prefix + "activity=" + activity); |
| } |
| pw.println(prefix + "conn=" + conn.asBinder() |
| + " flags=0x" + Integer.toHexString(flags)); |
| } |
| |
| ConnectionRecord(AppBindRecord _binding, ActivityRecord _activity, |
| IServiceConnection _conn, int _flags, |
| int _clientLabel, PendingIntent _clientIntent) { |
| binding = _binding; |
| activity = _activity; |
| conn = _conn; |
| flags = _flags; |
| clientLabel = _clientLabel; |
| clientIntent = _clientIntent; |
| } |
| |
| public String toString() { |
| if (stringName != null) { |
| return stringName; |
| } |
| StringBuilder sb = new StringBuilder(128); |
| sb.append("ConnectionRecord{"); |
| sb.append(Integer.toHexString(System.identityHashCode(this))); |
| sb.append(" u"); |
| sb.append(binding.client.userId); |
| sb.append(' '); |
| if ((flags&Context.BIND_AUTO_CREATE) != 0) { |
| sb.append("CR "); |
| } |
| if ((flags&Context.BIND_DEBUG_UNBIND) != 0) { |
| sb.append("DBG "); |
| } |
| if ((flags&Context.BIND_NOT_FOREGROUND) != 0) { |
| sb.append("!FG "); |
| } |
| if ((flags&Context.BIND_IMPORTANT_BACKGROUND) != 0) { |
| sb.append("IMPB "); |
| } |
| if ((flags&Context.BIND_ABOVE_CLIENT) != 0) { |
| sb.append("ABCLT "); |
| } |
| if ((flags&Context.BIND_ALLOW_OOM_MANAGEMENT) != 0) { |
| sb.append("OOM "); |
| } |
| if ((flags&Context.BIND_WAIVE_PRIORITY) != 0) { |
| sb.append("WPRI "); |
| } |
| if ((flags&Context.BIND_IMPORTANT) != 0) { |
| sb.append("IMP "); |
| } |
| if ((flags&Context.BIND_ADJUST_WITH_ACTIVITY) != 0) { |
| sb.append("WACT "); |
| } |
| if ((flags&Context.BIND_FOREGROUND_SERVICE_WHILE_AWAKE) != 0) { |
| sb.append("FGSA "); |
| } |
| if ((flags&Context.BIND_FOREGROUND_SERVICE) != 0) { |
| sb.append("FGS "); |
| } |
| if ((flags&Context.BIND_TREAT_LIKE_ACTIVITY) != 0) { |
| sb.append("LACT "); |
| } |
| if ((flags&Context.BIND_VISIBLE) != 0) { |
| sb.append("VIS "); |
| } |
| if ((flags&Context.BIND_SHOWING_UI) != 0) { |
| sb.append("UI "); |
| } |
| if ((flags&Context.BIND_NOT_VISIBLE) != 0) { |
| sb.append("!VIS "); |
| } |
| if (serviceDead) { |
| sb.append("DEAD "); |
| } |
| sb.append(binding.service.shortName); |
| sb.append(":@"); |
| sb.append(Integer.toHexString(System.identityHashCode(conn.asBinder()))); |
| sb.append('}'); |
| return stringName = sb.toString(); |
| } |
| |
| public void writeToProto(ProtoOutputStream proto, long fieldId) { |
| if (binding == null) return; // if binding is null, don't write data, something is wrong. |
| long token = proto.start(fieldId); |
| proto.write(ConnectionRecordProto.HEX_HASH, |
| Integer.toHexString(System.identityHashCode(this))); |
| if (binding.client != null) { |
| proto.write(ConnectionRecordProto.USER_ID, binding.client.userId); |
| } |
| ProtoUtils.writeBitWiseFlagsToProtoEnum(proto, ConnectionRecordProto.FLAGS, |
| flags, BIND_ORIG_ENUMS, BIND_PROTO_ENUMS); |
| if (serviceDead) { |
| proto.write(ConnectionRecordProto.FLAGS, ConnectionRecordProto.DEAD); |
| } |
| if (binding.service != null) { |
| proto.write(ConnectionRecordProto.SERVICE_NAME, binding.service.shortName); |
| } |
| proto.end(token); |
| } |
| } |