Deprecated API

Contents

• Deprecated Classes
• Deprecated Enums
• Deprecated Methods

Deprecated Classes

Class and Description
io.grpc.services.BinaryLogs Use BinaryLogs instead.
io.grpc.CallCredentials2 the new interface has been promoted into CallCredentials. Implementations should switch back to "extends CallCredentials".
io.grpc.services.ChannelzService Use ChannelzService instead.
io.grpc.auth.ClientAuthInterceptor use MoreCallCredentials.from(Credentials) instead.
io.grpc.services.HealthStatusManager Use HealthStatusManager instead.
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 Methods

Method and Description
io.grpc.Context.Storage.attach(Context) This is an old API that is no longer used.
io.grpc.stub.MetadataUtils.attachHeaders(T, Metadata) Use stub.withInterceptors(newAttachHeadersInterceptor(...)) instead.
io.grpc.stub.MetadataUtils.captureMetadata(T, AtomicReference<Metadata>, AtomicReference<Metadata>) Use stub.withInterceptors(newCaptureMetadataInterceptor()) instead.
io.grpc.MethodDescriptor.create(MethodDescriptor.MethodType, String, MethodDescriptor.Marshaller<RequestT>, MethodDescriptor.Marshaller<ResponseT>) use MethodDescriptor.newBuilder().
io.grpc.services.BinaryLogs.createBinaryLog(BinaryLogSink)
io.grpc.protobuf.services.BinaryLogs.createBinaryLog(BinaryLogSink)
io.grpc.LoadBalancer.Helper.createResolvingOobChannelBuilder(String) Use LoadBalancer.Helper.createResolvingOobChannelBuilder(String, ChannelCredentials) instead.
io.grpc.util.ForwardingLoadBalancerHelper.createResolvingOobChannelBuilder(String)
io.grpc.ClientStreamTracer.StreamInfo.getTransportAttrs() Use ClientStreamTracer.streamCreated(Attributes, Metadata) to handle the transport Attributes instead.
io.grpc.netty.GrpcHttp2ConnectionHandler.handleProtocolNegotiationCompleted(Attributes) Use the two argument method instead.
io.grpc.LoadBalancer.handleResolvedAddressGroups(List<EquivalentAddressGroup>, Attributes) override instead
io.grpc.util.ForwardingLoadBalancer.handleResolvedAddressGroups(List<EquivalentAddressGroup>, Attributes)
io.grpc.LoadBalancer.handleSubchannelState(LoadBalancer.Subchannel, ConnectivityStateInfo) This method will be removed. Stop overriding it. Instead, pass LoadBalancer.SubchannelStateListener to LoadBalancer.Subchannel.start(io.grpc.LoadBalancer.SubchannelStateListener) to receive Subchannel state updates
io.grpc.util.ForwardingLoadBalancer.handleSubchannelState(LoadBalancer.Subchannel, ConnectivityStateInfo)
io.grpc.util.GracefulSwitchLoadBalancer.handleSubchannelState(LoadBalancer.Subchannel, ConnectivityStateInfo)
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.ForwardingChannelBuilder.nameResolverFactory(NameResolver.Factory)
io.grpc.ManagedChannelBuilder.nameResolverFactory(NameResolver.Factory) Most usages should use a globally-registered NameResolverProvider instead, with either the SPI mechanism or NameResolverRegistry.register(io.grpc.NameResolverProvider). Replacements for all use-cases are not necessarily available yet. See #7133.
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.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.NameResolver.Listener2.onAddresses(List<EquivalentAddressGroup>, Attributes) This will be removed in 1.22.0
io.grpc.testing.TestUtils.preferredTestCiphers() Not for public use
io.grpc.LoadBalancer.SubchannelPicker.requestConnection() override LoadBalancer.requestConnection() instead.
io.grpc.ServerStreamTracer.serverCallStarted(ServerCall<?, ?>) Implement ServerStreamTracer.serverCallStarted(ServerCallInfo) instead. This method will be removed in a future release of gRPC.
io.grpc.ClientStreamTracer.StreamInfo.Builder.setTransportAttrs(Attributes) Use ClientStreamTracer.streamCreated(Attributes, Metadata) to handle the transport Attributes instead.
io.grpc.stub.AbstractStub.withChannel(Channel)