Micronaut Java 支持

2023-03-13 11:48 更新

对于 Java,Micronaut 使用 Java BeanDefinitionInjectProcessor 注解处理器在编译时处理类并生成 BeanDefinition 类。

这里的主要优点是你在编译时付出了一点代价,但在运行时,Micronaut 基本上是无反射的、快速的,并且消耗的内存很少。

在 Java 9+ 中使用 Micronaut

Micronaut 是用 Java 8 构建的,但在 Java 9 及更高版本上运行良好。 Micronaut 生成的类与同一个包中的现有类并排放置,因此不会违反有关 Java 模块系统的任何内容。

在 Micronaut 中使用 Java 9+ 时有一些注意事项。

javax.annotation 包

使用 CLI

如果您使用 Micronaut CLI 创建项目,如果您使用 Java 9+,则 javax.annotation 依赖项会自动添加到您的项目中。

包含@PostConstruct、@PreDestroy 等的javax.annotation 已从核心JDK 移至模块。一般来说,应该避免使用这个包中的注解,而是使用 jakarta.annotation 等价物。

使用 Gradle 进行增量注释处理

Micronaut 支持 Gradle 增量注释处理,它通过仅编译已更改的类来加速构建,避免完全重新编译。

但是,默认情况下禁用支持,因为 Micronaut 允许定义需要配置以进行处理的自定义元注释(例如定义自定义 AOP 建议)。

以下示例演示了如何为您在 com.example 包下定义的注释启用和配置增量注释处理:

Enabling Incremental Annotation Processing

tasks.withType(JavaCompile) {
    options.compilerArgs = [
        '-Amicronaut.processing.incremental=true',
        '-Amicronaut.processing.annotations=com.example.*',
    ]
}

如果您不为您的自定义注释启用处理,它们将被 Micronaut 忽略,这可能会破坏您的应用程序。

使用 Project Lombok

Project Lombok 是一个流行的 Java 库,它通过注释处理器向 Java 语言添加了许多有用的 AST 转换。

由于 Micronaut 和 Lombok 都使用注释处理器,因此在配置 Lombok 时必须特别小心,以确保 Lombok 处理器在 Micronaut 的处理器之前运行。

如果您使用 Gradle,请添加以下依赖项:

Configuring Lombok in Gradle

compileOnly 'org.projectlombok:lombok:1.18.24'
annotationProcessor "org.projectlombok:lombok:1.18.24"
...
// Micronaut processor defined after Lombok
annotationProcessor "io.micronaut:micronaut-inject-java"

或者,如果使用 Maven:

Configuring Lombok in Maven

<dependencies>
  <dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.24</version>
    <scope>provided</scope>
  </dependency>
</dependencies>
...
<annotationProcessorPaths combine.self="override">
  <path>
    <!-- must precede micronaut-inject-java -->
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.24</version>
  </path>
  <path>
    <groupId>io.micronaut</groupId>
    <artifactId>micronaut-inject-java</artifactId>
    <version>${micronaut.version}</version>
  </path>
    <path>
    <groupId>io.micronaut</groupId>
    <artifactId>micronaut-validation</artifactId>
    <version>${micronaut.version}</version>
  </path>
</annotationProcessorPaths>

在这两种情况下(Gradle 和 Maven)Micronaut 处理器必须在 Lombok 处理器之后配置。颠倒声明的依赖项的顺序将不起作用。

配置 IDE

如果您依赖配置的构建工具(Gradle 或 Maven)来构建应用程序,则可以使用任何 IDE 来开发 Micronaut 应用程序。

但是,目前可以使用 IntelliJ IDEA 或 Eclipse 4.9 或更高版本在 IDE 中运行测试。

保留参数名称

默认情况下,Java 不会在编译时保留方法参数的参数名称数据。如果您没有显式定义参数名称并依赖于已编译的外部 JAR,这对 Micronaut 来说可能是个问题。

考虑这个界面:

Client Interface

interface HelloOperations {
    @Get("/hello/{name}")
    String hello(String name);
}

在编译时,参数名称 name 丢失并在编译时变为 arg0 或稍后通过反射读取。为避免此问题,您有两种选择。您可以显式声明参数名称:

Client Interface

interface HelloOperations {
    @Get("/hello/{name}")
    String hello(@QueryValue("name") String name);
}

或者,建议您将所有带有 -parameters 标志的字节码编译为 javac。例如在 build.gradle 中:

build.gradle

compileJava.options.compilerArgs += '-parameters'


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号