«Заголовки, файлы cookie и параметры с поддержкой REST»

«1. Обзор

В этом кратком руководстве мы рассмотрим некоторые расширенные сценарии с поддержкой REST. Мы изучали REST-assured ранее в учебнике «Руководство по REST-assured».

Чтобы продолжить, мы рассмотрим примеры, показывающие, как устанавливать заголовки, файлы cookie и параметры для наших запросов.

Настройка такая же, как и в предыдущей статье, так что давайте углубимся в наши примеры.

2. Настройка параметров

Теперь давайте обсудим, как указать различные параметры для нашего запроса, начиная с параметров пути.

2.1. Параметры пути

Мы можем использовать pathParam(имя-параметра, значение) для указания параметра пути:

@Test
public void whenUsePathParam_thenOK() {
    given().pathParam("user", "eugenp")
      .when().get("/users/{user}/repos")
      .then().statusCode(200);
}

Чтобы добавить несколько параметров пути, мы будем использовать метод pathParams():

@Test
public void whenUseMultiplePathParam_thenOK() {
    given().pathParams("owner", "eugenp", "repo", "tutorials")
      .when().get("/repos/{owner}/{repo}")
      .then().statusCode(200);

    given().pathParams("owner", "eugenp")
      .when().get("/repos/{owner}/{repo}","tutorials")
      .then().statusCode(200);
}

В В этом примере мы использовали именованные параметры пути, но мы также можем добавить безымянные параметры и даже объединить их: репозитории/eugenp/учебники.

given().pathParams("owner", "eugenp")
  .when().get("/repos/{owner}/{repo}", "tutorials")
  .then().statusCode(200);

Обратите внимание, что безымянные параметры основаны на индексах.

2.2. Параметры запроса

Далее давайте посмотрим, как мы можем указать параметры запроса с помощью queryParam():

Метод param() будет действовать как queryParam() с запросами GET.

@Test
public void whenUseQueryParam_thenOK() {
    given().queryParam("q", "john").when().get("/search/users")
      .then().statusCode(200);

    given().param("q", "john").when().get("/search/users")
      .then().statusCode(200);
}

Для добавления нескольких параметров запроса мы можем либо объединить несколько методов queryParam(), либо добавить параметры в метод queryParams():

2.3. Параметры формы

@Test
public void whenUseMultipleQueryParam_thenOK() {
 
    int perPage = 20;
    given().queryParam("q", "john").queryParam("per_page",perPage)
      .when().get("/search/users")
      .then().body("items.size()", is(perPage));   
     
    given().queryParams("q", "john","per_page",perPage)
      .when().get("/search/users")
      .then().body("items.size()", is(perPage));
}

Наконец, мы можем указать параметры формы, используя formParam():

Метод param() будет действовать как formParam() для запросов POST.

@Test
public void whenUseFormParam_thenSuccess() {
 
    given().formParams("username", "john","password","1234").post("/");

    given().params("username", "john","password","1234").post("/");
}

Также обратите внимание, что formParam() добавляет заголовок Content-Type со значением «application/x-www-form-urlencoded».

3. Настройка заголовков

Далее мы можем настроить заголовки наших запросов с помощью header():

В этом примере мы использовали header() для установки заголовка User-Agent.

@Test
public void whenUseCustomHeader_thenOK() {
 
    given().header("User-Agent", "MyAppName").when().get("/users/eugenp")
      .then().statusCode(200);
}

Мы также можем добавить заголовок с несколькими значениями, используя тот же метод:

В этом примере у нас будет запрос с двумя заголовками: My-Header:val1 и My-Header:val2.

@Test
public void whenUseMultipleHeaderValues_thenOK() {
 
    given().header("My-Header", "val1", "val2")
      .when().get("/users/eugenp")
      .then().statusCode(200);
}

Для добавления нескольких заголовков мы будем использовать метод headers():

4. Добавление файлов cookie

@Test
public void whenUseMultipleHeaders_thenOK() {
 
    given().header("User-Agent", "MyAppName", "Accept-Charset", "utf-8")
      .when().get("/users/eugenp")
      .then().statusCode(200);
}

Мы также можем указать собственный файл cookie для нашего запроса, используя cookie():

~~ ~ Мы также можем настроить наш файл cookie с помощью конструктора файлов cookie:

@Test
public void whenUseCookie_thenOK() {
 
    given().cookie("session_id", "1234").when().get("/users/eugenp")
      .then().statusCode(200);
}

5. Заключение

@Test
public void whenUseCookieBuilder_thenOK() {
    Cookie myCookie = new Cookie.Builder("session_id", "1234")
      .setSecured(true)
      .setComment("session id cookie")
      .build();

    given().cookie(myCookie)
      .when().get("/users/eugenp")
      .then().statusCode(200);
}

В этой статье мы показали, как мы можем указать параметры запроса, заголовки и файлы cookie при использовании REST-assured.

И, как всегда, полный исходный код примеров доступен на GitHub.

«