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
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
/*
* Copyright (C) 2011 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.volley;
import androidx.annotation.Nullable;
import java.net.HttpURLConnection;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import java.util.TreeMap;
/** Data and headers returned from {@link Network#performRequest(Request)}. */
public class NetworkResponse {
/**
* Creates a new network response.
*
* @param statusCode the HTTP status code
* @param data Response body
* @param headers Headers returned with this response, or null for none
* @param notModified True if the server returned a 304 and the data was already in cache
* @param networkTimeMs Round-trip network time to receive network response
* @deprecated see {@link #NetworkResponse(int, byte[], boolean, long, List)}. This constructor
* cannot handle server responses containing multiple headers with the same name. This
* constructor may be removed in a future release of Volley.
*/
@Deprecated
public NetworkResponse(
int statusCode,
byte[] data,
@Nullable Map<String, String> headers,
boolean notModified,
long networkTimeMs) {
this(statusCode, data, headers, toAllHeaderList(headers), notModified, networkTimeMs);
}
/**
* Creates a new network response.
*
* @param statusCode the HTTP status code
* @param data Response body
* @param notModified True if the server returned a 304 and the data was already in cache
* @param networkTimeMs Round-trip network time to receive network response
* @param allHeaders All headers returned with this response, or null for none
*/
public NetworkResponse(
int statusCode,
byte[] data,
boolean notModified,
long networkTimeMs,
@Nullable List<Header> allHeaders) {
this(statusCode, data, toHeaderMap(allHeaders), allHeaders, notModified, networkTimeMs);
}
/**
* Creates a new network response.
*
* @param statusCode the HTTP status code
* @param data Response body
* @param headers Headers returned with this response, or null for none
* @param notModified True if the server returned a 304 and the data was already in cache
* @deprecated see {@link #NetworkResponse(int, byte[], boolean, long, List)}. This constructor
* cannot handle server responses containing multiple headers with the same name. This
* constructor may be removed in a future release of Volley.
*/
@Deprecated
public NetworkResponse(
int statusCode,
byte[] data,
@Nullable Map<String, String> headers,
boolean notModified) {
this(statusCode, data, headers, notModified, /* networkTimeMs= */ 0);
}
/**
* Creates a new network response for an OK response with no headers.
*
* @param data Response body
*/
public NetworkResponse(byte[] data) {
this(
HttpURLConnection.HTTP_OK,
data,
/* notModified= */ false,
/* networkTimeMs= */ 0,
Collections.<Header>emptyList());
}
/**
* Creates a new network response for an OK response.
*
* @param data Response body
* @param headers Headers returned with this response, or null for none
* @deprecated see {@link #NetworkResponse(int, byte[], boolean, long, List)}. This constructor
* cannot handle server responses containing multiple headers with the same name. This
* constructor may be removed in a future release of Volley.
*/
@Deprecated
public NetworkResponse(byte[] data, @Nullable Map<String, String> headers) {
this(
HttpURLConnection.HTTP_OK,
data,
headers,
/* notModified= */ false,
/* networkTimeMs= */ 0);
}
private NetworkResponse(
int statusCode,
byte[] data,
@Nullable Map<String, String> headers,
@Nullable List<Header> allHeaders,
boolean notModified,
long networkTimeMs) {
this.statusCode = statusCode;
this.data = data;
this.headers = headers;
if (allHeaders == null) {
this.allHeaders = null;
} else {
this.allHeaders = Collections.unmodifiableList(allHeaders);
}
this.notModified = notModified;
this.networkTimeMs = networkTimeMs;
}
/** The HTTP status code. */
public final int statusCode;
/** Raw data from this response. */
public final byte[] data;
/**
* Response headers.
*
* <p>This map is case-insensitive. It should not be mutated directly.
*
* <p>Note that if the server returns two headers with the same (case-insensitive) name, this
* map will only contain the last one. Use {@link #allHeaders} to inspect all headers returned
* by the server.
*/
@Nullable public final Map<String, String> headers;
/** All response headers. Must not be mutated directly. */
@Nullable public final List<Header> allHeaders;
/** True if the server returned a 304 (Not Modified). */
public final boolean notModified;
/** Network roundtrip time in milliseconds. */
public final long networkTimeMs;
@Nullable
private static Map<String, String> toHeaderMap(@Nullable List<Header> allHeaders) {
if (allHeaders == null) {
return null;
}
if (allHeaders.isEmpty()) {
return Collections.emptyMap();
}
Map<String, String> headers = new TreeMap<>(String.CASE_INSENSITIVE_ORDER);
// Later elements in the list take precedence.
for (Header header : allHeaders) {
headers.put(header.getName(), header.getValue());
}
return headers;
}
@Nullable
private static List<Header> toAllHeaderList(@Nullable Map<String, String> headers) {
if (headers == null) {
return null;
}
if (headers.isEmpty()) {
return Collections.emptyList();
}
List<Header> allHeaders = new ArrayList<>(headers.size());
for (Map.Entry<String, String> header : headers.entrySet()) {
allHeaders.add(new Header(header.getKey(), header.getValue()));
}
return allHeaders;
}
}
|
