CLAassistant
commented
4 months ago
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.
This PR contains the following updates:
1.54.1->1.57.0By merging this PR, the issue #1990 will be automatically resolved and closed:
Release Notes
grpc/grpc-java (io.grpc:grpc-api)
### [`v1.57.0`](https://togithub.com/grpc/grpc-java/releases/tag/v1.57.0) #### gRPC Java 1.57.0 Release Notes This release accidentally broke Java 8: `NoSuchMethodError` for some ByteBuffer methods. The issue is tracked in [https://github.com/grpc/grpc-java/issues/10432](https://togithub.com/grpc/grpc-java/issues/10432) and fixed in 1.57.1. ##### API Changes - Use fully qualified java.lang.String in all cases in generated code. This fixes compilation if a protobuf message is named “String”. - Stabilize io.grpc.Status.asRuntimeException(Metadata) and trailersFromThrowable - Stabilize io.grpc.ManagedChannelBuilder.useTransportSecurity ([#10244](https://togithub.com/grpc/grpc-java/issues/10244)) - Stabilize io.grpc.util.MutableHandlerRegistry ([#10348](https://togithub.com/grpc/grpc-java/issues/10348)) ##### Behavior Changes - api: CheckedForwardingClientCall now passes trailers from the caught exception - context, api: Package io.grpc is now consolidated into a single artifact grpc-api by moving classes from grpc-context to grpc-api. grpc-context now has a dependency on grpc-api (but excludes other dependencies of grpc-api) so any application previously using only grpc-context will now also bring in grpc-api. This fixes [#3522](https://togithub.com/grpc/grpc-java/issues/3522) which was the major issue preventing support of Java modules. We are not done fixing support, as some artifacts need to be split and Automatic-Module-Name needs to be added. The next release is likely to be more stable for modules. - core: Change delay for hedging retry after a non-fatal error to be 0 to match the gRFC ([A6](https://togithub.com/grpc/proposal/blob/master/A6-client-retries.md)). - core: Wrap other name resolver types in a RetryingNameResolver . Previously, if authority was not overridden, then some name resolvers (such as grpclb) had no retry. - xds: Handle loops and duplicates in xds Aggregate clusters - xds: require EDS service name in CDS resources with an xdstp name - xds: Use Rule order instead of RuleChain - xds: Environment variable "GRPC_XDS_EXPERIMENTAL_SECURITY_SUPPORT" is no longer respected, so xDS security cannot be disabled any more ([#10243](https://togithub.com/grpc/grpc-java/issues/10243)) ##### New Features - binder: Add `UserHandle` and `BinderChannelCredentials` to support cross-user communication ([#10197](https://togithub.com/grpc/grpc-java/issues/10197)) - xds,orca: LRS named metrics support ##### Improvements - core: Resolve isAndroid only once on class loading. This can improve channel creation performance on Android. - xds: Pick a subchannel with new static stride scheduler in WeightedRoundRobinLoadBalancer ##### Bug Fixes - xds: Fix the server sending a GOAWAY when an LDS update with no changes other than ordering is received. - netty: Fix NPE when a header with errors is received with endStream=true. This was causing logs to be filled with errors when health checkers didn’t specify a content type. - okhttp: Fix the Socket data race when shutdown/closed during connecting that was causing a significant delay ##### Dependencies - Upgraded Netty to 4.1.93-Final - Update guava dependency to 32.0.1 to address CVE-2023-2976 ##### Acknowledgements - Benjamin Peterson - Masakuni Oishi - Philip K. Warren - Stephane Landelle ### [`v1.56.1`](https://togithub.com/grpc/grpc-java/releases/tag/v1.56.1) ##### Bug fixes - core: Fix regression in 1.54.0 where polling NameResolvers would not refresh after a resolution error ([#10328](https://togithub.com/grpc/grpc-java/issues/10328)). The symptom is a transient failure like "UNAVAILABLE: Unable to resolve host" continuing potentially forever. This did not impact DnsNameResolver, but it did impacted GrpclbNameResolver which is the dns name resolver used when `grpc-grpclb` is in the classpath. So even users that think "I don't use grpclb" may have been impacted. `round_robin` is mainly impacted on startup, but if the error happened afterward it would commonly fix itself for short transient DNS failures. `pick_first` is impacted at all times; any failed DNS resolution could cause all future RPCs on the channel to fail. ### [`v1.56.0`](https://togithub.com/grpc/grpc-java/releases/tag/v1.56.0) ##### API Changes - api: Stabilize the `SynchronizationContext` class ([#10130](https://togithub.com/grpc/grpc-java/issues/10130)). - api: Stabilize `io.grpc.CallCredentials` ([#10208](https://togithub.com/grpc/grpc-java/issues/10208), [#10211](https://togithub.com/grpc/grpc-java/issues/10211)). `thisUsesUnstableApi()` is `@Deprecated` and has a default implementation. `CallCredentials` implementations should delete their implementation or remove `@Overrides`, as the method will be deleted in the future. - api: Stabilize the `ProxyDetector` hierarchy and `ManagedChannelBuilder.proxyDetector` method. ##### Behavior Changes - core: Sticky `TRANSIENT_FAILURE` in `PickFirstLoadBalancer` ([#10106](https://togithub.com/grpc/grpc-java/issues/10106)). See [gRFC A62](https://togithub.com/grpc/proposal/blob/master/A62-pick-first.md#sticky-transient-failure). If it can't connect, pick-first will now immediately fail RPCs until after it successfully connects. RPCs will no longer be delayed while it performs those attempts, which previously could cause significant (error) latency. It now also performs reconnect attempts after failure and backoff without prompting; previously it required an RPC to trigger the reconnect. `ManagedChannel.idleTimeout` (defaults to 30 minutes) still applies and forces the channel idle after a period of no RPCs. - stub: Add a null check for `responseObserver` into the methods for initiating a call that takes a `responseObserver` argument. This ensures a fail fast with a clearer cause instead of an NPE when the observer is first used. - xds: Flip default for RLS being enabled to true for XDS ([#10248](https://togithub.com/grpc/grpc-java/issues/10248)) ([#10252](https://togithub.com/grpc/grpc-java/issues/10252)). If there are no RLS configurations in your XDS or you already enabled it with the environment variable this will have no effect. To disable it, set the flag `GRPC_EXPERIMENTAL_XDS_RLS_LB` to false. - xds: Rename `weighted_round_robin_experimental` LB Policy to `weighted_round_robin` ([#10162](https://togithub.com/grpc/grpc-java/issues/10162)). ##### New Features - protobuf,protobuf-lite: Allow to configure protobuf recursion limit ([#10094](https://togithub.com/grpc/grpc-java/issues/10094)). - core: Optional address shuffle in `PickFirstLoadBalancer` ([#10110](https://togithub.com/grpc/grpc-java/issues/10110)). - xds: `pick_first` LB configuration ([#10181](https://togithub.com/grpc/grpc-java/issues/10181)). ##### Improvements - xds: Add `error-per-second` in weight formula for client-side WRR ([#10177](https://togithub.com/grpc/grpc-java/issues/10177)). - xds: Use` application_utilization ` and fallback to `cpu_utilization` if unset in weight formula for client-side WRR. ([#10256](https://togithub.com/grpc/grpc-java/issues/10256)). - bazel: The README now mentions Bazel and where to find the example. ([#10217](https://togithub.com/grpc/grpc-java/issues/10217)). ##### Bug Fixes - binder: Handle unexpected exceptions on binder threads. ([#10092](https://togithub.com/grpc/grpc-java/issues/10092). - android,binder,cronet: `.aar` file when publishing. ([#10138](https://togithub.com/grpc/grpc-java/issues/10138)). - api: Fix boundary check in `Status.fromCodeValue()`. ([#10155](https://togithub.com/grpc/grpc-java/issues/10155)). - core: Don't use system Locale for content-type matching. ([#10097](https://togithub.com/grpc/grpc-java/issues/10097)). - okhttp: Fix signed-byte comparison in server when checking for ASCII in header ([#10151](https://togithub.com/grpc/grpc-java/issues/10151)). Without fix, authority could contain utf-8. ##### Dependencies - Version pinning (e.g., `[1.56.0]` instead of `1.56.0`) has been removed from POMs, for both Netty and gRPC dependencies. The pinning was unreliable in Maven and ignored in Gradle, yet caused downloads during the build to fetch the version list. For a while we've had a BOM that helps reduce version skew. ([#10175](https://togithub.com/grpc/grpc-java/issues/10175)). - bazel: Add java toolchain type to all rules using `java_common`. ([#10225](https://togithub.com/grpc/grpc-java/issues/10225)). - Upgraded `netty-tcnative-boringssl-static` in `grpc-netty-shaded` to 2.0.61.Final ([#10260](https://togithub.com/grpc/grpc-java/issues/10260)). Netty itself was not updated. - Upgraded AndroidX Annotation to 1.6.0 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). - Upgraded AndroidX Core to 1.10.0 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). - Upgraded AndroidX Lifecycle-Common to 2.6.1 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). - Upgraded OpenCensus to 0.31.1 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). - Upgraded Cronet API to 108.5359.79 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). - Upgraded `proto-google-common-protos` to 2.17.0 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). - Upgraded Gson to 2.10.1 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). - Upgraded PerfMark API to 0.26.0 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). - Upgraded RE2/J to 1.7 ([#10178](https://togithub.com/grpc/grpc-java/issues/10178)). ##### Acknowledgements - [@chenwei321](https://togithub.com/chenwei321) - [@cushon](https://togithub.com/cushon) - [@kloyan](https://togithub.com/kloyan) - [@kotlaja](https://togithub.com/kotlaja) - [@vorburger](https://togithub.com/vorburger) ### [`v1.55.3`](https://togithub.com/grpc/grpc-java/releases/tag/v1.55.3) ##### Bug fixes - core: Fix regression in 1.54.0 where polling NameResolvers would not refresh after a resolution error ([#10328](https://togithub.com/grpc/grpc-java/issues/10328)). The symptom is a transient failure like "UNAVAILABLE: Unable to resolve host" continuing potentially forever. This did not impact DnsNameResolver, but it did impacted GrpclbNameResolver which is the dns name resolver used when `grpc-grpclb` is in the classpath. So even users that think "I don't use grpclb" may have been impacted. `round_robin` is mainly impacted on startup, but if the error happened afterward it would commonly fix itself for short transient DNS failures. `pick_first` is impacted at all times; any failed DNS resolution could cause all future RPCs on the channel to fail. ### [`v1.55.1`](https://togithub.com/grpc/grpc-java/releases/tag/v1.55.1) The 1.55.0 release failed. There were no artifacts published for it. ##### API Changes - services: Rename `MetricRecorder.setQps`/`clearQps` to `setQpsMetric`/`clearQpsMetric` ([#10031](https://togithub.com/grpc/grpc-java/issues/10031)) ##### Behavior Changes - gcp-observability: Remove monitored resource detection for logging ([https://github.com/grpc/grpc-java/pull/10020](https://togithub.com/grpc/grpc-java/pull/10020)). The cloud libraries will fill in these details instead - protoc-gen-grpc-java: binaries for Linux ARM and PPC are now built using Ubuntu 18.04. They will no longer work on Ubuntu 16.04 and Debian 9 ##### New Features - api: Stabilize the frequently used compression APIs ([#9942](https://togithub.com/grpc/grpc-java/issues/9942)): `CallOptions.withCompression`, `CallOptions.getCompressor`, `AbstractStub.withCompression`, `ServerCall.setCompression`, `ServerCall.setMessageCompression` - api: Stabilize `Detachable` and `HasByteBuffer` - gcp-observability: Stabilize `GcpObservability` ([https://github.com/grpc/grpc-java/pull/10024](https://togithub.com/grpc/grpc-java/pull/10024)). The GcpObservability API provides a simple way to export logging, tracing, and metrics to Google Cloud Operations. See [the Google Cloud blog post](https://cloud.google.com/blog/products/networking/introducing-grpc-observability-for-microservices). - census: Add new tracer annotation to indicate the time when name resolution completed for those RPCs that experienced name resolution delay, or the time when picking subchannel completed for those RPCs that experienced picking subchannel delay. ([#10014](https://togithub.com/grpc/grpc-java/issues/10014), [#10044](https://togithub.com/grpc/grpc-java/issues/10044)) - protoc-gen-grpc-java: binary for s390x is now published ([#9455](https://togithub.com/grpc/grpc-java/issues/9455)). The glibc version used is available in Ubuntu 20.04, Debian 11, and CentOS 9 and later - authz: Added `FileWatcherAuthorizationServerInterceptor` ([#9775](https://togithub.com/grpc/grpc-java/issues/9775)) - services: Added `OrcaMetricReportingServerInterceptor.create(MetricRecorder)` which adds common metrics per-RPC ([#9902](https://togithub.com/grpc/grpc-java/issues/9902)) - android: Add `UdsChannelBuilder` for using LocalSocket an Android ([#8418](https://togithub.com/grpc/grpc-java/issues/8418)) - alts: Observe the `GRPC_ALTS_MAX_CONCURRENT_HANDSHAKES` environment variable user to adjust the max number of concurrent ALTS handshakes ([#10016](https://togithub.com/grpc/grpc-java/issues/10016)) - binder: Expose client identity via `PeerUid` and `PeerUids` ([#9952](https://togithub.com/grpc/grpc-java/issues/9952)) - binder: Add `BindServiceFlags.setAllowActivityStarts()` for `BIND_ALLOW_ACTIVITY_STARTS` added in Android U ([#10008](https://togithub.com/grpc/grpc-java/issues/10008)) ##### Bug Fixes - core: Fix NPE race during hedging ([https://github.com/grpc/grpc-java/pull/10007](https://togithub.com/grpc/grpc-java/pull/10007)), fixing a Netty buffer memory leak for cancelled RPCs - core: Allow transparent retries after a retry attempt and the configured max retries was 1 ([#10066](https://togithub.com/grpc/grpc-java/issues/10066)) - okhttp: properly implement `OkHttpServerBuilder.maxConnectionAgeGrace()` ([#9968](https://togithub.com/grpc/grpc-java/issues/9968)) - xds: Enable federation support. See [gRFC A47](https://togithub.com/grpc/proposal/blob/master/A47-xds-federation.md) - xds: Enable Weighted Round Robin LB policy support. See [gRFC A58](https://togithub.com/grpc/proposal/blob/master/A58-client-side-weighted-round-robin-lb-policy.md) - xds: Avoid ClassCastException if the control plane changes the top-level policy ([#10091](https://togithub.com/grpc/grpc-java/issues/10091)). This is expected to be unlikely, but is possible - xds: Fix `java.util.NoSuchElementException: SecurityProtocolNegotiators$ClientSdsHandler#0` ([#10118](https://togithub.com/grpc/grpc-java/issues/10118)). This error did not cause any problems, other than unnecessary logging - xds: Avoid using the default locale for case insensitive path matching ([#10148](https://togithub.com/grpc/grpc-java/issues/10148)) - googleapis: Enable ignore_resource_deletion for `google-c2p:` resolver’s default xds bootstrap ([#10121](https://togithub.com/grpc/grpc-java/issues/10121)) - rls: Refresh name resolution on rejected addresses ([#10032](https://togithub.com/grpc/grpc-java/issues/10032)) ##### New Examples - Keepalive ([#9956](https://togithub.com/grpc/grpc-java/issues/9956)) - Cancellation ([#9962](https://togithub.com/grpc/grpc-java/issues/9962)) - Deadline ([#9958](https://togithub.com/grpc/grpc-java/issues/9958)) - Using waitForReady ([#9960](https://togithub.com/grpc/grpc-java/issues/9960)) - Client and Server sharing ([#9969](https://togithub.com/grpc/grpc-java/issues/9969)) - Reflection ([#9955](https://togithub.com/grpc/grpc-java/issues/9955)) - Doing debug ([#9957](https://togithub.com/grpc/grpc-java/issues/9957)) - Health service ([#9991](https://togithub.com/grpc/grpc-java/issues/9991)) - Error details ([#9997](https://togithub.com/grpc/grpc-java/issues/9997)) - Custom load balancing ([#9951](https://togithub.com/grpc/grpc-java/issues/9951)) - gRPC-level reverse proxy ([#10059](https://togithub.com/grpc/grpc-java/issues/10059)) ##### Dependencies - protobuf-java and protobuf-java-util upgraded to 3.22.3 ([#10045](https://togithub.com/grpc/grpc-java/issues/10045)) ##### Acknowledgements - [@carl-mastrangelo](https://togithub.com/carl-mastrangelo) - [@haubenr](https://togithub.com/haubenr) - [@jpd236](https://togithub.com/jpd236) - [@kenk42292](https://togithub.com/kenk42292) ### [`v1.54.2`](https://togithub.com/grpc/grpc-java/releases/tag/v1.54.2) ##### Bug Fixes - core: Fix regression in 1.54.0 where polling NameResolvers would not refresh after a resolution error ([https://github.com/grpc/grpc-java/pull/10328](https://togithub.com/grpc/grpc-java/pull/10328)). The symptom is a transient failure like "UNAVAILABLE: Unable to resolve host" continuing potentially forever. This did not impact DnsNameResolver, but it did impacted GrpclbNameResolver which is the dns name resolver used when grpc-grpclb is in the classpath. So even users that think "I don't use grpclb" may have been impacted. round_robin is mainly impacted on startup, but if the error happened afterward it would commonly fix itself for short transient DNS failures. pick_first is impacted at all times; any failed DNS resolution could cause all future RPCs on the channel to fail. - xds: Avoid using the default locale for case insensitive path matching ([#10149](https://togithub.com/grpc/grpc-java/issues/10149)) - xds: Avoid potential channel panic when control plane changes the field used to configure load balancing ([#10103](https://togithub.com/grpc/grpc-java/issues/10103)) - core: Allow transparent retries after a retry attempt and the configured max retries was 1 ([#10080](https://togithub.com/grpc/grpc-java/issues/10080))