使用 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项

目没什么不同。


  • 2021-01-21 13:55:53

    Mongodb字段更新$unset操作符

    当使用$操作符匹配任何数组元素,$unset替换指定的元素为null而不是删除掉指定的元素,此行为保持数组大小和位置一直;

  • 2021-01-22 08:30:02

    Android IO简化之Okio库

    如果之前有使用过Okhttp,那么你一定知道底层的IO读取是由square公司开发的Okio库。它补充了Java.io和java.nio的不足,以便能够更加方便,快速的访问、存储和处理你的数据。而在一般的开发中,我们也可以使用Okio来做IO读写,非常方便深得我心

  • 2021-01-22 21:56:48

    emcc生成wasm,wast,bc文件的方法

    Emscripten实现把C/C++文件转成wasm,wast(wasm的可读形式),llvm字节码(bc格式),ll格式(llvm字节码的可读形式)的步骤。

  • 2021-01-22 21:59:34

    emcc编译与部分重要参数选取

    C/C++代码通过emcc编译为字节码,然后根据不同的目标编译为asm.js或wasm。emcc和gcc编译选项类似,例如-s OPTIONS=VALUE、-O等。另外为了适应Web环境,emcc增加了一些特有的选项,如–pre-js 、–post-js 等。

  • 2021-01-22 22:01:19

    Emscripten Compiler Frontend (emcc)

    The Emscripten Compiler Frontend (emcc) is used to call the Emscripten compiler from the command line. It is effectively a drop-in replacement for a standard compiler like gcc or clang.

  • 2021-01-22 22:21:41

    emcc编译命令介绍

    这个输入文件file,既可以是clang可以编译的C/C++语言,也可以是二进制形式的llvm bitcode或者人类可读形式的llvm assembly文件。

  • 2021-01-22 22:25:51

    How to protect your JS code by WebAssembly

    对于iOS或是Android来说,我们可以将相关的算法通过C/C++进行编写,然后编译为dylib或是so并进行混淆以此来增加破解的复杂度,但是对于前端来说,并没有类似的技术可以使用。当然,自从asm.js及WebAssembly的全面推进后,我们可以使用其进一步增强我们核心代码的安全性,但由于asm.js以及WebAssembly标准的开放,其安全强度也并非想象中的那么美好。