v1.20.0

October 5, 2022

🌟 New features

You can now handle a GraphQL error using GraphqlErrorHandler. #4435

GraphqlErrorHandler errorHandler = new GraphqlErrorHandler() {
  @Override
  public HttpResponse handle(ServiceRequestContext ctx, ExecutionInput input,
                             ExecutionResult result, @Nullable Throwable cause) {
    final List<GraphQLError> errors = result.getErrors();
    if (errors.stream().map(GraphQLError::getMessage)
              .anyMatch(m -> m.startsWith("Unauthorized"))) {
      return HttpResponse.of(HttpStatus.UNAUTHORIZED);
    }
    ...
  }
};
GraphqlService
  .builder()
  .schemaFile(...)
  .runtimeWiring(...)
  .errorHandler(errorHandler) // 👈👈👈
  .build();

You can now easily configure client-side TLS key and certificates to support mTLS via ClientFactoryBuilder.tls(). #4410

File keyCertChainFile = ...;
File keyFile = ...;
ClientFactory factory =
  ClientFactory
    .builder()
    .tls(keyCertChainFile, keyFile)
    .build();
WebClient
  .builder()
  .factory(factory)
  .build();

gRPC HTTP/JSON transcoding endpoint can now handle both the snake case and camel case query parameters using HttpJsonTranscodingOptions. #4428

HttpJsonTranscodingOptions options =
  HttpJsonTranscodingOptions
    .builder()
    // Try the original field name and camel case
    // if it's not found via the original name.
    .queryParamMatchRules(LOWER_CAMEL_CASE,
                          ORIGINAL_FIELD)
                          ...
                          .build();
GrpcService
  .builder()
  .enableHttpJsonTranscoding(options)
  .build();

You can now use OutputStream to write data to a StreamMessage using StreamMessage.fromOutputStream(). #4402

StreamMessage.fromOutputStream(os -> {
  // perform blocking operation
  HttpData data0 = readDataFromBlockingDB(0);
  os.write(data0);
  HttpData data1 = readDataFromBlockingDB(1);
  os.write(data1);
  os.close();
}

You can now convert an AggregatedHttpRequest to an HttpRequest with new headers. #4441

AggregatedHttpRequest req = ...
HttpRequest httpRequest = req.toHttpRequest(newHeaders);

📈 Improvements

🛠️ Bug fixes

GraphQlService now respects the accept header correctly. #4451
GrpcService and THttpService no longer throw double subscription exceptions when the request is aggregated in a decorator. #4449
The content-length header is automatically removed from ResponseHeaders for a server streaming response in GrpcService. #4460
You no longer see a NullPointerException when using EndpointSelectionStrategy.rampingUp(). #4448
DocService no longer throw an exception when a protobuf message doesn't have any fields. #4436
You no longer see a 500 response when an empty multipart request is sent. #4432
The service name generated from a CGLIB-enhanced class no longer has a synthetic suffix in DocService. #4430
Users can now use ProtobufRequestConverterFunctionProvider without encountering a potential ClassCastException. #4429
Fixed a regression where thrift0.9 is incompatible with Thrift 0.9.1 since Armeria 1.17.0. #4427
enable-auto-injection property is correctly added to the generated spring-configuration-metadata.json file. #4425