Spring Boot 永远滴神！10分钟快速入门，Java程序员必看

「爱情、让人受尽委屈。」 2022-10-19 15:59 131阅读 0赞

大家好呀，我是七哥。

> 最近家里添加了一个小宝贝，近两周忙的是手忙脚乱的，所以《Spring江湖路》也搁置了一段时间。这不慢慢适应了生活的节奏，抽时间就来更新了。

**不过说句题外话，我之前是觉得我不喜欢孩子的，又哭又闹的，麻烦 ！！**

结果我宝宝出生后，我爱不释手，住院的那几天我连着两天没睡觉就盯着孩子看，生怕她饿了、哭了 。抱在怀里，看到她人生第一次喝奶，那太可爱了，也感到很神奇，这么小，嘴一碰奶瓶就使劲喝了起来。

**奶爸上线了，后面有机会在写，我们步入今天的正题。**

今天这篇文章是我们《Spring江湖路》正式内容的第一期，我决定就以 Spring Boot 作为我们步入江湖的开端。

### 为什么是 Spring Boot ###

因为目前开发 WEB 应用，Spring Boot 是启动 Spring 项目最快最流行的方式了。无论我们要构建一个什么样的应用，它都可以让我们尽可能快的启动运行起来。前期基本上无需配置啥东西，而且**内置应用服务器**，让我们两三下就可以搞一个 生产级别应用出来，这对于 Java 程序员来说，只能用俩字来形容了，那就是幸福！

![da6fbcdfa3a7f495cfb96c236cf50c62.png][]

### Spring Boot 和 Spring 的关系 ###

可能因为 SpringBoot 实在是太惊艳了，网上有很多言论可能对很多小伙伴造成了一些误解。这里我列举几个，看看你中了没？

1.  SpringBoot不是应用服务器；

之所以有这个误解，是因为 SpringBoot 可以将Web应用程序打包成可执行的 jar 文件，不用部署到我们传统的Java应用服务器就可以运行。这是因为 SpringBoot 内置了一个Servlet容器（Tomcat、Jetty等），所以**这个功能并不是 SpringBoot 本身的而是内嵌的 Servlet容器提供的**。

1.  SpringBoot 没有实现 JPA 或者 JMS（Java消息服务）等企业级 Java 规范。

只不过是自动配置了支持这些特性的 Bean，比如自动配置了 Hibernate ，这些都是之前已经有的技术，并不是SpringBoot新实现的；

**SpringBoot 就是 Spring，它做了那些没有它我们也会自己去做的 Spring Bean 配置**。它利用的是 Spring4 的条件化配置特性，以及 Maven 和 Gradle 提供的传递依赖。

Spring Boot 相比于 Spring 主要包含了以下四个核心功能：

1.  自动配置；
2.  起步依赖：告诉 Spring Boot 需要什么功能，它就能引入需要的库。
3.  命令行界面：这个可以让我们无须构建项目只写代码就可以完成完整的应用程序；
4.  Actuator：应用监测和监控；

搞清楚了 Spring Boot 其实就是一种开发 Spring 应用程序的快捷方式，那接下来，让我们一起来感受疾风吧，看看它到底有多便捷。

### 创建 Spring Boot 应用 ###

这里先说一下，本文我使用的 `Spring Boot` 版本是 `2.5.2` ，要求你本地安装的 JDK 至少是 1.8 或者更高的版本，Spring Boot 2.x 以上的版本最低要求就是 `JDK 1.8` 了。官方推荐的版本目前是 jdk8 和 jdk11，因为这俩版本目前是长期维护的。构建打包工具 `Gradle 4+ or Maven 3.2+`，最后就是宇宙最强 IDE，IntellJ IDEA，没有之一。

> 既然是入门，我们今天就以 Spring5 开始支持的响应式编程为例，让大家感受下使用 Spring Boot 是如何开发响应式项目的。

1.  打开 https://start.spring.io/, 选择语言和构建工具以及依赖项，点击如下图所示；

![4211070066d7240f83809b92c02725a6.png][]

1.  点击 **Generate** 下载；
2.  解压下载的压缩包，进入到项目根目录,然后使用 IDEA 打开 `pom.xml` ;

![f3af89b009d9da4bae9de54732e287ca.png][]

需要注意的是，上面一步，需要先设置 `pom.xml` 的默认打开应用程序为 `IDEA`，或者你可以选择 `File` \--> `New` \--> `Project from Existing Sources...` 然后选择 `pom.xml` 效果也是一样的，如下图所示。

![fede7d801a2b99d1f39be06ef1eb9992.png][]

1.  打开后，刷新 Maven 依赖（第一次会有点慢，耐心等待），我们就可以得到下图项目结构了；

![b5b5ede6ae785e2ab24e22bbb405643e.png][]

### 访问数据库 ###

Spring Boot 无缝集成了 **关系型数据库** 和 **NOSQL 数据库** 。 并且 Spring Boot 也提供了响应式的数据库访问支持。

那我们如果想使用 Spring Boot 访问数据库，都需要做什么呢？ 稳住，你可能会震惊的。

![2af42103ab6843c65482e46b00da5102.png][]

下面给大家看下我写的响应式编程数据库访问的测试代码，为了不依赖任何环境，让大家可以快速、直观的感受，我使用的是内存数据库 h2。

*  将下面的代码，放到你的 Spring Boot 专属启动类中。

@SpringBootApplication
    public class Springroad01Application { 
    
        public static void main(String[] args) { 
            SpringApplication.run(Springroad01Application.class, args);
        }
    
    }
    // 测试数据库访问，容器启动后会执行run方法
    @Component
    class DataWriter implements ApplicationRunner { 
    
        private Logger log = LoggerFactory.getLogger(DataWriter.class);
    
        private DatabaseClient client;
    
        private UsersDao usersDao;
    
        public DataWriter(DatabaseClient client, UsersDao usersDao) { 
            this.client = client;
            this.usersDao = usersDao;
        }
    
        @Override
        public void run(ApplicationArguments args) { 
    
            List<String> statements = Arrays.asList(
                    "DROP TABLE IF EXISTS USERS;",
                    "CREATE TABLE IF NOT EXISTS USERS ( id SERIAL PRIMARY KEY, name VARCHAR(100) NOT NULL);");
    
            statements.forEach(sql -> client.sql(sql).fetch().rowsUpdated()
                    .doOnSuccess(count -> log.info("Schema created, rows updated: {}", count))
                    .doOnError(error -> log.error("got error : {}",error.getMessage(),error))
                    .subscribe()
            );
    
            Flux.just("sevenluo","tonyzhu","jameschen").flatMap(name -> usersDao.save(new Users(null,name))).subscribe(user -> log.info("User saved: {}",user));
    
    
        }
    }
    // DAO 接口，不需要加注解，继承了 ReactiveCrudRepository 会自动生成实例的
    interface UsersDao extends ReactiveCrudRepository<Users, String> { 
    }
    
    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    class Users { 
        @Id
        private Integer id;
        private String name;
    
    }

*  执行 main 方法，输入结果；

![5ce904546deadeda90770432e4d3fceb.png][]

就是这么赤鸡，结束了，啥配置没有，直接写了几行代码就可以访问数据库了。

![b02430778defdb57b36dbed82b316530.png][]

### REST 接口开发 ###

你应该还关心 Spring Boot 如何开发一个 REST 风格的 WEB 接口吧？别慌，我们直接用 Spring 支持的响应式编程来搞一个 REST 应用服务。但是对于 WEB 访问用户来说是看不出来我们使用了非阻塞的响应式编程的，来一手润物细无声。

![02803682ea0baf643c4dab9191440bba.png][]

*  将下面的代码放到启动类中，就是一个响应式的 REST 接口就开发好了。

![ef5942700c4704442f32de8ffda062e6.png][]

*  测试一下，打开命令行，`curl` 测试一下（不是非要装逼不用浏览器访问，公司的大佬说程序员要多用shell环境，嗯！从小事开始练）；

![9eb5e9fc2a85519191b9ea41a7f905c4.png][]

> 温馨提示，在 mac 上安装 jq，直接使用 `brew install jq` 就会自动帮你安装好了。

好了，打完手工，没啥搞头，Spring Boot 永远滴神！

![9187c86b8083d4d16c844d214ed9a3d7.gif][]

### 监控和管理应用 ###

我们的应用上线后，那肯定都是要上监控的，不然哪一天神不知鬼不觉死翘翘了，麻烦就大了。这个 Spring Boot 它就天生带了可以替我们监控和管理的 Spring 应用的模块工具：`spring-boot-actuator` 。

![541aaee2d83d2c085ea4fca5a2fd90b9.png][]

像什么 健康检查、审计、统计和HTTP追踪等该有的它都有。值得一提的是 `spring-boot-actuator` 它还很 open ，支持与其它外部监控系统做整合。补充了它自身没有一些好看的仪表盘、图表、分析、告警等 酷炫吊炸天的能力。

那怎么玩呢？

**确认你的应用添加了对应的模块依赖；**

假如你使用的 maven，那看你的 `pom.xml` 中下面的依赖：

<dependencies>
    	<dependency>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-actuator</artifactId>
    	</dependency>
    </dependencies>

那如果你使用的 gradle，对应的 `build.gradle` 文件中有下面的依赖：

dependencies {
        compile("org.springframework.boot:spring-boot-starter-actuator")
    }

**Actuator 通过 `endpoint` 来暴露 HTTP 请求 来监控和管理应用；**

应用启动后，`http://localhost:8080/actuator` 会展示出所有通过 HTTP 暴露的 endpoint。

![60512cb3985d0479bf237fbfc1bb83bf.png][]

因为太长了，我这里列出的只是一部分 endpoint，你自己一定要动手试下。

就比如，`/health` 这个 endpoint，提供了关于应用健康的基础信息。

`/metrics` endpoint 展示了几个非常有用的度量信息，比如 JVM内存使用情况、系统 CPU 使用情况、打开的文件等等。

`/loggers` endpoint 展示了应用的日志和可以让你在运行时改变日志等级。

还有好多，下去都自己玩玩，动手就会了。

![879f2fb7f09e1ae0e67410b89d9ed9f9.png][]

> 友情提示，如果你的 `http://localhost:8080/actuator` 展示的 开放端点很少，那是因为 `actuator` 的 `endpoint` 可以显式的被打开和关闭，明白了吧！

默认情况下很多 endpoint 是被关闭掉了，你只需要在 application.properties 配置文件中增加如下配置即可。

management.endpoint.health.show-details=always //显示详细的健康信息
    management.endpoints.web.exposure.include=*  //粗暴的全部打开，反正自己玩，任性

这里我们就不多说这些 `endpoint` 每个的作用了, 如果你感兴趣，可以给我留言，我会根据大家需求看下是否在出一期教程详细介绍一下。

**当然除了上面默认显示的应用健康信息，我们也可以自定义一个健康指标；**

我们可以选择实现 `HealthIndicator` 接口来实现我们的目标；

@SpringBootApplication
    public class Springroad01Application { 
    		// 加上这个Bean就可以了
        @Bean
        HealthIndicator healthIndicator() { 
            return () -> Health.up().withDetail("app", "i am so good").
                    withDetail("error","开什么玩笑，老夫怎么可能有错！").build();
        }
    
        @Bean
        RouterFunction<ServerResponse> routes (UsersDao usersDao) { 
            return RouterFunctions.route(GET("/users"),serverRequest -> ok().body(usersDao.findAll(),Users.class));
    
        }
    
        public static void main(String[] args) { 
            SpringApplication.run(Springroad01Application.class, args);
        }
    
    }

一旦你加上我们上面自定义的健康指标，重启应用，就会看到 `health` 这个 endpoint 将展示出我们增加的这些信息：

![7f61b1d762500134535afbf2ad1ba507.png][]

### 安全控制 ###

对于应用安全的支持，那就绕不开 `Spring Security` 了。

它可以轻松完成应用的鉴权、授权功能，同时也提供了对响应式编程的支持。

接下来就展示下如果让你的应用快速带上安全套。

*  加入 Spring-Security 依赖包；

<dependency>
    	<groupId>org.springframework.boot</groupId>
    	<artifactId>spring-boot-starter-security</artifactId>
    </dependency>

*  内存中配置一个用户，设置用户名和密码；

@Bean
    // 内存中配置用户名、密码为 admin/admin，用户角色为 USER
    MapReactiveUserDetailsService users() { 
        return new MapReactiveUserDetailsService(User.withUsername("admin").password(PasswordEncoderFactories.createDelegatingPasswordEncoder().encode("admin")).roles("USER").build());
    }

*  验证

![dcc9d01b66c78189e35b129858cc27ce.png][]

直接访问，提示 401 错误，这个错误码应该了然于心了吧。 没错就是没有权限的意思。

加上用户名、密码我们再试试：

curl -vu admin:admin http://localhost:8080/actuator/health | jq

![b13234889dddb32583d1668717f63aae.png][]

加上用户名和密码令人期待的结果就返回了，是不是瞬间心情大好呢。

上面我们仅仅是引入了 Spring-Security 包，然后加了两三行代码，没有写任何的拦截器验证逻辑，我们的应用就具备了安全验证功能，这也太 **啊妹子ing** 了吧。

![caf85ba93a5defbb643192f5a6e26174.gif][]

### 江湖再见 ###

此章节我们就完成了 Spring-Boot 的入门开发介绍。

用10分钟完成了包含 **创建应用、访问数据库、REST接口开发、监控和管理、安全控制** 的开发。

章节中并没有对具体的技术细节做讲解，比如 Demo 中使用响应式编程、Spring Boot Actuator 端点的详细讲解等。

仅仅是为了让小伙伴们了解到 Spring Boot 的强大和便利，感受下 Spring 对我们程序员的友好，从而明白我们 **Spring 江湖路** 坚定闯下去的必要性。

更多关于 Spring 相关的内容，也在持续更新中，欢迎兄弟萌加个关注，Spring江湖之路，我们一起走！

[da6fbcdfa3a7f495cfb96c236cf50c62.png]: /images/20221004/54656d00eb4d4f92ac1da95a23c28d40.png
[4211070066d7240f83809b92c02725a6.png]: /images/20221004/b0d30d55eaa94897b4f9704c216c7a23.png
[f3af89b009d9da4bae9de54732e287ca.png]: /images/20221004/ecca0c43343c425da643d1dc9044881c.png
[fede7d801a2b99d1f39be06ef1eb9992.png]: /images/20221004/3fa0d1c295e94f6aaa97bc6f916f8ff7.png
[b5b5ede6ae785e2ab24e22bbb405643e.png]: /images/20221004/c281c8ee563c446a9cfd60a16439b327.png
[2af42103ab6843c65482e46b00da5102.png]: /images/20221004/f779a68f96b54a4a83aa3a3993b005a2.png
[5ce904546deadeda90770432e4d3fceb.png]: /images/20221004/76f4409486254162884cf23c60c696f4.png
[b02430778defdb57b36dbed82b316530.png]: /images/20221004/63b5b94925ce485db3ce1d39f35a5885.png
[02803682ea0baf643c4dab9191440bba.png]: /images/20221004/d4370b8c27ee4a188732d39efffae51f.png
[ef5942700c4704442f32de8ffda062e6.png]: /images/20221004/ee2c46714f2f439f8641e0091df1921d.png
[9eb5e9fc2a85519191b9ea41a7f905c4.png]: /images/20221004/05f1b785c904463685f524078cfd8936.png
[9187c86b8083d4d16c844d214ed9a3d7.gif]: /images/20221004/ab5ae90aa589447780d140fdc02176e0.png
[541aaee2d83d2c085ea4fca5a2fd90b9.png]: /images/20221004/a2575297e9b040e0837da735ba602633.png
[60512cb3985d0479bf237fbfc1bb83bf.png]: /images/20221004/15e80931a5764dfda323cd3bffb9779d.png
[879f2fb7f09e1ae0e67410b89d9ed9f9.png]: /images/20221004/e720f602757d44cb991b8f3b06877e84.png
[7f61b1d762500134535afbf2ad1ba507.png]: /images/20221004/e13636fb3ce34ad4abc026512b234dab.png
[dcc9d01b66c78189e35b129858cc27ce.png]: /images/20221004/3023b13f87f64111993b3069a994937e.png
[b13234889dddb32583d1668717f63aae.png]: /images/20221004/33137a1fecfa40528a6ddd23a306cf98.png
[caf85ba93a5defbb643192f5a6e26174.gif]: /images/20221004/9ca86681015c4e7daf8c5607c31ace1e.png