『Java微服务实践』 使用Spring Boot构建第一个API

得力于强力的Spring Boot框架,使得在Java领域开发微服务变得简单轻松。Spring Boot是个基于Spring依赖注入框架之上的快速开发及发布就绪(production-ready)框架,是在Java领域可以用来构建微服务的框架之一。在本文中将以实践的方式来介绍Spring Boot框架,以及使用Spring Boot来构建RESTful风格的微服务。在最后我们再来看看Spring Boot框架里面哪些特性可以帮助我们构建发布就绪(production-ready)的微服务。以下是你在本文中将学到的内容:

  1. 安装最新Spring Boot开发环境
  2. 使用Spring Boot开发RESTful风格的微服务
  3. 使用Spring Boot特性来构建发布就绪(production-ready)的微服务

开发环境准备

在使用Spring Boot开发微服务之前需要安装以下环境:

Oracle JDK8
Apache Maven 3.3+
Spring Tool Suite
其它可选的IDE有IntelliJ IDEA, NetBeans和Eclipse,为了Spring Boot相关组件的引入,所以本文就用STS来做演示了,同样,依赖管理工具Maven也可以换成Gradle,根据你自己的熟悉程度来选了。在本文中的Spring相关框架版本为:

Spring Boot 2.0.3.RELEASE
Spring Framework 5.0.7.RELEASE
使用Spring Boot作为微服务框架进行微服务开发,为了方便使用Spring生态的各类框架和工具,因此我们还需要准备相应的Spring Boot工具环境。

Spring Boot CLI 2.0.3

Spring Boot CLI快速开始

我们将使用Spring Boot CLI进行我们第一个Spring Boot应用的初始化,当然你可以使用STS或Spring Initializr来进行创建,这两种方法我们将在后面介绍,你日后可以根据自己的使用习惯来选择。如果你使用STS作为IDE开发的话,使用STS构建Spring Boot应用很简单,如果你习惯命令行操作的话,Spring Boot CLI是个不错的选择,如果你不想安装STS或Spring Boot CLI的话,直接使用Spring Initializr这是可以的。实际上Spring Boot CLI就是Spring Initializr的命令行版本。

当你安装完毕Spring Boot CLI后,你可以通过命令行查看下安装的版本情况。

$ spring --version
Spring CLI v1.4.0.RELEASE

如果你能够看到Spring CLI的版本信息,表明你的Spring Boot CLI已经安装完成,接下来,我们使用Spring Boot CLI来创建个示例项目:

spring init --build maven --groupId io.junq.examples  --version 1.0.0 --java-version 1.8 --dependencies web  --name hello-springboot --package-name io.junq.examples.boot hello-springboot

在执行完上面的命令后,会生成一个名为hello-springboot的目录,该目录里面就是hello-springboot项目的完整文件了。spring init命令还有一些可选参数,我们列一些常用的出来简单讲述下:

--build
  指定所使用的构建管理(依赖关系管理)工具。可选项为maven或gradle。

--groupId
  maven项目的groupId,会反映在pom.xml中,需要注意的是,设置了这个参数并不会指定包名,包名需要用 package-name参数来进行指定。

--package-name
  应用的包名。

--version
  应用的版本号,如 1.0.0

--java-version
  JDK版本

--dependencies
  该应用依赖的Spring组件列表,可以选择多个,以逗号分隔。

现在你可以进入hello-springboot目录,执行以下命令

 mvn spring-boot:run

如果不报错的话,你的终端或命令行应该输出类似以下日志:

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v2.0.3.RELEASE)

2017-02-10 15:39:43.321  INFO 64362 --- [           main] i.j.e.boot.HelloSpringbootApplication    : Starting HelloSpringbootApplication on junqiangs-MacBook-Pro.local with PID 64362 (started by junqiangliu in /Users/junqiangliu/Documents/james/courses/StuQ-1160 Java微服务/examples/hello-springboot)
2017-02-10 15:39:43.324  INFO 64362 --- [           main] i.j.e.boot.HelloSpringbootApplication    : No active profile set, falling back to default profiles: default
2017-02-10 15:39:43.406  INFO 64362 --- [           main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@2e6aff98: startup date [Fri Feb 10 15:39:43 CST 2017]; root of context hierarchy
2017-02-10 15:39:44.538  INFO 64362 --- [           main] trationDelegate$BeanPostProcessorChecker : Bean 'org.springframework.boot.autoconfigure.validation.ValidationAutoConfiguration' of type [class org.springframework.boot.autoconfigure.validation.ValidationAutoConfiguration] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying)
2017-02-10 15:39:44.651  INFO 64362 --- [           main] trationDelegate$BeanPostProcessorChecker : Bean 'validator' of type [class org.springframework.validation.beanvalidation.LocalValidatorFactoryBean] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying)
2017-02-10 15:39:44.966  INFO 64362 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat initialized with port(s): 8080 (http)
2017-02-10 15:39:44.981  INFO 64362 --- [           main] o.apache.catalina.core.StandardService   : Starting service Tomcat
2017-02-10 15:39:44.983  INFO 64362 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet Engine: Apache Tomcat/8.5.11
2017-02-10 15:39:45.150  INFO 64362 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2017-02-10 15:39:45.151  INFO 64362 --- [ost-startStop-1] o.s.web.context.ContextLoader            : Root WebApplicationContext: initialization completed in 1745 ms
2017-02-10 15:39:45.323  INFO 64362 --- [ost-startStop-1] o.s.b.w.servlet.ServletRegistrationBean  : Mapping servlet: 'dispatcherServlet' to [/]
2017-02-10 15:39:45.329  INFO 64362 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean   : Mapping filter: 'characterEncodingFilter' to: [/*]
2017-02-10 15:39:45.329  INFO 64362 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean   : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]
2017-02-10 15:39:45.329  INFO 64362 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean   : Mapping filter: 'httpPutFormContentFilter' to: [/*]
2017-02-10 15:39:45.330  INFO 64362 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean   : Mapping filter: 'requestContextFilter' to: [/*]
2017-02-10 15:39:45.627  INFO 64362 --- [           main] s.w.s.m.m.a.RequestMappingHandlerAdapter : Looking for @ControllerAdvice: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@2e6aff98: startup date [Fri Feb 10 15:39:43 CST 2017]; root of context hierarchy
2017-02-10 15:39:45.720  INFO 64362 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error]}" onto public org.springframework.http.ResponseEntity<java.util.Map<java.lang.String, java.lang.Object>> org.springframework.boot.autoconfigure.web.BasicErrorController.error(javax.servlet.http.HttpServletRequest)
2017-02-10 15:39:45.722  INFO 64362 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error],produces=[text/html]}" onto public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)
2017-02-10 15:39:45.759  INFO 64362 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-02-10 15:39:45.759  INFO 64362 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-02-10 15:39:45.810  INFO 64362 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-02-10 15:39:46.001  INFO 64362 --- [           main] o.s.j.e.a.AnnotationMBeanExporter        : Registering beans for JMX exposure on startup
2017-02-10 15:39:46.080  INFO 64362 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
2017-02-10 15:39:46.085  INFO 64362 --- [           main] i.j.e.boot.HelloSpringbootApplication    : Started HelloSpringbootApplication in 3.35 seconds (JVM running for 224.399)

现在你的第一个Spring Boot应用已经成功运行,打开浏览器访问 http://localhost:8080 ,你会看到如下内容:

这个是一个默认的错误页面,因为现在什么REST API代码都还没有编写,所以正常咯。

Hello World

我们现在已经有了一个可以运行的Spring Boot应用,接下来我们添加一些简单的方法来实现功能。现在我们来添加一个REST API,路径为 /api/hello,访问此API时,会返回“Hello world,Spring Boot rocks。”的消息。首先定位到“src/main/java/io/junq/examples/boot”在该目录下创建HelloRestController.java,该类负责 /api 这个API路径的所有业务逻辑,如下所示:

public class HelloRestController {

    public String hello() {
        return "Hello world, Spring Boot rocks.";
    }

}

添加 HTTP 请求入口

在上面我们创建了“HelloRestController”类想来它负责 /api 这个路径下的业务请求,所以我们要给其添加 HTTP Endpoints 才能够被Spring Boot框架正式处理,调用它来处理对应API路径下的业务逻辑,以下先介绍两个关键的注解:

@RestController

  告诉 Spring 这个控制器类可以用来作为HTTP请求入口,如GET、POST、PUT、DELETE等。

@RequestMapping

  表示将映射HTTP地址的哪个部分到Java代码上,这里的Java代码可以是类、方法等。

我们将 “/api” 的HTTP请求入口绑定至 HelloRestController 这个控制器类上,将 “/api/hello” 映射到 “hello” 方法上,如下所示:

@RestController
@RequestMapping("/api")
public class HelloRestController {

    @RequestMapping(method = RequestMethod.GET, value = "/hello",
            produces = "text/plain")
    public String hello() {
        return "Hello world, Spring Boot rocks.";
    }

}

这是再运行项目,使用浏览器访问 http://localhost:8080/api/hello ,你会看到如下内容:

发表评论

电子邮件地址不会被公开。 必填项已用*标注