Deprecated List (servicetalk-grpc-api 0.42.37 API)

Deprecated Interfaces
Interface and Description
GrpcRoutes.AllGrpcRoutes This class is not used starting from version 0.42.0 (see PR#1893), we plan to remove it in future releases. In case you have a use-case, let us know.
GrpcSerializationProvider Serialization is now specified via `MethodDescriptor`. Compression is configured per route. gRPC framing is internalized in the gRPC implementation.
GrpcServiceFilterFactory gRPC Service Filters will be removed in future release of ServiceTalk. We encourage the use of `StreamingHttpServiceFilterFactory` and if the access to the decoded payload is necessary, then performing that logic can be done in the particular `service implementation`. Please use `HttpServerBuilder.appendServiceFilter(StreamingHttpServiceFilterFactory)` upon the `builder` obtained using `GrpcServerBuilder.initializeHttp(GrpcServerBuilder.HttpInitializer)` if HTTP filters are acceptable in your use case.

Deprecated Exceptions
Exceptions and Description
MessageEncodingException This exception type was thrown only by `ProtoBufSerializationProviderBuilder` that was deprecated and will be removed in future releases. Use `SerializationException` instead that can be thrown by a new implementation.

Deprecated Fields
Field and Description
io.servicetalk.grpc.api.DefaultGrpcClientMetadata.INSTANCE Use `DefaultGrpcClientMetadata()` to create a new instance instead. `GrpcClientMetadata` contains modifiable `GrpcMetadata.requestContext()` and `GrpcMetadata.responseContext()` now. Using this constant there will be no access to the actual context and both mentioned methods will throw `UnsupportedOperationException`.

Deprecated Methods
Method and Description
io.servicetalk.grpc.api.GrpcRoutes.addBlockingRequestStreamingRoute(String, Class<?>, String, GrpcRoutes.BlockingRequestStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addBlockingStreamingRoute(Class, MethodDescriptor, BufferDecoderGroup, List, BlockingStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addBlockingRequestStreamingRoute(String, GrpcExecutionStrategy, GrpcRoutes.BlockingRequestStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addBlockingRequestStreamingRoute(GrpcExecutionStrategy, MethodDescriptor, BufferDecoderGroup, List, BlockingRequestStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addBlockingResponseStreamingRoute(String, Class<?>, String, GrpcRoutes.BlockingResponseStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addBlockingResponseStreamingRoute(Class, MethodDescriptor, BufferDecoderGroup, List, BlockingResponseStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addBlockingResponseStreamingRoute(String, GrpcExecutionStrategy, GrpcRoutes.BlockingResponseStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addBlockingResponseStreamingRoute(GrpcExecutionStrategy, MethodDescriptor, BufferDecoderGroup, List, BlockingResponseStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addBlockingRoute(String, Class<?>, String, GrpcRoutes.BlockingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addBlockingRoute(Class, MethodDescriptor, BufferDecoderGroup, List, BlockingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addBlockingRoute(String, GrpcExecutionStrategy, GrpcRoutes.BlockingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addBlockingRoute(GrpcExecutionStrategy, MethodDescriptor, BufferDecoderGroup, List, BlockingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addBlockingStreamingRoute(String, Class<?>, String, GrpcRoutes.BlockingStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addBlockingStreamingRoute(Class, MethodDescriptor, BufferDecoderGroup, List, BlockingStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addBlockingStreamingRoute(String, GrpcExecutionStrategy, GrpcRoutes.BlockingStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addBlockingStreamingRoute(GrpcExecutionStrategy, MethodDescriptor, BufferDecoderGroup, List, BlockingStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addRequestStreamingRoute(String, Class<?>, String, GrpcRoutes.RequestStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addRequestStreamingRoute(Class, MethodDescriptor, BufferDecoderGroup, List, RequestStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addRequestStreamingRoute(String, GrpcExecutionStrategy, GrpcRoutes.RequestStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addRequestStreamingRoute(GrpcExecutionStrategy, MethodDescriptor, BufferDecoderGroup, List, RequestStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addResponseStreamingRoute(String, Class<?>, String, GrpcRoutes.ResponseStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addResponseStreamingRoute(Class, MethodDescriptor, BufferDecoderGroup, List, ResponseStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addResponseStreamingRoute(String, GrpcExecutionStrategy, GrpcRoutes.ResponseStreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addResponseStreamingRoute(GrpcExecutionStrategy, MethodDescriptor, BufferDecoderGroup, List, ResponseStreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addRoute(String, Class<?>, String, GrpcRoutes.Route<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addRoute(Class, MethodDescriptor, BufferDecoderGroup, List, Route)`.
io.servicetalk.grpc.api.GrpcRoutes.addRoute(String, GrpcExecutionStrategy, GrpcRoutes.Route<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addRoute(GrpcExecutionStrategy, MethodDescriptor, BufferDecoderGroup, List, Route)`.
io.servicetalk.grpc.api.GrpcRoutes.addStreamingRoute(String, Class<?>, String, GrpcRoutes.StreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addStreamingRoute(Class, MethodDescriptor, BufferDecoderGroup, List, StreamingRoute)`.
io.servicetalk.grpc.api.GrpcRoutes.addStreamingRoute(String, GrpcExecutionStrategy, GrpcRoutes.StreamingRoute<Req, Resp>, Class<Req>, Class<Resp>, GrpcSerializationProvider) Use `GrpcRoutes.addStreamingRoute(GrpcExecutionStrategy, MethodDescriptor, BufferDecoderGroup, List, StreamingRoute)`
io.servicetalk.grpc.api.GrpcStatus.asException() Use `GrpcStatusException(GrpcStatus)`.
io.servicetalk.grpc.api.GrpcStatus.asException(Supplier<Status>) Use `GrpcStatusException.of(Status)`.
io.servicetalk.grpc.api.GrpcStatus.cause() Use `GrpcStatusException.fromThrowable(Throwable)` to create a `GrpcStatusException` then `Throwable.getCause()`.
io.servicetalk.grpc.api.GrpcStatus.fromThrowable(Throwable) Use `GrpcStatusException.fromThrowable(Throwable)`.
io.servicetalk.grpc.api.GrpcStatus.fromThrowableNullable(Throwable) Use `GrpcStatusException.fromThrowable(Throwable)`.
io.servicetalk.grpc.api.GrpcRoutes.BlockingStreamingRoute.handle(GrpcServiceContext, BlockingIterable<Req>, GrpcPayloadWriter<Resp>) Use `GrpcRoutes.BlockingStreamingRoute.handle(GrpcServiceContext, BlockingIterable, BlockingStreamingGrpcServerResponse)`. In the next release, this method will have a default implementation but the new overload won't. To avoid breaking API changes, make sure to implement both methods. The release after next will remove this method. This intermediate step is necessary to maintain `FunctionalInterface` contract that requires to have a single non-default method. Note: if you also use `GrpcRoutes.BlockingStreamingRoute.wrap(GrpcRoutes.BlockingStreamingRoute, GracefulAutoCloseable)` method, make sure to pass there an implementation of `GrpcRoutes.BlockingStreamingRoute` that implements both overloads instead of a lambda. Otherwise, the default `GrpcRoutes.BlockingStreamingRoute.handle(GrpcServiceContext, BlockingIterable, BlockingStreamingGrpcServerResponse)` implementation will be used.
io.servicetalk.grpc.api.GrpcRoutes.BlockingResponseStreamingRoute.handle(GrpcServiceContext, Req, GrpcPayloadWriter<Resp>) Use `GrpcRoutes.BlockingResponseStreamingRoute.handle(GrpcServiceContext, Object, BlockingStreamingGrpcServerResponse)`. In the next release, this method will have a default implementation but the new overload won't. To avoid breaking API changes, make sure to implement both methods. The release after next will remove this method. This intermediate step is necessary to maintain `FunctionalInterface` contract that requires to have a single non-default method. Note: if you also use `GrpcRoutes.BlockingResponseStreamingRoute.wrap( GrpcRoutes.BlockingResponseStreamingRoute, GracefulAutoCloseable)` method, make sure to pass there an implementation of `GrpcRoutes.BlockingResponseStreamingRoute` that implements both overloads instead of a lambda. Otherwise, the default `GrpcRoutes.BlockingResponseStreamingRoute.handle(GrpcServiceContext, Object, BlockingStreamingGrpcServerResponse)` implementation will be used.
io.servicetalk.grpc.api.GrpcClientCallFactory.newBlockingCall(GrpcSerializationProvider, Class<Req>, Class<Resp>) use `GrpcClientCallFactory.newBlockingCall(MethodDescriptor, BufferDecoderGroup)`.
io.servicetalk.grpc.api.GrpcClientCallFactory.newBlockingRequestStreamingCall(GrpcSerializationProvider, Class<Req>, Class<Resp>) Use `GrpcClientCallFactory.newBlockingRequestStreamingCall(MethodDescriptor, BufferDecoderGroup)`.
io.servicetalk.grpc.api.GrpcClientCallFactory.newBlockingResponseStreamingCall(GrpcSerializationProvider, Class<Req>, Class<Resp>) Use `GrpcClientCallFactory.newBlockingResponseStreamingCall(MethodDescriptor, BufferDecoderGroup)`.
io.servicetalk.grpc.api.GrpcClientCallFactory.newBlockingStreamingCall(GrpcSerializationProvider, Class<Req>, Class<Resp>) Use `GrpcClientCallFactory.newBlockingStreamingCall(MethodDescriptor, BufferDecoderGroup)`.
io.servicetalk.grpc.api.GrpcClientCallFactory.newCall(GrpcSerializationProvider, Class<Req>, Class<Resp>) Use `GrpcClientCallFactory.newCall(MethodDescriptor, BufferDecoderGroup)`.
io.servicetalk.grpc.api.GrpcClientCallFactory.newRequestStreamingCall(GrpcSerializationProvider, Class<Req>, Class<Resp>) Use `GrpcClientCallFactory.newRequestStreamingCall(MethodDescriptor, BufferDecoderGroup)`.
io.servicetalk.grpc.api.GrpcClientCallFactory.newResponseStreamingCall(GrpcSerializationProvider, Class<Req>, Class<Resp>) Use `GrpcClientCallFactory.newResponseStreamingCall(MethodDescriptor, BufferDecoderGroup)`.
io.servicetalk.grpc.api.GrpcRoutes.newServiceFromRoutes(GrpcRoutes.AllGrpcRoutes) This method is not used starting from version 0.42.0 (see PR#1893), we plan to remove it in future releases. In case you have a use-case, let us know.
io.servicetalk.grpc.api.GrpcClientCallFactory.newStreamingCall(GrpcSerializationProvider, Class<Req>, Class<Resp>) Use `GrpcClientCallFactory.newStreamingCall(MethodDescriptor, BufferDecoderGroup)`.
io.servicetalk.grpc.api.GrpcExecutionStrategies.offloadNever() Use `GrpcExecutionStrategies.offloadNone()` instead.
io.servicetalk.grpc.api.GrpcMetadata.path() Use `MethodDescriptor.httpPath()`.
io.servicetalk.grpc.api.GrpcRoutes.registerRoutes(Service) This method is not used starting from version 0.42.0 (see PR#1893), we plan to remove it in future releases. In case you have a use-case, let us know.
io.servicetalk.grpc.api.GrpcClientMetadata.requestEncoding() Use `GrpcClientMetadata.requestCompressor()`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata.requestEncoding()
io.servicetalk.grpc.api.GrpcClientFactory.supportedMessageCodings() Use generated code methods targeting `List` of `BufferEncoder`s and `BufferDecoderGroup`.
io.servicetalk.grpc.api.GrpcServiceContext.supportedMessageCodings() Will be removed along with `ContentCodec`.
io.servicetalk.grpc.api.GrpcClientFactory.supportedMessageCodings(List<ContentCodec>) Use generated code methods targeting `List` of `BufferEncoder`s and `BufferDecoderGroup`.

Deprecated Constructors
Constructor and Description
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String) Use `DefaultGrpcClientMetadata()`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, ContentCodec) Use `DefaultGrpcClientMetadata(BufferEncoder)`
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, ContentCodec, Duration) Use `DefaultGrpcClientMetadata(BufferEncoder, Duration)`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, Duration) Use `DefaultGrpcClientMetadata(BufferEncoder, Duration)`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, GrpcClientMetadata) Use `DefaultGrpcClientMetadata(DefaultGrpcClientMetadata)`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, GrpcExecutionStrategy) Use `DefaultGrpcClientMetadata(GrpcExecutionStrategy, BufferEncoder)`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, GrpcExecutionStrategy, ContentCodec) Use `DefaultGrpcClientMetadata(GrpcExecutionStrategy, BufferEncoder)`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, GrpcExecutionStrategy, ContentCodec, Duration) Use `DefaultGrpcClientMetadata(GrpcExecutionStrategy, BufferEncoder, Duration)`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, GrpcExecutionStrategy, Duration) Use `DefaultGrpcClientMetadata(GrpcExecutionStrategy, BufferEncoder, Duration)`.
io.servicetalk.grpc.api.DefaultGrpcClientMetadata(String, Supplier<ContextMap>, Supplier<ContextMap>, GrpcExecutionStrategy, ContentCodec, Duration)
io.servicetalk.grpc.api.GrpcRoutes(RouteExecutionStrategyFactory<GrpcExecutionStrategy>) this constructor is not needed anymore, use `GrpcRoutes()` instead.
io.servicetalk.grpc.api.GrpcStatus(GrpcStatusCode, Throwable) Use `GrpcStatusException` if there is a `Throwable` cause.
io.servicetalk.grpc.api.GrpcStatus(GrpcStatusCode, Throwable, CharSequence) Use `GrpcStatusException` if there is a cause or `GrpcStatus(GrpcStatusCode, String)`.

Deprecated API

Contents