Spring Boot与Eclipse MicroProfile比较

到目前为止,您可能已经听说过 Eclipse MicroProfile
(MP)。它是一个社区驱动的计划,用于定义企业Java  微服务
规范。MicroProfile仅用了两年时间,但它已经提供了八项创新规范并且正在快速发展。它提供指标,API文档,运行状况检查,容错,分布式跟踪等。有了它,您可以充分利用尖端的原生技术,并以供应商中立的方式实现!

对于熟悉Spring Boot开发人员,我们准备了本文,它将使用Spring Boot和MicroProfile开发应用程序的基础知识进行了比较。我们写了两个应用程序,每个解决方案一个。在本文中,我们将介绍它们之间的差异。您可以在 GitHub
上 找到
这两个项目的源代码

对于MicroProfile应用程序,我们使用 Thorntail
(以前称为Wildfly Swarm),但除了设置部分,Open Liberty,Payara,TomEE或任何其他实现看起来完全相同。

在本文中,我们假设您了解Spring Boot,并且我们专注于MicroProfile中的不同之处。

设置项目

我们使用Maven设置了两个应用程序。

使用Thorntail,项目的设置与Spring Boot非常相似。第一个区别在于项目包装。虽然我们使用jar(默认包装)Spring Boot应用程序,但我们需要将其设置Thorntail应用程序的打包WAR。

我们的Spring Boot应用程序使用名为的BOM文件spring-boot-dependencies。Thorntail也提供BOM文件。我们选择了bom,列出了所有稳定,经过良好测试的Thorntail元素。例如,如果您想进行实验,可以使用  bom-all。

Spring Boot和Thorntail都使用Maven插件将用户的类,资源和所选解决方案的所有位打包成一个胖JAR。对于Thorntail,该插件被调用thorntail-maven-plugin。下面的清单显示了其声明以及Thorntail BOM的声明。

<project ...>
 ...
 <packaging>war</packaging>

<dependencyManagement>
 <dependencies>
   <dependency>
     <groupId>io.thorntail</groupId>
     <artifactId>bom</artifactId>
     <version>${version.thorntail}</version>
     <type>pom</type>
     <scope><b>import</b></scope>
   </dependency>
 </dependencies>
</dependencyManagement>
...
<build>
 <plugins>
   <plugin>
     <groupId>io.thorntail</groupId>
     <artifactId>thorntail-maven-plugin</artifactId>
     <version>${version.thorntail}</version>
     <executions>
       <execution>
         <goals>
           <goal><b>package</b></goal>
         </goals>
       </execution>
     </executions>
   </plugin>
 </plugins>
</build>

定义了基础知识后,我们可以选择我们需要的功能。

相对于我们选择的Spring Boot spring-boot-starter-web,我们microprofile只是为Thorntail 添加一个依赖项。

<dependency>
 <groupId>io.thorntail</groupId>
 <artifactId>microprofile</artifactId>
</dependency>

您可以查看 GitHub项目
中的最终pom.xml 文件  。

设置项目还有一个不同之处:应该放置静态资源的地方。我们的Spring Boot应用程序将静态资源保留在  src/main/resources/static目录中,而Thorntail应用程序则需要将它们放入src/main/webapp。

公开REST端点

从Spring应用程序公开REST API的最惯用方法是使用Spring MVC。MicroProfile是利用JAX-RS实现相同功能。

首先,对于JAX-RS,Application需要一个类。它扩展  javax.ws.rs.core.Application并可以为所有JAX-RS端点提供全局路径前缀。在我们的例子中它是:

@ApplicationPath(<font>"/api"</font><font>)
<b>public</b> <b>class</b> ApplicationConfig <b>extends</b> Application {
}
</font>

那么这只是翻译资源类注释的问题。

以下Spring MVC代码:

@RestController
@RequestMapping(value = <font>"/api/greeting"</font><font>, produces = MediaType.APPLICATION_JSON_VALUE)
<b>public</b> <b>class</b> GreetingController {

   @GetMapping
   <b>public</b> Greeting greeting(@RequestParam(value = </font><font>"name"</font><font>, defaultValue = </font><font>"World"</font><font>) String name) {
      ...
   }
</font>

转换为以下MicroProfile代码:

@Path(<font>"/greeting"</font><font>) </font><font><i>// 1</i></font><font>
@Produces(MediaType.APPLICATION_JSON) </font><font><i>// 2</i></font><font>
<b>public</b> <b>class</b> GreetingResource {

   @GET </font><font><i>// 3</i></font><font>
   <b>public</b> Response greeting(@QueryParam(</font><font>"name"</font><font>) @DefaultValue(</font><font>"World"</font><font>) String name) {  </font><font><i>// 4</i></font><font>
      ...
   }
</font>

逐行解释:

  1. JAX-RS端点类应该注释@Path。此注释也是为端点提供任何前缀的位置。
  2. @Produces如果我们想要指定响应的内容类型,则必须使用单独的注释。它有一个名为的对应项,@Consumes用于指定接受的请求实体类型
  3. 处理请求的方法@GET,@POST,@DELETE,@PUT,或者@HEAD,取决于他们是为了处理HTTP方法。
  4. 我们的端点使用查询参数。为了使它工作,我们在Spring MVC中使用了一个注释@RequestParam。对于MicroProfile,要使用的注释是@QueryParam。为了提供默认值,我们添加了一个@DefaultValue注释。

有关javax.ws.rs其他可用注释,请参阅  包。

重要的是还要提到@Context注释。有了它,您可以将HTTP标头或安全上下文等值注入方法或端点。

依赖注入

Spring的核心是它的依赖注入。使用MicroProfile,您可以使用CDI。

这主要意味着使用@Inject注释而不是Spring的@Autowired 注释:

@Inject
   <b>private</b> GreetingGenerator generator;

与Spring类似,CDI有一个bean的概念,这些bean生活在一定的作用域内,@Scope是用于控制作用域的,为Spring的Bean概念将转换为  @ApplicationScoped,@RequestScoped等等CDI注释。

这里是一个GreetingGenerator 类:

@ApplicationScoped
<b>public</b> <b>class</b> GreetingGenerator {
 …
}

查看  javax.enterprise.context软件包以获取所有可用选项的列表。

转换非常简单。唯一的问题是默认作用域不同。在Spring中,默认范围是单例,在CDI中它是@Dependent- 与Spring的原型相对应的作用域。

配置

在我们的Spring应用程序中,我们使用@Value注释注入配置值。使用MicroProfile Config,我们可以实现:

@Inject
@ConfigProperty(name = <font>"greeting.message"</font><font>)
<b>private</b> String message;
</font>

上面的message字段的值将取自META-INF/microprofile-config.properties。它可以被环境变量或系统属性覆盖。MicroProfile Config还提供了一种简单的机制来定义自定义ConfigSource配置值的附加源。

执行

要获取代码,请克隆GitHub存储库:

git clone https://github.com/michalszynkiewicz/from-spring-to-microprofile/

存储库包含两个独立目录中的两个项目。要构建其中任何一个,请导航到相应的目录并运行以下命令:

mvn clean package

Spring Boot和Thorntail都生成了一个超级JAR。要运行Thorntail,请进入目标目录并执行以下命令:

java -jar microprofile-from-spring-1.0-SNAPSHOT-thorntail.jar

现在,当您在浏览器中访问http:// localhost:8080时,应该会看到所选应用程序公开的网页。您可以通过浏览器试用该应用程序,也可以直接在http:// localhost:8080 / api / greeting?name = put-your-name-here访问REST API 。

MicroProfile特点

虽然两个示例应用程序的代码非常相似,但MicroProfile具有更多功能。

根据配置,MicroProfile应用程序还会公开:

  • REST端点的OpenAPI文档,位于http:// localhost:8080 / openapi
  • 应用程序指标,包括http:// localhost:8080 / metrics上的线程计数,堆使用情况等
  • 可以在http:// localhost:8080 / healthcheck上使用Kubernetes进行健康检查

此外,在不修改配置的情况下,它可以使用其他MicroProfile规范,例如Fault Tolerance或类型安全的REST客户端。

原文 

https://www.jdon.com/51638

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » Spring Boot与Eclipse MicroProfile比较

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址