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.services; 18 19 import android.app.Service; 20 import android.content.res.Configuration; 21 22 import androidx.annotation.CheckResult; 23 24 import com.android.eventlib.Event; 25 import com.android.eventlib.EventLogger; 26 import com.android.eventlib.EventLogsQuery; 27 import com.android.queryable.info.ServiceInfo; 28 import com.android.queryable.queries.ServiceQuery; 29 import com.android.queryable.queries.ServiceQueryHelper; 30 31 /** 32 * Event logged when {@link Service#onConfigurationChanged(Configuration)} 33 */ 34 public class ServiceConfigurationChangedEvent extends Event { 35 36 private static final long serialVersionUID = 1; 37 38 /** Begins a query for {@link ServiceConfigurationChangedEvent} events. */ 39 public static ServiceConfigurationChangedEvent.ServiceConfigurationChangedEventQuery queryPackage(String packageName)40 queryPackage(String packageName) { 41 return new ServiceConfigurationChangedEvent 42 .ServiceConfigurationChangedEventQuery(packageName); 43 } 44 45 /** {@link EventLogsQuery} for {@link ServiceConfigurationChangedEvent}. */ 46 public static final class ServiceConfigurationChangedEventQuery 47 extends EventLogsQuery<ServiceConfigurationChangedEvent, 48 ServiceConfigurationChangedEvent.ServiceConfigurationChangedEventQuery> { 49 50 private static final long serialVersionUID = 1; 51 52 ServiceQueryHelper<ServiceConfigurationChangedEvent.ServiceConfigurationChangedEventQuery> 53 mService = new ServiceQueryHelper<>(this); 54 ServiceConfigurationChangedEventQuery(String packageName)55 private ServiceConfigurationChangedEventQuery(String packageName) { 56 super(ServiceConfigurationChangedEvent.class, packageName); 57 } 58 59 /** Query {@link Service}. */ 60 @CheckResult whereService()61 public ServiceQuery<ServiceConfigurationChangedEventQuery> whereService() { 62 return mService; 63 } 64 65 @Override filter(ServiceConfigurationChangedEvent event)66 protected boolean filter(ServiceConfigurationChangedEvent event) { 67 if (!mService.matches(event.mService)) { 68 return false; 69 } 70 return true; 71 } 72 73 @Override describeQuery(String fieldName)74 public String describeQuery(String fieldName) { 75 return toStringBuilder(ServiceConfigurationChangedEvent.class, this) 76 .field("service", mService) 77 .toString(); 78 } 79 } 80 81 82 /** Begins logging a {@link ServiceConfigurationChangedEvent}. */ logger( Service service, String serviceName, Configuration configuration)83 public static ServiceConfigurationChangedEvent.ServiceConfigurationChangedEventLogger logger( 84 Service service, String serviceName, 85 Configuration configuration) { 86 return new ServiceConfigurationChangedEvent.ServiceConfigurationChangedEventLogger( 87 service, serviceName, configuration); 88 } 89 90 /** {@link EventLogger} for {@link ServiceConfigurationChangedEvent}. */ 91 public static final class ServiceConfigurationChangedEventLogger extends 92 EventLogger<ServiceConfigurationChangedEvent> { 93 ServiceConfigurationChangedEventLogger(Service service, String serviceName, Configuration configuration)94 private ServiceConfigurationChangedEventLogger(Service service, 95 String serviceName, 96 Configuration configuration) { 97 super(service, new ServiceConfigurationChangedEvent()); 98 mEvent.mConfiguration = configuration; 99 setService(serviceName); 100 } 101 102 /** Sets the {@link Service} which received this event. */ setService( String serviceName)103 public ServiceConfigurationChangedEvent.ServiceConfigurationChangedEventLogger setService( 104 String serviceName) { 105 mEvent.mService = ServiceInfo.builder() 106 .serviceClass(serviceName) 107 .build(); 108 return this; 109 } 110 111 /** Sets the {@link Configuration} */ 112 public ServiceConfigurationChangedEvent.ServiceConfigurationChangedEventLogger setConfiguration(Configuration configuration)113 setConfiguration(Configuration configuration) { 114 mEvent.mConfiguration = configuration; 115 return this; 116 } 117 118 } 119 120 protected ServiceInfo mService; 121 protected Configuration mConfiguration; 122 123 /** 124 * The {@link Configuration} passed into {@link Service#onConfigurationChanged(Configuration)}. 125 */ configuration()126 public Configuration configuration() { 127 return mConfiguration; 128 } 129 130 /** Information about the {@link Service} which received the configuration. */ service()131 public ServiceInfo service() { 132 return mService; 133 } 134 135 @Override toString()136 public String toString() { 137 return "ServiceConfigurationChangedEvent{" 138 + " configuration=" + configuration() 139 + ", service=" + mService 140 + ", packageName='" + mPackageName + "'" 141 + ", timestamp=" + mTimestamp 142 + "}"; 143 } 144 } 145