1b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri/* 2b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * Copyright (C) 2017 The Android Open Source Project 3b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * 4b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * Licensed under the Apache License, Version 2.0 (the "License"); 5b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * you may not use this file except in compliance with the License. 6b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * You may obtain a copy of the License at 7b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * 8b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * http://www.apache.org/licenses/LICENSE-2.0 9b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * 10b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * Unless required by applicable law or agreed to in writing, software 11b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * distributed under the License is distributed on an "AS IS" BASIS, 12b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * See the License for the specific language governing permissions and 14b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * limitations under the License. 15b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri */ 16080b054bddee55428943b821c99887543d1fd290Seigo Nonakapackage android.provider; 17b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri 18b0812a30499376e09e2deb5995e998c629f24985Clara Bayarriimport android.annotation.NonNull; 193c4be77db95ea716889568bde853be082e764da9Clara Bayarriimport android.util.Base64; 20b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri 21b0812a30499376e09e2deb5995e998c629f24985Clara Bayarriimport com.android.internal.util.Preconditions; 22b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri 233c4be77db95ea716889568bde853be082e764da9Clara Bayarriimport java.util.ArrayList; 243c4be77db95ea716889568bde853be082e764da9Clara Bayarriimport java.util.Collections; 253c4be77db95ea716889568bde853be082e764da9Clara Bayarriimport java.util.List; 263c4be77db95ea716889568bde853be082e764da9Clara Bayarri 27b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri/** 28b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * Information about a font request that may be sent to a Font Provider. 29b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri */ 30080b054bddee55428943b821c99887543d1fd290Seigo Nonakapublic final class FontRequest { 31b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri private final String mProviderAuthority; 323c4be77db95ea716889568bde853be082e764da9Clara Bayarri private final String mProviderPackage; 33b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri private final String mQuery; 343c4be77db95ea716889568bde853be082e764da9Clara Bayarri private final List<List<byte[]>> mCertificates; 353c4be77db95ea716889568bde853be082e764da9Clara Bayarri 36daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka // Used for key of the cache. 37daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka private final String mIdentifier; 38daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka 393c4be77db95ea716889568bde853be082e764da9Clara Bayarri /** 403c4be77db95ea716889568bde853be082e764da9Clara Bayarri * @param providerAuthority The authority of the Font Provider to be used for the request. This 413c4be77db95ea716889568bde853be082e764da9Clara Bayarri * should be a system installed app. 423c4be77db95ea716889568bde853be082e764da9Clara Bayarri * @param providerPackage The package for the Font Provider to be used for the request. This is 433c4be77db95ea716889568bde853be082e764da9Clara Bayarri * used to verify the identity of the provider. 443c4be77db95ea716889568bde853be082e764da9Clara Bayarri * @param query The query to be sent over to the provider. Refer to your font provider's 453c4be77db95ea716889568bde853be082e764da9Clara Bayarri * documentation on the format of this string. 463c4be77db95ea716889568bde853be082e764da9Clara Bayarri */ 473c4be77db95ea716889568bde853be082e764da9Clara Bayarri public FontRequest(@NonNull String providerAuthority, @NonNull String providerPackage, 483c4be77db95ea716889568bde853be082e764da9Clara Bayarri @NonNull String query) { 493c4be77db95ea716889568bde853be082e764da9Clara Bayarri mProviderAuthority = Preconditions.checkNotNull(providerAuthority); 503c4be77db95ea716889568bde853be082e764da9Clara Bayarri mQuery = Preconditions.checkNotNull(query); 513c4be77db95ea716889568bde853be082e764da9Clara Bayarri mProviderPackage = Preconditions.checkNotNull(providerPackage); 523c4be77db95ea716889568bde853be082e764da9Clara Bayarri mCertificates = Collections.emptyList(); 53daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka mIdentifier = new StringBuilder(mProviderAuthority).append("-").append(mProviderPackage) 54daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka .append("-").append(mQuery).toString(); 553c4be77db95ea716889568bde853be082e764da9Clara Bayarri } 56b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri 57b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri /** 58b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * @param providerAuthority The authority of the Font Provider to be used for the request. 59b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * @param query The query to be sent over to the provider. Refer to your font provider's 603c4be77db95ea716889568bde853be082e764da9Clara Bayarri * documentation on the format of this string. 613c4be77db95ea716889568bde853be082e764da9Clara Bayarri * @param providerPackage The package for the Font Provider to be used for the request. This is 623c4be77db95ea716889568bde853be082e764da9Clara Bayarri * used to verify the identity of the provider. 633c4be77db95ea716889568bde853be082e764da9Clara Bayarri * @param certificates The list of sets of hashes for the certificates the provider should be 643c4be77db95ea716889568bde853be082e764da9Clara Bayarri * signed with. This is used to verify the identity of the provider. Each set in the 653c4be77db95ea716889568bde853be082e764da9Clara Bayarri * list represents one collection of signature hashes. Refer to your font provider's 663c4be77db95ea716889568bde853be082e764da9Clara Bayarri * documentation for these values. 67b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri */ 683c4be77db95ea716889568bde853be082e764da9Clara Bayarri public FontRequest(@NonNull String providerAuthority, @NonNull String providerPackage, 693c4be77db95ea716889568bde853be082e764da9Clara Bayarri @NonNull String query, @NonNull List<List<byte[]>> certificates) { 70b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri mProviderAuthority = Preconditions.checkNotNull(providerAuthority); 713c4be77db95ea716889568bde853be082e764da9Clara Bayarri mProviderPackage = Preconditions.checkNotNull(providerPackage); 72b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri mQuery = Preconditions.checkNotNull(query); 733c4be77db95ea716889568bde853be082e764da9Clara Bayarri mCertificates = Preconditions.checkNotNull(certificates); 74daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka mIdentifier = new StringBuilder(mProviderAuthority).append("-").append(mProviderPackage) 75daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka .append("-").append(mQuery).toString(); 76b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri } 77b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri 78b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri /** 79b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * Returns the selected font provider's authority. This tells the system what font provider 80b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * it should request the font from. 81b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri */ 82b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri public String getProviderAuthority() { 83b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri return mProviderAuthority; 84b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri } 85b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri 86b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri /** 873c4be77db95ea716889568bde853be082e764da9Clara Bayarri * Returns the selected font provider's package. This helps the system verify that the provider 883c4be77db95ea716889568bde853be082e764da9Clara Bayarri * identified by the given authority is the one requested. 893c4be77db95ea716889568bde853be082e764da9Clara Bayarri */ 903c4be77db95ea716889568bde853be082e764da9Clara Bayarri public String getProviderPackage() { 913c4be77db95ea716889568bde853be082e764da9Clara Bayarri return mProviderPackage; 923c4be77db95ea716889568bde853be082e764da9Clara Bayarri } 933c4be77db95ea716889568bde853be082e764da9Clara Bayarri 943c4be77db95ea716889568bde853be082e764da9Clara Bayarri /** 95b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * Returns the query string. Refer to your font provider's documentation on the format of this 96b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri * string. 97b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri */ 98b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri public String getQuery() { 99b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri return mQuery; 100b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri } 101b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri 1023c4be77db95ea716889568bde853be082e764da9Clara Bayarri /** 1033c4be77db95ea716889568bde853be082e764da9Clara Bayarri * Returns the list of certificate sets given for this provider. This helps the system verify 1043c4be77db95ea716889568bde853be082e764da9Clara Bayarri * that the provider identified by the given authority is the one requested. 1053c4be77db95ea716889568bde853be082e764da9Clara Bayarri */ 1063c4be77db95ea716889568bde853be082e764da9Clara Bayarri public List<List<byte[]>> getCertificates() { 1073c4be77db95ea716889568bde853be082e764da9Clara Bayarri return mCertificates; 1083c4be77db95ea716889568bde853be082e764da9Clara Bayarri } 1093c4be77db95ea716889568bde853be082e764da9Clara Bayarri 110daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka /** @hide */ 111daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka public String getIdentifier() { 112daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka return mIdentifier; 113daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka } 114daa8dfc690c4755510ccc15da5ed5bbdd9731fa4Seigo Nonaka 115b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri @Override 116b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri public String toString() { 1173c4be77db95ea716889568bde853be082e764da9Clara Bayarri StringBuilder builder = new StringBuilder(); 1183c4be77db95ea716889568bde853be082e764da9Clara Bayarri builder.append("FontRequest {" 119b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri + "mProviderAuthority: " + mProviderAuthority 1203c4be77db95ea716889568bde853be082e764da9Clara Bayarri + ", mProviderPackage: " + mProviderPackage 121b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri + ", mQuery: " + mQuery 1223c4be77db95ea716889568bde853be082e764da9Clara Bayarri + ", mCertificates:"); 1233c4be77db95ea716889568bde853be082e764da9Clara Bayarri for (int i = 0; i < mCertificates.size(); i++) { 1243c4be77db95ea716889568bde853be082e764da9Clara Bayarri builder.append(" ["); 1253c4be77db95ea716889568bde853be082e764da9Clara Bayarri List<byte[]> set = mCertificates.get(i); 1263c4be77db95ea716889568bde853be082e764da9Clara Bayarri for (int j = 0; j < set.size(); j++) { 1273c4be77db95ea716889568bde853be082e764da9Clara Bayarri builder.append(" \""); 1283c4be77db95ea716889568bde853be082e764da9Clara Bayarri byte[] array = set.get(j); 1293c4be77db95ea716889568bde853be082e764da9Clara Bayarri builder.append(Base64.encodeToString(array, Base64.DEFAULT)); 1303c4be77db95ea716889568bde853be082e764da9Clara Bayarri builder.append("\""); 1313c4be77db95ea716889568bde853be082e764da9Clara Bayarri } 1323c4be77db95ea716889568bde853be082e764da9Clara Bayarri builder.append(" ]"); 1333c4be77db95ea716889568bde853be082e764da9Clara Bayarri } 1343c4be77db95ea716889568bde853be082e764da9Clara Bayarri builder.append("}"); 1353c4be77db95ea716889568bde853be082e764da9Clara Bayarri return builder.toString(); 136b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri } 137b0812a30499376e09e2deb5995e998c629f24985Clara Bayarri} 138