v1.30.0

August 12, 2024

🌟 New features

Outlier Detection for Connections: You can now use OutlierDetection to detect unhealthy connections and close them gracefully. #5751 #5763

OutlierDetectingRule rule =
  OutlierDetectingRule
    .builder()
    .onServerError()
    .onException(IOException.class)
    .onException(WriteTimeoutException.class, OutlierDetectionDecision.FATAL)
    .build();

OutlierDetection outlierDetection =
  OutlierDetection
    .builder(rule)
    .counterSlidingWindow(Duration.ofSeconds(10))
    .counterUpdateInterval(Duration.ofSeconds(1))
    .failureRateThreshold(0.5)
    .build();

ClientFactory
  .builder()
  // Apply the OutlierDetection to detect and close unhealthy connections
  .connectionOutlierDetection(outlierDetection)

Automatic value loader: You can now use an AsyncLoader to (re)load a value atomically, lazily and asynchronously. #5506 #5590

Function<String, CompletableFuture<String>> loader = cache -> {
  ResponseEntity<String> response =
    client.prepare().get("/api/v1/items").asString().execute();
    return response.thenApply(res -> res.content());
};

AsyncLoader<String> asyncLoader =
  AsyncLoader
    .builder(loader)
    .expireAfterLoad(Duration.ofSeconds(60))
    .build();
asyncLoader.get().join();

Configurable Response Timeout: You can now use ResponseTimeoutMode to configure when a response timeout starts for a client. The timeout can be set when a request is started, a connection is acquired or a request is fully sent. #4591 #5793

ClientFactory
  .builder()
  .responseTimeout(Duration.ofSeconds(5))
  // A request will be timed out if the response is not fully received
  // within 5 seconds.
  .responseTimeoutMode(ResponseTimeoutMode.FROM_START)
  .build();

Fallback File Extensions: You can now set fallback file extensions in FileService. This feature is useful when you want to map a RESTful URI to a static resource file. #4542 #5806
```
FileService
  .builder(rootDir)
  // '/app/projects' path could be mapped to '<rootDir>/app/projects.html'
  .fallbackFileExtensions("html")
  ...
```

Sending Arbitrary Content in gRPC-JSON Transcoding: You can now use google.api.HttpBody to send arbitrary content in gRPC-JSON transcoding. #5311 #5400

rpc ArbitraryHttp(google.api.HttpBody) returns (google.api.HttpBody) {
  option (google.api.http) = {
    post: "/v1/arbitrary"
  };
}

Zone-Aware Load Balancing: XdsEndpointGroup now supports zone-aware load balancing which prioritizes sending traffic to local zones. #5785 #5808
WebSocketService Testing: You can now use ServerExtension.webSocketClient() to test WebSocketService. #5538 #5765

📈 Improvements

Armeria client now supports the Expect: 100-continue header. #5646
ClientRequestContext.cancel() now cancels the associated request immediately. #5800
The health checking behavior of XdsEndpointGroup is more aligned with Envoy. #5785
Subsets now supports features available in the default load balancer of XdsEndpointGroup #5801
New headers from Guava have been added to HttpHeaderNames. #5789
Armeria is now compatible with Thrift 0.19 and 0.20.0 #5243 #5822
Armeria client now silently ignores content instead of raising an exception when content exists for a status that indicates empty content. #5823

🛠️ Bug fixes

Validation for URI's authority is relaxed to permit underscores (_). #5814 #5854
A user can send and receive an HTTP request whose :path contains the following characters now: #5845
- TAB (0x09)
- FS (0x1C)
- GS (0x1D)
- RS (0x1E)
- US (0x1F)
Fixed a potential leak when sending compressed responses. #5858
ResteasyClient now correctly releases ClientFactory when it is closed. #5833
Content decompression exceptions are now properly propagated. #5177 #5620
@Blocking now correctly works with gRPC-Kotlin stubs #5295 #5399
Fixed DocService sidebar to occupy at most 40% of the window width. #5091 #5839
InputStream created from StreamMessage.toInputStream() now correctly raises an exception if the original StreamMessage is closed with an exception. #5859
ClientRequestContext.isTimedOut() now correctly returns true if a DNS query, a session creation or a write operation times out. #4935 #5156

📃 Documentation

Added a gRPC reverse proxy server example. #2353 #5722

☢️ Breaking changes

Modified the behavior of Endpoint.withAttrs() to merge the original Attributes with the new one. #5802
- Instead, Endpoint.replaceAttrs() is added to replace the entire attributes of Endpoint.