Merge "Temporarily re-add methods and classes removed in ag/1420175." into sc-dev am: e78d13af99 (06eae45a) · Commits · e / os / android_frameworks_base

apex/appsearch/framework/Android.bp

+2 −1

Original line number	Diff line number	Diff line
		@@ -36,6 +36,7 @@ java_sdk_library {
		srcs: [":framework-appsearch-sources"],
		sdk_version: "core_platform", // TODO(b/146218515) should be module_current
		impl_only_libs: ["framework-minus-apex"], // TODO(b/146218515) should be removed
		libs: ["unsupportedappusage"], // TODO(b/181887768) should be removed
		defaults: ["framework-module-defaults"],
		permitted_packages: ["android.app.appsearch"],
		aidl: {

apex/appsearch/framework/java/android/app/appsearch/AppSearchSession.java

+27 −0

Original line number	Diff line number	Diff line
		@@ -21,6 +21,7 @@ import android.annotation.NonNull;
		import android.annotation.UserIdInt;
		import android.app.appsearch.exceptions.AppSearchException;
		import android.app.appsearch.util.SchemaMigrationUtil;
		import android.compat.annotation.UnsupportedAppUsage;
		import android.os.Bundle;
		import android.os.RemoteException;
		import android.os.SystemClock;
		@@ -294,6 +295,19 @@ public final class AppSearchSession implements Closeable {
		}
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		public void getByUri(
		@NonNull GetByUriRequest request,
		@NonNull @CallbackExecutor Executor executor,
		@NonNull BatchResultCallback<String, GenericDocument> callback) {
		getByDocumentId(request.toGetByDocumentIdRequest(), executor, callback);
		}

		/**
		* Gets {@link GenericDocument} objects by document IDs in a namespace from the {@link
		* AppSearchSession} database.
		@@ -488,6 +502,19 @@ public final class AppSearchSession implements Closeable {
		}
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		public void remove(
		@NonNull RemoveByUriRequest request,
		@NonNull @CallbackExecutor Executor executor,
		@NonNull BatchResultCallback<String, Void> callback) {
		remove(request.toRemoveByDocumentIdRequest(), executor, callback);
		}

		/**
		* Removes {@link GenericDocument} objects by document IDs in a namespace from the {@link
		* AppSearchSession} database.

apex/appsearch/framework/java/external/android/app/appsearch/AppSearchSchema.java

+38 −0

Original line number	Diff line number	Diff line
		@@ -21,6 +21,7 @@ import android.annotation.NonNull;
		import android.annotation.Nullable;
		import android.app.appsearch.exceptions.IllegalSchemaException;
		import android.app.appsearch.util.BundleUtil;
		import android.compat.annotation.UnsupportedAppUsage;
		import android.os.Bundle;
		import android.util.ArraySet;

		@@ -746,6 +747,31 @@ public final class AppSearchSchema {
		mBundle.putString(SCHEMA_TYPE_FIELD, schemaType);
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		public Builder(@NonNull String propertyName) {
		mBundle.putString(NAME_FIELD, propertyName);
		mBundle.putInt(DATA_TYPE_FIELD, DATA_TYPE_DOCUMENT);
		mBundle.putInt(CARDINALITY_FIELD, CARDINALITY_OPTIONAL);
		mBundle.putBoolean(INDEX_NESTED_PROPERTIES_FIELD, false);
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		@NonNull
		public Builder setSchemaType(@NonNull String schemaType) {
		mBundle.putString(SCHEMA_TYPE_FIELD, schemaType);
		return this;
		}

		/**
		* The cardinality of the property (whether it is optional, required or repeated).
		*
		@@ -777,6 +803,18 @@ public final class AppSearchSchema {
		return this;
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		@NonNull
		public DocumentPropertyConfig.Builder setIndexNestedProperties(
		boolean indexNestedProperties) {
		return setShouldIndexNestedProperties(indexNestedProperties);
		}

		/**
		* Constructs a new {@link PropertyConfig} from the contents of this builder.
		*

apex/appsearch/framework/java/external/android/app/appsearch/GenericDocument.java

+12 −0

Original line number	Diff line number	Diff line
		@@ -22,6 +22,7 @@ import android.annotation.NonNull;
		import android.annotation.Nullable;
		import android.annotation.SuppressLint;
		import android.app.appsearch.util.BundleUtil;
		import android.compat.annotation.UnsupportedAppUsage;
		import android.os.Bundle;
		import android.os.Parcelable;
		import android.util.Log;
		@@ -137,6 +138,17 @@ public class GenericDocument {
		return mBundle;
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		@NonNull
		public String getUri() {
		return getId();
		}

		/** Returns the unique identifier of the {@link GenericDocument}. */
		@NonNull
		public String getId() {

apex/appsearch/framework/java/external/android/app/appsearch/GetByUriRequest.java

0 → 100644

+200 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright 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 android.app.appsearch;

		import android.annotation.NonNull;
		import android.compat.annotation.UnsupportedAppUsage;
		import android.util.ArrayMap;
		import android.util.ArraySet;

		import com.android.internal.util.Preconditions;

		import java.util.ArrayList;
		import java.util.Arrays;
		import java.util.Collection;
		import java.util.Collections;
		import java.util.List;
		import java.util.Map;
		import java.util.Objects;
		import java.util.Set;

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		public final class GetByUriRequest {
		/**
		* Schema type to be used in {@link GetByUriRequest.Builder#addProjection} to apply property
		* paths to all results, excepting any types that have had their own, specific property paths
		* set.
		*/
		public static final String PROJECTION_SCHEMA_TYPE_WILDCARD = "*";

		private final String mNamespace;
		private final Set<String> mIds;
		private final Map<String, List<String>> mTypePropertyPathsMap;

		GetByUriRequest(
		@NonNull String namespace,
		@NonNull Set<String> ids,
		@NonNull Map<String, List<String>> typePropertyPathsMap) {
		mNamespace = Objects.requireNonNull(namespace);
		mIds = Objects.requireNonNull(ids);
		mTypePropertyPathsMap = Objects.requireNonNull(typePropertyPathsMap);
		}

		/** Returns the namespace attached to the request. */
		@NonNull
		public String getNamespace() {
		return mNamespace;
		}

		/** Returns the set of document IDs attached to the request. */
		@NonNull
		public Set<String> getUris() {
		return Collections.unmodifiableSet(mIds);
		}

		/**
		* Returns a map from schema type to property paths to be used for projection.
		*
		* <p>If the map is empty, then all properties will be retrieved for all results.
		*
		* <p>Calling this function repeatedly is inefficient. Prefer to retain the Map returned by this
		* function, rather than calling it multiple times.
		*/
		@NonNull
		public Map<String, List<String>> getProjections() {
		Map<String, List<String>> copy = new ArrayMap<>();
		for (Map.Entry<String, List<String>> entry : mTypePropertyPathsMap.entrySet()) {
		copy.put(entry.getKey(), new ArrayList<>(entry.getValue()));
		}
		return copy;
		}

		/**
		* Returns a map from schema type to property paths to be used for projection.
		*
		* <p>If the map is empty, then all properties will be retrieved for all results.
		*
		* <p>A more efficient version of {@link #getProjections}, but it returns a modifiable map. This
		* is not meant to be unhidden and should only be used by internal classes.
		*
		* @hide
		*/
		@NonNull
		public Map<String, List<String>> getProjectionsInternal() {
		return mTypePropertyPathsMap;
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@NonNull
		public GetByDocumentIdRequest toGetByDocumentIdRequest() {
		GetByDocumentIdRequest.Builder builder =
		new GetByDocumentIdRequest.Builder(mNamespace).addIds(mIds);
		for (Map.Entry<String, List<String>> projection : mTypePropertyPathsMap.entrySet()) {
		builder.addProjection(projection.getKey(), projection.getValue());
		}
		return builder.build();
		}

		/**
		* Builder for {@link GetByUriRequest} objects.
		*
		* <p>Once {@link #build} is called, the instance can no longer be used.
		*/
		public static final class Builder {
		private final String mNamespace;
		private final Set<String> mIds = new ArraySet<>();
		private final Map<String, List<String>> mProjectionTypePropertyPaths = new ArrayMap<>();
		private boolean mBuilt = false;

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		public Builder(@NonNull String namespace) {
		mNamespace = Objects.requireNonNull(namespace);
		}

		/**
		* Adds one or more document IDs to the request.
		*
		* @throws IllegalStateException if the builder has already been used.
		*/
		@NonNull
		public Builder addUris(@NonNull String... ids) {
		Objects.requireNonNull(ids);
		return addUris(Arrays.asList(ids));
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		@NonNull
		public Builder addUris(@NonNull Collection<String> ids) {
		Preconditions.checkState(!mBuilt, "Builder has already been used");
		Objects.requireNonNull(ids);
		mIds.addAll(ids);
		return this;
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		@NonNull
		public Builder addProjection(
		@NonNull String schemaType, @NonNull Collection<String> propertyPaths) {
		Preconditions.checkState(!mBuilt, "Builder has already been used");
		Objects.requireNonNull(schemaType);
		Objects.requireNonNull(propertyPaths);
		List<String> propertyPathsList = new ArrayList<>(propertyPaths.size());
		for (String propertyPath : propertyPaths) {
		Objects.requireNonNull(propertyPath);
		propertyPathsList.add(propertyPath);
		}
		mProjectionTypePropertyPaths.put(schemaType, propertyPathsList);
		return this;
		}

		/**
		* @deprecated TODO(b/181887768): Exists for dogfood transition; must be removed.
		* @hide
		*/
		@Deprecated
		@UnsupportedAppUsage
		@NonNull
		public GetByUriRequest build() {
		Preconditions.checkState(!mBuilt, "Builder has already been used");
		mBuilt = true;
		return new GetByUriRequest(mNamespace, mIds, mProjectionTypePropertyPaths);
		}
		}
		}