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

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

Пример
- Вывод информации о функции

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

Важно

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

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

public class Handler : YcFunction<int, String> {
  public String FunctionHandler(int i, Context c) {
    return String.valueOf(i);
  }
}

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

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

// у YcFunction не указаны оба типа параметра
public class Handler : YcFunction {
  public Object FunctionHandler(Object i, Context c) {
    return i;
  }
}

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

Примечание

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

Пример

Вывод информации о функции

Следующая функция:

Получает на вход число.
Выводит данные о функции, взятые из контекста вызова, в журнал выполнения
Возвращает данные о том, является ли переданное число четным.

Важно

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

Файл Handler.cs:

using Yandex.Cloud.Functions;

public class Handler : YcFunction<int, bool> {

  public bool FunctionHandler(int number, Context c) {
    Console.WriteLine($"Function name: {c.FunctionId}");
    Console.WriteLine($"Function version: {c.FunctionVersion}");
    Console.WriteLine($"Service account token: {c.TokenJson}");
    return number % 2 == 0;
  }
}

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

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

Function name: <название вашей функции>
Function version: <id данной версии вашей функции>
Service account token: <token для вашего сервисного аккаунта>

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

false