Spring Boot是一个广泛用来构建Java微服务的框架,它基于Spring依赖注入框架来进行工作。Spring Boot允许开发人员使用更少的配置来构建微服务,同时框架本身能够尽可能的减少开发人员的冲突,它和我们后面要介绍的两个框架类似,它通过以下几个方面帮助开发人员:
Spring以噩梦般的配置而闻名,虽然框架本身相比其他组件模型(EJB 1.x 和 2.x)简单了不少,但是它也带来了自己的配置模式。也就是说,如果想要正确的使用Spring,你需要深入了解如何进行XML配置、了解
、
- JdbcTemplate
以及
- JmsTemplate
生命周期、了解
- BeanFactory
监听器,你以为掌握了这些就可以开始开发了吗?实际上问题远没有结束,如果你要用Spring MVC编写一个简单的
- Servlet
,你还需要了解
- hello world
和一堆
- DispatcherServlet
相关的类型。
- Model-View-Controller
Spring Boot目标就是消除掉这些与业务无关的配置和概念,通过简单的注解,你就能够完成这些工作,当然如果你想继续想以前一样使用Spring,它也不会拦着你。
Spring广泛使用着,包括了大型企业应用,在应用中,用户将会使用到不同的技术组件,包括:JDBC数据源、消息队列、文件系统以及应用缓存等。开发人员需要在需要这些功能时,停下来,仔细分析一下自己究竟需要什么?需要的内容属于哪个依赖(“哦,我需要JPA依赖”),然后花费大量的时间在依赖组织和排除上。
Spring Boot提供了功能域(一批jar包依赖)的依赖,它让开发人员声明需要的功能,而不用去关系究竟如何处理依赖关系。这些starter可以允许开发人员直接使用这些功能:
通过直接添加一个starter,能够让开发人员获得这个特性相关的一组依赖,而这些依赖的组合已经被验证,省却了开发人员的不少时间。
Spring Boot是一组jar包和符合其约定的配置的构建块,因此它不会运行在现有的应用服务器中,而使用Spring Boot的大多数开发人员更喜欢的是直接运行的这种自包含的
包。这意味着Spring Boot将所有的依赖和应用程序代码都包装到一个自包含的
- jar
中,而这些jar包运行在一个平面的类加载器中。简单的类加载体系使得开发人员更容易理解应用程序的启动、依赖关系和日志输出,但更重要的是,它有助于减少应用从构建到生产环境的步骤数量。这意味着开发人员不必将打包好的应用放置到应用服务器中,而是直接运行这个standalone的应用,如果你需要
- jar
,那么完全可以将其打包在应用内,使其为你服务。
- servlet
没错,一个简单的
就可以启动你的应用了!Spring Boot、Dropwizard和WildFly Swarm都遵循将所有内容打包成可执行的
- java -jar <name.jar>
模式。但是传统的应用服务器包含的管理能力,怎么在这种模式下实现呢?
- jar
Spring Boot推出了一个叫做
的模块,它可以实现应用的指标统计。例如:我们可以收集日志、查看指标、生成执行线程dump、显示环境变量、了解gc以及显示BeanFactory中配置的bean。可以通过
- actuator
或者
- HTTP
暴露这些信息或者进行日志输出。借助Spring Boot,我们可以利用Spring框架的功能、减少配置并快速开发应用并上线。
- JMX
说了这么多,让我们看看怎么使用它。
我们接下来使用Spring Boot的命令行工具(CLI)来创建第一个Spring Boot程序(CLI底层使用了Spring Initializer)。你也可以使用自己喜欢的方式,比如使用集成了Spring Initializer的IDE,或者直接访问web来创建一个工程。
Spring Boot CLI 的安装方式,可以参考 这里
Homebrew下:
- brew tap pivotal/tap
- brew install springboot
一旦你安装了Spring Boot CLI,你可以这样检查一下。
- $ spring --version
- Spring CLI v1.5.4.RELEASE
如果你能看到版本的输出,恭喜你,安装成功了。接下来,在你希望创建工程的目录下运行命令:
- spring init --build maven --groupId com.murdock.examples --version 1.0 --java-version 1.8 --dependencies web --name hola-springboot hola-springboot
在microservices-camp下运行。
运行该命令后,将会在当前目录下创建一个
目录,同时该目录下包含了一个完整的Spring Boot程序,简单的介绍一下这个命令中包含的内容。
- hola-springboot
、
- jpa
和
- security
- cassandra
进入到
目录中, 执行命令:
- hola-springboot
,如果程序启动,没有报错,你就能看到如下的日志:
- mvn spring-boot:run
- 2017-06-18 10:46:51.070 INFO 3397 --- [ main] o.s.j.e.a.AnnotationMBeanExporter : Registering beans for JMX exposure on startup
- 2017-06-18 10:46:51.081 INFO 3397 --- [ main] o.s.c.support.DefaultLifecycleProcessor : Starting beans in phase 0
- 2017-06-18 10:46:51.253 INFO 3397 --- [ main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
- 2017-06-18 10:46:51.262 INFO 3397 --- [ main] c.m.e.h.HolaSpringbootApplication : Started HolaSpringbootApplication in 13.988 seconds (JVM running for 17.985)
恭喜你!你快速的创建了一个Spring Boot应用,并且启动了它,你甚至可以访问
,你会看到如下内容
- http://localhost:8080
可以看到返回了默认的出错页面,到目前为止,它除了这个什么也做不了。接下来,我们就添加一些特性,比如:REST访问,做一个helloworld式的应用。
后续实践内容与原文有不同,在操作性上要比原文具备更好的实践性。
现在我们拥有了一个可以运行的Spring Boot应用,让我们为它添加一些简单的功能。首先,我们想做的是,让应用暴露一个位置是
HTTP/REST端点,访问它将返回 Hola Spring Boot @ X,而其中的 X 是运行应用的本机IP。
- api/holaV1
在编写代码前,先将
导入到IDE中,在
- hola-springboot
包下面建立一个类,名称为
- com.murdock.examples.holaspringboot
。
- HolaRestControllerV1
- public class HolaRestControllerV1 {
- public String hola() throws UnknownHostException {
- String hostname = null;
- try {
- hostname = InetAddress.getLocalHost().getHostAddress();
- } catch(UnknownHostException e) {
- hostname = "unknown";
- }
- return "Hola Spring Boot @ " + hostname;
- }
- }
可以看到方法
返回了我们需要的内容,一个简单的字符串。
- hola()
到现在为止,我们只是创建了一个名为
的
- HolaRestControllerV1
,你可以写一些单元测试去做验证,而让它暴露HTTP端点,则需要增加一些内容。
- POJO
- @RestController
- @RequestMapping("/api")
- public class HolaRestControllerV1 {
- @RequestMapping(method = RequestMethod.GET, value = "/holaV1", produces = "text/plain")
- public String hola() throws UnknownHostException {
- String hostname = null;
- try {
- hostname = InetAddress.getLocalHost()
- .getHostAddress();
- } catch (UnknownHostException e) {
- hostname = "unknown";
- }
- return "Hola Spring Boot @ " + hostname;
- }
- }
通过添加这两个注解,我们就可以使得原有的类具备了暴露HTTP端点的能力。针对上面的代码,比如
代表着
- @RequestMapping("/api")
接受来自
- HolaRestControllerV1
路径的请求,当添加
- /api
时,表示告知Spring在/holaV1(其实是/api/holaV1)暴露HTTP GET端点,该端点接受的类型是
- @RequestMapping(method = RequestMethod.GET, value = "/holaV1", produces = "text/plain")
。Spring Boot将会使用内置的
- text/plain
运行,当然你也可以切换到
- Tomcat
或者
- Jetty
。
- Undertow
我们在
目录下,执行
- hola-springboot
,然后使用浏览器访问
- mvn clean package spring-boot:run
,如果一切正常,我们可以看到如下内容。
- http://localhost:8080/api/holaV1
现在这些返回内容是写死的,如果我们想个应用增加一些环境相关的配置,如何做呢?比如:可以替代 Hola 这个词,比如使用 Guten Tag 德语,我们把这个应用部署给德国人用,我们需要一个将外部属性注入给应用的途径。
Spring Boot可以很容易使用诸如:properties文件、命令行参数和系统环境变量等作为外部的配置来源。我们甚至可以将这些配置属性通过Spring Context绑定到类型实例上,例如:如果想将
属性绑定到
- helloapp.*
,可以在类型上声明
- HolaRestController
,Spring Boot会自动尝试将比如
- @ConfigurationProperties(prefix="helloapp")
或者
- helloapp.foo
等这些属性值绑定到类型实例的
- helloapp.bar
、
- foo
等字段上。
- bar
在Spring Initializer CLI创建的工程中,已经有了一个
,我们就可以在这个文件中定义新属性,比如:
- application.properties
。
- helloapp.saying
- $ more src/main/resources/application.properties
- helloapp.saying=Guten Tag aus
创建一个新的控制器
。
- HolaRestControllerV2
- @RestController
- @RequestMapping("/api")
- @ConfigurationProperties(prefix = "helloapp")
- public class HolaRestControllerV2 {
- private String saying;
- @RequestMapping(method = RequestMethod.GET, value = "/holaV2", produces = "text/plain")
- public String hola() throws UnknownHostException {
- String hostname = null;
- try {
- hostname = InetAddress.getLocalHost()
- .getHostAddress();
- } catch (UnknownHostException e) {
- hostname = "unknown";
- }
- return saying + " @ " + hostname;
- }
- public String getSaying() {
- return saying;
- }
- public void setSaying(String saying) {
- this.saying = saying;
- }
- }
停止之前运行的应用,然后在
目录下,继续使用
- hola-springboot
来编译工程,运行这个应用,然后使用浏览器访问
- mvn clean package spring-boot:run
,你会看到如下内容。
- http://localhost:8080/api/holaV2
我们现在通过更改外部配置文件来使应用适应部署的环境,比如:调用服务的url、数据库url和密码以及消息队列配置,这些都适合作为配置。但是也要把握度,不是所有的内容都适合放置在配置中,比如:应用在任何环境下都应该具备相同的超时、线程池、重试等配置。
一个Spring Boot应用搭建起来了,紧接着就是将其部署到生产环境,我们怎样监控它呢?当我们想知道它运行的怎么样,我们该怎么办呢?除非我们让应用向外暴露出Metrics,否则应用就会像黑盒子一样。Spring Boot专门提供了一个starter --
来完成这个工作。
- actuator
让我们看看如何启用
,启用的过程非常简单。在
- actuator
中依赖:
- hola-springboot/pom.xml
- <dependency>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-actuator</artifactId>
- </dependency>
然后在
中增加一个配置(安全原因):
- hola-springboot/src/main/resources/application.properties
- $ more src/main/resources/application.properties
- management.security.enabled=false
随后,结束当前应用,在
下运行:
- hola-springboot
重新编译工程,启动项目。
- mvn clean package spring-boot:run
我们可以通过浏览器访问几次
以及
- http://localhost:8080/api/holaV1
,然后访问一下:
- http://localhost:8080/api/holaV2
,可以看到如下内容。
- http://localhost:8080/metrics
类似这样的URL还有许多:
暴露出这些运行时信息,使得开发人员在忙于业务开发的同时,更轻松获取到系统信息。
到现在为止,我们还是以开发者视角使用maven来构建这个简单的工程。如果我们需要将它部署到其他环境,比如:开发、测试或者生产环境,需要怎么做呢?
幸运的是,使用Spring Boot,我们可以轻松的发布和构建,Spring Boot推荐单一、可执行的jar,而在这个jar中包括了所有的依赖,这些依赖的jar都会放置在应用的类路径下。在
下,运行
- hola-springboot
,然后可以通过
- mvn clean package
来运行。
- java -jar
- $ mvn clean package
- $ java -jar target/hola-springboot-1.0.jar
就是这样,我们可以启动这个应用,后续接下来介绍的
和
- Dropwizard
都使用类似的方式进行。
- WildFly Swarm
在微服务环境下,每个服务都有提供功能的义务并服务好它的调用者。就像我们在第一章中谈的,因为网络的不确定性,构建分布式系统十分的困难,本章主要讨论一个服务怎样调用到后台的服务。
在第五章中,将会讨论服务的柔性、适应性交互和调用
接下来将扩展
项目,完成服务的调用,但在此之前,我们先要搭建一个后台服务,完成类似下图的交互。
- hola-springboot
后台服务的构建,将采用forge + WildFly的方式进行,比原文中写一个Servlet部署到Jetty显得更好
关于forge的安装,在mac下:
- brew install jboss-forge
通过以下方式,可以在
下创建一个具备持久化能力的REST服务,它可以自由的部署到
- microservices-camp
中。
- WildFly
使用
构建完成之后,可以将其导入到IDE中,如果观察
- forge
这个类型,你会发现涉及到
- BookEndpoint
以及分页查询等逻辑已经完全具备了。
- CRUD
通过上述命令,我们可以构建出一个
的应用,下面我们将其部署到
- hola-backend.war
中。
- WildFly
的使用可以通过下载到本地运行,但是由于涉及到两个进程的交互,本文采用
- WildFly
的方式进行部署,读者可以自行准备环境。
- Docker
笔者准备了
镜像,可以简单的运行起来执行:
- WildFly
,可以启动一个
- sudo docker run --name wildfly -it -p 9990:9990 -p 8080:8080 weipeng2k/wildfly-admin
,HTTP端口在8080,应用管理端口在9990管理员账号笔者已经构建在镜像中:admin/Admin#hello1234
- WildFly
登录到
后台,通过管理界面,部署
- WildFly
。
- hola-backend.war
可以看到后台的更新日志,从中可以了解到应用部署正常。
使用这种方式的好处在于开发阶段如果有新的包生成直接进行上传就好,如果想整体销毁,直接停止删除容器即可,不会弄坏
。下面使用chrome插件
- WildFly
构建
- Postman
数据,然后测试是否可用。
- Book
新增数据测试。
查询数据测试。
看来后台服务应用
工作正常,当然可以通过
- hola-backend
的管理界面查询运行时信息,这点和Spring Boot的actuator很像,但是产品化的体验做的更好些。
- WildFly
接下来在
项目中新建
- hola-springboot
,使用
- BookRestController
来完成后端服务的交互。
- RestTemplate
- @RestController
- @RequestMapping("/api")
- @ConfigurationProperties(prefix = "books")
- public class BookRestController {
- private RestTemplate template = new RestTemplate();
- private String backendHost;
- private int backendPort;
- @RequestMapping(value = "/books/{bookId}",
- method = RequestMethod.GET, produces = "text/plain")
- public String greeting(@PathVariable("bookId") Long bookId) {
- String backendServiceUrl = String.format("http://%s:%d/hola-backend/rest/books/{bookId}", backendHost, backendPort);
- Map object = template.getForObject(backendServiceUrl, Map.class, bookId);
- return object.toString();
- }
- public String getBackendHost() {
- return backendHost;
- }
- public void setBackendHost(String backendHost) {
- this.backendHost = backendHost;
- }
- public int getBackendPort() {
- return backendPort;
- }
- public void setBackendPort(int backendPort) {
- this.backendPort = backendPort;
- }
- }
可以看到
将后端的host与port放在了配置中,而前缀是
- BookRestController
,那么也就需要在
- books
中增加这些配置。
- application.properties
- $ more src/main/resources/application.properties
- books.backendHost=192.168.0.125
- books.backendPort=8080
接下来,打开浏览器访问:
,它将访问
- http://localhost:8080/api/books/1
,而
- hola-springboot
将会调用
- hola-springboot
,最终由
- hola-backend
输出结果。
- hola-springboot
通过本章的内容,我们学习了Spring Boot的基本知识,了解它与传统的
和
- WAR
不同的部署方式,以及如何使用外部资源来完成配置,并通过actuator暴露了Metrics,使用
- EAR
调用了另一个服务。如果你想了解跟多内容,可以参考下面的链接。
- RestTemplate
来源: http://click.aliyun.com/m/34180/