v1.32.0

March 5, 2025

🌟 New features

Load Balancer: You can now create a LoadBalancer using various load balancing strategies to select an element from a list of candidates. #5289 #5779

List<Endpoint> candidates = ...;
LoadBalancer.ofRoundRobin(candidates);
LoadBalancer.ofWeightedRoundRobin(candidates);
LoadBalancer.ofSticky(candidates, contextHasher);
LoadBalancer.ofWeightedRandom(candidates);
LoadBalancer.ofRampingUp(candidates);

Filter Invalid IP address: You can now reject invalid IP addresses using ClientFactoryBuilder.ipAddressFilter(). #6106 #6111

ClientFactory
  .builder()
  .ipAddressFilter(ip -> { // 👈👈👈
    if ("1.2.3.4".equals(ip.getAddress().getHostAddress())) {
      return false;
    }
    return true;
  }).build();

Graceful Shutdown: You can now use GracefulShutdown to terminate unfinished requests when a server stops. #5941

GracefulShutdown gracefulShutdown =
  GracefulShutdown
    .builder()
    .quietPeriod(Duration.ofSeconds(10))
    .timeout(Duration.ofSeconds(15))
    .toExceptionFunction((ctx, req) -> {
      return new ServerStopException();
    })
    .build();
Server.builder()
      .gracefulShutdown(gracefulShutdown);

DNS Channel Strategy: You can now set datagramChannelStrategy which provides an option to create a channel per-resolution for DNS queries. #6122 #6127

DnsAddressEndpointGroup
  .builder("foo.com")
  .port(8080)
  .datagramChannelStrategy(
    DnsNameResolverChannelStrategy.ChannelPerResolution) // 👈👈👈
  .build();

Map Injection for an Annotated Service: The annotated service now supports the Map<String, Object> parameter. #6058 #6072
```
@Get("/dogma/repos")
public String repos(@Param Map<String, Object> repoOptions) {...}
```

Eureka InstanceInfo: You can now retrieve a Eureka InstanceInfo from an Endpoint via InstanceInfo.instanceInfo(). #6056 #6069

EurekaEndpointGroup eurekaEndpointGroup = ...;
eurekaEndpointGroup.endpoints().forEach(endpoint -> {
  InstanceInfo instanceInfo = InstanceInfo.instanceInfo(endpoint); // 👈👈👈

Client Preprocessor: You can now use a client Preprocessor to customize certain properties. #6057

HttpPreprocessor preprocessor = (delegate, ctx, req) -> {
  ctx.setEndpointGroup(Endpoint.of("overriding-host"));
  return delegate.execute(ctx, req);
};
WebClient client =
  WebClient.builder()
           .preprocessor(preprocessor) // 👈👈👈
           .build();

Backoff Builder: You can now easily create a Backoff using builder. #5483 #5488

Backoff backoff =
  Backoff.builderForExponential()
         .initialDelayMillis(100)
         .maxDelayMillis(10000)
         .multiplier(2.0)
         .build();

📈 Improvements

Armeria now automatically registers the metrics of PooledByteBufAllocator.DEFAULT. #2633 #5916
Server metrics now have a port tag for better monitoring and troubleshooting. #6089 #6116
You can now see the remoteAddress in the error message when a SessionProtocolNegotiationException is raised. #6113
You can now use the default HealthCheckUpdateHandler via HealthCheckUpdateHandler.of() #6002

🛠️ Bug fixes

A cookie is correctly overwritten when a cookie with the same name, domain, and path is set. #5870 #6126
CorsPolicyBuilder.build() is exposed publicly again. #6121
Connections do not hold references on automatically aborted requests, resulting in less memory pressure. #6108
CircuitBreakerRuleBuilder.onTimeoutException() and RetryRuleBuilder.onTimeoutException() now work when a connection or proxy establishment is timed out. #6107
DNS refresh query is executed by the correct executor. #5891 #6092
You can now choose whether to use the json_name field option when transcoding HTTP/JSON to gRPC messages. #5890 #6082
Automatic-Module-Names are correctly set by replacing a dot followed by a digit with an underscore. #6075 #6076
Delayed tasks for gRPC requests that have already been cancelled are not executed anymore. #6066
You no longer see a false positive warning log when HealthCheckedEndpointGroup is closing. #6063
An Endpoint no longer includes attributes in .toString(). #6061
Fixed a bug where a trailing dot was included in the hostname used by SNI. #6044 #6046
Log levels for responses are now correctly mapped based on the SuccessFunction. #6042
Resolved the Java module conflict with the NonBlocking interface. #6037
Unnecessary logs aren't left from an HttpResponseWrapper. #6035
Requests with a Content-Length header exceeding the allowed limit can now be rejected early for improving efficiency. #5880 #6032
You can now sample the stacktrace of ResponseCompleteException with verboseExceptionSampler. #5972
The ProxyConfig now correctly respect the TTL of a DNS record. #5843 #5960
A recovered HttpResponse by the ServiceErrorHandler now correctly produces a response content preview. #3969 #5076