使用 Spring Initializr 初始化 Spring Boot 项目 -- 转载至https://blog.csdn.net/caodameng_csdn/article/details/

最新推荐文章于 2024-08-30 19:56:58 发布

禅与编程艺术

最新推荐文章于 2024-08-30 19:56:58 发布

阅读量195

点赞数

万事开头难，你需要设置一个目录结构存放各种项目内容，创建构建文件，并在其中加入各
种依赖。Spring Boot CLI消除了不少设置工作，但如果你更倾向于传统Java项目结构，那你应该
看看Spring Initializr。
Spring Initializr从本质上来说就是一个Web应用程序，它能为你生成Spring Boot项目结构。虽
然不能生成应用程序代码，但它能为你提供一个基本的项目结构，以及一个用于构建代码的
Maven或Gradle构建说明文件。你只需要写应用程序的代码就好了。
Spring Initializr有几种用法。
 通过Web界面使用。
 通过Spring Tool Suite使用。
 通过IntelliJ IDEA使用。
 使用Spring Boot CLI使用。
下面分别看看这几种用法，先从Web界面开始。

1. 使用Spring Initializr的Web界面

要使用Spring Initializr，最直接的办法就是用浏览器打开http://start.spring.io，你应该能看到

类似图1-1的一个表单。

表单的头两个问题是，你想用Maven还是Gradle来构建项目，以及使用Spring Boot的哪个版
本。程序默认生成Maven项目，并使用Spring Boot的最新版本（非里程碑和快照版本），但你也可
以自由选择其他选项。
表单左侧要你指定项目的一些基本信息。最起码你要提供项目的Group和Artifact，但如果你
点击了“Switch to the full version”链接，还可以指定额外的信息，比如版本号和基础包名。这些

信息是用来生成Maven的pom.xml文件（或者Gradle的build.gradle文件）的。

图1-1 Spring Initializr是生成空Spring项目的Web应用程序，可以视为开发过程的第一步

        表单右侧要你指定项目依赖，最简单的方法就是在文本框里键入依赖的名称。随着你的输入
会出现匹配依赖的列表，选中一个（或多个）依赖，选中的依赖就会加入项目。如果找不到你要
的依赖，点击“Switch to the full version”就能看到可用依赖的完整列表。
        要是你瞄过一眼附录B，就会发现这里的依赖和Spring Boot起步依赖是对应的。实际上，在
这里选中依赖，就相当于告诉Initializr把对应的起步依赖加到项目的构建文件里。（第2章会进一
步讨论Spring Boot起步依赖。）
        填完表单，选好依赖，点击“Generate Project”按钮，Spring Initializr就会为你生成一个项目。
浏览器将会以ZIP文件的形式（文件名取决于Artifact字段的内容）把这个项目下载下来。根据你的选择，ZIP文件的内容也会略有不同。不管怎样，ZIP文件都会包含一个极其基础的项目，让你
能着手使用Spring Boot开发应用程序。
举例来说，假设你在Spring Initializr里指定了如下信息。
 Artifact：myapp
 包名：myapp
 类型：Gradle项目
 依赖：Web和JPA
点击“Generate Project”，就能获得一个名为myapp.zip的ZIP文件。解压后的项目结构同图1-2

类似。

图1-2 Initializr创建的项目，提供了构建Spring Boot应用程序所需的基本内容

如你所见，项目里基本没有代码，除了几个空目录外，还包含了如下几样东西。
 build.gradle：Gradle构建说明文件。如果选择Maven项目，这就会换成pom.xml。
 Application.java ：一个带有 main() 方法的类，用于引导启动应用程序。
 ApplicationTests.java ：一个空的JUnit测试类，它加载了一个使用Spring Boot自动
配置功能的Spring应用程序上下文。
 application.properties：一个空的properties文件，你可以根据需要添加配置属性。
在Spring Boot应用程序中，就连空目录都有自己的意义。static目录放置的是Web应用程序的
静态内容（JavaScript、样式表、图片，等等）。还有，稍后你将看到，用于呈现模型数据的模板
会放在templates目录里。
你很可能会把Initializr生成的项目导入IDE。如果你用的IDE是Spring Tool Suite，则可以直接
在IDE里创建项目。下面来看看Spring Tool Suite是怎么创建Spring Boot项目的。

2. 在Spring Tool Suite里创建Spring Boot项目

长久以来，Spring Tool Suite
① 一直都是开发Spring应用程序的不二之选。从3.4.0版本开始，

它就集成了Spring Initializr，这让它成为开始上手Spring Boot的好方法。

要在Spring Tool Suite里创建新的Spring Boot应用程序，在File菜单里选中New > Spring Starter
Project菜单项，随后Spring Tool Suite会显示一个与图1-3相仿的对话框。
如你所见，这个对话框要求填写的信息和Spring Initializr的Web界面里是一样的。事实上，
你在这里提供的数据会被发送给Spring Initializr，用于创建项目ZIP文件，这和使用Web表单是

一样的。

图1-3 Spring Tool Suite集成了Spring Initializr，可以在IDE里创建并直接导入Spring

Boot项目

如果你想在文件系统上指定项目创建的位置，或者把它加入IDE里的特定工作集，就点击Next
按钮。你会看到第二个对话框，如图1-4所示。
Location指定了文件系统上项目的存放位置。如果你使用Eclipse的工作集来组织项目，那么
也可以勾上Add Project to Working Sets这个复选框，选择一个工作集，这样就能把项目加入指定
的工作集了。
Site Info部分简单描述了将要用来访问Initializr的URL，大多数情况下你都可以忽略这部分内
容。然而，如果要部署自己的Initializr服务器（从https://github.com/spring-io/initializr复制代码即
可），你可以在这里设置Initializr基础URL。
点击Finish按钮后，项目的生成和导入过程就开始了。你必须认识到一点，Spring Tool Suite
的Spring Starter Project对话框，其实是把项目生成的工作委托给http://start.spring.io上的Spring

Initializr来做的，因此必须联网才能使用这一功能。

图1-4 Spring Starter Project对话框的第2页可以让你指定在哪里创建项目

一旦把项目导入工作空间，应用程序就可以开发了。在开发的过程中，你会发现Spring Tool
Suite针对Spring Boot还有一些锦上添花的功能。比如，可以在Run菜单里选中Run As > Spring Boot
Application，在嵌入式服务器里运行你的应用程序。
注意，Spring Tool Suite是通过REST API与Initializr交互的，因此只有连上Initializr它才能正常
工作。如果你的开发机离线，或者Initializr被防火墙阻断了，那么Spring Tool Suite的Spring Starter
Project向导是无法使用的。

3. 在IntelliJ IDEA里创建Spring Boot项目

IntelliJ IDEA是非常流行的IDE，IntelliJ IDEA 14.1已经支持Spring Boot了！
①
要在IntelliJ IDEA里创建新的Spring Boot应用程序，在File菜单里选择New > Project。你会看
到几屏内容（图1-5是第一屏），问的问题和Initializr的Web应用程序以及Spring Tool Suite类似。
在首先显示的这一屏中，在左侧项目选择里选中Spring Initializr，随后会提示你选择一个
Project SDK（基本上就是这个项目要用的Java SDK），同时选择Initializr Web服务的位置。除非你

在使用自己的Initializr，否则应该不做任何修改直接点Next按钮，之后就到了图1-6。

图1-5 IntelliJ IDEA里Spring Boot初始化向导的第一屏

图1-6 在IntelliJ IDEA的Spring Boot初始化向导里指定项目信息

Spring Boot初始化向导的第二屏要求你提供项目的一些基本信息，比如项目名称、Maven
Group和Artifact、Java版本，以及你是想用Maven还是Gradle来构建项目。描述好项目信息之后，

点击Next按钮就能看到第三屏了，如图1-7所示。

图1-7 在IntelliJ IDEA的Spring Boot初始化向导里选择项目依赖

第二屏向你询问项目的基本信息，第三屏就开始问你要往项目里添加什么依赖了。和之前一
样，屏幕里的复选框和Spring Boot起步依赖是对应的。选完之后点击Next就到了向导的最后一屏，
如图1-8所示。
最后一屏问你项目叫什么名字，还有要在哪里创建项目。一切准备就绪之后，点击Finish按

钮，就能在IDE里得到一个空的Spring Boot项目了。

图1-8 IntelliJ IDEA的Spring Boot初始化向导的最后一屏

4. 在Spring Boot CLI里使用Initializr

        如前文所述，如果你想仅仅写代码就完成Spring应用程序的开发，那么Spring Boot CLI是个
不错的选择。然而，Spring Boot CLI的功能还不限于此，它有一些命令可以帮你使用Initializr，通
过它上手开发更传统的Java项目。
        Spring Boot CLI包含了一个 init 命令，可以作为Initializr的客户端界面。 init 命令最简单的
用法就是创建Spring Boot项目的基线：
$ spring init
        在和Initializr的Web应用程序通信后， init 命令会下载一个demo.zip文件。解压后你会看到
一个典型的项目结构，包含一个Maven的pom.xml构建描述文件。Maven的构建说明只包含最基本
的内容，即只有Spring Boot基线和测试起步依赖。你可能会想要更多的东西。
假设你想要构建一个Web应用程序，其中使用JPA实现数据持久化，使用Spring Security进行
安全加固，可以用 --dependencies 或 -d 来指定那些初始依赖：
$ spring init -dweb,jpa,security
        这条命令会下载一个demo.zip文件，包含与之前一样的项目结构，但在pom.xml里增加了
Spring Boot的Web、jpa和security起步依赖。请注意，在 -d 和依赖之间不能加空格，否则就变成
了下载一个ZIP文件，文件名是web,jpa,security。
现在，假设你想用Gradle来构建项目。没问题，用 --build 参数将Gradle指定为构建类型：
$ spring init -dweb,jpa,security --build gradle
        默认情况下，无论是Maven还是Gradle的构建说明都会产生一个可执行JAR文件。但如果你

想要一个WAR文件，那么可以通过 --packaging 或者 -p 参数进行说明：

$ spring init -dweb,jpa,security --build gradle -p war
        到目前为止， init 命令只用来下载ZIP文件。如果你想让CLI帮你解压那个ZIP文件，可以指
定一个用于解压的目录：
$ spring init -dweb,jpa,security --build gradle -p war myapp
        此处的最后一个参数说明你希望把项目解压到myapp目录里去。
此外，如果你希望CLI把生成的项目解压到当前目录，可以使用 --extract 或者 -x 参数：
$ spring init -dweb,jpa,security --build gradle -p jar -x
        init 命令还有不少其他参数，包括基于Groovy构建项目的参数、指定用Java版本编译的参数，
还有选择构建依赖的Spring Boot版本的参数。可以通过 help 命令了解所有参数的情况：
$ spring help init
    你也可以查看那些参数都有哪些可选项，为 init 命令带上 --list 或 -l 参数就可以了：
$ spring init -l
        你一定注意到了，尽管 spring init –l 列出了一些Initializr支持的参数，但并非所有参数
都能直接为Spring Boot CLI的 init 命令所支持。举例来说，用CLI初始化项目时，你不能指定根
包的名字，它默认为demo。 spring help init 会告诉你CLI的 init 命令都支持哪些参数。
无论你是用Initializr的Web界面，在Spring Tool Suite里创建项目，还是用Spring Boot CLI来初
始化项目，Spring Boot Initializr创建出来的项目都有相似的项目布局，和你之前开发过的Java项
目没什么不同。