1 /* 2 * Copyright (C) 2021 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.eventlib.events.deviceadminreceivers; 18 19 import android.app.admin.DeviceAdminReceiver; 20 import android.content.Context; 21 import android.content.Intent; 22 23 import androidx.annotation.CheckResult; 24 25 import com.android.eventlib.Event; 26 import com.android.eventlib.EventLogger; 27 import com.android.eventlib.EventLogsQuery; 28 import com.android.queryable.info.DeviceAdminReceiverInfo; 29 import com.android.queryable.queries.DeviceAdminReceiverQuery; 30 import com.android.queryable.queries.DeviceAdminReceiverQueryHelper; 31 import com.android.queryable.queries.IntentQueryHelper; 32 import com.android.queryable.queries.StringQuery; 33 import com.android.queryable.queries.StringQueryHelper; 34 import com.android.queryable.util.SerializableParcelWrapper; 35 36 /** 37 * Event logged when {@link DeviceAdminReceiver#onLockTaskModeEntering(Context, Intent, String)} 38 * is called. 39 */ 40 public final class DeviceAdminLockTaskModeEnteringEvent extends Event { 41 42 private static final long serialVersionUID = 1; 43 44 /** Begins a query for {@link DeviceAdminLockTaskModeEnteringEvent} events. */ queryPackage(String packageName)45 public static DeviceAdminLockTaskModeEnteringEventQuery queryPackage(String packageName) { 46 return new DeviceAdminLockTaskModeEnteringEventQuery(packageName); 47 } 48 49 /** {@link EventLogsQuery} for {@link DeviceAdminLockTaskModeEnteringEvent}. */ 50 public static final class DeviceAdminLockTaskModeEnteringEventQuery 51 extends EventLogsQuery<DeviceAdminLockTaskModeEnteringEvent, 52 DeviceAdminLockTaskModeEnteringEventQuery> { 53 54 private static final long serialVersionUID = 1; 55 56 DeviceAdminReceiverQueryHelper<DeviceAdminLockTaskModeEnteringEventQuery> mDeviceAdminReceiver = 57 new DeviceAdminReceiverQueryHelper<>(this); 58 IntentQueryHelper<DeviceAdminLockTaskModeEnteringEventQuery> mIntent = 59 new IntentQueryHelper<>(this); 60 StringQueryHelper<DeviceAdminLockTaskModeEnteringEventQuery> mPkg = 61 new StringQueryHelper<>(this); 62 DeviceAdminLockTaskModeEnteringEventQuery(String packageName)63 private DeviceAdminLockTaskModeEnteringEventQuery(String packageName) { 64 super(DeviceAdminLockTaskModeEnteringEvent.class, packageName); 65 } 66 67 /** 68 * Queries {@link Intent} passed into 69 * {@link DeviceAdminReceiver#onLockTaskModeEntering(Context, Intent, String)}. 70 */ 71 @CheckResult whereIntent()72 public IntentQueryHelper<DeviceAdminLockTaskModeEnteringEventQuery> whereIntent() { 73 return mIntent; 74 } 75 76 /** Queries {@link DeviceAdminReceiver}. */ 77 @CheckResult whereDeviceAdminReceiver()78 public DeviceAdminReceiverQuery<DeviceAdminLockTaskModeEnteringEventQuery> whereDeviceAdminReceiver() { 79 return mDeviceAdminReceiver; 80 } 81 82 /** Query {@code pkg} passed into 83 * {@link DeviceAdminReceiver#onLockTaskModeEntering(Context, Intent, String)}. 84 */ 85 @CheckResult wherePkg()86 public StringQuery<DeviceAdminLockTaskModeEnteringEventQuery> wherePkg() { 87 return mPkg; 88 } 89 90 @Override filter(DeviceAdminLockTaskModeEnteringEvent event)91 protected boolean filter(DeviceAdminLockTaskModeEnteringEvent event) { 92 if (!mIntent.matches(event.mIntent)) { 93 return false; 94 } 95 if (!mDeviceAdminReceiver.matches(event.mDeviceAdminReceiver)) { 96 return false; 97 } 98 if (!mPkg.matches(event.pkg())) { 99 return false; 100 } 101 return true; 102 } 103 104 @Override describeQuery(String fieldName)105 public String describeQuery(String fieldName) { 106 return toStringBuilder(DeviceAdminLockTaskModeEnteringEvent.class, this) 107 .field("intent", mIntent) 108 .field("deviceAdminReceiver", mDeviceAdminReceiver) 109 .field("pkg", mPkg) 110 .toString(); 111 } 112 } 113 114 /** Begins logging a {@link DeviceAdminLockTaskModeEnteringEvent}. */ logger( DeviceAdminReceiver deviceAdminReceiver, Context context, Intent intent, String pkg)115 public static DeviceAdminLockTaskModeEnteringEventLogger logger( 116 DeviceAdminReceiver deviceAdminReceiver, Context context, Intent intent, String pkg) { 117 return new DeviceAdminLockTaskModeEnteringEventLogger( 118 deviceAdminReceiver, context, intent, pkg); 119 } 120 121 /** {@link EventLogger} for {@link DeviceAdminLockTaskModeEnteringEvent}. */ 122 public static final class DeviceAdminLockTaskModeEnteringEventLogger 123 extends EventLogger<DeviceAdminLockTaskModeEnteringEvent> { DeviceAdminLockTaskModeEnteringEventLogger( DeviceAdminReceiver deviceAdminReceiver, Context context, Intent intent, String pkg)124 private DeviceAdminLockTaskModeEnteringEventLogger( 125 DeviceAdminReceiver deviceAdminReceiver, 126 Context context, Intent intent, String pkg) { 127 super(context, new DeviceAdminLockTaskModeEnteringEvent()); 128 mEvent.mIntent = new SerializableParcelWrapper<>(intent); 129 mEvent.mPkg = pkg; 130 setDeviceAdminReceiver(deviceAdminReceiver); 131 } 132 133 /** Sets the {@link DeviceAdminReceiver} which received this event. */ setDeviceAdminReceiver( DeviceAdminReceiver deviceAdminReceiver)134 public DeviceAdminLockTaskModeEnteringEventLogger setDeviceAdminReceiver( 135 DeviceAdminReceiver deviceAdminReceiver) { 136 mEvent.mDeviceAdminReceiver = new DeviceAdminReceiverInfo(deviceAdminReceiver); 137 return this; 138 } 139 140 /** Sets the {@link DeviceAdminReceiver} which received this event. */ setDeviceAdminReceiver( Class<? extends DeviceAdminReceiver> deviceAdminReceiverClass)141 public DeviceAdminLockTaskModeEnteringEventLogger setDeviceAdminReceiver( 142 Class<? extends DeviceAdminReceiver> deviceAdminReceiverClass) { 143 mEvent.mDeviceAdminReceiver = new DeviceAdminReceiverInfo(deviceAdminReceiverClass); 144 return this; 145 } 146 147 /** Sets the {@link DeviceAdminReceiver} which received this event. */ setDeviceAdminReceiver( String deviceAdminReceiverClassName)148 public DeviceAdminLockTaskModeEnteringEventLogger setDeviceAdminReceiver( 149 String deviceAdminReceiverClassName) { 150 mEvent.mDeviceAdminReceiver = new DeviceAdminReceiverInfo(deviceAdminReceiverClassName); 151 return this; 152 } 153 154 /** Sets the {@link Intent} which was received. */ setIntent(Intent intent)155 public DeviceAdminLockTaskModeEnteringEventLogger setIntent(Intent intent) { 156 mEvent.mIntent = new SerializableParcelWrapper<>(intent); 157 return this; 158 } 159 160 /** Sets the {@code pkg}. */ setPkg(String pkg)161 public DeviceAdminLockTaskModeEnteringEventLogger setPkg(String pkg) { 162 mEvent.mPkg = pkg; 163 return this; 164 } 165 } 166 167 protected SerializableParcelWrapper<Intent> mIntent; 168 protected String mPkg; 169 protected DeviceAdminReceiverInfo mDeviceAdminReceiver; 170 171 /** 172 * The {@link Intent} passed into 173 * {@link DeviceAdminReceiver#onLockTaskModeEntering(Context, Intent, String)}. 174 */ intent()175 public Intent intent() { 176 if (mIntent == null) { 177 return null; 178 } 179 return mIntent.get(); 180 } 181 182 /** 183 * The {@code pkg} passed into 184 * {@link DeviceAdminReceiver#onLockTaskModeEntering(Context, Intent, String)}. 185 */ pkg()186 public String pkg() { 187 return mPkg; 188 } 189 190 /** Information about the {@link DeviceAdminReceiver} which received the intent. */ deviceAdminReceiver()191 public DeviceAdminReceiverInfo deviceAdminReceiver() { 192 return mDeviceAdminReceiver; 193 } 194 195 @Override toString()196 public String toString() { 197 return "DeviceAdminLockTaskModeEnteringEvent{" 198 + " intent=" + intent() 199 + ", pkg=" + mPkg 200 + ", deviceAdminReceiver=" + mDeviceAdminReceiver 201 + ", packageName='" + mPackageName + "'" 202 + ", timestamp=" + mTimestamp 203 + "}"; 204 } 205 } 206