v1.18.0

August 8, 2022

🌟 New features

DocService can now render Markdown and Mermaid formatted documentation for annotated services. #4299 #4304

@Description(value = "### Markdown format", markup = Markup.MARKDOWN)
@Get("/markdown")
public HttpResponse markdown() {
  return HttpResponse.of(200);
}

@Description(value = "graph TD;\n" +
                     " A-->B;\n" +
                     " A-->C;\n" +
                     " B-->D;\n" +
                     " C-->D;",
             markup = Markup.MERMAID)
@Get("/mermaid")
public HttpResponse mermaid() {
  return HttpResponse.of(200);
}

You can now bind decorators to each gRPC service using GrpcServiceBuilder.addService(). #4311 #4316

GrpcService.builder()
  .addService(myGrpcService, List.of(decorator)) // 👈👈👈
  .build();

UnframedGrpcErrorHandler.ofJson() now conforms to Google's error model. #4231 #4384

GrpcService
  .builder()
  .addService(myGrpcServiceImpl)
  .unframedGrpcErrorHandler(
    UnframedGrpcErrorHandler.ofJson()) // 👈👈👈
  .build();

{
  "code": 2,
  "message": "A custom message!",
  ...
}

You can now extract the innermost element of Unwrappable type objects easily using Unwrappable.unwrapAll(). #4338

Foo foo = new Foo();
Bar<Foo> bar = new Bar<>(foo);
Qux<Bar<Foo>> qux = new Qux<>(bar);
assert qux.unwrapAll() == foo; // 👈👈👈

📈 Improvements

RequestContext now extends Unwrappable. #4308

🛠️ Bug fixes

You no longer see an intermittent IllegalStateException for gRPC services when GrpcServiceBuilder.useBlockingTaskExecutor() is enabled. #4367 #4374
Requests no longer hang when gRPC-JSON transcoding is enabled and gRPC decorators return an unframed response. #4337 #4348
You can now use HttpFile to serve files from the OSGI bundle. #4371 #4373
A request's start time on the server side is now correctly recorded when a server receives the first header. #4365 #4372
You no longer see a false positive warning of unknown MethodType when using gRPC clients. #4363
You no longer see a NoSuchElementException while a HealthCheckedEndpointGroup is closed. #4349
ClosedSessionException and ClosedStreamException are raised correctly according to their usage. #4380
The timeout for client's endpoint selection isn't clamped by responseTimeout anymore. #4383