在一个程序员的眼里,万物皆可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按钮。
填写项目信息
弹出如图所示的项目信息填写界面,其中Group对应pom文件中的groupId,Artifact对应pom文件中的artifactId,分别填入对应的内容即可。
首先将项目类型设置为Maven,语言设置为Java,打包方式设置为Jar,然后在Java Version下拉列表中选择8选项,单击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快捷键。
项目启动成功后,可以在Intellij IDEA的控制台看到如下日志:
接下来在浏览器中访问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将这些基础设施整合好,让用户可以直接拿过来用,从而专注于自己的需求,这样才是好的产品。
了解这些思想,对我们在工作、学习中的帮助也是非常大的。我们知道了什么样的软件才称得上好软件,什么样的设计才称得上优秀的设计。希望大家在学习一门技术的时候,多留心技术上的设计思想,并且多尝试将这些优秀的思想应用于自己的软件中。
值得拥有的YAMLYAML(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。
声明:内容选自《SpringBoot趣味实战》京东可直接购买,侵权联系删除
,