使用 Spring Initializr 初始化 Spring Boot 项目

2019-07-30 22:36:10

参考文档  使用 Spring Initializr 初始化 Spring Boot 项目

   万事开头难,你需要设置一个目录结构存放各种项目内容,创建构建文件,并在其中加入各

种依赖。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项

目没什么不同。


  • 2019-08-19 15:50:17

    记录PHP的进程和线程理解

    线程是进程的一个执行流,线程不能分配系统资源,它是进程的一部分,比进程更小的独立运行的单位。 解释一下:进程有两个特性:一是资源的所有权,一个是调度执行(指令集),线程是调度执行中的一部分,是指进程执行过程的路径,也叫程序执行流。线程有时候也叫轻量级进程。

  • 2019-08-20 08:51:52

    一台Linux服务器可以负载多少个连接?

    我们在压测一台目标服务器,想看下负载的连接数,当我们压到一定数量的时候,控制台突然报"too many open files",这是因为linux系统创建一个TCP连接的时候,都会创建一个socket句柄,每个socket句柄就是一个文件句柄。

  • 2019-08-20 08:56:42

    Linux下Http高并发参数优化之TCP参数

    Linux 内核参数考虑的是最通用场景,并不符合用于支持高并发访问的Web服务器的定义,所以需要修改Linux内核参数。其次,对 Nginx 的一些参数,也需要根据服务情况进行调整。

  • 2019-08-20 11:05:30

    php,nginx,线程和进程分析

    大多数的 Linux 程序都倾向于使用进程而不是线程,因为 Linux 下相对来说创建进程的开销比较小,而 Linux 的线程功能又不是很强大。

  • 2019-08-20 11:22:36

    Node.js 单线程与多进程比较

    进过上面两种方式的对比,结果很明显,多进程处理速度是单线程处理速度的 4 倍多。而且有条件的情况下,如果电脑 CPU 足够,进程数更多,那么速度也会更快。

  • 2019-08-22 13:35:27

    Generator函数的语法

    执行Generator函数会返回一个遍历器对象,也就是说,Generator函数除了是状态机还是一个遍历器对象生成函数。 返回遍历器对象,可以依次遍历Generator函数内部的每一个状态。

  • 2019-08-22 16:38:15

    理解JS原型对象与原型链(重要清晰)

    JavaScript 常被描述为一种基于原型的语言 (prototype-based language)——每个对象对应拥有一个原型,对象以其原型为模板、从原型继承方法和属性。而同时原型也是对象,它也拥有原型,并从中继承方法和属性,一层一层、以此类推。这种关系常被称为原型链 (prototype chain),它解释了为何一个对象会拥有定义在其他对象中的属性和方法。