@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()
Response
public final int status()
Response
public final String reason()
Response
public final Map<String,List<String>> headers()
Response
public String body()
Response
UTF-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()
Response
Copyright © 2012–2016 jcabi.com. All rights reserved.