ServiceInfo.java revision 365038217553e192d011861422715f8a87b30618
1/* 2 * Copyright (C) 2007 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 17package android.content.pm; 18 19import android.os.Parcel; 20import android.os.Parcelable; 21import android.util.Printer; 22 23/** 24 * Information you can retrieve about a particular application 25 * service. This corresponds to information collected from the 26 * AndroidManifest.xml's <service> tags. 27 */ 28public class ServiceInfo extends ComponentInfo 29 implements Parcelable { 30 /** 31 * Optional name of a permission required to be able to access this 32 * Service. From the "permission" attribute. 33 */ 34 public String permission; 35 36 /** 37 * Bit in {@link #flags}: If set, the service will automatically be 38 * stopped by the system if the user removes a task that is rooted 39 * in one of the application's activities. Set from the 40 * {@link android.R.attr#stopWithTask} attribute. 41 */ 42 public static final int FLAG_STOP_WITH_TASK = 0x0001; 43 44 /** 45 * Bit in {@link #flags}: If set, the service will run in its own 46 * isolated process. Set from the 47 * {@link android.R.attr#isolatedProcess} attribute. 48 */ 49 public static final int FLAG_ISOLATED_PROCESS = 0x0002; 50 51 /** 52 * Bit in {@link #flags}: If set, 53 * {@link android.app.Service#onProvideAssistData(android.os.Bundle)} will 54 * be called on the service when it is running in the foreground. Set from 55 * the android.R.attr#provideAssistData attribute. 56 */ 57 public static final int FLAG_PROVIDE_ASSIST_DATA = 0x0004; 58 59 /** 60 * Bit in {@link #flags}: If set, a single instance of the service will 61 * run for all users on the device. Set from the 62 * {@link android.R.attr#singleUser} attribute. 63 */ 64 public static final int FLAG_SINGLE_USER = 0x40000000; 65 66 /** 67 * Options that have been set in the service declaration in the 68 * manifest. 69 * These include: 70 * {@link #FLAG_STOP_WITH_TASK}, {@link #FLAG_ISOLATED_PROCESS}, 71 * {@link #FLAG_SINGLE_USER}. 72 */ 73 public int flags; 74 75 public ServiceInfo() { 76 } 77 78 public ServiceInfo(ServiceInfo orig) { 79 super(orig); 80 permission = orig.permission; 81 flags = orig.flags; 82 } 83 84 public void dump(Printer pw, String prefix) { 85 super.dumpFront(pw, prefix); 86 pw.println(prefix + "permission=" + permission); 87 pw.println(prefix + "flags=0x" + Integer.toHexString(flags)); 88 } 89 90 public String toString() { 91 return "ServiceInfo{" 92 + Integer.toHexString(System.identityHashCode(this)) 93 + " " + name + "}"; 94 } 95 96 public int describeContents() { 97 return 0; 98 } 99 100 public void writeToParcel(Parcel dest, int parcelableFlags) { 101 super.writeToParcel(dest, parcelableFlags); 102 dest.writeString(permission); 103 dest.writeInt(flags); 104 } 105 106 public static final Creator<ServiceInfo> CREATOR = 107 new Creator<ServiceInfo>() { 108 public ServiceInfo createFromParcel(Parcel source) { 109 return new ServiceInfo(source); 110 } 111 public ServiceInfo[] newArray(int size) { 112 return new ServiceInfo[size]; 113 } 114 }; 115 116 private ServiceInfo(Parcel source) { 117 super(source); 118 permission = source.readString(); 119 flags = source.readInt(); 120 } 121} 122