library/xyz.malefic.koven.contract.field/OptionalCookieField

OptionalCookieField

class OptionalCookieField<T>(val inner: CookieField<T>) : CookieField<T?>

A cookie field that is optional.

Constructors

OptionalCookieField

constructor(inner: CookieField<T>)

Properties

fields

open override val fields: List<String>

The field name(s) for this field.

inner

val inner: CookieField<T>

name

open override val name: String

Functions

and

infix fun <A, B> CookieField<A>.and(other: CookieField<B>): CookiePairField<A, B>

Creates a pair of cookie fields as CookiePairField.

clear

open fun clear(): Cookie

Creates an empty Cookie with the properties defined in this field for the purpose of clearing an already-existent cookie.

create

open infix fun create(value: String): Cookie

Creates a Cookie using the properties defined in this field.

createCookies

open fun createCookies(value: T?): Cookies

Creates a Cookies object from the given value.

decode

context(_: Raise<Issue>)
open infix override fun decode(cookies: Map<String, String>): T?

domain

open override fun domain(): String?

The domain for which the cookie is valid.

encodeCookies

open override fun encodeCookies(value: T?): List<Cookie>

flatten

open override fun flatten(): List<CookieField<*>>

Flattens the field into its constituent fields.

isHttpOnly

open override fun isHttpOnly(): Boolean

Whether this cookie is intended to be server-side only.

maxAge

open override fun maxAge(): Long?

The maximum age of the cookie in seconds.

optional

fun <T> CookieField<T>.optional(): CookieField<T?>

Marks a cookie field as optional.

path

open override fun path(): String?

The path for which the cookie is valid.

sameSite

open override fun sameSite(): SameSite

The SameSite attribute of the cookie.

secure

open override fun secure(): Boolean

Whether the cookie should only be sent over secure connections.