com.jayway.restassured.response.Response Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of rest-assured Show documentation
Show all versions of rest-assured Show documentation
Java DSL for easy testing of REST services
/*
* Copyright 2013 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.jayway.restassured.response;
import java.util.Map;
/**
* The response of a request made by REST Assured.
*
* Usage example:
*
* Response response = get("/lotto");
* String body = response.getBody().asString();
* String headerValue = response.getHeader("headerName");
* String cookieValue = response.getCookie("cookieName");
*
*
* You can also map the response body to a Java object automatically. REST Assured will use
* Jackson, Gson and JAXB to accommodate this:
*
* Message message = get("/message").as(Message.class);
*
*
*/
public interface Response extends ResponseBody {
/**
* Syntactic sugar, simply returns the same response instance.
*
* @return The same response instance.
*/
Response andReturn();
/**
* Syntactic sugar, simply returns the same response instance.
*
* @return The same response instance.
*/
Response thenReturn();
/**
* Returns the response body
*
* @return The response body.
*/
ResponseBody body();
/**
* Returns the response body
*
* @return The response body.
*/
ResponseBody getBody();
/**
* The response headers. If there are several response headers with the same name a list of
* the response header values are returned.
*
* @return The response headers.
*/
Headers headers();
/**
* The response headers. If there are several response headers with the same name a list of
* the response header values are returned.
*
* @return The response headers.
*/
Headers getHeaders();
/**
* Get a single header value associated with the given name. If the header is a multi-value header then you need to use
* {@link Headers#getList(String)} in order to get all values.
*
* @return The header value or null
if value was not found.
*/
String header(String name);
/**
* Get a single header value associated with the given name. If the header is a multi-value header then you need to use
* {@link Headers#getList(String)} in order to get all values..
*
* @return The header value or null
if value was not found.
*/
String getHeader(String name);
/**
* The response cookies as simple name/value pair. It assumes that no cookies have the same name. If two cookies should never the less
* have the same name the Last cookie value is used. If you want to return ALL cookies including all the details such as Max-Age etc use
* {@link #detailedCookies()}.
*
* @return The response cookies.
*/
Map cookies();
/**
* The response cookies with all the attributes. It also gives you the possibility to get multi-value cookies.
*
* @return The response cookies.
*/
Cookies detailedCookies();
/**
* The response cookies as simple name/value pair. It assumes that no cookies have the same name. If two cookies should never the less
* have the same name the first cookie value is used. If you want to return ALL cookies inlucding all the details such as Max-Age etc use
* {@link #getDetailedCookies()}.
*
* @return The response cookies.
*/
Map getCookies();
/**
* The response cookies with all the attributes. It also gives you the possibility to get multi-value cookies.
*
* @return The response cookies.
*/
Cookies getDetailedCookies();
/**
* Get a single cookie value associated with the given name. If you want more details than just
* the value use {@link #detailedCookie(String)}.
*
* @return The cookie value or null
if value was not found.
*/
String cookie(String name);
/**
* Get a single cookie value associated with the given name. If you want more details than just
* the value use {@link #getDetailedCookie(String)}.
*
* @return The cookie value or null
if value was not found.
*/
String getCookie(String name);
/**
* Get a single cookie including all attributes associated with the given name.
*
* @return The cookie value or null
if value was not found.
*/
Cookie detailedCookie(String name);
/**
* Get a single cookie including all attributes associated with the given name.
*
* @return The cookie value or null
if value was not found.
*/
Cookie getDetailedCookie(String name);
/**
* Get the content type of the response
*
* @return The content type value or null
if not found.
*/
String contentType();
/**
* Get the content type of the response
*
* @return The content type value or null
if not found.
*/
String getContentType();
/**
* Get the status line of the response.
*
* @return The status line of the response.
*/
String statusLine();
/**
* Get the status line of the response.
*
* @return The status line of the response.
*/
String getStatusLine();
/**
* Get the session id from the response. The session id name can be configured from the {@link com.jayway.restassured.config.SessionConfig}.
*
* @return The session id of the response or null
if not defined.
*/
String sessionId();
/**
* Get the session id from the response. The session id name can be configured from the {@link com.jayway.restassured.config.SessionConfig}.
*
* @return The session id of the response or null
if not defined.
*/
String getSessionId();
/**
* Get the status code of the response.
*
* @return The status code of the response.
*/
int statusCode();
/**
* Get the status code of the response.
*
* @return The status code of the response.
*/
int getStatusCode();
/**
* Returns a validatable response that's lets you validate the response. Usage example:
*
*
* given().
* param("firstName", "John").
* param("lastName", "Doe").
* when().
* get("/greet").
* then().
* body("greeting", equalTo("John Doe"));
*
*
* @return A validatable response
*/
ValidatableResponse then();
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy