kvision/io.kvision.remote

Package-level declarations

A set of components for creating multiplatform automatic JSON-RPC connectivity with a backend server.

Types

AbstractServiceException

abstract class AbstractServiceException

CallAgent

open class CallAgent

An agent responsible for remote calls.

ContentTypeException

class ContentTypeException(message: String)

An exception thrown when the server returns a non-json response for a json-rpc call.

Credentials

data class Credentials(val username: String? = null, val password: String? = null)

Username and password credentials.

HttpMethod

enum HttpMethod : Enum<HttpMethod>

IllegalParameterCountException

class IllegalParameterCountException(val actualParameterCount: Int, val expectedParamterCount: Int) : RuntimeException

JsonRpcRequest

data class JsonRpcRequest(val id: Int, val method: String, val params: List<String?>, val jsonrpc: String = "2.0")

JsonRpcResponse

data class JsonRpcResponse(val id: Int? = null, val result: String? = null, val error: String? = null, val exceptionType: String? = null, val exceptionJson: String? = null, val jsonrpc: String = "2.0")

KVRemoteAgent

open class KVRemoteAgent<T : Any>(val serviceManager: <Error class: unknown class><T>, serializersModules: List<<Error class: unknown class>>? = null, val requestFilter: suspend <Error class: unknown class>.() -> Unit? = null)

Client side agent for JSON-RPC remote calls.

KVServiceBinder

abstract class KVServiceBinder<out T, RH, WH, SH>(routeNameGenerator: NameGenerator? = null)

Binds HTTP calls to kotlin functions

KVServiceManager

expect open class KVServiceManager<out T : Any>(serviceClass: KClass<T>) : KVServiceMgr<T>

Multiplatform service manager.

KVServiceManagerJs

open class KVServiceManagerJs<out T : Any>

KVServiceMgr

interface KVServiceMgr<out T : Any>

Base interface for fullstack service manager.

LoginService

class LoginService(val loginEndpoint: String)

Form login dispatcher.

NameGenerator

typealias NameGenerator = () -> String

Object

external class Object

JavaScript Object type

ObjectDeSerializer

interface ObjectDeSerializer

RemoteData

data class RemoteData<T>(val data: List<T> = listOf(), val last_page: Int = 0, val last_row: Int? = null)

RemoteFilter

data class RemoteFilter(val field: String, val type: String, val value: String?)

RemoteOption

data class RemoteOption(val value: String? = null, val text: String? = null, val className: String? = null, val subtext: String? = null, val icon: String? = null, val content: String? = null, val disabled: Boolean = false, val divider: Boolean = false)

RemoteSerialization

expect object RemoteSerialization

JSON utility functions

RemoteSorter

data class RemoteSorter(val field: String, val dir: String)

RequestHandler

typealias RequestHandler = suspend <Error class: unknown class><Unit, <Error class: unknown class>>.(Unit) -> Unit

ResponseBodyType

enum ResponseBodyType : Enum<ResponseBodyType>

HTTP response body types.

ResultSerializer

class ResultSerializer<T>(tSerializer: <Error class: unknown class><T>)

A custom serializer for the Result class.

RouteMapEntry

data class RouteMapEntry<T>(val method: <Error class: unknown class>, val path: String, val handler: T)

RouteMapRegistry

interface RouteMapRegistry<T>

Stores a mapping from an HTTP-method+path to a handler

SecurityException

class SecurityException(message: String)

A security exception.

SecurityMgr

abstract class SecurityMgr

Form login dispatcher.

ServiceException

class ServiceException(message: String)

SimpleRemoteOption

data class SimpleRemoteOption(val value: String, val text: String? = null)

Socket

class Socket

A websocket client implementation.

SocketClosedException

class SocketClosedException(val reason: String) : Throwable

Websocket closed exception class.

SseHandler

typealias SseHandler = RequestHandler

WebsocketHandler

typealias WebsocketHandler = suspend <Error class: unknown class>.() -> Unit

Properties

HTTP_UNAUTHORIZED

const val HTTP_UNAUTHORIZED: Int = 401

HTTP status unauthorized (401).

injector

val <Error class: unknown class>.injector: <Error class: unknown class>

injectorKey

val injectorKey: <Error class: unknown class>

Functions

applyRoutes

fun <T : Any> <Error class: unknown class>.applyRoutes(serviceManager: KVServiceManager<T>, serializersModules: List<<Error class: unknown class>>? = null)

A function to generate routes based on definitions from the service manager.

createNameGenerator

fun createNameGenerator(prefix: String): NameGenerator

createRouteMapRegistry

fun <T> createRouteMapRegistry(): RouteMapRegistry<T>

Create a default implementation of @see RouteMapRegistry

deserialize

inline fun <T> ObjectDeSerializer.deserialize(str: String?): T

encodeURIComponent

external fun encodeURIComponent(uri: String): String

JavaScript encodeURIComponent function

getAllServiceManagers

fun getAllServiceManagers(): List<KVServiceManager<*>>

This will make IntelliJ think that this function exists. The real implementation will be generated by the KVision Gradle Plugin.

getService

inline fun <T : Any> getService(serializersModules: List<<Error class: unknown class>>? = null, noinline requestFilter: suspend <Error class: unknown class>.() -> Unit? = null): T

This will make IntelliJ think that this function exists. The real implementation will be generated by the KVision Gradle Plugin.

getServiceManager

inline fun <T : Any> getServiceManager(): KVServiceManager<T>

This will make IntelliJ think that this function exists. The real implementation will be generated by the KVision Gradle Plugin.

getServiceManagers

fun getServiceManagers(vararg kclass: KClass<*>): List<KVServiceManager<*>>

This will make IntelliJ think that this function exists. The real implementation will be generated by the KVision Gradle Plugin.

getWebSocketUrl

fun getWebSocketUrl(url: String): String

Creates a websocket URL from current window.location and given path.

handleSseConnection

suspend fun <T, OBJECTS_OUT> handleSseConnection(deSerializer: ObjectDeSerializer, rawOut: <Error class: unknown class><String>, serializerOut: <Error class: unknown class><OBJECTS_OUT>, service: T, function: suspend T.(<Error class: unknown class><OBJECTS_OUT>) -> Unit)

Convenience function for cases were the raw channel works with strings. See the overloaded method for details.

suspend fun <T, RAW_OUT, OBJECTS_OUT> handleSseConnection(deSerializer: ObjectDeSerializer, rawOut: <Error class: unknown class><RAW_OUT>, rawOutFromText: (String) -> RAW_OUT, serializerOut: <Error class: unknown class><OBJECTS_OUT>, service: T, function: suspend T.(<Error class: unknown class><OBJECTS_OUT>) -> Unit)

function receives a SendChannel, from which objects are read, serialized and sent to the client in the form of JSON-RPC calls.

handleWebsocketConnection

suspend fun <T, OBJECTS_IN, OBJECTS_OUT> handleWebsocketConnection(deSerializer: ObjectDeSerializer, rawIn: <Error class: unknown class><String>, rawOut: <Error class: unknown class><String>, serializerIn: <Error class: unknown class><OBJECTS_IN>, serializerOut: <Error class: unknown class><OBJECTS_OUT>, service: T, function: suspend T.(<Error class: unknown class><OBJECTS_IN>, <Error class: unknown class><OBJECTS_OUT>) -> Unit)

Convenience function for cases were the raw channels work with strings. See the overloaded method for details.

suspend fun <T, RAW_IN, RAW_OUT, OBJECTS_IN, OBJECTS_OUT> handleWebsocketConnection(deSerializer: ObjectDeSerializer, rawIn: <Error class: unknown class><RAW_IN>, rawInToText: (RAW_IN) -> String?, rawOut: <Error class: unknown class><RAW_OUT>, rawOutFromText: (String) -> RAW_OUT, serializerIn: <Error class: unknown class><OBJECTS_IN>, serializerOut: <Error class: unknown class><OBJECTS_OUT>, service: T, function: suspend T.(<Error class: unknown class><OBJECTS_IN>, <Error class: unknown class><OBJECTS_OUT>) -> Unit)

Reads JSON-RPC calls from rawIn, deserializes them and forwards them in form of a channel to function. Additionally function also receives a SendChannel, from which objects are read, serialized and sent to the client in the form of JSON-RPC calls.

initStaticResources

fun <Error class: unknown class>.initStaticResources()

Initialize default static resources for Ktor server.

kotlinxObjectDeSerializer

fun kotlinxObjectDeSerializer(serializersModules: List<<Error class: unknown class>>? = null): ObjectDeSerializer

kvisionInit

fun <Error class: unknown class>.kvisionInit(vararg modules: Module): <Error class: unknown class>

fun <Error class: unknown class>.kvisionInit(initStaticResources: Boolean, vararg modules: Module): <Error class: unknown class>

fun <Error class: unknown class>.kvisionInit(initStaticResources: Boolean, json: <Error class: unknown class>, vararg modules: Module): <Error class: unknown class>

Initialization function for Ktor server.

fun <Error class: unknown class>.kvisionInit(json: <Error class: unknown class>, vararg modules: Module): <Error class: unknown class>

Initialization function for Ktor server with custom JsonSerializer.

obj

fun obj(init: dynamic.() -> Unit): dynamic

Helper function for creating JavaScript objects.

requireParameterCountEqualTo

fun requireParameterCountEqualTo(actualParameterCount: Int, expectedParamterCount: Int)

fun requireParameterCountEqualTo(params: Collection<*>, expectedParameterCount: Int)

serializeNonNull

inline fun <T> ObjectDeSerializer.serializeNonNull(obj: T): String

serializeNullable

inline fun <T> ObjectDeSerializer.serializeNullable(obj: T?): String?