Package io.kvision.remote

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

Types

CallAgent

open class CallAgent

An agent responsible for remote calls.

Credentials

data class Credentials(username: String?, password: String?)

Username and password credentials.

HttpMethod

common

enum HttpMethod : Enum<HttpMethod>

IllegalParameterCountException

jvm

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

JSON

object JSON

JSON utility functions

JsonRpcRequest

common

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

JsonRpcResponse

common

data class JsonRpcResponse(id: Int?, result: String?, error: String?, exceptionType: String?, jsonrpc: String)

KVRemoteAgent

open class KVRemoteAgent<T : Any>(serviceManager: KVServiceMgr<T>, requestFilter: RequestInit.() -> Unit?) : RemoteAgent

Client side agent for JSON-RPC remote calls.

KVServiceBinder

jvm

abstract class KVServiceBinder<T, RH, WH>(deSerializer: ObjectDeSerializer, routeNameGenerator: NameGenerator?)

Binds HTTP calls to kotlin functions

KVServiceManagerJs

open class KVServiceManagerJs<T : Any> : KVServiceMgr<T>

KVServiceMgr

common

interface KVServiceMgr<T : Any>

Base interface for multiplatform service manager.

LoginService

class LoginService(loginEndpoint: String)

Form login dispatcher.

NameGenerator

jvm

typealias NameGenerator = () -> String

NotEnumTypeException

class NotEnumTypeException : Exception

NotStandardTypeException

class NotStandardTypeException(type: String) : Exception

Object

external class Object

JavaScript Object type

ObjectDeSerializer

jvm

interface ObjectDeSerializer

RemoteAgent

open class RemoteAgent

Interface for client side agent for JSON-RPC remote calls.

RemoteData

common

data class RemoteData<T>(data: List<T>, last_page: Int)

RemoteFilter

common

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

RemoteOption

common

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

RemoteSorter

common

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

ResponseBodyType

enum ResponseBodyType : Enum<ResponseBodyType>

HTTP response body types.

RouteMapEntry

jvm

data class RouteMapEntry<T>(method: HttpMethod, path: String, handler: T)

RouteMapRegistry

jvm

interface RouteMapRegistry<T>

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

SecurityException

class SecurityException(message: String) : Exception

A security exception.

SecurityMgr

abstract class SecurityMgr

Form login dispatcher.

ServiceException

common

class ServiceException(message: String) : Exception

Socket

class Socket

A websocket client implementation.

SocketClosedException

class SocketClosedException(reason: String) : Throwable

Websocket closed exception class.

Functions

createNameGenerator

jvm

fun createNameGenerator(prefix: String): NameGenerator

createRouteMapRegistry

jvm

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

Create a default implementation of @see RouteMapRegistry

deserialize

jvm

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

getWebSocketUrl

fun getWebSocketUrl(url: String): String

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

handleWebsocketConnection

jvm

suspend fun <T, OBJECTS_IN, OBJECTS_OUT> handleWebsocketConnection(deSerializer: ObjectDeSerializer, rawIn: ReceiveChannel<String>, rawOut: SendChannel<String>, serializerIn: KSerializer<OBJECTS_IN>, serializerOut: KSerializer<OBJECTS_OUT>, service: T, function: suspend T.(ReceiveChannel<OBJECTS_IN>, SendChannel<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: ReceiveChannel<RAW_IN>, rawInToText: (RAW_IN) -> String?, rawOut: SendChannel<RAW_OUT>, rawOutFromText: (String) -> RAW_OUT, serializerIn: KSerializer<OBJECTS_IN>, serializerOut: KSerializer<OBJECTS_OUT>, service: T, function: suspend T.(ReceiveChannel<OBJECTS_IN>, SendChannel<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.