以下内容均选自“实验楼”新课《Micronaut 入门实战:基于 JVM 的微服务框架》。
Micronaut是什么?
Micronaut 是一个现代化的基于 JVM 的全栈框架,用于构建模块化且易于测试的微服务或无服务程序。- s @ R o X ! -
同t } %时,Ms O c S j bicronaut 使用 Netty,并且对响应式编程提供一流的支持。对于 JVi ! HM 领域的C A w |全栈框架来说,Micronaut 是一个非常有前途的新成员。
Micronaut 旨k / y A在提供构建微服务所需要的K E 0 u j ; o o一切工具,包含:
- 依赖注入(DI)和6 K % S ) 6控制翻转(IoC)。
- 合V 8 g ~理的默认值和自动配置。
- 配置及配置共享。
- 服务发现。
- HTTP 路由。
- 具有负载均衡的 HTTP 客户端。
同时,Micro, n #naut 也s : 0 i & 致力于避免像 Spring、Spring Boot 和 Grails 中的弊端,通过:
- 快速启X H g w $ 1 e = w动。
- 减少内存占用。
- 极少的反射使用。
- 极少的代理使用。
- 简单的单元测试。
在以前,像 Spring 和 Grails 这些y x } T 1 ) v T框架并不是被设计来在 server-lessL e F % O &、 _ ` b . ; W Q安卓 Apps 或低内存占用的场景中运行。相反,Micronaut 则是为此而生。
Micronaut 通过使用 Java 的 annotation processor 来实现以上功能,annota} T F : R } F gtion processor 可以在任何支持其的 JVM 上使用,包括在使用 Netty 构建的 HTTP Server 和 Client 上。
为了提供和 Spring 以及 Grails 相似的编程模型,这些 annotation processor 预编译了必要的元数据(Metadata)来进行依赖注入、定义 AOP 代理以及配置你的应用程序,使其能够在微服务环境中运行。
创建第一个 Micronaut 程序
接下来将要创建我们的第一个 Micronaut 程0 2 4 o序,O ! M d Z T &内6 & K L $容包括提供一个 /hello API 接口以及相应的测试类。
然后n b : 2 S V T,使用 GraalVM 提供的 natiz @ b 3 & - B G -ve image 将程序构建为一个可运行的二进制文件。
▲创K m 0 -建程序
Micr 1 ronaut 提供了一个 CLI(Command Line Interface,命令行接口)让我们可以方便快z W L + a 1速地创建一个 Micronaut 程n U ~ 序。这个 CLI 包含了用于生成指定类型项目的命令,可以选择项目的构建工具、测试框架0 ( ; 2 N 7 9 甚至是程序使用的语言。同时,它也提供了生成代码(如:Controller、Clientj : 6 m U & Interface 和 Serverless Functions)的命令k I 3 1 P V O Y。详情可参考官网文档 Micronaut1 b z CLI。
下面我们来使用 Micronaut CLI 来创- n } H h建程序,在实验楼 WebIDE 终端中执行以下命令:
mn create-app example.micronaut.complete
- mn 用于调用 Micronaut 的 CLc Z / 2 $ N T mI。
- create-app 即表明要创建一个 Micronaut 程序。默认情况下,create-app 会创建一个 Java Micronaut 程序,并使用 Gradle 构建系统。但你也可以使用其他的构建工具(如:MaX x ~ven)和s v ) $语言(如:Groovy 和 Kotlin)。
- example.micronaut.complete 作为参数,指定了程序的默认包名和程序名,最后一个c n - 9 8 D .6 % @ ] r ? K T L 号前面的内容将作为包名(此处即:example.micronaut),后面的内容将作为文件夹名(此处即:complete)。
执行后的结果如下:
注意:以后的实验中,如无特殊说明,都将在* T O o R B ` 3 + /home/project 目录下创建程序。
Application
Application.java 文件被S ! B V用于使用 Gradle 或部署时运行程序,你也可% 2 ; D以通过直接执行该类的 main() 函数来直接运行程序。其代码如下:
package exampl: z x S 2e.micronaut;
import io.micronaut.runtime.Micronaut;
public class Application {
public static void main(String[] args) {
Micronautv ~ j G .run(Application.class);
}
}
▲编写代码
Controller
为了创建一个能够响p g X -应并返回 \"Hello World\" 的微服务,首先我们需要创建一个 Controller。
在 src/main/java/example/micronaut 目录下创建 HelloCont0 z @roller.java 文件,编写代码如下:
package example.micronaut;
import io.micro5 k $ - V rnaut.http.MediaType;
import io.micronaut.http.annotation.Controller;
import io.micronaut.http.annotation.Get;
import io% F D V F [.micronaut.http.annotation.Produces;
@Contp 8 k C U [ ( J }roller(\"/hello\") // ①
public class HelloController {
@Get // ②
@Produces(MediaType.TEXM 8 m o # / = DT_PLAIN) // ③
public String index() {
retun I rrn \"Hello World\"; // ④
}
}
为了便于查看,我们在程序中用数字来标注,然后在下方给予解释,序号一一对应。
- 在这 % f : Y ~ $ X里,我们使用 @Controller 注解定义了一个 Controller,并把它映射到 /hello 路径。
- @Get 注解用于将 inF H 7 p 1dex() 方法和所有 HTTP GET 的请求进行映射。
- 在默认情况下,Micronaut 程序的响应P f 4 d J g会使H % S e l q w & E用 applicatc 3 9 7ion/json 作为 Content-Type。这里我们返回一个字符串类型的数据,不是 JSOS W MN,所以设置为 text/plain。
- 返回V ) T H G字符串 \"Hello Worli c h y * g xd\" 作为请求响应结果。
注:后续实验中,如无特殊说明的情况下,在编写程序N | & 9 C t l V Y时,默认_ H j k使用 sr, p L l q Ac/main/java/exa/ 7 q gmple/mi( i H Q M ) N : !cronaut 作为目录。
如:创建 HelloControllerg o 9 1 f ] 4 E {.java 文件Q q ^。
即:在 src/main/java/B @ s Eexample/micronaut 目录下创建 HelloController.java 文件。
Test
接着我们创建一个 Junit 的测试来验证当W ( x { U V 6 C W我们对 /hello 进行一次 GET 请求时,是否会得到 He` D I 3 @ O W X Wllo World 作为响应。
在 src/test/java/example/miG 6 + ! ? Y %cronaut 目录下创建 HelloControllerTest.java 文件,编写代X F Z F码如下:
package example.micronaut;
import sx w P E ` y hta_ & C k ^ z C *tic org.junit.jupi3 e 6 . Q x 2ter.api.Assertions.assertEquals;
import ste ` L # S { 5atic org.junit.jupiter.api.Assertions.assertNotNull;
import io.micronaut.http.H6 $ z | x R & [ttpRequest;
import io.micronaut.http.clieb { b G int.RxHttpClient;
import io.micronau5 m } W 3 Z +t.http.client.x ` y | F p D 0 mannotation.Clienw z p |t;
import io.micronaut.test.annotation.MicronautT( : ? X Kest;
im} r v + 2 I B Uport org.junit.jz 2 O R ) A Z 3 mupiter.ae Y 3pi.Test;
import javax.inject.I` o 5 y 7 L 6nj. { Wect;
@Micronaut ( ^ Test // ①
public class HelloControllerTest {
@Inject
@Client(\"/\")
RxHttpClient clientb M s = z e 3 k S; // ②
@Test
public void testHello() {
HttpRequest<String> request = HttpRequest.GET(\"/hello\"); // ③
String body =V { u r / 8 g client.toBlocking().retrievp n z Ae(requeM 5 7st);
assertNotNull(o S p h h Z - 2body);
assertEquals(\"Hello World 3 m\", body);
}
}
- 对_ d ^ d * 5 a类使用 @MicronautTest 注解,这样 Micronaut 会初始化 Application Context 和 Embedded Server。
- 注射 RxHttpClient 的 bean,用于执行 Hq - *TTP 请求来访问 Controller。
- 使用 Micronaut 提供的 API 创建 HTTP 请求。
▲运行程序
测试t E : n E ?程序
在运行程序之前,最好的做法是先进行测试。在实验楼 WebIDE 终端中执行以下命令进行测试。
# 进入项目的目录
cd /home/project/complete
# 测试
./gradlew test
执行的结果如下所示。
运行程序
在实验楼 WebIDE 终端中使用以下命令可以让程序在 8080 端口运行。
./gradv N +lew run
当控制C 8 4 W 6 [ ;台显示内容如下时,表明程序已经处于运行状态中。N c @ X F { L
接着,打开 Web 服务,在地址栏末尾添加 /hello 来访问我们的 /hello API。结果如下。
如果要 M S停止程序运行,按下 Ctrl + C 即可。
▲使用 GraalVM 生成 Native Image
我们将使用 GraalVM,一个多语言可嵌入的虚拟机,来为我们的程序生成一个 Native Image(本地镜像)。
Native Images 用到了 Gra) s m L _ j ( palVM 的 a= j Ahead-of-time 技术为基于 JVM 的应用改善启动时间并减少内存占用。
▲Micronaut + GraalVM 的变化
M5 / 6icroT D n ^naut 本身不依赖反射或动态类加载,所以可M v # N B U C 9 r以很好地适配 GraalVM! g g Native。
首先,添加 Micronaut Graal 的注解处理器来用于生成 native-image 工具要使用的n , H Y | M g reflection& 6 #-config.json 元数据。
打开项目的 b. _ M F 2 | Huild.gradle 文件,追加以下依赖。
depende! R A Xncies {
annotationProcessor \"io.micr? S Oonaut:micronaut-graal\4 A J / D 6"
}
GraalVM Native Image 允许我们预编译(ahead-of-time compile)Java 代码来生成一个叫做本地镜像(Native Image)的独立可执行文件。这个可执行文件包含了程序本身、库和 JDK,且不运行在 Java 虚拟机上,但在另一个叫做 SVI 4 N a o HM(Substrate VM) 的虚拟机P y e * ; 9中包含了必要的组件,如内存管理和线程调度。SVM 是运行时组件的一个统称,这些组件包括 deoptimizer_,_garbage collector 和 thread schedulina 5 Z k ,g 等等。p 5 &这使得生成的程序会比使用 Java 虚拟机时拥有更快的启动速度以及更低的内存占用。
我们需要在 build.gradle 中添加一个 SVM 的依赖:
depend| 2 2encies {
compileOnly \"org.graalvm.na} x $ Y 8 - ,tiveimage:svm:19.3.0\"
}
为了使构建镜像更加简洁,我们需要创建一个 native-image.properties 文件。标准做法是使用 sra/main/resources/META-INF/native-image 文件夹并在该文件夹下创建一个遵循 Mave9 r 1n 坐标来描述程序的文件夹。例如,我们的项目名设为 m- d * + ^ P R @icronautguide,则应创建 example.micronaut/micronautguide 文件夹。下面通过命令行的模式来进行创建。
# 进入项目目录
cd1 b [ 6 O ( ? h O /home/project/complete
# 创建文件夹
mkdir -pw M a D [ E src/main/resources/META-INF/native-imal K Xge/example.micronaut/micronautguide
# 创建文件
to: h 5 P l M L 0 7uch src/main/res] 2 j G _ources/META-INF/native-image/example.micronaut/micronautguide/nativeo 2 T-image.properties
然后,在 native-image.properties 文件中编写以下内容。
Args = -H:IncludeResources=logback.xml|application.yml \\
-H:Name=micronautguide \\
-H:Class=exa8 c ] m Zmple.micronaut.Application
- -H:IncludeResou& W D g A D Grces:参数允许我们设置包括哪些静态资源,可以使用正则表达式。这里为 logback.xml 和 application.yml。
- -H:Name:参与指定了生成的 Native Image 的名字,这里为 mic~ d d j p .ronautguide。
- -H:Class:] z :参数指定了程序的入口(定义了 mai] w F ; t On() 方法的类)。这里为 example.micronaut.Application,即 Application.java 文件中的 main() 方法。
▲生成 Native Image
为了生成 Native Image,我们需要先生成程序的 FAT JA| t : @ m o n jR。
在实验| + } b T [ P 3 l楼 WebIDE 终端中执行以下r h 5 R X命令。
./gradlew assemble
执行后的结果] | q如下。
然后开始生成 N, % 9ative Image,生成镜像的C % a W q ( Z命令如下。
native-imageP b k t G G --no-servZ ) D Qer -cp! w h + N 3 P N + build/libs/complete-0.1-all.jar
- -no-s% lerver 选项表明不使用基于 server 的镜像来1 s _ , # T构建。
重要提示
构建 Native Image 的开销较大,由于实验楼的环境限制,标准环境下会因内存不足而失败。b = B ]所以我们建议跳过构建镜像的步骤,下载我们提前构建的 Native Image。同学可以在自己电脑上进行尝试。
在实验楼 WebIDE 终端中K 6 y ? 4 1 R k .执行以下命令下载构建好的镜像。
# 进入项目目录
cd /home/project/complete
# 下载镜像
wget https://labfile.oss.aliyuncs.com/courses/1511/micronautguide
# 为文件添加可执行权限
chmod +x ./micronautguide
这里提供一下生成镜像时的控制台输出截图,可以看到在 1 核 4 G 的环境中花了 20 分钟的时间。
最后,让我k % l / 8 s们来体验一下生成的镜像的优势。在实验楼 WebIDE 中执行以下命令运行程序。
./micronaE ( ~ ?utguide -Xmx68m
执行结果如下。
可以看到程- K z s O _ y R ;序比起之前启动的速度明显提升了J / 8 K不少。新建一个控制台(菜单栏 -> Terminal -> NewH o ; = 8 X Terminal),执行以下命令来访问 /hello API 接口。
curl localhost:8080/hello
执行结果如下。
你的第一个程序就完成啦,想查看本节实验的源码并继续学习后面的内容,可访问“实验楼”官网,搜索课程《Micronaut 入门实战:基于 JVM 的微服务框架》。