grpc.cache_client.HttpcacheGrpcKt.kt Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of client-protos-jvm Show documentation
Kotlin protobuf protocols for the JVM that define the Momento gRPC wire format
There is a newer version: 0.119.4
package grpc.cache_client

import com.google.api.HttpBody
import grpc.cache_client.HttpCacheGrpc.getServiceDescriptor
import io.grpc.CallOptions
import io.grpc.CallOptions.DEFAULT
import io.grpc.Channel
import io.grpc.Metadata
import io.grpc.MethodDescriptor
import io.grpc.ServerServiceDefinition
import io.grpc.ServerServiceDefinition.builder
import io.grpc.ServiceDescriptor
import io.grpc.Status.UNIMPLEMENTED
import io.grpc.StatusException
import io.grpc.kotlin.AbstractCoroutineServerImpl
import io.grpc.kotlin.AbstractCoroutineStub
import io.grpc.kotlin.ClientCalls.unaryRpc
import io.grpc.kotlin.ServerCalls.unaryServerMethodDefinition
import io.grpc.kotlin.StubFor
import kotlin.String
import kotlin.coroutines.CoroutineContext
import kotlin.coroutines.EmptyCoroutineContext
import kotlin.jvm.JvmOverloads
import kotlin.jvm.JvmStatic

/**
 * Holder for Kotlin coroutine-based client and server APIs for cache_client.HttpCache.
 */
public object HttpCacheGrpcKt {
  public const val SERVICE_NAME: String = HttpCacheGrpc.SERVICE_NAME

  @JvmStatic
  public val serviceDescriptor: ServiceDescriptor
    get() = getServiceDescriptor()

  public val getMethod: MethodDescriptor<_HttpGetRequest, HttpBody>
    @JvmStatic
    get() = HttpCacheGrpc.getGetMethod()

  public val setMethod: MethodDescriptor<_HttpSetRequest, _SetResponse>
    @JvmStatic
    get() = HttpCacheGrpc.getSetMethod()

  public val setButItsAPutMethod: MethodDescriptor<_HttpSetRequest, _SetResponse>
    @JvmStatic
    get() = HttpCacheGrpc.getSetButItsAPutMethod()

  /**
   * A stub for issuing RPCs to a(n) cache_client.HttpCache service as suspending coroutines.
   */
  @StubFor(HttpCacheGrpc::class)
  public class HttpCacheCoroutineStub @JvmOverloads constructor(
    channel: Channel,
    callOptions: CallOptions = DEFAULT,
  ) : AbstractCoroutineStub(channel, callOptions) {
    override fun build(channel: Channel, callOptions: CallOptions): HttpCacheCoroutineStub =
        HttpCacheCoroutineStub(channel, callOptions)

    /**
     * Executes this RPC and returns the response message, suspending until the RPC completes
     * with [`Status.OK`][io.grpc.Status].  If the RPC completes with another status, a
     * corresponding
     * [StatusException] is thrown.  If this coroutine is cancelled, the RPC is also cancelled
     * with the corresponding exception as a cause.
     *
     * @param request The request message to send to the server.
     *
     * @param headers Metadata to attach to the request.  Most users will not need this.
     *
     * @return The single response from the server.
     */
    public suspend fun `get`(request: _HttpGetRequest, headers: Metadata = Metadata()): HttpBody =
        unaryRpc(
      channel,
      HttpCacheGrpc.getGetMethod(),
      request,
      callOptions,
      headers
    )

    /**
     * Executes this RPC and returns the response message, suspending until the RPC completes
     * with [`Status.OK`][io.grpc.Status].  If the RPC completes with another status, a
     * corresponding
     * [StatusException] is thrown.  If this coroutine is cancelled, the RPC is also cancelled
     * with the corresponding exception as a cause.
     *
     * @param request The request message to send to the server.
     *
     * @param headers Metadata to attach to the request.  Most users will not need this.
     *
     * @return The single response from the server.
     */
    public suspend fun `set`(request: _HttpSetRequest, headers: Metadata = Metadata()): _SetResponse
        = unaryRpc(
      channel,
      HttpCacheGrpc.getSetMethod(),
      request,
      callOptions,
      headers
    )

    /**
     * Executes this RPC and returns the response message, suspending until the RPC completes
     * with [`Status.OK`][io.grpc.Status].  If the RPC completes with another status, a
     * corresponding
     * [StatusException] is thrown.  If this coroutine is cancelled, the RPC is also cancelled
     * with the corresponding exception as a cause.
     *
     * @param request The request message to send to the server.
     *
     * @param headers Metadata to attach to the request.  Most users will not need this.
     *
     * @return The single response from the server.
     */
    public suspend fun setButItsAPut(request: _HttpSetRequest, headers: Metadata = Metadata()):
        _SetResponse = unaryRpc(
      channel,
      HttpCacheGrpc.getSetButItsAPutMethod(),
      request,
      callOptions,
      headers
    )
  }

  /**
   * Skeletal implementation of the cache_client.HttpCache service based on Kotlin coroutines.
   */
  public abstract class HttpCacheCoroutineImplBase(
    coroutineContext: CoroutineContext = EmptyCoroutineContext,
  ) : AbstractCoroutineServerImpl(coroutineContext) {
    /**
     * Returns the response to an RPC for cache_client.HttpCache.Get.
     *
     * If this method fails with a [StatusException], the RPC will fail with the corresponding
     * [io.grpc.Status].  If this method fails with a [java.util.concurrent.CancellationException],
     * the RPC will fail
     * with status `Status.CANCELLED`.  If this method fails for any other reason, the RPC will
     * fail with `Status.UNKNOWN` with the exception as a cause.
     *
     * @param request The request from the client.
     */
    public open suspend fun `get`(request: _HttpGetRequest): HttpBody = throw
        StatusException(UNIMPLEMENTED.withDescription("Method cache_client.HttpCache.Get is unimplemented"))

    /**
     * Returns the response to an RPC for cache_client.HttpCache.Set.
     *
     * If this method fails with a [StatusException], the RPC will fail with the corresponding
     * [io.grpc.Status].  If this method fails with a [java.util.concurrent.CancellationException],
     * the RPC will fail
     * with status `Status.CANCELLED`.  If this method fails for any other reason, the RPC will
     * fail with `Status.UNKNOWN` with the exception as a cause.
     *
     * @param request The request from the client.
     */
    public open suspend fun `set`(request: _HttpSetRequest): _SetResponse = throw
        StatusException(UNIMPLEMENTED.withDescription("Method cache_client.HttpCache.Set is unimplemented"))

    /**
     * Returns the response to an RPC for cache_client.HttpCache.SetButItsAPut.
     *
     * If this method fails with a [StatusException], the RPC will fail with the corresponding
     * [io.grpc.Status].  If this method fails with a [java.util.concurrent.CancellationException],
     * the RPC will fail
     * with status `Status.CANCELLED`.  If this method fails for any other reason, the RPC will
     * fail with `Status.UNKNOWN` with the exception as a cause.
     *
     * @param request The request from the client.
     */
    public open suspend fun setButItsAPut(request: _HttpSetRequest): _SetResponse = throw
        StatusException(UNIMPLEMENTED.withDescription("Method cache_client.HttpCache.SetButItsAPut is unimplemented"))

    final override fun bindService(): ServerServiceDefinition = builder(getServiceDescriptor())
      .addMethod(unaryServerMethodDefinition(
      context = this.context,
      descriptor = HttpCacheGrpc.getGetMethod(),
      implementation = ::`get`
    ))
      .addMethod(unaryServerMethodDefinition(
      context = this.context,
      descriptor = HttpCacheGrpc.getSetMethod(),
      implementation = ::`set`
    ))
      .addMethod(unaryServerMethodDefinition(
      context = this.context,
      descriptor = HttpCacheGrpc.getSetButItsAPutMethod(),
      implementation = ::setButItsAPut
    )).build()
  }
}