阿里java框架学习(云原生Java框架-Micronaut)(1)

长期以来,Spring框架一直主导着后端Java的开发,但是以Micronaut、Quarkus、以及Dropwizard为代表的新型云原生Java框架正在不断流行。其中,Micronaut是一种令人耳目一新的替代方案。它是由构建Grails(译者注:Grails是一套用于快速Web应用开发的开源框架)的团队,专为现代化架构而设计开发的。

本文先介绍Micronaut的基本特点,然后从一个简单的基于RESTful API的应用开始,将其重构为反应式非阻塞IO(reactive non-blocking IO,NIO),并介绍Micronaut如何支持基于微服务和无服务器架构的云原生开发。

Micronaut的特征

Micronaut提供了从Spring和Grails等传统框架处继承来的大量优势,其中的一项被称为“原生云原生(natively cloud native)”,即:为云环境从头开始构建。它的云原生能力包括:环境检测、服务发现、以及分布式跟踪等。

同时,Micronaut提供了一个全新的控制反转(inversion-of-control,IoC)容器。该容器能够使用提前(ahead-of-time,AoT)编译,来加快启动速度。此处的AoT是指,启动时间不会随着代码库的增多而增加。这对于无服务器和基于容器的部署来说,是尤其重要的。毕竟,在这些部署中,节点通常会按需进行关闭和启动。

作为一个多语言JVM框架,Micronaut目前支持Java、Groovy和Kotlin,并且即将支持Scala。

此外,Micronaut也支持响应式编程。开发人员可以在该框架内,使用ReactiveX或Reactor。其实,从 2021年7月发布的Micronaut 3开始,Reactor已被推荐使用了。值得注意的是,其新版本并没有将响应式库作为传递式依赖项。

1.开始使用Micronaut

我们可以通过SDKMan,将Micronaut轻松地安装在包括Linux和macOS在内的任何基于Unix的系统上。如果您使用的是Windows,那么请下载Micronaut的二进制文件,并将其添加到合适的路径中。

在安装完成后,您可以在命令行中看到mn工具的提示符。也就是说,通过打开一个Shell,并定位到合适的位置,您便可以键入:mn create-app micronaut-idg --build maven。

Micronaut通过包装器(wrapper)来支持Gradle和maven。这免去了自行安装和构建工具的繁琐。注意,如果您喜欢使用Gradle的话,请不要在上述命令中使用--build maven。

如果您使用mvnw mn:run命令来运行服务器,并在浏览器中输入http://localhost:8080/,那么您可能会看到一个默认为“未找到(not found)”的JSON响应。对此,让我们来研究一下该示例项目的布局。它是一个标准的Maven项目。其main类位于src/main/java/micronaut/idg/Application.java中。请注意,该main类是以一个嵌入式服务器运行的。当您更改代码时,Micronaut开发服务器会自动更新正在运行的应用程序。

2.添加一个Micronaut控制器

就像在Spring的MVC 中一样,您可以添加各种控制器类(controller class),将URL映射到代码处理器(handler)上。例如,您可以在src/main/java/micronaut/idg/controller/SimpleController上添加一个类。如下面的清单1所示,我们使用该控制器来创建一个文本响应。

清单1. 使用Micronaut控制器

package micronaut.idg.controller; import io.micronaut.http.MediaType; import io.micronaut.http.annotation.Controller; import io.micronaut.http.annotation.Get; @Controller("/simple") public class SimpleController { @Get(produces = MediaType.TEXT_PLAIN) public String index() { return "A Simple Endpoint"; } }

如下面的清单2所示,它能够容易地返回一个JSON格式的响应。

清单2. JSON格式的响应

package micronaut.idg.controller; import io.micronaut.http.MediaType; import io.micronaut.http.annotation.Controller; import io.micronaut.http.annotation.Get; import java.util.Map; import java.util.HashMap; @Controller("/simple") public class SimpleController { @Get(produces = MediaType.APPLICATION_JSON) public Map index() { Map msg = new HashMap(); msg.put("message", "A simple message"); return msg; } }

清单2演示了Micronaut针对@Get注解的produces参数所进行的智能处理。在这种情况下,它会发送我们已设置好的JSON格式的响应。

3.添加Micronaut服务层

由于能够预运行,因此Micronaut的IoC实现在底层是唯一的。当然,它仍然属于CDI(Contexts and Dependency Injection,上下文和依赖注入)规范的完整实现。这就意味着您可以使用从Spring中(如@Inject)获悉的所有类似DI的注释。

在下面的清单3中,我们将连接一个服务层的bean,以提供消息。在实际的应用程序中,这个类可以通过一个数据访问bean,来调用数据存储或其他远程的API。例如,我们可以创建一个src/main/java/micronaut/idg/service文件夹,并添加如清单3所示的两个文件——一个接口(Simple)、及其实现(SimpleService)。

清单3. 创建一个简单的服务层bean

// Simple.java package micronaut.idg.service; public interface Simple { public String getMessage(); } // SimpleService.java package micronaut.idg.service; import jakarta.inject.Singleton; @Singleton public class SimpleService implements Simple { public String getMessage(){ return "A simple service message"; } }

现在,您可以通过将服务注入在清单1中创建的SimpleController服务,来使用新的服务层。下面的清单4展示了Constructor的注入。

清单4. 将服务bean注入控制器

@Controller("/simple") public class SimpleController { @Inject private final Simple simpleService; public SimpleController(@Named("simpleService") Simple simple) { //(1) thi.simpleService = simple; } @Get(produces = MediaType.APPLICATION_JSON) public Map index() { Map msg = new HashMap(); msg.put("message", simpleService.getMessage()); return msg; } }

关键性任务是在注释1处完成的,其中服务bean是按照名称完成了连接。至此,如果您去访问http://localhost:8080/simple,就能够看到来自服务层的响应:{"message":"A simple service message"}。

4.使用Micronaut的反应式NIO

接下来,让我们来讨论Micronaut与Reactor的结合使用。在这种情况下,我们将重构当前的应用程序,以使用Reactor和非阻塞IO。该应用程序虽然仍执行相同的任务,但是在后台会使用非阻塞栈——Reactor和Netty。

如前文所述,Micronaut 3默认是不包含响应式库的,因此,正如下面的清单5所示,我们首先需要将Reactor核心添加到Maven的pom处。

清单5. 将Reactor添加到pom.xml

<dependency> <groupId>io.projectreactor</groupId> <artifactId>reactor-core</artifactId> <version>3.4.11</version> </dependency>

如下面的清单6所示,您可以对返回的SimpleController进行修改。

清单6. 使控制器非阻塞

import reactor.core.publisher.Mono; //... @Get public Mono<map> index() { Map msg = new HashMap(); msg.put("message", simpleService.getMessage()); return Mono.just(msg); } }

如您所见,我们只是使用Reactor的Mono类,包装了相同的返回类型(即,string/strin的映射)。

在反应方式中,由于使用远程服务也能够得到类似的支持,因此您完全可以在非阻塞IO上运行应用程序。

5.使用Micronaut的CLI创建新的组件

您也可以使用Micronaut的命令行工具(CLI),来stub out各种组件。例如,如果你想添加一个新的控制器,那么可以使用命令:mn add-controller MyController。如下面的清单7所示,它将输出一个新的控制器、及其对应的测试。

清单7. 使用Micronaut命令行创建一个新的控制器

mn create-controller MyController | Rendered controller to src/main/java/micronaut/idg/MyControllerController.java | Rendered test to src/test/java/micronaut/idg/MyControllerControllerTest.java

6.使用Micronaut进行云原生开发

如前文所述,Micronaut是为云原生微服务和无服务器的开发而构建的。Micronaut支持一种所谓联合(federation)的云原生概念。此处的联合是指,几个较小的应用程序共享相同的设置,并且可以实现串联部署。这听起来像极了微服务架构,其目的就是为了使得微服务的开发更简单,并能够保持可管理性。有关联合服务的更多信息,请参阅Micronaut的相关文档。

此外,Micronaut还可以轻松地针对云环境实现部署。如下面的清单8 所示,您可以部署Google Cloud Platform(GCP)的docker存储库。

清单8. 使用GCP的Docker存储库部署Micronaut应用

./mvnw deploy \ -Dpackaging=docker \ -Djib.to.image=gcr.io/my-org/my-project:latest

在这种情况下,该项目会被作为Docker镜像,推送到GCP的Docker存储库处。请注意,我们在此用到了Jib Maven插件。它能够将Java项目转换为Docker镜像,而无需您创建实际的Docker文件。

此外,我们已经将Docker标识为带有-Dpackaging=docker的打包工具,一旦打包完成,您便可以像下面的清单9那样,使用GCP命令行工具,去部署自己的项目。

清单9. 从命令行处运行Docker镜像

gcloud run deploy \ --image=gcr.io/my-org/my-project:latest \ --platform managed \ --allow-unauthenticated

Micronaut支持的另一种云原生功能是:跟踪。例如,Micronaut通过各种注释,使得启用Jaeger的分布式跟踪,变得相当简单。

如下面的清单10所示,我们可以将Jaeger配置为跟踪微服务应用程序application.xml文件中的所有请求。

清单10. application.xml中的Jaeger配置

tracing: jaeger: enabled: true sampler: probability: 1

7.小结

Micronaut提供了一系列非常适合云原生和微服务开发的功能。同时,该框架更适合让传统的、基于API的开发,变得简单明了。此外,它还可以与反应式NIO的Reactor和Netty进行很好的集成。

原文链接:https://www.infoworld.com/article/3658968/intro-to-micronaut-a-cloud-native-java-framework.html

,