Merge "Minimal skeleton for location time zone providers"

4 files changed, 226 insertions, 0 deletions

diff --git a/location/java/com/android/internal/location/timezone/ILocationTimeZoneProvider.aidl b/location/java/com/android/internal/location/timezone/ILocationTimeZoneProvider.aidl
new file mode 100644
index 000000000000..16aa84859f6e
--- /dev/null
+++ b/location/java/com/android/internal/location/timezone/ILocationTimeZoneProvider.aidl
@@ -0,0 +1,33 @@
+/*
+ * Copyright (C) 2020 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.internal.location.timezone;
+
+import com.android.internal.location.timezone.ILocationTimeZoneProviderManager;
+import com.android.internal.location.timezone.LocationTimeZoneProviderRequest;
+
+/**
+ * Binder interface for location time zone provider implementations. Do not implement this
+ * directly, extend {@link com.android.location.timezone.provider.LocationTimeZoneProviderBase}
+ * instead.
+ * @hide
+ */
+interface ILocationTimeZoneProvider {
+
+    oneway void setLocationTimeZoneProviderManager(in ILocationTimeZoneProviderManager manager);
+
+    oneway void setRequest(in LocationTimeZoneProviderRequest request);
+}
diff --git a/location/java/com/android/internal/location/timezone/ILocationTimeZoneProviderManager.aidl b/location/java/com/android/internal/location/timezone/ILocationTimeZoneProviderManager.aidl
new file mode 100644
index 000000000000..f89a64fc586c
--- /dev/null
+++ b/location/java/com/android/internal/location/timezone/ILocationTimeZoneProviderManager.aidl
@@ -0,0 +1,27 @@
+/*
+ * Copyright (C) 2020 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.internal.location.timezone;
+
+import android.location.timezone.LocationTimeZoneEvent;
+
+/**
+ * Binder interface for the manager of location time zone provider implementations.
+ * @hide
+ */
+interface ILocationTimeZoneProviderManager {
+    void onLocationTimeZoneEvent(in LocationTimeZoneEvent locationTimeZoneEvent);
+}
diff --git a/location/java/com/android/internal/location/timezone/LocationTimeZoneProviderRequest.aidl b/location/java/com/android/internal/location/timezone/LocationTimeZoneProviderRequest.aidl
new file mode 100644
index 000000000000..bb59457094f4
--- /dev/null
+++ b/location/java/com/android/internal/location/timezone/LocationTimeZoneProviderRequest.aidl
@@ -0,0 +1,19 @@
+/*
+ * Copyright (C) 2020 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.internal.location.timezone;
+
+parcelable LocationTimeZoneProviderRequest;
diff --git a/location/java/com/android/internal/location/timezone/LocationTimeZoneProviderRequest.java b/location/java/com/android/internal/location/timezone/LocationTimeZoneProviderRequest.java
new file mode 100644
index 000000000000..8f3b5d7781cf
--- /dev/null
+++ b/location/java/com/android/internal/location/timezone/LocationTimeZoneProviderRequest.java
@@ -0,0 +1,147 @@
+/*
+ * Copyright (C) 2020 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.internal.location.timezone;
+
+import android.annotation.NonNull;
+import android.os.Parcel;
+import android.os.Parcelable;
+import android.os.WorkSource;
+
+import java.util.Objects;
+
+/**
+ * An request passed to a location time zone provider to configure it.
+ *
+ * @hide
+ */
+public final class LocationTimeZoneProviderRequest implements Parcelable {
+
+    public static final Creator<LocationTimeZoneProviderRequest> CREATOR =
+            new Creator<LocationTimeZoneProviderRequest>() {
+                @Override
+                public LocationTimeZoneProviderRequest createFromParcel(Parcel in) {
+                    return LocationTimeZoneProviderRequest.createFromParcel(in);
+                }
+
+                @Override
+                public LocationTimeZoneProviderRequest[] newArray(int size) {
+                    return new LocationTimeZoneProviderRequest[size];
+                }
+            };
+
+    /** Location time zone reporting is requested (true) */
+    private final boolean mReportLocationTimeZone;
+    /** The WorkSource for power attribution. */
+    @NonNull private final WorkSource mWorkSource;
+
+    private LocationTimeZoneProviderRequest(boolean reportLocationTimeZone, WorkSource workSource) {
+        mReportLocationTimeZone = reportLocationTimeZone;
+        mWorkSource = Objects.requireNonNull(workSource);
+    }
+
+    public boolean getReportLocationTimeZone() {
+        return mReportLocationTimeZone;
+    }
+
+    @NonNull
+    public WorkSource getWorkSource() {
+        return mWorkSource;
+    }
+
+    @Override
+    public int describeContents() {
+        return 0;
+    }
+
+    @Override
+    public void writeToParcel(Parcel parcel, int flags) {
+        parcel.writeInt(mReportLocationTimeZone ? 1 : 0);
+        parcel.writeParcelable(mWorkSource, 0);
+    }
+
+    static LocationTimeZoneProviderRequest createFromParcel(Parcel in) {
+        ClassLoader classLoader = LocationTimeZoneProviderRequest.class.getClassLoader();
+        return new Builder()
+                .setReportLocationTimeZone(in.readInt() == 1)
+                .setWorkSource(in.readParcelable(classLoader))
+                .build();
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        LocationTimeZoneProviderRequest that = (LocationTimeZoneProviderRequest) o;
+        return mReportLocationTimeZone == that.mReportLocationTimeZone
+                && mWorkSource.equals(that.mWorkSource);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(mReportLocationTimeZone, mWorkSource);
+    }
+
+    @Override
+    public String toString() {
+        StringBuilder s = new StringBuilder();
+        s.append("TimeZoneProviderRequest[");
+        if (mReportLocationTimeZone) {
+            s.append("ON");
+        } else {
+            s.append("OFF");
+        }
+        s.append(",");
+        s.append("workSource=").append(mWorkSource);
+        s.append(']');
+        return s.toString();
+    }
+
+    /** @hide */
+    public static final class Builder {
+
+        private boolean mReportLocationTimeZone;
+        private WorkSource mWorkSource;
+
+        /**
+         * Sets the property that enables / disables the provider. This is set to {@code false} by
+         * default.
+         */
+        public Builder setReportLocationTimeZone(boolean reportLocationTimeZone) {
+            mReportLocationTimeZone = reportLocationTimeZone;
+            return this;
+        }
+
+        /**
+         * Sets the {@link WorkSource} to attribute the power usage to.
+         */
+        public Builder setWorkSource(@NonNull WorkSource workSource) {
+            mWorkSource = Objects.requireNonNull(workSource);
+            return this;
+        }
+
+        /** Builds the {@link LocationTimeZoneProviderRequest} instance. */
+        @NonNull
+        public LocationTimeZoneProviderRequest build() {
+            return new LocationTimeZoneProviderRequest(this.mReportLocationTimeZone,
+                    this.mWorkSource);
+        }
+    }
+}