Использование интерфейса Function для задания функции-обработчика

Примеры
- Вывод структуры HTTP-запроса
- Разбор HTTP-запроса

Вы можете задать функцию-обработчик, реализовав интерфейс Function.

Важно

Вы должны указать оба значения для параметров типа Function, причем первый тип является типом входного аргумента, а второй — типом возвращаемого значения.

Пример корректного обработчика:

import java.util.function.Function;

public class Handler implements Function<Integer, String> {
  @Override
  public String apply(Integer i) {
    return String.valueOf(i);
  }
}

Примеры некорректных обработчиков:

import java.util.function.Function;
// у Function указан лишь один тип параметра
// у Handler не должно быть типов-параметров (см. требования к обработчику)
public class Handler<T> implements Function<T, Integer> {
  @Override
  public Integer apply(T i) {
    return 2;
  }
}

import java.util.function.Function;
// у Function не указаны оба типа параметра
public class Handler implements Function {
  @Override
  public Object apply(Object i) {
    return i;
  }
}

Вы можете использовать любые классы в качестве входного и возвращаемого типов.

Примечание

Поля этих классов могут иметь любые модификаторы доступа. В случае, когда поле непубличное, писать для него getter/setter необязательно.

Примеры

Вывод структуры HTTP-запроса

Следующая функция получает на вход запрос с двумя полями (строкой и числом) и возвращает отформатированную строку с переданными данными.

Важно

Функцию необходимо вызывать с помощью YC CLI или с помощью HTTP-запроса с параметром integration=raw.

Файл Request.java:

public class Request {
  public String message;
  public int number;
}

Файл Handler.java:

import java.util.function.Function;

public class Handler implements Function<Request, String> {

  @Override
  public String apply(Request r) {
    // на этом этапе в переменной r уже хранится разобранный запрос
    return String.format("Message is %s, number is %d", r.message, r.number);
  }
}

Пример входных данных:

{
  "message": "Hello",
  "number": 24
}

Возвращаемая строка:

Message is Hello, number is 24

Разбор HTTP-запроса

Функция вызывается с помощью HTTP-запроса с именем пользователя, записывает в журнал метод и тело запроса и возвращает приветствие.

Важно

Не используйте для вызова этой функции параметр integration=raw. При применении этого параметра функция не получает данных о методах, заголовках и параметрах исходного запроса.

Примечание

В данном примере для интерпретации JSON используется сторонняя библиотека org.json.

Файл Request.java:

public class Request {
  public String httpMethod;
  public String body;
}

Файл Response.java:

public class Response {
  public int statusCode;
  public String body;

  public Response(int statusCode, String body) {
    this.statusCode = statusCode;
    this.body = body;
  }
}

Файл Handler.java:

import java.util.function.Function;
import org.json.*;

public class Handler implements Function<Request, Response> {

  @Override
  public Response apply(Request r) {
    var method = r.httpMethod;
    var body = r.body;
    System.out.println(String.format("%s, %s", method, body));

    var jsonObject = new JSONObject(body);
    // здесь из тела запроса достается параметр "name"
    // если не передать его, то выбросится ошибка
    var name = jsonObject.getString("name");
    return new Response(200, String.format("Hello, %s", name));
  }
}

Пример входных данных (метод POST):

{
  "name": "Anonymous"
}

В журнале будет напечатано:

POST, { "name": "Anonymous" }

Возвращаемый ответ:

Hello, Anonymous