1.31.0 release notes

13th November 2024

🌟 New features

Dynamic TLS Configuration: You can now update TLS configurations dynamically using TlsProvider #5033 #5228

You can create a TlsProvider which specifies TlsKeyPair dynamically.

// return a TlsKeyPair for host patterns
TlsProvider tlsProvider = TlsProvider
  .builder()
  .keyPair("*.a.com", TlsKeyPair.of(...))
  .keyPair("*.b.com", TlsKeyPair.of(...))
  .build();

// return a TlsKeyPair dynamically
TlsProvider tlsProvider = hostname -> TlsKeyPair.of(...);

The TlsProvider can be used for both servers and clients.

// client-side
ClientFactory
  .builder()
  .tlsProvider(tlsProvider);

// server-side
Server
  .builder()
  .tlsProvider(tlsProvider);

Access to Raw Request Path: You can access the raw request path via ServiceRequestContext.rawPath(). #5931 #5932
- This can be useful when you need to get the original request path sent from the client, even if it's potentially insecure.
```
ServiceRequestContext ctx = ...;
String rawPath = ctx.rawPath();
// rawPath may contain unencoded, invalid or insecure characters.
```

Additional Static Factory Methods for ResponseEntity: More static factory methods are added for ResponseEntity. #5954

ResponseEntity<Object> response = ResponseEntity.of(200);
ResponseEntity<String> response = ResponseEntity.of("Hello!");

Timeout Support for HttpRequest and HttpResponse: You can specify HttpRequest.timeout() or HttpResponse.timeout() to set a timeout for an HttpRequest or HttpResponse. #5744 #5761
```
HttpRequest
  .streaming(HttpMethod.GET, "/")
  .timeout(Duration.ofSeconds(1)) // timeout if there is a delay exceeding 1 second between each data chunk
```

Nacos Integration for Server Registration and Endpoint Retrieval: You can now register your server to or retrieve Endpoints from a Nacos registry server. #5365 #5409

Use NacosUpdatingListener to register the Servers to Nacos:

Server server = ...;
server.addListener(
  NacosUpdatingListener
    .builder(nacosUri, "my-service")
    ...
    .build());

Use NacosEndpointGroup for clients:

EndpointGroup group = NacosEndpointGroup.of(nacosUri, "my-service");
WebClient client = WebClient.of(SessionProtocol.HTTP, group);

📈 Improvements

XdsEndpointGroup now supports disable_active_health_check. #5879

🛠️ Bug fixes

DNS resolver now correctly adds search domains for hostnames with trailing dots. #5963
CORS headers for failed requests are now correctly set even when a custom ServerErrorHandler is configured. #5493 #5939
Fixed a bug where AsyncServerInterceptor is incompatible with the OpenTelemetry gRPC agent. #5937 #5938
The GraalVM native image metadata has been updated to reflect recent code changes. #5946
Spring Actuator correctly collects metrics when using Spring WebFlux integration. #5882 #5884

☢️ Breaking changes

ABI compatibility of ResponseEntity.of() has been broken. #5954

⛓ Dependencies