Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Enums
• Deprecated Fields
• Deprecated Methods

Deprecated Interfaces

Interface and Description
io.grpc.CallCredentials.MetadataApplier

Deprecated Classes

Class and Description
io.grpc.auth.ClientAuthInterceptor use MoreCallCredentials.from(Credentials) instead.
io.grpc.netty.HandlerSettings renamed to InternalHandlerSettings and should not be used externally
io.grpc.PickFirstBalancerFactory this is the default balancer and should not be referenced to. This will be deleted soon.
io.grpc.util.RoundRobinLoadBalancerFactory use LoadBalancerRegistry.getProvider(java.lang.String) with "round-robin" policy. This class will be deleted soon.
io.grpc.testing.StreamRecorder Not for public use

Deprecated Enums

Enum and Description
io.grpc.okhttp.NegotiationType use OkHttpChannelBuilder.usePlaintext() or OkHttpChannelBuilder.useTransportSecurity() directly rather than OkHttpChannelBuilder.negotiationType(NegotiationType).

Deprecated Fields

Field and Description
io.grpc.CallCredentials.ATTR_AUTHORITY
io.grpc.CallCredentials.ATTR_SECURITY_LEVEL transport implementations should use io.grpc.internal.GrpcAttributes.ATTR_SECURITY_LEVEL instead.
io.grpc.okhttp.OkHttpChannelBuilder.DEFAULT_CONNECTION_SPEC Deemed of little benefit and users weren't using it. Just define one yourself

Deprecated Methods

Method and Description
io.grpc.CallCredentials.applyRequestMetadata(MethodDescriptor<?, ?>, Attributes, Executor, CallCredentials.MetadataApplier) implement CallCredentials2 instead.
io.grpc.Context.Storage.attach(Context) This is an old API that is no longer used.
io.grpc.MethodDescriptor.create(MethodDescriptor.MethodType, String, MethodDescriptor.Marshaller<RequestT>, MethodDescriptor.Marshaller<ResponseT>) use MethodDescriptor.newBuilder().
io.grpc.netty.NettyChannelBuilder.enableKeepAlive(boolean) Please use NettyChannelBuilder.keepAliveTime(long, java.util.concurrent.TimeUnit) and NettyChannelBuilder.keepAliveTimeout(long, java.util.concurrent.TimeUnit) instead
io.grpc.okhttp.OkHttpChannelBuilder.enableKeepAlive(boolean) Use OkHttpChannelBuilder.keepAliveTime(long, java.util.concurrent.TimeUnit) instead
io.grpc.netty.NettyChannelBuilder.enableKeepAlive(boolean, long, TimeUnit, long, TimeUnit) Please use NettyChannelBuilder.keepAliveTime(long, java.util.concurrent.TimeUnit) and NettyChannelBuilder.keepAliveTimeout(long, java.util.concurrent.TimeUnit) instead
io.grpc.okhttp.OkHttpChannelBuilder.enableKeepAlive(boolean, long, TimeUnit, long, TimeUnit) Use OkHttpChannelBuilder.keepAliveTime(long, java.util.concurrent.TimeUnit) and OkHttpChannelBuilder.keepAliveTimeout(long, java.util.concurrent.TimeUnit) instead
io.grpc.netty.GrpcHttp2ConnectionHandler.handleProtocolNegotiationCompleted(Attributes) Use the two argument method instead.
io.grpc.Context.CancellableContext.isCurrent() This method violates some GRPC class encapsulation and should not be used. If you must know whether a Context is the current context, check whether it is the same object returned by Context.current().
io.grpc.Attributes.keys() This method is being considered for removal, if you feel this method is needed please reach out on this Github issue: grpc-java/issues/1764.
io.grpc.testing.TestUtils.loadX509Cert(String) Not for public use
io.grpc.netty.NettyChannelBuilder.maxHeaderListSize(int) Use NettyChannelBuilder.maxInboundMetadataSize(int) instead
io.grpc.netty.NettyServerBuilder.maxHeaderListSize(int) Use NettyServerBuilder.maxInboundMetadataSize(int) instead
io.grpc.netty.NettyServerBuilder.maxMessageSize(int) Call NettyServerBuilder.maxInboundMessageSize(int) instead. This method will be removed in a future release.
io.grpc.okhttp.OkHttpChannelBuilder.negotiationType(NegotiationType) use OkHttpChannelBuilder.usePlaintext() or OkHttpChannelBuilder.useTransportSecurity() instead.
io.grpc.Attributes.newBuilder(Attributes) Use Attributes.toBuilder() on the Attributes instance instead. This method will be removed in the future.
io.grpc.ClientStreamTracer.Factory.newClientStreamTracer(Metadata) Override/call ClientStreamTracer.Factory.newClientStreamTracer(CallOptions, Metadata) instead.
io.grpc.testing.TestUtils.newSslSocketFactoryForCa(Provider, File) Not for public use
io.grpc.Attributes.Key.of(String) use Attributes.Key.create(java.lang.String) instead. This method will be removed in the future.
io.grpc.CallOptions.Key.of(String, T) Use CallOptions.Key.create(java.lang.String) or CallOptions.Key.createWithDefault(java.lang.String, T) instead. This method will be removed.
io.grpc.testing.TestUtils.preferredTestCiphers() Not for public use
io.grpc.util.ForwardingLoadBalancerHelper.runSerialized(Runnable)
io.grpc.LoadBalancer.Helper.runSerialized(Runnable) use/implement getSynchronizationContext() instead
io.grpc.ServerStreamTracer.serverCallStarted(ServerCall<?, ?>) Implement ServerStreamTracer.serverCallStarted(ServerCallInfo) instead. This method will be removed in a future release of gRPC.
io.grpc.ManagedChannelBuilder.usePlaintext(boolean) Use ManagedChannelBuilder.usePlaintext() instead.
io.grpc.inprocess.InProcessChannelBuilder.usePlaintext(boolean) use InProcessChannelBuilder.usePlaintext() instead.
io.grpc.ForwardingChannelBuilder.usePlaintext(boolean) use ForwardingChannelBuilder.usePlaintext() instead.
io.grpc.netty.NettyChannelBuilder.usePlaintext(boolean) use NettyChannelBuilder.usePlaintext() instead.
io.grpc.okhttp.OkHttpChannelBuilder.usePlaintext(boolean) use OkHttpChannelBuilder.usePlaintext() instead.
io.grpc.stub.AbstractStub.withChannel(Channel)