2.1　使用Eclipse编写第一个Spring Boot程序

2.1.1　在Spring官网上生成初始项目文件

Spring官方提供了一个自动创建Spring Boot项目的网页，可以为程序开发人员省去大量的配置操作。使用该网页创建Spring Boot项目的步骤如下。

（1）打开浏览器，输入网址https://start.spring.io，在这个页面中填写项目各种配置和基本信息，具体内容如图2.1所示，矩形框里的文字是笔者给出的标注。

在图2.1中，含有很多标签，例如Project、Language、Spring Boot、Project Metadata下的Group等。那么，这些标签表示的含义是什么呢？各个标签的说明如下：

　Project：表示创建什么类型的项目。书中使用Maven作为项目构建工具，所以这里选择Maven Project，也就是Maven项目。

　Language：表示使用哪种开发语言。这里选择Java。

　Spring Boot：表示使用哪个版本的Spring Boot。SNAPSHOT表示仍在开发过程中的试用版，RELEASE表示稳定版，表单中未做任何标注的版本则认为是RELEASE稳定版，因此选择最新的稳定版本2.7.5。

　Project Metadata下的Group：这是开发团队或公司的唯一标志。命名规则通常为团队／公司主页域名的转置，例如域名为www.mr.com，Group就应该写成com.mr，忽略域名前缀。

　Project Metadata下的Artifact：表示项目的唯一ID。因为同一个团队下可能有多个项目，这个ID就是用来区分不同项目的。图中填写的是MyFirstSpringBootProject。

　Project Metadata下的Name：项目的名称，也是导入Eclipse之后看到的项目名。图中填写的是MyFirstSpringBootProject。

　Project Metadata下的Description：项目的描述。对于学习者来说使用默认值即可。

　Project Metadata下的Package name：用于指定Spring Boot的底层包，也就是Spring Boot启动类所在的包。图中填写的是com.mr。

　Project Metadata下的Packaging：表示项目以哪种格式打包。项目如果打包成jar包，可以直接在JRE环境中启动运行；如果打包成War文件，可以直接部署到服务器容器中。这里推荐大家打包成jar包，便于学习。

　Project Metadata下的Java：用于指定项目使用哪个版本的JDK，这里选择JDK 19。

（2）因为Spring Boot主要用于Web项目开发，所以还需要给项目添加Web依赖。单击页面右侧的ADD DEPENDENCIES按钮，列出可选的依赖项。按钮的位置如图2.2所示。

（3）在列出的如图2.3所示的依赖项中，找到并单击Spring Web选项。

（4）完成以上操作，在如图2.4所示的页面的右侧可以看见已经添加的Spring Web依赖。单击页面下方的GENERATE按钮，下载自动生成的项目压缩包。

（5）如图2.5所示，在D盘根目录下，新建一个名为SpringBootProject的文件夹，将下载好的压缩包解压到该文件夹中，这样就完成了初始项目的准备工作。

2.1.2　Eclipse导入Spring Boot项目

Eclipse支持导入Maven项目，不过导入Maven项目的方式与导入普通Java项目不太一样，本节将演示Eclipse导入Maven项目的步骤。

（1）依次选择File/Import菜单，如图2.6所示。在导入的类型中，选择Maven菜单下的Existing Maven Projects子菜单，单击Next按钮，如图2.7所示。

（2）在弹出的对话框中，单击右侧的Browse按钮，如图2.8所示。找到上一节下载并解压完毕的项目目录，项目目录确认成功后，单击下方的Finish按钮完成导入，如图2.9所示。

（3）导入完成后，Eclipse会自动启动Maven下载jar包的操作，此时Eclipse右下方出现一个滚动条，显示下载进度，程序开发人员可以单击滚动条右侧的图标查看下载明细，如图2.10所示。

导入之后的项目结构如图2.11所示。

2.1.3　编写简单的跳转功能

Spring Boot自带Tomcat容器，无须部署项目就可以直接启动Web服务。下面将演示如何编写一个简单的跳转功能，当用户访问一个网址后，页面会展示一段程序开发人员自己编写的文字。

（1）首先在com.mr包下创建子包controller，然后在该子包中创建名为HelloController的类，如图2.12所示。

（2）打开该类文件，补充以下代码：

    package com.mr.controller;

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

    @RestController
    public class HelloController {
         @RequestMapping("hello")
         public String sayHello() {
              return "你好，这是我的第一个Spring Boot项目";
         }
    }

（3）运行com.mr包下的MyFirstSpringBootProjectApplication.java文件（即项目的启动类），可以在控制台中看到如图2.13所示的启动日志。其中，日志“Started MyFirstSpringBootProjectApplication in 3.045 seconds”表示项目启动成功，耗时3.045秒，这样就可以在浏览器里访问Web服务了。

打开浏览器，访问http://127.0.0.1:8080/hello地址，就可以在页面中看到代码返回的字符串，如图2.14所示。

2.1.4　测试工具——Postman

Postman是一款功能强大的网络接口测试工具，它可以模拟各种网络场景，发送各式各样的请求。Spring Boot是一个专门编写服务器接口的框架，一些特殊场景很难用前端页面模拟，因此推荐使用Postman来完成复杂场景的测试工作。本节将对Postman的下载、启动和使用进行详解。

下载Postman的步骤如下。

（1）打开浏览器，输入https://www.Postman.com/downloads/地址，网页会自动识别你的操作系统，给出适合操作系统的安装包。如图2.15所示，单击左侧的Windows 64-bit按钮。

（2）下载完成之后，双击安装包，软件会自动安装。安装完成后会在桌面生成如图2.16所示的快捷图标。

启动Postman的步骤如下。

（1）双击Postman快捷图标打开Postman后，如果弹出用于提示用户登录或注册的对话框，就单击skip and go to the app超链接，跳过登录。

（2）对话框显示如图2.17所示的主界面后，单击New按钮，创建新的连接测试。

（3）在弹出的如图2.18所示的对话框中，选择HTTP Request连接类型。

（4）回到如图2.19所示的主界面后，程序开发人员需要先在功能面板中填写要访问的URL地址，再设置请求类型、请求参数等，单击Send按钮即可向服务器发送一条请求。服务器返回的内容会在面板底部展示。

使用Postman的方式如下：要使用Postman测试第一个Spring Boot程序中的连接，只需先在URL的位置填写http://127.0.0.1:8080/hello，再单击右侧的Send按钮，即可在底部可看到服务器返回的结果，如图2.20所示。不难发现，图2.20所示的结果与图2.14所示的用户在浏览器上看到的内容相同。

2.1.5　打包项目

Spring Boot可以将所有依赖都打包到一个jar包中，只需要执行这个jar包就可以启动完整Spring Boot项目。这为程序开发人员省去了不少配置和部署的工作。本节介绍如何在Eclipse环境中为Spring Boot项目打包。步骤如下。

（1）在项目上单击鼠标右键，依次选择Run As/Maven install菜单，位置如图2.21所示。选择之后Maven会自动下载并打包所需的jar包。

（2）打包时控制台会打印大量日志，当打包程序结束时，日志中出现如图2.22所示的BUILD SUCCESS字样，表示打包成功。

（3）在项目上单击鼠标右键，在弹出的快捷菜单中选择ReFresh（或按F5键）刷新项目，就可以在target文件夹下看到很多文件，其中MyFirstSpringBootProject-0.0.1-SNAPSHOT.jar包就是本项目打包生成的执行文件，位置如图2.23所示。

（4）将这个jar包保存到D盘根目录，再打开“命令提示符”对话框，输入以下命令：

    d:
    java -jar MyFirstSpringBootProject-0.0.1-SNAPSHOT.jar