sila_java.library.server_base.metadata

Class MetadataInterceptor

java.lang.Object

sila_java.library.server_base.metadata.MetadataInterceptor

All Implemented Interfaces:

io.grpc.ServerInterceptor

public abstract class MetadataInterceptor
extends Object
implements io.grpc.ServerInterceptor

Constructor Summary

Constructors

Constructor and Description
MetadataInterceptor(@NonNull List<String> affectedCalls)
MetadataInterceptor(@NonNull String affectedCall)

Method Summary

Modifier and Type	Method and Description
abstract <ReqT,RespT> io.grpc.Context	intercept(io.grpc.ServerCall<ReqT,RespT> call, ServerMetadataContainer metadata) Handle received SiLA Client Metadata
<ReqT,RespT> io.grpc.ServerCall.Listener<ReqT>	interceptCall(io.grpc.ServerCall<ReqT,RespT> call, io.grpc.Metadata headers, io.grpc.ServerCallHandler<ReqT,RespT> next) The actual interception logic: Calls intercept(ServerCall, ServerMetadataContainer) and forwards the returned context to the next call handler.

Methods inherited from class java.lang.Object

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

Constructor Detail

MetadataInterceptor

public MetadataInterceptor(@NonNull
                           @NonNull List<String> affectedCalls)

MetadataInterceptor

public MetadataInterceptor(@NonNull
                           @NonNull String affectedCall)

Method Detail

intercept

public abstract <ReqT,RespT> io.grpc.Context intercept(io.grpc.ServerCall<ReqT,RespT> call,
                                                       ServerMetadataContainer metadata)

Handle received SiLA Client Metadata

Type Parameters:

ReqT - request type

RespT - response type

Parameters:

call - incoming call

metadata - received SiLA Client Metadata

Returns:

context for the next call (usually Context.current())

Implementation Note:

The returned Context is ignored when handling metadata during SiLA Binary Upload

interceptCall

public final <ReqT,RespT> io.grpc.ServerCall.Listener<ReqT> interceptCall(io.grpc.ServerCall<ReqT,RespT> call,
                                                                          io.grpc.Metadata headers,
                                                                          io.grpc.ServerCallHandler<ReqT,RespT> next)

The actual interception logic: Calls intercept(ServerCall, ServerMetadataContainer) and forwards the returned context to the next call handler. On error, the appropriate SiLA Error is issued.

Specified by:

interceptCall in interface io.grpc.ServerInterceptor

Type Parameters:

ReqT - request type

RespT - response type

Parameters:

call - object to receive response messages

headers - which can contain extra call metadata from ClientCall.start(io.grpc.ClientCall.Listener<RespT>, io.grpc.Metadata), e.g. authentication credentials.

next - next processor in the interceptor chain

Returns:

next call listener