《Spring Boot 实战:从0到1》第2章 快速开始Hello World

  1. 云栖社区>
  2. 博客>
  3. 正文

《Spring Boot 实战:从0到1》第2章 快速开始Hello World

程序员诗人 2017-08-01 10:49:00 浏览945
展开阅读全文

第2章 快速开始Hello World

大约20年前,程序员们使用“企业级Java Bean”(EJB)开发企业应用,需要配置复杂的XML。在二十世纪初期,新兴Java技术——Spring,横空出世。使用极简XML和POJO(普通Java对象),结合EJB的替代品(如Hibernate),Spring在企业级Java开发上占据了绝对领先地位。

但是,随着Spring的不断发展,当初的XML配置逐渐变得复杂庞大,成了累赘,遭众多程序员“诟病”。后来,Spring推出了JavaConfig项目,使用声明式的注解,大量减少了显式的XML配置。

然而,故事到这里,并没有结束。

下面即将进入我们的 SpringBoot 之旅。

Boot:引导,启动也。

本章我们快速开始 Hello World 的体验。

1.1 Spring Boot CLI groovy版Hello World

1.1.1 配置环境

首先安装Spring Boot CLI,我们去这里下载最新版本的压缩包
http://repo.spring.io/snapshot/org/springframework/boot/spring-boot-cli/
当前最新版本是:2.0.0.BUILD-SNAPSHOT 。

我们把下载好的spring-boot-cli-2.0.0.BUILD-SNAPSHOT-bin.zip 解压到相应的目录下,然后配置环境变量:

$vim .bashrc
export SPRING_BOOT_HOME=/Users/jack/soft/spring-2.0.0.BUILD-SNAPSHOT
export PATH=$PATH:$SPRING_BOOT_HOME/bin

提示:更多安装参考文档:http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#getting-started-installing-the-cli

在命令行验证spring环境安装成功:

$ source .bashrc
$ spring --version
Spring CLI v2.0.0.BUILD-SNAPSHOT

1.1.2 编写控制器groovy代码

随便打开一个编辑器,新建文件HelloController.groovy,敲入如下代码:

 @Controller
 class HelloController{
      @RequestMapping("/hello")
      @ResponseBody
      String hello(){
          return "Hello World!"
      }
 }

1.1.3 运行测试

然后在命令行执行:

$ spring run HelloController.groovy

你将会在控制台看到输出以下日志

螢幕快照 2017-08-01 13.02.12.png

一个极简的Restful Hello World就搞定了。

浏览器访问:http://localhost:8080/hello(或者curl http://localhost:8080/hello

你会看到输出:

Hello World!

1.2 常规的Java版的Hello World

1. 创建 SpringBoot Web 项目

我们可以直接在命令行输入

$ spring init -dweb --build gradle
Using service at https://start.spring.io

Content saved to 'demo.zip'

来创建一个模板项目,也可以到Spring Initializer : https://start.spring.io/ 页面进行操作。

为了更加直观,我们在Spring Initializer页面创建项目示例。如下图所示

创建项目

首先,我们依次选择 Gradle Project, Java, SpringBoot 版本是 2.0.0.BUILD-SNAPSHOT 。

然后,配置项目基本信息

Group :com.easy.springboot
Artifact: chapter1_helloworld

依赖项我们就先只用 Web 。

最后,点击 Generate Project , 页面会自动生成一个模板工程 zip 包:chapter1_helloworld.zip 。

2.解压zip,导入idea中

导入 Gradle 工程,配置 Gradle 环境,如下图

配置 Gradle 环境

等待 IDEA 构建完毕,我们将得到一个标准的 SpringBoot Application

.
├── build.gradle
├── chapter1_helloworld.iml
├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── easy
    │   │           └── springboot
    │   │               └── chapter1_helloworld
    │   │                   └── Chapter1HelloworldApplication.java
    │   └── resources
    │       ├── application.properties
    │       ├── static
    │       └── templates
    └── test
        ├── java
        │   └── com
        │       └── easy
        │           └── springboot
        │               └── chapter1_helloworld
        │                   └── Chapter1HelloworldApplicationTests.java
        └── resources

19 directories, 9 files


3. build.gradle配置文件

我们来看一下生成的模板工程里面的Gradle配置文件

buildscript {
    ext {
        springBootVersion = '2.0.0.BUILD-SNAPSHOT'
    }
    repositories {
        mavenCentral()
        maven { url "https://repo.spring.io/snapshot" }
        maven { url "https://repo.spring.io/milestone" }
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
    }
}

apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'

version = '0.0.1-SNAPSHOT'
sourceCompatibility = 1.8

repositories {
    mavenCentral()
    maven { url "https://repo.spring.io/snapshot" }
    maven { url "https://repo.spring.io/milestone" }
}


dependencies {
    compile('org.springframework.boot:spring-boot-starter-web')
    testCompile('org.springframework.boot:spring-boot-starter-test')
}

我们通过下面的表格简要说明如下

配置项 功能说明
spring-boot-gradle-plugin 这个插件在 Gradle中提供了SpringBoot支持,例如打包可执行的jar或war,运行SpringBoot应用程序等功能。它使用spring-boot-dependencies 提供的依赖管理。这样我们在dependencies 添加SpringBoot依赖的时候可以不用指定版本号。
apply plugin: 'org.springframework.boot' 应用spring-boot-gradle-plugin插件
compile('org.springframework.boot:spring-boot-starter-web') Spring 全栈式Web开发启动器,包括Tomcat、spring-webmvc、SpringBoot AutoConfigure 等核心依赖

4. SpringBoot 应用启动类

我们使用 @SpringBootApplication 注解来标注SpringBoot 应用的启动类。

package com.easy.springboot.chapter1_helloworld;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Chapter1HelloworldApplication {

    public static void main(String[] args) {
        SpringApplication.run(Chapter1HelloworldApplication.class, args);
    }
}

同样的,你将看到控制台输出如下日志:

...
 :: Spring Boot ::  (v2.0.0.BUILD-SNAPSHOT)

2017-08-01 14:31:43.849  INFO 4987 --- [           main] c.e.s.c.Chapter1HelloworldApplication    : Starting Chapter1HelloworldApplication on jacks-MacBook-Air.local with PID 4987 
...
2017-08-01 14:31:47.841  INFO 4987 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http)
2017-08-01 14:31:47.846  INFO 4987 --- [           main] c.e.s.c.Chapter1HelloworldApplication    : Started Chapter1HelloworldApplication in 5.74 seconds (JVM running for 7.021)

通过日志,我们可以看到SpringBootApplication大致的启动流程。这个过程中,很大一部分工作是在做SpringBoot 的自动配置。

5. @SpringBootApplication注解

@SpringBootApplication注解是 SpringBoot 应用的启动类的注解,它包括三个注解,如下表

注解 功能说明
@SpringBootConfiguration 等同于@Configuration,表示将该类是SpringBoot 应用程序入口类
@EnableAutoConfiguration 表示程序启动时,启动SpringBoot默认的自动配置。自动配置类通常根据类路径和我们自定义的 bean 来执行相应的自动配置策略。例如, 如果我们的类路径上有tomcat-embedded.jar , 那么SpringBoot 就会尝试去自动配置TomcatServletWebServerFactory Bean,或者去配置我们自定义的 ServletWebServerFactory Bean。
@ComponentScan 表示程序启动时自动扫描当前包及子包下所有类。

6. 编写控制器类HelloWorldController

我们简单编写一个 RestController,代码如下

package com.easy.springboot.chapter1_helloworld.controller;

import java.util.Date;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloWorldController {
    @RequestMapping("hello")
    String hello() {
        return "Hello World! " + new Date();
    }
}

7. 运行测试

我们在 IDEA 中直接点击 main 函数运行

点击 main 函数运行

可以看到控制台输入如下的日志:

...
 :: Spring Boot ::  (v2.0.0.BUILD-SNAPSHOT)

2017-08-01 14:57:24.928  INFO 5224 --- [           main] c.e.s.c.Chapter1HelloworldApplication    : Starting Chapter1HelloworldApplication on  
...
Mapped "{[/hello]}" onto java.lang.String com.example.controller.HelloWorldController.hello()
...
2017-08-01 14:57:28.468  INFO 5224 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http)
2017-08-01 14:57:28.479  INFO 5224 --- [           main] c.e.s.c.Chapter1HelloworldApplication    : Started Chapter1HelloworldApplication in 4.128 seconds (JVM running for 4.914)

浏览器访问:http://localhost:8080/hello

我们将看到如下输出:

Hello World! Tue Apr 04 23:08:33 CST 2017

另外,如果是在命令行运行,使用SpringBoot gradle插件的执行:

gradle bootRun

如果是使用的 Maven,那么对应的是SpringBoot maven插件的执行:

mvn spring-boot:run

8. 运维监控

SpringBoot 本身提供了丰富的健康监控等运维功能,这些功能在 actuator 里。我们在build.gradle的依赖里面添加一行actuator的配置

compile('org.springframework.boot:spring-boot-starter-actuator')

为了方便测试,我们在application.properties 添加如下配置

endpoints.metrics.enabled=true
management.security.enabled=false // 去掉安全校验

然后重启应用,我们可以看到 IDEA 的控制台Endpoints 的 Beans Tab界面里面有我们的这个 SpringBoot 应用的所有 Bean 的信息列表

Endpoints 的 Beans 界面
helloWorldController Bean

Health Tab 界面中我们可以看到服务器(本机)的磁盘使用信息

Health Tab 界面

在请求映射 Mappings 界面我们可以看到SpringBoot 应用提供出来的所有的 Rest 接口

Mappings 界面

例如,我们访问http://127.0.0.1:8080/application/health , 可以得到如下输出

{
  "status": "UP",
  "diskSpace": {
    "status": "UP",
    "total": 120108089344,
    "free": 1280909312,
    "threshold": 10485760
  }
}

其他的监控 API,可以类似访问,看看输出的内容。关于spring actuator 监控的更多内容,我们将在后面的章节中介绍。

本章小结

本章我们通过两个Hello World 实例,快速体验了 SpringBoot 开发的过程。在 SpringBoot 里面我们不再有各种繁杂的 xml 配置,不再有配置、启动、运行 Tomcat Web 服务器的一系列繁琐操作了。

同时您也一定发现了:我们的这个 Web 应用是怎么启动运行的?

下一章中我们就来一起学习一下 SpringBoot 应用的启动过程和自动配置原理。

https://github.com/EasySpringBoot/chapter1_helloworld

网友评论

登录后评论
0/500
评论
程序员诗人
+ 关注