Kotlin
Kotlin は Java と同じ公開 API を使います。スキーマは Yavi.schema() で構築し、JSpecify の null 性アノテーションは Kotlin コンパイラが読むため、null になりうる値は nullable な Kotlin 型でなければなりません。validator<T> DSL は従来の Validator を構築します。
Kotlin からスキーマ API を使う
制約の関数は it で書き、コンストラクタはメソッド参照で呼びます。
data class Member(val name: String, val nickname: String?)
val memberValidator = Yavi.schema()
._string("name") { it.notBlank().lessThanOrEqual(50) }
._string("nickname") { it.lessThanOrEqual(20) }.nullable()
.apply(::Member)
.apply(::Member) は ArgumentsNValidator を返し、.fromMap(::Member) は Map を読み取ります。パラメータの Kotlin の型は、Java の場合と同じく、バリデータが受け付けるものをコンパイラに伝えます。
2 番目以降のプロパティでは、コンストラクタをメソッド参照(apply(::Account))で与えてください。拡張関数では先行する引数の型を名指しできないため、ラムダではそれらが Nothing として見えます。
単一値のバリデータは、am.ik.yavi.validator のトップレベル関数で構築できます。Class リテラルの代わりに、enum またはオブジェクトの型を型引数で与えます。関数は名前でインポートし、am.ik.yavi.builder の同名の関数もインポートする場合は一方に別名を付けます。
import am.ik.yavi.validator._enum
import am.ik.yavi.validator._object
val role = _enum<Role>("role") { it.oneOf(Role.ADMIN) }
val id = _object<UUID>("id")
Kotlin DSL
am.ik.yavi.builder の validator<T> は、すでに存在するオブジェクトのための Validator<T> を構築します。DSL は Kotlin リフレクションでプロパティ名を取得するため、実行時クラスパスに kotlin-reflect が必要です。
val validator = validator<User> {
User::name {
notNull()
lessThanOrEqual(20)
}
User::email {
notNull()
email()
}
}
プロパティには別の名前を与えられ、ネストしたオブジェクトとコレクションは nest と forEach で検証します。
val validator = validator<Order> {
(Order::customer)("Customer") {
notNull()
}
Order::items forEach {
OrderItem::name {
notBlank()
}
}
Order::customer nest {
Customer::name {
notBlank()
}
}
}
nestIfPresentとforEachIfPresentは、nullable なネストしたオブジェクト、コレクション、Map、配列を存在する場合にだけ検証します。- 時刻型と enum のプロパティには専用のオーバーロードがあります。たとえば
past()やoneOf(Status.ACTIVE)です。 onConditionとonGroupは条件付きおよびグループ固有の制約を追加し、unwrap()は基になるValidatorBuilderを返します。- DSL が構築するのはオブジェクトの検証の従来の
Validatorであり、スキーマ API ではありません。Validatorは存在するオブジェクトを検証し、スキーマはオブジェクトを生成します。
null 性
YAVI は JSpecify でアノテーションされています。nullable() のプロパティは @Nullable であり、Kotlin はこれを String? として読むため、apply や fromMap に渡す関数はそのパラメータを nullable と宣言しなければなりません。
data class Member(val name: String, val nickname: String?)
val validator = Yavi.schema()
._string("name") { it.notBlank() }
._string("nickname") { it.lessThanOrEqual(20) }.nullable()
.apply(::Member)
Kotlin DSL で検証される型は nullable ではありません。validator<T>、nest、forEach は T : Any を宣言しています。Kotlin 2.1 以降は JSpecify アノテーションとの不一致をエラーとして報告します。すべてのパラメータと戻り値を検査するには -Xjspecify-annotations=strict を指定してコンパイルします。
コルーチン
am.ik.yavi.fn の拡張は Validation の結果の扱いを suspend します。awaitFold、awaitBimap、awaitMap、awaitMapErrors、awaitMapError は fold、bimap、map、mapErrors、mapError に対応し、kotlinx-coroutines-core を必要とします。
import am.ik.yavi.fn.awaitFold
suspend fun createUser(validated: Validated<User>): HttpStatus = validated.awaitFold(
errorsMapper = { violations -> HttpStatus.BAD_REQUEST },
mapper = { user -> HttpStatus.OK },
)