com.jcabi.http.response

Class RestResponse

java.lang.Object

com.jcabi.http.response.RestResponse

All Implemented Interfaces:

Response

@Immutable
public final class RestResponse
extends Object

REST response.

This response decorator is able to make basic assertions on HTTP response and manipulate with it afterwords, for example:

 String name = new JdkRequest("http://my.example.com")
   .fetch()
   .as(RestResponse.class)
   .assertStatus(200)
   .assertBody(Matchers.containsString("hello, world!"))
   .assertHeader("Content-Type", Matchers.hasItem("text/plain"))
   .jump(URI.create("/users"))
   .fetch();

Method jump(URI) creates a new instance of class Request with all cookies transferred from the current one.

The class is immutable and thread-safe.

Since:

0.8

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
RestResponse(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.
RestResponse	assertBody(Matcher<String> matcher) Verifies HTTP response body content against provided matcher, and throws AssertionError in case of mismatch.
RestResponse	assertHeader(String name, Matcher<Iterable<String>> matcher) Verifies HTTP header against provided matcher, and throws AssertionError in case of mismatch.
RestResponse	assertHeader(String name, String value) Verifies HTTP header against provided matcher, and throws AssertionError in case of mismatch.
RestResponse	assertStatus(int status) Verifies HTTP response status code against the provided absolute value, and throws AssertionError in case of mismatch.
RestResponse	assertStatus(Matcher<Integer> matcher) Verifies HTTP response status code against the provided matcher, and throws AssertionError in case of mismatch.
RestResponse	assertThat(Matcher<Response> matcher) Assert using custom matcher.
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).
Cookie	cookie(String name) Get one cookie by name.
Request	follow() Follow LOCATION header.
Map<String,List<String>>	headers() Get a collection of all headers.
Request	jump(URI uri) Jump to a new location.
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

RestResponse

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

Public ctor.

Parameters:

resp - Response

Method Detail

assertThat

@NotNull(message="new response is never NULL")
public RestResponse assertThat(@NotNull(message="matcher can\'t be NULL")
                                     Matcher<Response> matcher)

Assert using custom matcher.

Parameters:

matcher - The matcher to use

Returns:

The same object

assertStatus

@NotNull(message="response is never NULL")
public RestResponse assertStatus(int status)

Verifies HTTP response status code against the provided absolute value, and throws AssertionError in case of mismatch.

Parameters:

status - Expected status code

Returns:

The same object

assertStatus

@NotNull(message="REST response is never NULL")
public RestResponse assertStatus(@NotNull(message="status matcher can\'t be NULL")
                                       Matcher<Integer> matcher)

Verifies HTTP response status code against the provided matcher, and throws AssertionError in case of mismatch.

Parameters:

matcher - Matcher to validate status code

Returns:

This object

assertBody

@NotNull(message="REST response is never NULL")
public RestResponse assertBody(@NotNull(message="body matcher can\'t be NULL")
                                     Matcher<String> matcher)

Verifies HTTP response body content against provided matcher, and throws AssertionError in case of mismatch.

Parameters:

matcher - The matcher to use

Returns:

This object

assertHeader

@NotNull(message="response is never NULL")
public RestResponse assertHeader(@NotNull(message="header name can\'t be NULL")
                                       String name,
                                       @NotNull(message="header matcher can\'t be NULL")
                                       Matcher<Iterable<String>> matcher)

Verifies HTTP header against provided matcher, and throws AssertionError in case of mismatch.

The iterator for the matcher will always be a real object an never NULL, even if such a header is absent in the response. If the header is absent the iterable will be empty.

Parameters:

name - Name of the header to match

matcher - The matcher to use

Returns:

This object

assertHeader

@NotNull(message="response is never NULL")
public RestResponse assertHeader(@NotNull(message="header name can\'t be NULL")
                                       String name,
                                       @NotNull(message="header value can\'t be NULL")
                                       String value)

Verifies HTTP header against provided matcher, and throws AssertionError in case of mismatch.

Parameters:

name - Name of the header to match

value - The value to expect in one of the headers

Returns:

This object

Since:

0.9

jump

@NotNull(message="request is never NULL")
public Request jump(@NotNull(message="URI can\'t be NULL")
                          URI uri)

Jump to a new location.

Parameters:

uri - Destination to jump to

Returns:

New request

follow

@NotNull(message="request is never NULL")
public Request follow()

Follow LOCATION header.

Returns:

New request

cookie

@NotNull(message="cookie is never NULL")
public Cookie cookie(@NotNull
                           String name)

Get one cookie by name.

Parameters:

name - Cookie name

Returns:

Cookie found

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)