@Immutable public final class JsonResponse extends Object
This response decorator is able to parse HTTP response body as a JSON document and manipulate with it afterwords, for example:
String name = new JdkRequest("http://my.example.com")
.header(HttpHeaders.ACCEPT, MediaType.APPLICATION_JSON)
.fetch()
.as(JsonResponse.class)
.json()
.readObject()
.getString("name");
The class is immutable and thread-safe.
| Constructor and Description |
|---|
JsonResponse(Response resp)
Public ctor.
|
| Modifier and Type | Method and Description |
|---|---|
<T extends Response> |
as(Class<T> type)
Convert it to another type, by encapsulation.
|
JsonResponse |
assertJson(String element)
Verifies the JSON data against the element identifier argument,
and throws
AssertionError in case of mismatch. |
Request |
back()
Get back to the request it's related to.
|
byte[] |
binary()
Raw body as a an array of bytes.
|
String |
body()
Get body as a string, assuming it's
UTF-8 (if there is something
else that can't be translated into a UTF-8 string a runtime exception
will be thrown). |
Map<String,List<String>> |
headers()
Get a collection of all headers.
|
javax.json.JsonReader |
json()
Read body as JSON.
|
String |
reason()
Get status line reason phrase.
|
int |
status()
Get status of the response as a positive integer number.
|
String |
toString() |
public JsonResponse(Response resp)
resp - Responsepublic JsonResponse assertJson(String element)
AssertionError in case of mismatch.element - Element in the JSON data of this objectpublic javax.json.JsonReader json()
public final Request back()
Responsepublic final int status()
Responsepublic final String reason()
Responsepublic final Map<String,List<String>> headers()
Responsepublic String body()
ResponseUTF-8 (if there is something
else that can't be translated into a UTF-8 string a runtime exception
will be thrown).
DISCLAIMER:
The only encoding supported here is UTF-8. If the body of response
contains any chars that can't be used and should be replaced with
a "replacement character", a RuntimeException will be thrown. If
you need to use some other encodings, use
Response.binary() instead.
public final byte[] binary()
ResponseCopyright © 2012–2017 jcabi.com. All rights reserved.