Java tutorial
/* * Copyright 2018 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 io.restassured.builder; import io.restassured.http.ContentType; import io.restassured.http.Header; import io.restassured.http.Headers; import io.restassured.response.Response; import io.restassured.specification.ResponseSpecification; import org.apache.commons.io.IOUtils; import org.junit.Rule; import org.junit.Test; import org.junit.rules.ExpectedException; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.Arrays; import java.util.HashMap; import java.util.concurrent.TimeUnit; import static io.restassured.RestAssured.withArgs; import static org.hamcrest.CoreMatchers.containsString; import static org.hamcrest.CoreMatchers.endsWith; import static org.hamcrest.CoreMatchers.equalTo; import static org.hamcrest.Matchers.lessThan; import static org.hamcrest.Matchers.startsWith; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.when; /** * Tests assertions for ResponseSpec. For each method (type of assertion), there is following test data provided: * 1) assertion description * 2) response spec builder with tested assertion * 3) response mock that should pass assertion * 4) response mock that should fail assertion */ @RunWith(Parameterized.class) public class ResponseSpecBuilderExpectationsTest { @Rule public ExpectedException exception = ExpectedException.none(); private ResponseSpecification responseSpecification; private Response matchingResponse; private Response unmatchedResponse; @SuppressWarnings("unused") public ResponseSpecBuilderExpectationsTest(String description, Response matchingResponse, Response unmatchedResponse, ResponseSpecBuilder builder) { this.matchingResponse = matchingResponse; this.unmatchedResponse = unmatchedResponse; this.responseSpecification = builder.build(); } @Test public void validResponseShouldMatch() { responseSpecification.validate(matchingResponse); } @Test public void invalidResponseShouldNotMatch() { exception.expect(AssertionError.class); responseSpecification.validate(unmatchedResponse); } @Parameters(name = "{0}") @SuppressWarnings("deprecation") public static Iterable<Object[]> data() { return Arrays.asList(new Object[][] { { "Content matcher", when(responseMock().asString()).thenReturn("goodBody").getMock(), when(responseMock().asString()).thenReturn("badBody").getMock(), new ResponseSpecBuilder().expectContent(startsWith("good")), }, { "Content matcher with path", responseMockInJson("{\"name\": \"goodValue\"}"), responseMockInJson("{\"name\": \"badValue\"}"), new ResponseSpecBuilder().expectContent("name", startsWith("good")), }, { "Content matcher with parametrized path", responseMockInJson("{\"name\": [\"value1\", \"value2\"]}"), responseMockInJson("{\"name\": [\"value3\", \"value4\"]}"), new ResponseSpecBuilder().expectContent("name[%d]", withArgs(1), endsWith("2")), }, { "Status code matcher", when(responseMock().getStatusCode()).thenReturn(567).getMock(), when(responseMock().getStatusCode()).thenReturn(765).getMock(), new ResponseSpecBuilder().expectStatusCode(lessThan(600)) }, { "Status code value", when(responseMock().getStatusCode()).thenReturn(567).getMock(), when(responseMock().getStatusCode()).thenReturn(765).getMock(), new ResponseSpecBuilder().expectStatusCode(567) }, { "Status line matcher", when(responseMock().getStatusLine()).thenReturn("HTTP/5.6 567 GOOD").getMock(), when(responseMock().getStatusLine()).thenReturn("FTP/4.3 765 BAD").getMock(), new ResponseSpecBuilder().expectStatusLine(containsString("GOOD")) }, { "Status line value", when(responseMock().getStatusLine()).thenReturn("HTTP/5.6 567 GOOD").getMock(), when(responseMock().getStatusLine()).thenReturn("FTP/4.3 765 BAD").getMock(), new ResponseSpecBuilder().expectStatusLine("HTTP/5.6 567 GOOD") }, { "Headers map", when(responseMock().getHeaders()).thenReturn( new Headers(new Header("header1", "header1Value"), new Header("header2", "header2Value"))) .getMock(), when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("header3", "header3Value"))).getMock(), new ResponseSpecBuilder().expectHeaders(new HashMap<String, Object>() { { put("header1", "header1Value"); } }) }, { "Header matcher", when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("header1", "goodHeaderValue"))).getMock(), when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("header1", "badHeaderValue"))).getMock(), new ResponseSpecBuilder().expectHeader("header1", equalTo("goodHeaderValue")) }, { "Header value", when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("header1", "goodHeaderValue"))).getMock(), when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("header1", "badHeaderValue"))).getMock(), new ResponseSpecBuilder().expectHeader("header1", "goodHeaderValue") }, { "Cookies map", when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("Set-Cookie", "cookie1=cookie1Val"))).getMock(), when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("Set-Cookie", "cookie1=cookie1BadVal"))) .getMock(), new ResponseSpecBuilder().expectCookies(new HashMap<String, Object>() { { put("cookie1", "cookie1Val"); } }) }, { "Cookie matcher", when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("Set-Cookie", "cookie1=cookie1GoodVal"))).getMock(), when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("Set-Cookie", "cookie1=cookie1BadVal"))) .getMock(), new ResponseSpecBuilder().expectCookie("cookie1", containsString("GoodVal")) }, { "Cookie value", when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("Set-Cookie", "cookie1=cookie1Val"))).getMock(), when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("Set-Cookie", "cookie1=cookie1BadVal"))) .getMock(), new ResponseSpecBuilder().expectCookie("cookie1", "cookie1Val") }, { "Cookie presence", when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("Set-Cookie", "cookie1=cookie1Val"))).getMock(), when(responseMock().getHeaders()) .thenReturn(new Headers(new Header("Set-Cookie", "cookie2=cookie2Val"))).getMock(), new ResponseSpecBuilder().expectCookie("cookie1") }, { "Response time matcher", when(responseMock().getTimeIn(TimeUnit.MILLISECONDS)).thenReturn(4000L).getMock(), when(responseMock().getTimeIn(TimeUnit.MILLISECONDS)).thenReturn(8000L).getMock(), new ResponseSpecBuilder().expectResponseTime(lessThan(5000L)) }, { "Response time matcher with time unit", when(responseMock().getTimeIn(TimeUnit.NANOSECONDS)).thenReturn(4000L).getMock(), when(responseMock().getTimeIn(TimeUnit.NANOSECONDS)).thenReturn(8000L).getMock(), new ResponseSpecBuilder().expectResponseTime(lessThan(5000L), TimeUnit.NANOSECONDS) }, { "Content type object", when(responseMock().getContentType()).thenReturn("text/xml").getMock(), when(responseMock().getContentType()).thenReturn("application/json").getMock(), new ResponseSpecBuilder().expectContentType(ContentType.XML) }, { "Content type string", when(responseMock().getContentType()).thenReturn("text/xml").getMock(), when(responseMock().getContentType()).thenReturn("application/json").getMock(), new ResponseSpecBuilder().expectContentType("text/xml") }, { "Body matcher", when(responseMock().asString()).thenReturn("goodBody").getMock(), when(responseMock().asString()).thenReturn("badBody").getMock(), new ResponseSpecBuilder().expectBody(containsString("good")), }, { "Body matcher with path", responseMockInJson("{\"name\": \"goodValue\"}"), responseMockInJson("{\"name\": \"badValue\"}"), new ResponseSpecBuilder().expectBody("name", startsWith("good")), }, { "Body matcher with parametrized path", responseMockInJson("{\"name\": [\"value1\", \"value2\"]}"), responseMockInJson("{\"name\": [\"value3\", \"value4\"]}"), new ResponseSpecBuilder().expectBody("name[%d]", withArgs(1), endsWith("2")), } }); } private static Response responseMock() { return mock(Response.class); } private static Response responseMockInJson(String body) { Response response = mock(Response.class); when(response.getContentType()).thenReturn("application/json"); when(response.contentType()).thenReturn("application/json"); when(response.asString()).thenReturn(body); when(response.asInputStream()).thenReturn(IOUtils.toInputStream(body)); return response; } }