Migration Guide 3.21

Table of Contents

• TLS Registry ⚙️ ✅
• Quarkus REST
  • JSON view Deserialization changes
• gRPC
  • Kotlin code generation

Note	We highly recommend the use of quarkus update to update to a new version of Quarkus. Items marked below with ⚙️ ✅ are automatically handled by quarkus update.

TLS Registry ⚙️ ✅

The TLS registry extension has been reorganized to follow the structure proposed in https://github.com/quarkusio/quarkus/discussions/43130 and avoid split packages. Thus, the io.quarkus.tls.TlsRegistryBuildItem class has been renamed to io.quarkus.tls.deployment.spi.TlsRegistryBuildItem.

Quarkus REST

JSON view Deserialization changes

With this version, the deserialization support for JSON views gets documented and slightly changed.

For example:

@POST
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
@JsonView(Views.Private.class)
public RestResponse<User> create(User user) { (1)
    return RestResponse.status(CREATED, user);
}

@POST
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
@JsonView(Views.Private.class) (2)
public RestResponse<User> create(@JsonView(Views.Public.class) User user) {
    return RestResponse.status(CREATED, user);
}

1. The method parameter user was also deserialized using the Views.Private view.

2. The method parameter user was most likely to correctly use the expected Views.Public view for deserialization. For Serialization however, the Views.Public was also used, although the method is annoted with the Views.Private view.

The behaviour changed, so that now the deserialization is only influenced by the method parameter @JsonView. The serialization is now always only influenced by the method (or class level) @JsonView:

• For (1), the user parameter does not use any JSON view anymore.

• For (2), this means that the user parameter correctly uses Views.Public for deserialization, and for serialization Views.Private gets used

gRPC

Kotlin code generation

As Quarkus now supports Kotlin code generation when quarkus-kotlin and quarkus-grpc are used together, users now have to include:

 <dependency>
     <groupId>com.google.protobuf</groupId>
     <artifactId>protobuf-kotlin</artifactId>
 </dependency>

as a dependency of the project