Перейти к основному содержимому

Переменные и кеширование

Редакция: OpenIDE Pro.

Токен авторизации не нужно получать заново перед каждым запросом: результат запроса, привязанный к переменной, вычисляется один раз и переиспользуется. На этом механизме держатся все сценарии из нескольких шагов, поэтому его стоит понять до того, как скрипт начнёт вести себя неожиданно.

by, а не =​

Результат запроса связывается с переменной через делегат by:

val token: String by POST("$host/api/auth/signin") {
contentType("application/json")
body("""{"username": "$user", "password": "$password"}""")
} then {
decode<String>("$.accessToken")
}

Знак = вместо by компилируется, но делает не то, что ожидается: в переменную попадёт не значение из ответа, а объект отложенного вызова. Скрипт только регистрирует запросы, выполняет их раннер, поэтому вручную «дёрнуть» такой объект из скрипта не получится.

// Не сработает: в token окажется не строка, а описание запроса
val token = POST("$host/api/auth/signin") then { decode<String>("$.accessToken") }

Значение вычисляется один раз​

Первое обращение к переменной выполняет запрос, дальше используется сохранённое значение. Токен из примера выше будет одним и тем же во всех последующих запросах — это видно в журнале выполнения: повторного вызова signin там не появится.

GET("$host/api/users/me") {
bearerAuth(token)
}

GET("$host/api/orders") {
bearerAuth(token)
}

Значение сохраняется между запусками сценария, а не только внутри одного. Чтобы получить новое, запустите сам запрос, который его вычисляет.

Время жизни значения​

Если у токена есть срок действия, задайте ttl. По его истечении следующий запуск получит значение заново, а не вернёт просроченное:

import kotlin.time.Duration.Companion.minutes
import kotlin.time.Duration.Companion.seconds

val token: String by POST("$host/api/auth/token") {
ttl(5.minutes)
} then {
decode<String>("$.access_token")
}

Срок можно взять из самого ответа — например, из поля expires_in:

val token: String by POST("$host/api/auth/token") {
ttl { decode<Long>("$.expires_in").seconds }
} then {
decode<String>("$.access_token")
}

У useCase тоже есть ttl, но только с фиксированным сроком:

val token: String by useCase("Авторизация") {
ttl(5.minutes)
val response by POST("$host/api/auth/token")
response.decode<String>("$.access_token")
}
Ответ 401 не сбрасывает кеш

ttl считает время, а не следит за ответами: получив 401, Connekt не обновит значение автоматически. Для потоков, где токен нужно перевыпускать по отказу сервера, используйте OAuth 2.0.