Releases: grpc/grpc-java
Releases · grpc/grpc-java
v1.69.0
v1.69.0
New Features
- api: Allow
LoadBalancer
s to specify an authority per-RPC.(#11631) (c167ead) CallOptions.withAuthority() has higher precedence. - netty: Add soft Metadata size limit enforcement. (#11603) (735b3f3) The soft limit is a lower size limit that fails an increasing percentage of RPCs as the Metadata size approaches the upper limit. This can be used as an “early warning” that the Metadata size is growing too large
- alts: support altsCallCredentials in
GoogleDefaultChannelCredentials
(#11634) (ba8ab79) - xds: Add grpc.xds_client metrics, as documented by OpenTelemetry Metrics (#11661) (20d09ce).
grpc.xds.authority
is not yet available
Bug Fixes
- api: When forwarding from
Listener
onAddresses toListener2
continue to use onResult (#11666) (dae078c). This fixes a 1.68.1 "IllegalStateException: Not called from the SynchronizationContext" regression (#11662) that could be seen in certain custom NameResolvers - okhttp: If the frame handler thread is null do not schedule it on the executor (ef1fe87). This fixes a 1.68.1 NullPointerException regression when a custom transportExecutor was provided to the channel and it did not have enough threads to run new tasks
Improvements
- api: Add
java.time.Duration
overloads toCallOptions
,AbstractStub
methods that take TimeUnit and a time value (#11562) (766b923) - core: Make timestamp usage in Channelz use nanos from Java.time.Instant when available (#11604) (9176b55). This increases the timestamp precision from milliseconds
- okhttp: Fix for ipv6 link local with scope (#11725) (e98e7445b)
- binder: Let
AndroidComponentAddress
specify a target UserHandle (#11670) (e58c998) - servlet: Deframe failures should be logged on the server as warnings (#11645) (a5db67d)
- s2a: Rename the Bazel target s2av2_credentials to s2a (29dd9ba). The target s2a had been referenced by IO_GRPC_GRPC_JAVA_OVERRIDE_TARGETS but didn’t previously exist
- services: Make channelz work with proto lite (#11685) (b170334). This compatibility is on the source level. There is not a pre-built binary on Maven Central that supports proto lite
- services: Deprecate ProtoReflectionService (#11681) (921f88a). The class implements the deprecated v1alpha of the reflection protocol. Prefer ProtoReflectionServiceV1, which implements the v1 version of the reflection protocol
Dependencies
- Upgrade proto-google-common-protos to 2.48.0 (1993e68)
- Upgrade google-auth-library to 1.24.1 (1993e68)
- Upgrade error_prone_annotations to 2.30.0 (1993e68)
- Upgrade Guava to 33.3.1-android (1993e68)
- Upgrade opentelemetry-api to 1.43.0 (1993e68)
- xds: Remove Bazel dependency on xds v2 (664f1fc). This had been done for the Maven Central binaries in 1.63.0, but had been missed for Bazel builds
Documentation
- binder: Update error codes doc for new "Safer Intent" rules. (#11639) (fe350cf)
- examples: Use xds-enabled server and xds credentials in example-gcp-csm-observability (#11706) (a79982c)
Thanks to
@niloc132
@rockspore
@SreeramdasLavanya
@vinodhabib
v1.68.2
Bug Fixes
- api: When forwarding from Listener onAddresses to Listener2 continue to use onResult (#11688). This fixes a 1.68.1 "IllegalStateException: Not called from the SynchronizationContext" regression (#11662) that could be seen in certain custom NameResolvers
- okhttp: If the frame handler thread is null do not schedule it on the executor (#11716). This fixes a 1.68.1 NullPointerException regression when a custom transportExecutor was provided to the channel and it did not have enough threads to run new tasks
Improvements
- examples: Use xds-enabled server and xds credentials in example-gcp-csm-observability (#11707)
v1.68.1
v1.68.0 was a mistake. This is the first release of version 1.68.x
Bug Fixes
- xds: Fix NullPointerException introduced in "Fix load reporting when pick first is used for locality-routing" (#11553). This was in 1.67.1 but not 1.68.0
Behavior Changes
- core: JSON parsing rejects duplicate keys in objects (#11575) (4be69e3). This is the existing behavior in C core. Duplicate keys in objects are dangerous as which value takes effect is undefined. Previously, the last value was used
- okhttp: Detect transport executors with no remaining threads (#11503) (3a6be9c). The transport uses two threads, but one is on-demand. If the executor provided to
builder.transportExecutor()
runs out of threads (e.g., it is a fixed-size thread pool), all transports can be wedged, unable to run on-demand tasks, until keepalive kills one of them. Two threads are now used when handshaking a new transport, and the transport will time out after 1 second with “Timed out waiting for second handshake thread” if two threads are unavailable - gcp-csm-o11y: Get
mesh_id
value fromCSM_MESH_ID
environment variable, instead of getting it from bootstrap file (84d30af)
Improvements
- New grpc-context-override-opentelemetry artifact (#11523) (782a44a) (#11599) (e59ae5f). This is a
io.grpc.Context
storage override to store its state inio.opentelemetry.context.Context
. Libraries should not add a dependency on this artifact, as applications can only have one storage override in their classpath - New grpc-s2a artifact. It is a transport that offloads the handshake similar to ALTS, but for TLS. It provides
io.grpc.s2a.S2AChannelCredentials
- api: Enhance name resolver `ResolutionResult` to hold addresses or error so the single listener API onResult2 is used to convey both success and error cases for name resolution (#11330) (1ded8af)
- core: Handle NameResolver/LoadBalancer exceptions when panicking (b692b9d). This expands the class of bugs that will fail RPCs with the panic error, versus some undefined behavior
- core: Use the default service config in case of initial name resolver address resolution error (#11577) (fa26a8b)
- core:
StreamTracer.inboundMessageRead()
now reports uncompressed message size when the message does not need compression (#11598) (2aae68e). Previously it always reported-1
(unknown) - netty: Avoid TCP_USER_TIMEOUT warning when explicitly specifying a non-epoll channel type to use (#11564) (62f4098)
- okhttp: Don't warn about missing Conscrypt (6f35422). This is especially helpful when using TLS but not running on Android
- android: For
UdsChannelBuilder
, use fake IP instead of localhost (a908b5e). This avoids an unnecessary DNS lookup - xds: Add xDS node ID in select control plane errors to enable cross-referencing with control plane logs when debugging (f3cf7c3)
- xds: Enhanced how ADS stream terminations are handled, specifically addressing cases where a response has or hasn't been received (#2e9c3e19f)
- binder: Update status code documentation for Android 11's package visibility rules. (#11551) (99be6e9)
- binder: Update binderDied() error description to spell out the possibilities for those unfamiliar with Android internals. (#11628) (46c1b38)
- example-gauth: Use application default creds instead of file argument (#11595) (94a0a0d)
- opentelemetry: Experimental OpenTelemetry tracing is available. Set the
GRPC_EXPERIMENTAL_ENABLE_OTEL_TRACING
environment variable totrue
to enable tracing support inGrpcOpenTelemetry
(#11409, #11477)(043ba55, 421e237)
Dependencies
- Updated protobuf-java to 3.25.5. This helps avoid CVE-2024-7254 (2ff837a)
Thanks to:
@Juneezee
@lgalfaso
@bestbeforetoday
@hlx502
@JoeCqupt
v1.67.1
gRPC Java 1.67.1 Release Notes
There was no 1.67.0 release. There was a problem making the release and it went to Maven Central as 1.68.0 instead. This is a version-corrected release.
Improvements
- Petiole load balancing policies (e.g., round_robin, weighted_round_robin, ring_hash, least_request) had internal refactorings. This should not have changed their behavior
- api: Introduce onResult2 in NameResolver Listener2 that returns Status (90d0fab)
- core: touch() buffer when detach()ing (e821d5e). This makes it clearer whether a leak is a gRPC leak or an application leak when the Detachable API is being used
- example: delete duplicate and unused code in KeepAliveClient.java (6a9bc3b)
- example: Added Dualstack example (#11451) (72a977b)
- stub: Add newAttachMetadataServerInterceptor() MetadataUtil (#11458) (6dbd1b9)
- xds: Separate xds clients for each channel target, each with its own connection to an xds server. (#11484) (d034a56)
- xds: Envoy proto sync to 2024-07-06 (#11401) (96a788a)
- xds: cncf/xds proto sync to 2024-07-24 (#11417) (0017c98)
- xds: Import RLQS protos (#11418) (c29763d)
- xds: ClusterManagerLB must update child configuration (10d6002). Previously, RLS configuration would not have been updated
Bug Fixes
- core: Revert "Enable new PickFirst LB (#11348)" (#11425) (cc1cbe9)
- rls: Fix log statements incorrectly referring to "LRS" (#11497) (c63e354)
- util: Stop using SocketAddress.toString() for checking address equality (f866c80). This change applies to all petiole load balancing policies. For regular usages that use dns name resolution, this is unlikely to matter as the default dns name resolver returns consistent addresses. But this might improve LB behavior for some custom load balancers
- xds: Fix load reporting when pick first is used for locality-routing. (#11495) (1dae144)
- xds: Fix NullPointerException introduced in "Fix load reporting when pick first is used for locality-routing" (#11553). This change is not present in 1.68.0
- xds: XdsClient should unsubscribe on last resource (#11264) (448ec4f)
Dependencies
- Upgrade Netty to 4.1.110 and tcnative to 2.0.65 (#11444) (70ae832)
- examples: Upgrade Maven plugin versions (75012a5)
- Remove direct dependency on j2objc (ff8e413)
Thanks to
v1.68.0 MISTAKE
This was supposed to be v1.67.0, but there was a mistake during the release process. This has everything in v1.67.1, except for:
- xds: Fix NullPointerException introduced in "Fix load reporting when pick first is used for locality-routing" (#11553)
v1.66.0
gRPC Java 1.66.0 Release Notes
API Changes
- stub: Support setting onReadyThreshold through AbstractStub. (#11320) (25a8b7c)
- util: Stabilize
AdvancedTlsX509TrustManager
, anX509ExtendedTrustManager
that allows users to configure advanced TLS features, such as root certificate reloading and peer cert custom verification. (658cbf6) - util: Align AdvancedTlsX509{Key and Trust}Manager. (#11385)
- util: Add
GracefulSwitchLoadBalancer
config (ebed047) and mark switchTo() deprecated. (85e0a01).GracefulSwitchLoadBalancer
now receives its configuration like a regular load balancer. - binder: Introduce
AllowSecurityPolicy
to allow calling code to not have to wait on async/slow implementations.BinderTransport
now submits async implementations to an executor. (#11272) (7fee6a3) - api: Add convenience method in
ServerBuilder
for adding a list of service implementations to the handler registry together. (#11285) (85ed053)
Improvements
- examples: Improve example Bazel WORKSPACE to demonstrate referencing grpc-xds. (5ec0187)
- examples: Include Bazel bzlmod configuration (36e687f). There are now examples for both non-bzlmod and bzlmod.
- core: Fixes to
PickFirstLeafLoadBalancer
- core: Change default to use the new pick first load balancer (PickFirstLeafLoadBalancer). (#11348)
- core: Use retryThrottling from defaultServiceConfig when the name resolver config doesn't provide this config. (#11274) (062ebb4)
- netty: Enable use of Netty 4.1.111 by avoiding the optimization provided by
NettyAdaptiveCumulator
if Netty is on version 4.1.111 or later. (#11367) - binder: Set a default connect timeout of 60 seconds. (#11359) (21dec30)
- binder: Make
BinderServer
ownServerAuthInterceptor
's executor that helps avoid leaks. (#11293) (15ad9f5) - services:: Added
ProtoReflectionServiceV1
for the v1 reflection protocol. The preexistingProtoReflectionService
implements the v1alpha reflection protocol. (#11237) (0aa976c)
Bug Fixes
- binder: Add missing synchronization to prevent races when calling awaitTermination(). (#11277) (14fd81f)
- util: Fix
AdvancedTlsX509TrustManager
validation on servers when using SSLSocket. Previously it would try to use a null SSLEngine . (dcb1c01)
Dependencies
- compiler: Upgrade from CentOS 7 to AlmaLinux 8 for the pre-compiled Linux protoc-gen-grpc-java (71eb5fb). This adds a runtime dependency on libstdc++
- Upgrade animal-sniffer-annotations to 1.24 (a977385)
- Upgrade error_prone_annotations to 2.28.0 (a977385)
- Upgrade proto-google-common-protos to 2.41.0 (a977385)
- Upgrade google-auth-library to 1.23.0 (a977385)
- Upgrade gson to 2.11.0 (a977385)
- Upgrade guava to 33.2.1 (a977385)
- Upgrade opentelemetry to 1.40.0 (a977385)
- Upgrade perfmark-api to 0.27.0 (a977385)
- Upgrade protobuf-java to 3.25.3 (a977385)
- xds: Remove unused opencensus-proto dependency (e7c3803)
- bazel: Replace
@com_github_cncf_udpa
usage with preexisting@com_github_cncf_xds
; delete@com_github_cncf_udpa
repo alias for xds (6dd6ca9) - bazel: Upgrade envoyproxy/data-plane-api to 1611a730 (c540993). The version used by Gradle had been updated in 1.62.0 (68334a0), but the bazel version had not
- bazel: Use com_google_protobuf instead of com_google_protobuf_javalite (7a25e68). Bazel’s protobuf rules no longer use the old com_google_protobuf_javalite repository name
- bazel: Don't require protobuf to be in maven_install (d3c2f5a). Protobuf’s targets are generally just used directly; this fixed the only place that used maven’s
artifact()
syntax
Thanks to
v1.65.1
What's Changed
- netty: Restore old behavior of NettyAdaptiveCumulator, but avoid using that class if Netty is on version 4.1.111 or later
v1.64.2
What's Changed
- netty: Restore old behavior of NettyAdaptiveCumulator, but avoid using that class if Netty is on version 4.1.111 or later
v1.63.2
What's Changed
- okhttp: Workaround SSLSocket not noticing socket is closed
- netty: skip using NettyAdaptiveCumulator when Netty is on version 4.1.111 or later
v1.64.1
What's Changed
- netty:Fix Netty composite buffer merging to be compatible with Netty 4.1.111 (1.64.x backport) by @larry-safran in #11303