WebResourceResponse
public class WebResourceResponse
extends Object
| java.lang.Object | |
| ↳ | android.webkit.WebResourceResponse |
Encapsulates a resource response. Applications can return an instance of this class from WebViewClient.shouldInterceptRequest to provide a custom response when the WebView requests a particular resource.
Summary
Public constructors | |
|---|---|
WebResourceResponse(String mimeType, String encoding, int statusCode, String reasonPhrase, Map<String, String> responseHeaders, InputStream data) Constructs a resource response with the given parameters. | |
WebResourceResponse(String mimeType, String encoding, InputStream data) Constructs a resource response with the given MIME type, character encoding, and input stream. | |
Public methods | |
|---|---|
InputStream | getData() Gets the input stream that provides the resource response's data. |
String | getEncoding() Gets the resource response's encoding. |
String | getMimeType() Gets the resource response's MIME type. |
String | getReasonPhrase() Gets the description of the resource response's status code. |
Map<String, String> | getResponseHeaders() Gets the headers for the resource response. |
int | getStatusCode() Gets the resource response's status code. |
void | setData(InputStream data) Sets the input stream that provides the resource response's data. |
void | setEncoding(String encoding) Sets the resource response's encoding, for example "UTF-8". |
void | setMimeType(String mimeType) Sets the resource response's MIME type, for example "text/html". |
void | setResponseHeaders(Map<String, String> headers) Sets the headers for the resource response. |
void | setStatusCodeAndReasonPhrase(int statusCode, String reasonPhrase) Sets the resource response's status code and reason phrase. |
Inherited methods | |
|---|---|
Public constructors
WebResourceResponse
public WebResourceResponse (String mimeType, String encoding, int statusCode, String reasonPhrase, Map<String, String> responseHeaders, InputStream data)
Constructs a resource response with the given parameters. Callers must implement InputStream.read(byte[]) for the input stream. InputStream.close() will be called after the WebView has finished with the response.
Note: See WebResourceResponse(java.lang.String, java.lang.String, java.io.InputStream) for details on what should be specified for mimeType and encoding.
| Parameters | |
|---|---|
mimeType | String: the resource response's MIME type, for example "text/html". |
encoding | String: the resource response's character encoding, for example "utf-8". |
statusCode | int: the status code needs to be in the ranges [100, 299], [400, 599]. Causing a redirect by specifying a 3xx code is not supported. |
reasonPhrase | String: the phrase describing the status code, for example "OK". Must be non-empty. This value cannot be null. |
responseHeaders | Map: the resource response's headers represented as a mapping of header name -> header value. |
data | InputStream: the input stream that provides the resource response's data. Must not be a StringBufferInputStream. |
WebResourceResponse
public WebResourceResponse (String mimeType, String encoding, InputStream data)
Constructs a resource response with the given MIME type, character encoding, and input stream. Callers must implement InputStream.read(byte[]) for the input stream. InputStream.close() will be called after the WebView has finished with the response.
Note: The MIME type and character encoding must be specified as separate parameters (for example "text/html" and "utf-8"), not a single value like the "text/html; charset=utf-8" format used in the HTTP Content-Type header. Do not use the value of a HTTP Content-Encoding header for encoding, as that header does not specify a character encoding. Content without a defined character encoding (for example image resources) should pass null for encoding.
| Parameters | |
|---|---|
mimeType | String: the resource response's MIME type, for example "text/html". |
encoding | String: the resource response's character encoding, for example "utf-8". |
data | InputStream: the input stream that provides the resource response's data. Must not be a StringBufferInputStream. |
Public methods
getData
public InputStream getData ()
Gets the input stream that provides the resource response's data.
| Returns | |
|---|---|
InputStream | The input stream that provides the resource response's data |
getEncoding
public String getEncoding ()
Gets the resource response's encoding.
| Returns | |
|---|---|
String | The resource response's encoding |
getMimeType
public String getMimeType ()
Gets the resource response's MIME type.
| Returns | |
|---|---|
String | The resource response's MIME type |
getReasonPhrase
public String getReasonPhrase ()
Gets the description of the resource response's status code.
| Returns | |
|---|---|
String | The description of the resource response's status code. |
getResponseHeaders
public Map<String, String> getResponseHeaders ()
Gets the headers for the resource response.
| Returns | |
|---|---|
Map<String, String> | The headers for the resource response. |
getStatusCode
public int getStatusCode ()
Gets the resource response's status code.
| Returns | |
|---|---|
int | The resource response's status code. |
setData
public void setData (InputStream data)
Sets the input stream that provides the resource response's data. Callers must implement InputStream.read(byte[]). InputStream.close() will be called after the WebView has finished with the response.
| Parameters | |
|---|---|
data | InputStream: the input stream that provides the resource response's data. Must not be a StringBufferInputStream. |
setEncoding
public void setEncoding (String encoding)
Sets the resource response's encoding, for example "UTF-8". This is used to decode the data from the input stream.
| Parameters | |
|---|---|
encoding | String: The resource response's encoding |
setMimeType
public void setMimeType (String mimeType)
Sets the resource response's MIME type, for example "text/html".
| Parameters | |
|---|---|
mimeType | String: The resource response's MIME type |
setResponseHeaders
public void setResponseHeaders (Map<String, String> headers)
Sets the headers for the resource response.
| Parameters | |
|---|---|
headers | Map: Mapping of header name -> header value. |
setStatusCodeAndReasonPhrase
public void setStatusCodeAndReasonPhrase (int statusCode, String reasonPhrase)
Sets the resource response's status code and reason phrase.
| Parameters | |
|---|---|
statusCode | int: the status code needs to be in the ranges [100, 299], [400, 599]. Causing a redirect by specifying a 3xx code is not supported. |
reasonPhrase | String: the phrase describing the status code, for example "OK". Must be non-empty. This value cannot be null. |