1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/*
* Copyright (C) 2017 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.provider;
import android.annotation.NonNull;
import android.util.Base64;
import com.android.internal.util.Preconditions;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/**
* Information about a font request that may be sent to a Font Provider.
*/
public final class FontRequest {
private final String mProviderAuthority;
private final String mProviderPackage;
private final String mQuery;
private final List<List<byte[]>> mCertificates;
// Used for key of the cache.
private final String mIdentifier;
/**
* @param providerAuthority The authority of the Font Provider to be used for the request. This
* should be a system installed app.
* @param providerPackage The package for the Font Provider to be used for the request. This is
* used to verify the identity of the provider.
* @param query The query to be sent over to the provider. Refer to your font provider's
* documentation on the format of this string.
*/
public FontRequest(@NonNull String providerAuthority, @NonNull String providerPackage,
@NonNull String query) {
mProviderAuthority = Preconditions.checkNotNull(providerAuthority);
mQuery = Preconditions.checkNotNull(query);
mProviderPackage = Preconditions.checkNotNull(providerPackage);
mCertificates = Collections.emptyList();
mIdentifier = new StringBuilder(mProviderAuthority).append("-").append(mProviderPackage)
.append("-").append(mQuery).toString();
}
/**
* @param providerAuthority The authority of the Font Provider to be used for the request.
* @param query The query to be sent over to the provider. Refer to your font provider's
* documentation on the format of this string.
* @param providerPackage The package for the Font Provider to be used for the request. This is
* used to verify the identity of the provider.
* @param certificates The list of sets of hashes for the certificates the provider should be
* signed with. This is used to verify the identity of the provider. Each set in the
* list represents one collection of signature hashes. Refer to your font provider's
* documentation for these values.
*/
public FontRequest(@NonNull String providerAuthority, @NonNull String providerPackage,
@NonNull String query, @NonNull List<List<byte[]>> certificates) {
mProviderAuthority = Preconditions.checkNotNull(providerAuthority);
mProviderPackage = Preconditions.checkNotNull(providerPackage);
mQuery = Preconditions.checkNotNull(query);
mCertificates = Preconditions.checkNotNull(certificates);
mIdentifier = new StringBuilder(mProviderAuthority).append("-").append(mProviderPackage)
.append("-").append(mQuery).toString();
}
/**
* Returns the selected font provider's authority. This tells the system what font provider
* it should request the font from.
*/
public String getProviderAuthority() {
return mProviderAuthority;
}
/**
* Returns the selected font provider's package. This helps the system verify that the provider
* identified by the given authority is the one requested.
*/
public String getProviderPackage() {
return mProviderPackage;
}
/**
* Returns the query string. Refer to your font provider's documentation on the format of this
* string.
*/
public String getQuery() {
return mQuery;
}
/**
* Returns the list of certificate sets given for this provider. This helps the system verify
* that the provider identified by the given authority is the one requested.
*/
public List<List<byte[]>> getCertificates() {
return mCertificates;
}
/** @hide */
public String getIdentifier() {
return mIdentifier;
}
@Override
public String toString() {
StringBuilder builder = new StringBuilder();
builder.append("FontRequest {"
+ "mProviderAuthority: " + mProviderAuthority
+ ", mProviderPackage: " + mProviderPackage
+ ", mQuery: " + mQuery
+ ", mCertificates:");
for (int i = 0; i < mCertificates.size(); i++) {
builder.append(" [");
List<byte[]> set = mCertificates.get(i);
for (int j = 0; j < set.size(); j++) {
builder.append(" \"");
byte[] array = set.get(j);
builder.append(Base64.encodeToString(array, Base64.DEFAULT));
builder.append("\"");
}
builder.append(" ]");
}
builder.append("}");
return builder.toString();
}
}
|
