commonMain.io.rsocket.kotlin.RSocket.kt Maven / Gradle / Ivy

Go to download
/*
 * Copyright 2015-2020 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package io.rsocket.kotlin

import io.ktor.utils.io.core.*
import io.rsocket.kotlin.payload.*
import kotlinx.coroutines.*
import kotlinx.coroutines.flow.*

public interface RSocket {
    public val job: Job

    public suspend fun metadataPush(metadata: ByteReadPacket) {
        metadata.release()
        notImplemented("Metadata Push")
    }

    public suspend fun fireAndForget(payload: Payload) {
        payload.release()
        notImplemented("Fire and Forget")
    }

    public suspend fun requestResponse(payload: Payload): Payload {
        payload.release()
        notImplemented("Request Response")
    }

    public fun requestStream(payload: Payload): Flow {
        payload.release()
        notImplemented("Request Stream")
    }

    public fun requestChannel(initPayload: Payload, payloads: Flow): Flow {
        initPayload.release()
        notImplemented("Request Channel")
    }
}

private fun notImplemented(operation: String): Nothing = throw NotImplementedError("$operation is not implemented.")

/**
 * Tries to emit [value], if emit failed, f.e. due cancellation, calls [Closeable.close] on [value].
 * Better to use it instead of [FlowCollector.emit] with [Payload] or [ByteReadPacket] to avoid leaks of dropped elements.
 */
public suspend fun  FlowCollector.emitOrClose(value: C) {
    try {
        return emit(value)
    } catch (e: Throwable) {
        value.close()
        throw e
    }
}