com.jcabi.http.response

Class JsonResponse

java.lang.Object

com.jcabi.http.response.JsonResponse

All Implemented Interfaces:

Response

@Immutable
public final class JsonResponse
extends Object

JSON response.

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.

Since:

0.8

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
JsonResponse(Response resp) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	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()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

JsonResponse

public JsonResponse(@NotNull(message="response can\'t be NULL")
            Response resp)

Public ctor.

Parameters:

resp - Response

Method Detail

assertJson

@NotNull(message="JSON response is never NULL")
public JsonResponse assertJson(@NotNull(message="JSON query can\'t be NULL")
                                     String element)

Verifies the JSON data against the element identifier argument, and throws AssertionError in case of mismatch.

Parameters:

element - Element in the JSON data of this object

Returns:

This object

json

@NotNull(message="JSON reader is never NULL")
public javax.json.JsonReader json()

Read body as JSON.

Returns:

Json reader

toString

public final String toString()

Overrides:

toString in class Object

back

public final Request back()

Description copied from interface: Response

Get back to the request it's related to.

Specified by:

back in interface Response

Returns:

The request we're in

status

public final int status()

Description copied from interface: Response

Get status of the response as a positive integer number.

Specified by:

status in interface Response

Returns:

The status code

reason

public final String reason()

Description copied from interface: Response

Get status line reason phrase.

Specified by:

reason in interface Response

Returns:

The status line reason phrase

headers

public final Map<String,List<String>> headers()

Description copied from interface: Response

Get a collection of all headers.

Specified by:

headers in interface Response

Returns:

The headers

body

public final String body()

Description copied from interface: Response

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).

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.

Specified by:

body in interface Response

Returns:

The body, as a UTF-8 string

binary

public final byte[] binary()

Description copied from interface: Response

Raw body as a an array of bytes.

Specified by:

binary in interface Response

Returns:

The body, as a UTF-8 string

as

public final <T> T as(Class<T> type)

Convert it to another type, by encapsulation.

Specified by:

as in interface Response

Type Parameters:

T - Type to use

Parameters:

type - Type to use

Returns:

New response

Suppressed Checkstyle violations:

MethodName (4 lines)