牛刀小试——五分钟入门Spring Boot

在一个程序员的眼里，万物皆可Hello World。Spring Boot当然也不例外。下面一起来完成我们的第一个Spring Boot程序。

创建一个Web工程

新建项目

在 首 次 运 行 Intellij IDEA 时 ， 或 者 取 消 勾 选 Reopen projects onstartup（启动时重新打开项目）复选框时，你会看到如图所示的界面，选择New Project选项。

在非首次运行Intellij IDEA时，你可以选择File→New→Project菜单命令来创建一个工程。

选择项目类型

弹出如图所示的项目类型选择界面，首先选择左侧项目类型列表中的Spring Initializr 选 项 ， 然 后 在 Project SDK 下 拉 列 表 中 选 择 1.8 javaversion“1.8.0_271”选项，单击Next按钮。

接下来选择项目需要依赖的Jar包。如果你写过非Spring Boot的Java Web项目，那么回想一下，创建一个Java Web项目需要依赖哪些Jar包呢？好的，我知道你可能根本想不起来（或者说想不全）了，但这并不是你的错，因为Jar包实在太多、太琐碎了。值得庆幸的是，我们今天使用Spring Boot开发一个Web项目，根本不需要你记住依赖哪些Jar包。你只需要知道要开发的是一个Web工程即可。在Intellij IDEA的依赖选择界面中（见图3-4），你只需要勾选Spring Web复选框，然后单击Next按钮即可。

选择项目的保存路径

最后需要选择一下项目的保存路径，这里可以根据自己的习惯与喜好进行设置，并单击Finish按钮（见图）。

项目创建完成后，你会看到如图所示的项目结构。关于这个结构的细节，我们会在下一节进行详细讨论。

完成核心代码

经过上面的操作，我们就搭建好了一个Web工程的基础框架，距离完成我们的第一个Spring Boot程序只差最后一步了。接下来创建HelloController类并编写本例中仅有的hello方法代码。

创建HelloController类

在Intellij IDEA中新建一个类很简单，可以按照图所示，单击工具栏中的Java Class按钮（如果你的Intellij IDEA中没有这个按钮，可以参考2.3.1 节 进 行 设 置 ） 来 创 建 一 个 HelloController 类 ， 或 者 选 择File→New→Java Class菜单命令来创建，或者直接右击对应的package（如com.shuijing.boot）来创建。

在New Java Class对话框中输入HelloController，并按Enter键，如图所示。

编写hello方法代码

在HelloController类中添加一个hello方法，具体代码如下：

运行并查看效果

经过以上步骤，我们的第一个Spring Boot程序就全部完成了。接下来需要验证一下这个程序是否可以正常运行。在Intellij IDEA中启动一个项目很简单，可以单击图中任意一个向右的小箭头，也可以使用Shift+F10快捷键。

接下来在浏览器中访问http://localhost：8080/hello，会看到页面中打印出如下内容：

运行结果如图

经过上面的简单操作，我们就完成了一个基于Spring Boot的Hello World程序。如果你之前用过SSH或者SSM（如果没有，那么建议你去网上找一个教程体会一下），那么应当会更加深切地体会到Spring Boot的简洁与高效。

不知道你刚刚有没有意识到，在使用Spring Boot创建一个Web项目时，我们仅仅通过5个步骤就完成了！我们没有配置（甚至都没有见到）web.xml；没有配置启用注解；没有配置包扫描路径；没有配置视图解析；没有配置Tomcat……

对于以前创建一个Java Web项目时需要进行的所有配置，我们好像都没有做。难道现在技术进步了，不需要这些配置了吗？当然不是，当你觉得轻松的时候，一定是有人替你完成了这些配置。没错，一切繁杂且与业务无关的配置，都由Spring Boot帮我们默默地完成了。那么，Spring Boot是怎么做到的呢？其实核心思想就6个字——约定优于配置。

Spring Boot的工程结构

接下来我们一起学习Spring Boot的工程结构。我们刚刚创建的工程结构如图

如果你之前接触过Maven，那么应当非常熟悉这个结构，这就是一个标准的Maven工程结构。

Spring Boot之所以使用Maven的工程结构，是因为它们都遵循“约定优于配置”的设计哲学。

结构详解

下面我们来看每个文件/文件夹（目录）的作用：

从上面的结构中可以看出，工程根目录由4部分组成——target（目录）、gitignore（文件）、pom.xml（文件）和src（目录）。

我们知道，target是目标的意思，使用Maven打包后会将编译后的.class文件和依赖的Jar包，以及一些资源文件放到这个目录下。

gitignore文件用来配置那些不需要Git帮助我们进行版本控制的文件或目录，例如，Intellij IDEA产生的配置文件或者本地开发使用的applicationlocal.yml文件等。

pom.xml文件用来配置依赖的Jar包，帮助我们进行Jar包管理。我们会经常跟它打交道。

最后的src目录用来存放所有我们编写的Java源码文件、程序配置文件、资源文件等，是开发需要用到的主目录。

至此，我们对于Maven或者说Spring Boot的工程结构已经有了一个非常清晰的认识。但对于我们这种好学之人（不许笑），到这里是远远不够的。我们还想要了解为什么要将工程结构设计成这样。既要知其然，还要知其所以然。

结构分类

功能目录

target、gitignore和pom.xml都是偏工具属性的，主要是给Maven、Git用的，与开发人员的关系没有那么紧密。我们可以将其称为功能目录（文件）。

业务目录

真正跟开发人员息息相关的是src目录下的内容。开发人员平时操作最多的内容也是这个目录下的内容。我们可以清晰地看到，src目录有两个分支——main和test。这两个目录的用途很好理解，main用来存放业务逻辑主代码，而test则用来存放测试代码。而且我们可以很容易地发现它们两个内部的结构极其相似。因为test就是为main服务的，理论上讲，main中的每一个Java类（POJO类除外）在test中都有一个测试类，可以理解成main中的每个类都有一个“贴身侍卫”，用来护其周全。

再往下看，又分为dao、service、controller等目录，这体现了软件开发中最基本的分层思想，对应着数据层、业务逻辑层及Web控制层。

珍爱生命，我用Starters

计算机的“发烧友”都喜欢按照自己的喜好购买各个部件（CPU、显卡、主板、电源、机箱等），然后自己组装一台心仪的主机。但这对于普通用户来说，技术门槛太高了。普通用户不关心CPU到底采用的是多少纳米的工艺，只要能满足日常办公需要就行了；不关心显卡有多少个流处理器，只要能流畅地播放主流高清视频就行了；不关心硬盘是SATA还是M.2接口，只要能装下老师们的讲解视频就行了（对，我说的就是那些教你写代码的视频）。

组装计算机和Starters有什么关系呢？不光有关系，简直就是一回事，你看完就明白了。

没有Starters的日子

Java在业界之所以有今天的地位，很大一部分原因是JVM生态具有非常强大的第三方支持力量。但凡事都有两面性，这些库实在太多了，以致完成同一个功能会有很多种方案可供选择，而同一个方案又有N个版本。在没有Starters的日子，开发一个项目时，你需要在pom文件中手动维护动辄上百个Jar包依赖。

以我们前面创建的Hello World程序为例，在没有Starters的日子，我们需要进行以下操作。

• 1.收集Web应用所需的Jar包。
• 2.将这些Jar包的坐标添加到Maven依赖里。
• 3.有些Jar包的版本可能需要更换。
• 4.某个Jar包可能与其他Jar包冲突或者不兼容。
• 5.反复地调试，直到可以正常运行。

这项操作也是5步，跟前面差不多，但似乎哪里不对——这5步好像只做了前面“选择依赖”这件事！如果运气不好（更准确地说，是“经验不足”），遇到冲突或者不兼容的情况，就不知道需要多久才能解决了。很显然，这对一个初学者（就称他“小白”吧）来说太不友好了，他有可能还没入门就只能放弃。假如小白意志坚强，经过不断“打怪升级”，积累经验，并将之前“踩过的坑”记录到自己的知识库中，那么以后每次用到的时候只需要施展“CV大法”即可。

这样看起来也挺不错，效率比之前提高了不少。但小白的整个职业生涯可能需要写几十、几百个工程，而全世界又有多少个像小白一样的人呢？假设施展一次“CV大法”耗时10秒，平均一个人一生创建100个工程，全世界的Java程 序 员 有 100 万 人 ， 那 么 这 些 人 用 在 “CV 大 法 ” 上 的 时 间 为 ：10×100×1000000=1000000000秒≈31年。

有了Starters以后

有了Starters以后的Spring Boot可以让我们多轻松呢？还记得前面选择依赖那个步骤吗？如图所示。

勾选Spring Web复选框，对应到pom文件中，就是添加如下依赖：

没错，就是这么简单，一个spring-boot-starter-web就把一个Web工程需要的Jar包全部搞定了。那么，Starters究竟是何方“神圣”，是如何做到这些的呢？

什么是Starters

Spring官网对Starters的介绍如下：

Starters are a set of convenient dependency descriptors that youcan include in your application.You get a one-stop shop for all theSpring and related technologies that you need without having to huntthrough sample code and copy-paste loads of dependency descriptors.简单翻译如下：

Starters是一组方便的依赖描述。你可以将其添加到你的应用中，将会得到Spring及相关技术的一站式服务，使你不必再将那些样板代码进行反复的复制、粘贴操作。

spring-boot-starter-web包含的Jar包如图所示。

图中展示了spring-boot-starter-web包含的所有Jar包，看到这里我们就明白了，Starters其实就是将一组具有相关性的Jar包做了一个整合。不同的Starters对应不同的功能。例如：

•  spring-boot-starter-web用于Web工程
•  spring-boot-starter-test用于单元测试
• ·spring-boot-starter-mail用于邮件服务
• ·spring-boot-starter-data-redis用于Redis
• ·……

想了解更多Starters的读者，请查阅Spring Boot官方文档。Starters按照功能把相关的依赖整合起来，不需要开发者自己手动添加，大大提高了开发效率。不仅如此，这些Starters都是经过官方测试的，所以不会出现版本不兼容等令人抓狂的问题。

Spring将依赖按照不同的功能进行组合打包，你可以按照自己的需求进行选择，想要开发Web项目，就选择starter-web；想要发送邮件，就选择starter-mail。就像前面组装计算机一样，普通用户不太关心具体参数，他们需要的是提出需求，由卖家直接给出一个好的解决方案即可。

从程序运行机制来说，使用Starters和自己手动添加Jar包依赖并没有任何不同。Spring将这些基础设施整合好，让用户可以直接拿过来用，从而专注于自己的需求，这样才是好的产品。

了解这些思想，对我们在工作、学习中的帮助也是非常大的。我们知道了什么样的软件才称得上好软件，什么样的设计才称得上优秀的设计。希望大家在学习一门技术的时候，多留心技术上的设计思想，并且多尝试将这些优秀的思想应用于自己的软件中。

值得拥有的YAML

YAML（YAML Ain’t Markup Language）是专门用来编写配置文件的，其设计宗旨是方便人类阅读与书写，所以相较于其他配置文件的常用格式（如XML、Properties、JSON等），它的结构更加简洁与清晰。

Properties与YAML

Properties用来编写配置文件已经非常简单了，但是它有一个缺点，就是结构不够清晰，不能体现配置项的相关性和层次。下面通过Spring Boot官方文档中的一个例子来进行对比。

Properties：

YAML：

通过上面的例子，我们可以很容易地看出，YAML更加具有整体性和层次感，直观地体现了各个配置项之间的层级关系；而Properties在这一点上比较弱，它的内容只是罗列了4条配置信息，并没有直观地体现它们之间的关系。同时，YAML的写法更加简洁。

YAML语法

基本规则

• · 大小写敏感
• · 使用空格缩进表示层级关系
• · 对缩进的空格数目没有要求，只要同级元素左侧对齐即可
• · 使用＃注释，只有行注释，没有块注释
• · key与value用

（英文冒号）加上空格来分割

基本组件

YAML的基本组件主要有两种。

• · 对象（映射/字典）
• · 数组（列表）

对象：

数组：

数据类型

• · 字符串
• · 布尔值
• · 数值（整型、浮点）
• · null
• · 日期/时间（Date、Time）

示例：

学习了以上这些知识，你应该可以应对接下来的实战内容了。YAML还有一些高级用法，感兴趣的读者可以自己探索一下。

Spring Boot 默 认 使 用 Properties 作 为 配 置 文 件 格 式 ， 需 要 手 动 将application.properties重命名为application.yml。

学会创建虚拟环境，让你的python编程更高效

喜欢 (2)赏

[]

分享 (0)