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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
/*
* Copyright (C) 2010 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.drm;
import java.io.File;
import java.io.IOException;
/**
* An entity class that wraps the license information retrieved from the online DRM server.
*<p>
* A caller can instantiate a {@link DrmRights} object by first invoking the
* {@link DrmManagerClient#processDrmInfo(DrmInfo)} method and then using the resulting
* {@link ProcessedData} object to invoke the {@link DrmRights#DrmRights(ProcessedData, String)}
* constructor.
*<p>
* A caller can also instantiate a {@link DrmRights} object by using the
* {@link DrmRights#DrmRights(String, String)} constructor, which takes a path to a file
* containing rights information instead of a <code>ProcessedData</code>.
*<p>
* Please note that the account id and subscription id is not mandatory by all DRM agents
* or plugins. When account id or subscription id is not required by the specific DRM
* agent or plugin, they can be either null, or an empty string, or any other don't-care
* string value.
*
*/
public class DrmRights {
private byte[] mData;
private String mMimeType;
private String mAccountId;
private String mSubscriptionId;
/**
* Creates a <code>DrmRights</code> object with the given parameters.
*
* @param rightsFilePath Path to the file containing rights information.
* @param mimeType MIME type. Must not be null or an empty string.
*/
public DrmRights(String rightsFilePath, String mimeType) {
File file = new File(rightsFilePath);
instantiate(file, mimeType);
}
/**
* Creates a <code>DrmRights</code> object with the given parameters.
*
* @param rightsFilePath Path to the file containing rights information.
* @param mimeType MIME type. Must not be null or an empty string.
* @param accountId Account ID of the user.
*/
public DrmRights(String rightsFilePath, String mimeType, String accountId) {
this(rightsFilePath, mimeType);
mAccountId = accountId;
}
/**
* Creates a <code>DrmRights</code> object with the given parameters.
*
* @param rightsFilePath Path to the file containing rights information.
* @param mimeType MIME type. Must not be null or an empty string.
* @param accountId Account ID of the user.
* @param subscriptionId Subscription ID of the user.
*/
public DrmRights(
String rightsFilePath, String mimeType, String accountId, String subscriptionId) {
this(rightsFilePath, mimeType);
mAccountId = accountId;
mSubscriptionId = subscriptionId;
}
/**
* Creates a <code>DrmRights</code> object with the given parameters.
*
* @param rightsFile File containing rights information.
* @param mimeType MIME type. Must not be null or an empty string.
*/
public DrmRights(File rightsFile, String mimeType) {
instantiate(rightsFile, mimeType);
}
private void instantiate(File rightsFile, String mimeType) {
try {
mData = DrmUtils.readBytes(rightsFile);
} catch (IOException e) {
e.printStackTrace();
}
mMimeType = mimeType;
if (!isValid()) {
final String msg = "mimeType: " + mMimeType + "," +
"data: " + mData;
throw new IllegalArgumentException(msg);
}
}
/**
* Creates a <code>DrmRights</code> object with the given parameters.
*
* @param data A {@link ProcessedData} object containing rights information.
* Must not be null.
* @param mimeType The MIME type. It must not be null or an empty string.
*/
public DrmRights(ProcessedData data, String mimeType) {
if (data == null) {
throw new IllegalArgumentException("data is null");
}
mData = data.getData();
mAccountId = data.getAccountId();
mSubscriptionId = data.getSubscriptionId();
mMimeType = mimeType;
if (!isValid()) {
final String msg = "mimeType: " + mMimeType + "," +
"data: " + mData;
throw new IllegalArgumentException(msg);
}
}
/**
* Retrieves the rights data associated with this <code>DrmRights</code> object.
*
* @return A <code>byte</code> array representing the rights data.
*/
public byte[] getData() {
return mData;
}
/**
* Retrieves the MIME type associated with this <code>DrmRights</code> object.
*
* @return The MIME type.
*/
public String getMimeType() {
return mMimeType;
}
/**
* Retrieves the account ID associated with this <code>DrmRights</code> object.
*
* @return The account ID.
*/
public String getAccountId() {
return mAccountId;
}
/**
* Retrieves the subscription ID associated with this <code>DrmRights</code> object.
*
* @return The subscription ID.
*/
public String getSubscriptionId() {
return mSubscriptionId;
}
/**
* Determines whether this instance is valid or not.
*
* @return True if valid; false if invalid.
*/
/*package*/ boolean isValid() {
return (null != mMimeType && !mMimeType.equals("")
&& null != mData && mData.length > 0);
}
}
|
