Package com.linecorp.armeria.server.grpc.protocol

Class AbstractUnsafeUnaryGrpcService

java.lang.Object

com.linecorp.armeria.server.AbstractHttpService

com.linecorp.armeria.server.grpc.protocol.AbstractUnsafeUnaryGrpcService

All Implemented Interfaces:

Unwrappable, HttpService, Service<HttpRequest,HttpResponse>

Direct Known Subclasses:

AbstractUnaryGrpcService

@UnstableApi
public abstract class AbstractUnsafeUnaryGrpcService
extends AbstractHttpService

An AbstractUnsafeUnaryGrpcService can be used to implement a gRPC service without depending on gRPC stubs. This service takes care of deframing and framing with the gRPC wire format and handling appropriate headers. This unsafe version of a unary gRPC service accepts and returns pooled ByteBuf for payloads. It is for advanced users only, and it is generally recommended to use normal gRPC stubs or AbstractUnaryGrpcService.

This service does not support compression. If you need support for compression, please consider using normal gRPC stubs or file a feature request.

Constructor Summary

Constructors

Constructor	Description
AbstractUnsafeUnaryGrpcService()

Method Summary

Modifier and Type	Method	Description
protected final HttpResponse	doPost(ServiceRequestContext ctx, HttpRequest req)	Handles a POST request.
ExchangeType	exchangeType(RoutingContext routingContext)	Determines an ExchangeType for this HttpService from the given RoutingContext.
protected abstract CompletionStage<ByteBuf>	handleMessage(ServiceRequestContext ctx, ByteBuf message)	Returns an unframed response message to return to the client, given an unframed request message.

Methods inherited from class com.linecorp.armeria.server.AbstractHttpService

doConnect, doDelete, doGet, doHead, doOptions, doPatch, doPut, doTrace, serve

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.linecorp.armeria.server.HttpService

decorate, decorate

Methods inherited from interface com.linecorp.armeria.server.Service

as, serviceAdded, shouldCachePath, unwrap

Methods inherited from interface com.linecorp.armeria.common.util.Unwrappable

equalsIgnoreWrapper, unwrapAll

Constructor Details

AbstractUnsafeUnaryGrpcService

public AbstractUnsafeUnaryGrpcService()

Method Details

handleMessage

protected abstract CompletionStage<ByteBuf> handleMessage(ServiceRequestContext ctx,
 ByteBuf message)

Returns an unframed response message to return to the client, given an unframed request message. It is expected that the implementation has the logic to know how to parse the request and serialize a response into ByteBuf. The returned ByteBuf will be framed and returned to the client.

exchangeType

public ExchangeType exchangeType(RoutingContext routingContext)

Description copied from interface: HttpService

Determines an ExchangeType for this HttpService from the given RoutingContext. By default, ExchangeType.BIDI_STREAMING is set.

Note that an HttpRequest will be aggregated before serving the HttpService if ExchangeType.UNARY or ExchangeType.RESPONSE_STREAMING is set.

doPost

protected final HttpResponse doPost(ServiceRequestContext ctx,
 HttpRequest req)

Description copied from class: AbstractHttpService

Handles a POST request. This method sends a 405 Method Not Allowed response by default.

Overrides:

doPost in class AbstractHttpService