Module io.helidon.microprofile.grpc.core
Package io.helidon.microprofile.grpc.core

Class ClientStreamingMethodHandlerSupplier.ClientStreamingIterable<ReqT,RespT>

java.lang.Object
io.helidon.microprofile.grpc.core.ClientStreamingMethodHandlerSupplier.AbstractClientStreamingHandler<ReqT,RespT>
io.helidon.microprofile.grpc.core.ClientStreamingMethodHandlerSupplier.ClientStreamingIterable<ReqT,RespT>
Type Parameters:
ReqT - the request type
RespT - the response type
All Implemented Interfaces:
io.grpc.stub.ServerCalls.BidiStreamingMethod<ReqT,RespT>, io.grpc.stub.ServerCalls.ClientStreamingMethod<ReqT,RespT>, io.grpc.stub.ServerCalls.ServerStreamingMethod<ReqT,RespT>, io.grpc.stub.ServerCalls.UnaryMethod<ReqT,RespT>, MethodHandler<ReqT,RespT>
Enclosing class:
ClientStreamingMethodHandlerSupplier
public static class ClientStreamingMethodHandlerSupplier.ClientStreamingIterable<ReqT,RespT> extends ClientStreamingMethodHandlerSupplier.AbstractClientStreamingHandler<ReqT,RespT>
A client side only client streaming MethodHandler that streams requests from an iterable. 
     CompletionStage<RespT> invoke(Iterable<ReqT> observer)

  • Method Details

    • clientOnly

      public boolean clientOnly()
      Description copied from interface: MethodHandler
      Determine whether this is a client side only handler.
      Returns:
      true if this handler can only be used on the client

    • invoke

      protected io.grpc.stub.StreamObserver<ReqT> invoke(Method method, Object instance, io.grpc.stub.StreamObserver<RespT> observer) throws InvocationTargetException, IllegalAccessException
      Invoke the actual client streaming or bi-directional gRPC method handler.
      Parameters:
      method - the Method to invoke
      instance - the service instance to invoke the method on
      observer - the method response observer
      Returns:
      the StreamObserver to receive requests from the client
      Throws:
      InvocationTargetException - if an error occurs invoking the method
      IllegalAccessException - if the method cannot be accessed

    • clientStreaming

      public Object clientStreaming(Object[] args, MethodHandler.ClientStreaming client)
      Description copied from interface: MethodHandler
      Handle a bi-directional client call.
      Parameters:
      args - the call arguments.
      client - the MethodHandler.ClientStreaming instance to forward the call to.
      Returns:
      the call result

    • type

      public final io.grpc.MethodDescriptor.MethodType type()
      Description copied from interface: MethodHandler
      Obtain the gRPC method tyoe that this MethodHandler handles.
      Specified by:
      type in interface MethodHandler<ReqT,RespT>
      Returns:
      the gRPC method type that this MethodHandler handles

    • invoke

      public void invoke(ReqT request, io.grpc.stub.StreamObserver<RespT> observer)
      Specified by:
      invoke in interface MethodHandler<ReqT,RespT>
      Specified by:
      invoke in interface io.grpc.stub.ServerCalls.ServerStreamingMethod<ReqT,RespT>
      Specified by:
      invoke in interface io.grpc.stub.ServerCalls.UnaryMethod<ReqT,RespT>

    • invoke

      public io.grpc.stub.StreamObserver<ReqT> invoke(io.grpc.stub.StreamObserver<RespT> observer)
      Specified by:
      invoke in interface MethodHandler<ReqT,RespT>
      Specified by:
      invoke in interface io.grpc.stub.ServerCalls.BidiStreamingMethod<ReqT,RespT>
      Specified by:
      invoke in interface io.grpc.stub.ServerCalls.ClientStreamingMethod<ReqT,RespT>

    • getRequestType

      public Class<?> getRequestType()
      Description copied from interface: MethodHandler
      Obtain the request type.
      Specified by:
      getRequestType in interface MethodHandler<ReqT,RespT>
      Returns:
      the request type

    • setRequestType

      protected void setRequestType(Class<?> requestType)
      Set the request type to use if no Grpc.RequestType annotation is present on the annotated method.
      Parameters:
      requestType - the request type

    • getResponseType

      public Class<?> getResponseType()
      Description copied from interface: MethodHandler
      Obtain the response type.
      Specified by:
      getResponseType in interface MethodHandler<ReqT,RespT>
      Returns:
      the response type

    • javaMethodName

      public String javaMethodName()
      Description copied from interface: MethodHandler
      Obtain the name of the underlying Java method that this handler maps to.
      Specified by:
      javaMethodName in interface MethodHandler<ReqT,RespT>
      Returns:
      the name of the underlying Java method that this handler maps to

    • setResponseType

      protected void setResponseType(Class<?> responseType)
      Set the response type to use if no Grpc.ResponseType annotation is present on the annotated method.
      Parameters:
      responseType - the response type

    • methodName

      protected String methodName()
      Obtain the gRPC method name.
      Returns:
      the gRPC method name

    • handleFuture

      protected Void handleFuture(RespT response, Throwable thrown, io.grpc.stub.StreamObserver<RespT> observer)
      Complete a StreamObserver.
      Parameters:
      response - the response value
      thrown - an error that may have occurred
      observer - the StreamObserver to complete
      Returns:
      always returns Void (i.e. null)

    • getGenericResponseType

      protected Class<?> getGenericResponseType(Type type)
      Obtain the generic type of a Type

      Typically used to obtain the generic type of a StreamObserver but could be used to obtain the generic type of other classes.

      If the type passed in is a Class then it has no generic component so the Object Class will be returned. Typically this would be due to a declaration such as 

      StreamObserver observer
      instead of a generic declaration such as 
      StreamObserver<String> observer
      .
      Parameters:
      type - the type to obtain the generic type from
      Returns:
      the generic type of a Type