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

Статья создана

Yandex.Cloud

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

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

Важно

Метод-обработчик должен быть публичным, иметь имя FunctionHandler и один входной параметр.

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

public class Handler {
  public String FunctionHandler(int i) {
    return i.ToString();
  }
}

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

// у Handler не должно быть типов-параметров (см. [требования к обработчику](index.md))
public class Handler<T> {
  public int FunctionHandler(T i) {
    return 2;
  }
}

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

Примечание

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

Примеры

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

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

Важно

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

Файл Request.cs:

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

Файл Handler.cs:

public class Handler {
  public String FunctionHandler(Request r) {
    // на этом этапе в переменной r уже хранится разобранный запрос
    return $"Message is {r.message}, number is {r.number}";
  }
}

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

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

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

Message is Hello, number is 24

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

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

Важно

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

Файл Request.cs:

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

Файл Response.cs:

public class Response {
  public int statusCode { get; set; }
  public String body { get; set; }

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

Файл Handler.cs:

using System.Text.Json;

public class Handler {

  public Response FunctionHandler(Request r) {
    var method = r.httpMethod;
    var body = r.body;
    Console.WriteLine($"{method}, {body}");

    using var jsonDoc = JsonDocument.Parse(body);
    var root = jsonDoc.RootElement;

    // здесь из тела запроса достается параметр "name"
    // если не передать его, то выбросится ошибка
    var name = root.GetProperty("name").GetString(); 
    return new Response(200, $"Hello, {name}");
  }
}

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

{
  "name": "Anonymous"
}

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

POST, { "name": "Anonymous" }

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

Hello, Anonymous