Spring 5 开发工具

在本章中，您将学习如何设置和使用最流行的开发工具来创建Spring应用程序。与许多其他软件框架一样，Spring也有大量的开发工具可供选择，从简单的命令行工具到复杂的图形化工具，称为集成开发环境(IDE)。

无论您是已经使用了某些Java开发工具，还是第一次使用Java开发工具，以下食谱将指导您如何设置不同的工具箱，以便在接下来的章节中进行练习，以及开发任何Spring应用程序。

以下是启动Spring应用程序所需的三个工具箱和相应的章节:

• Spring工具套件: 章节1-1
• IntelliJ IDE:章节1-2(以及Maven命令行接口的章节1-3和1-4;用于Gradle命令行界面的章节1-5和1-6)
• Text editor:Maven命令行界面的章节1-3和1-4;用于level命令行接口的章节1-5和1-6

Spring工具套件

使用IntelliJ IDE构建一个Spring应用程序

问题

您希望使用IntelliJ IDE来构建Spring应用程序。

解决方案

要在IntelliJ Quick start窗口中启动一个新的Spring应用程序，请单击Create new Project链接。在下一个窗口中，为项目分配一个名称，选择一个运行时JDK，并选择Java模块选项。在下一个窗口中，单击各种Spring复选框，以便IntelliJ下载项目所需的Spring依赖项。

要打开一个使用Maven的Spring应用程序，您首先需要安装Maven以从命令行接口工作(请参阅配方1-4)。从IntelliJ顶级文件菜单中，选择Import Project选项。接下来，从您的工作站上基于Maven选择Spring应用程序。在下一个屏幕上，选择“从外部模型导入项目”选项并选择Maven类型。

要打开使用Gradle的Spring应用程序，首先需要从命令行界面安装Gradle(参见菜谱1-5)。在IntelliJ顶级文件菜单中，选择Import Project选项。接下来，根据您的工作站上的Gradle选择Spring应用程序。在下一个屏幕中，选择“从外部模型导入项目”选项并选择一个Gradle类型。

它是如何工作的

IntelliJ是市场上最受欢迎的商业ide之一。与其他由基金会(如Eclipse)或支持公司旗舰软件(如Spring框架的STS)生成的ide不同，IntelliJ是由JetBrains公司(JetBrains)生产的，该公司的唯一业务是将开发工具商业化。正是这种关注，使得IntelliJ在企业环境中特别受专业开发人员的欢迎。

对于这个食谱，我们假设您已经安装了IntelliJ Ultimate edition，并且只需要启动和运行Spring应用程序。

■警告intelliJ最终有一个免费的社区版和一个30天免费试用版。
尽管免费社区版为应用程序开发提供了良好的价值，但是Community edition并不包括对Spring应用程序的支持。
下面的指令是基于假设您正在使用intelliJ终极版本的。

创建一个Spring应用程序

要启动Spring应用程序，请在IntelliJ Quick start窗口中单击Create New Project链接。在新项目窗口中，选择Spring选项并单击各种Spring复选框，如图1-8所示。

导入并构建Maven项目

比从头创建Spring应用程序更常见的情况是继续开发现有的Spring应用程序。在这种情况下，应用程序的所有者通常使用构建脚本分发应用程序的源代码，以促进其正在进行的开发。
大多数Java应用程序选择的构建脚本是pom。围绕Maven构建工具或最近的构建设计的xml文件。围绕渐变工具设计的渐变文件。这本书的源代码及其应用程序提供了渐变构建文件，以及一个带有Maven构建文件的应用程序。
下载了该书的源代码并将其解压缩到本地目录后，单击IntelliJ顶级文件菜单并选择Import Project选项。弹出窗口，如图1-9所示。

在此窗口中，在目录树中向下展开，直到您到达ch01中图书源代码的目录，然后选择springintro_mvn。点击打开按钮。在下一个屏幕中，选择“从外部模型导入项目”选项并选择Maven类型，如图1-10所示。

在下一个窗口中(参见图1-11)，您可以对一些Maven项目设置进行微调，例如自动将更改导入到pom.xml，下载依赖源，等等。当满足设置时，单击Next

确保选中了项目复选框，如图1-12所示，并单击Next按钮导入项目。

接下来，为项目选择SDK版本。确认项目名称和位置并单击Finish按钮。IntelliJ中的所有项目都被加载到项目窗口的左边。在本例中，项目以名称springintro_mvn出现。
如果您单击项目图标，您将能够看到项目结构(即Java类、依赖项、配置文件等)。如果双击项目窗口中的任何一个项目文件，文件将在中心窗口的一个单独的选项卡中打开。您可以检查文件的内容，以及编辑或删除它的内容。
接下来，您需要设置Maven来使用IntelliJ。按照食谱1-3中的说明，从命令行安装Maven。这样做之后，您就可以设置IntelliJ来与Maven一起工作了。

单击IntelliJ顶级文件菜单并选择Settings选项。出现一个弹出窗口来配置IntelliJ设置。单击Maven选项，在Maven主目录中介绍基于系统的Maven安装目录，如图1-13所示。单击Apply按钮，然后单击OK按钮。

接下来，在IntelliJ的右侧，单击垂直选项卡Maven项目来显示Maven项目窗格，
如图1-14所示。

在Maven Projects窗格中选择项目的“Spring line简介”，然后右键单击以打开包含项目各种命令的上下文菜单。选择Run Maven构建选项。在IntelliJ的底部中心，你会看到Run窗口出现。在这种情况下，Run窗口将显示Maven生成的一系列构建消息，以及在构建过程失败时可能出现的任何错误。

警告如果您看到错误消息“没有找到有效的maven安装。要么在配置对话框中设置主目录，要么在系统上设置m2_home环境变量。验证maven的安装和配置过程。

您刚刚构建了应用程序，祝贺您!现在,让我们来运行它。如果没有看到目标目录，请按Ctrl+Alt+Y组合键来同步项目。通过单击展开目标目录
它的图标。接下来，右键单击文件springintro_mvn-4.0.0-SNAPSHOT.jar，如图1-15所示，并选择Run选项。

在运行窗口IntelliJ的底部中心，您将看到应用程序日志消息，以及应用程序定义的问候语消息。

导入和建设Gradle项目

现在，让我们用IntelliJ构建一个Gradle应用程序。首先你需要安装等级。按照配方1-4中的说明从命令行安装Gradle。一旦您这样做了，您就可以设置IntelliJ来处理Gradle。
单击IntelliJ顶级文件菜单并选择Import Project选项。弹出窗口，如图1-9所示。在弹出窗口中向下挖掘目录树，直到您可以选择文件构建。在ch01/springintro目录的书的源代码。
点击打开按钮。在下一个屏幕上，选择“从外部模型导入项目”选项并选择Gradle。在下一个屏幕上，根据系统的Gradle安装，在“Gradle home”框中输入Gradle home目录，如图1-16所示。

单击Finish按钮确认导入过程，然后单击Finish按钮完成导入过程。接下来，在项目窗口中，右键单击build。渐变并选择运行构建。
您刚刚构建了应用程序。现在,让我们来运行它。在项目窗口中，展开构建目录并进入libs目录。找到springintro-all.jar，如图1-17所示。

注意，build.gradle文件被配置为生成一个影子Jar，这意味着它包含运行所需的所有类和依赖项。

现在右键单击springintro-all.jar 文件并选择Run选项。在运行窗口IntelliJ的底部中心，您将看到应用程序日志消息，以及应用程序定义的问候语消息。

使用Maven命令行接口构建一个Spring应用程序

问题

您希望使用命令行中的Maven构建一个Spring应用程序。

解决方案

从http://maven.apache.org/download.cgi下载Maven。确保将JAVA_HOME环境变量设置为Java的SDK主目录。修改PATH环境变量以包含Maven的bin目录。

它是如何工作的

Maven是一个独立的命令行接口工具。这允许从各种开发环境中使用Maven。例如,如果您更喜欢使用一个文本编辑器如emacs或vi编辑应用程序的代码,就基本能够访问Maven这样的构建工具来自动化的繁重工作(例如,复制文件,一步编译)通常与Java应用程序的构建过程相关联。

可以从http://maven.apache.org/download.cgi免费下载Maven。Maven可以在源代码和二进制版本中使用。由于Java工具是跨平台的，我们建议您下载二进制版本，以避免额外的编译步骤。在撰写本文时，Maven的最新稳定版本是3.5.0版本。

下载Maven之后，确保在系统上安装了Java SDK，因为Maven在运行时需要它。通过解压Maven并定义JAVA_HOME和PATH环境变量，继续安装Maven。

运行以下命令解压:

www@ubuntu:~$ tar -xzvf apache-maven-3.5.0-bin.tar.gz

使用以下命令添加JAVA_HOME变量:

www@ubuntu:~$ export JAVA_HOME=/usr/lib/jvm/java-8-openjdk/

使用以下命令将Maven可执行文件添加到PATH变量:

www@ubuntu:~$ export PATH=$PATH:/home/www/apache-maven-3.5.0/bin/

■提示如果你声明JAVA_HOME变量和路径说明之前,你需要做这个过程你每次打开一个新的shell会话使用maven。在Unix/linux系统上，您可以在用户的主目录中打开.bashrc文件，并添加相同的导出行，以避免在每个会话中声明环境变量。在Windows系统上，您可以通过选择我的计算机图标，右键单击，然后选择properties选项来永久设置环境变量。在弹出窗口中，选择advanced选项卡并单击“环境变量”按钮。

Maven可执行文件通过mvn命令可用。如果您按照前面的描述正确地设置了环境变量，那么从系统上的任何目录输入mvn将调用Maven。描述关于Maven执行的更多细节将超出此菜谱的范围。然而，接下来我们将描述如何使用Maven从该书的源代码构建Spring应用程序。
一旦下载了该书的源代码并将其解压到本地目录，请转到名为ch01/springintro_mvn的目录。键入mvn调用Maven，并在springintro_mvn下构建应用程序。
输出应该如图1-18所示。

您刚刚构建了应用程序，祝贺您!现在,让我们来运行它。深入到由Maven在ch01/springintro_mvn目录下创建的名为target的目录中。您将看到文件springintro_mvn- 4.0.0-SNAPSHOT.jar，它是构建的应用程序。执行命令java -jar springintro_mvn- 1-0.SNAPSHOT.jar来运行应用程序。您将看到应用程序日志消息，以及应用程序定义的问候消息。

使用Gradle命令行界面构建一个Spring应用程序

问题

您希望使用命令行中的Gradle构建Spring应用程序。

解决方案

从www.gradle.org/downloads下载它。确保将JAVA_HOME环境变量设置为。
Java SDK主要目录。修改PATH环境变量以包含Gradle的bin目录。

它是如何工作的

Gradle是一个独立的命令行工具。这允许从广泛的开发环境中使用Gradle。例如,如果您更喜欢使用一个文本编辑器如emacs或vi编辑应用程序的代码,就基本能够访问像Gradle自动化构建工具繁重工作(例如,复制文件,一步编译)通常与Java应用程序的构建过程相关联。
Gradle可以通过www.gradle.org/downloads免费下载。Gradle可以在源代码和二进制版本中使用。由于Java工具是跨平台的，我们建议您下载二进制版本，以避免额外的编译步骤。在撰写本文时，Gradle的最新稳定版本是3.5版本。
一旦您下载了Gradle，确保在系统上安装了Java SDK，因为Gradle在运行时需要它。通过解压并定义JAVA_HOME和PATH环境变量，继续安装Gradle。

运行以下命令解压:

www@ubuntu:~$ unzip gradle-3.5-bin.zip

使用以下命令添加JAVA_HOME变量:

www@ubuntu:~$ export JAVA_HOME=/usr/lib/jvm/java-8-openjdk/

使用以下命令将可执行等级添加到路径变量:

www@ubuntu:~$ export PATH=$PATH:/home/www/gradle-3.5/bin/

尽管Gradle(参见1-3)作为一个独立的命令行工具可用，但是很多(开源)项目使用Maven包装器来访问Maven。这种方法的优点是应用程序完全是自提供的。作为开发人员，您不需要安装Maven，因为Maven包装器将下载特定版本的Maven来构建项目。

提示:如果您如前面所示声明了变量JAVA_HOME和PATH，那么每次打开一个新的shell会话使用gradle时，您都需要执行这个过程。在Unix/linux系统上，您可以在用户的主目录中打开.bashrc文件，并添加相同的导出行，以避免在每个会话中声明环境变量。在Windows系统上，您可以通过选择我的计算机图标，右键单击，然后选择properties选项来永久设置环境变量。在弹出窗口中，选择advanced选项卡并单击“环境变量”按钮。

Gradle可执行文件通过gradle命令可用。如果您按照前面描述的那样正确地设置环境变量，那么从系统上的任何目录输入gradle将调用gradle。描述更多关于等级执行的细节将超出这个食谱的范围。然而，由于本书的源代码中有许多使用Gradle的Spring应用程序，我们将描述如何使用Gradle来构建这些Spring应用程序中的一个。

一旦下载了该书的源代码并将其解压缩到本地目录，请转到名为ch01/springintro的目录。类型gradle调用gradle并在springintro下构建应用程序。输出应该如图1-20所示。

您刚刚构建了应用程序，祝贺您!现在,让我们来运行它。深入到ch01/springintro目录下的Gradle创建的名为libs的目录中。您将看到文件springintro-all.jar，它是构建的应用程序。执行命令java -jar springintro-all.jar torunthe应用程序。您将看到应用程序日志消息，以及应用程序定义的问候消息。

使用Gradle包装器构建一个Spring应用程序

问题

您希望使用命令行中的Gradle包装器构建一个Spring应用程序。

解决方案

从命令行运行gradlew脚本。

它是如何工作的

尽管Gradle(参见秘诀1-5)可以作为独立的命令行工具，但是很多(开源的)项目都使用Gradle包装器来提供对Gradle的访问。这种方法的优点是应用程序完全是自提供的。作为开发人员，您不需要安装Gradle，因为Gradle包装器将下载特定版本的Gradle来构建项目。
一旦您有了一个使用Gradle包装器的项目，您就可以简单地在命令行上输入./gradlew构建，这样Gradle就可以自动下载并运行构建。惟一的先决条件是安装Java SDK，因为Gradle在运行时需要它，而Gradle包装器需要它运行。

下载这本书的源代码并将其解压到本地目录之后，转到名为ch01/Recipe_1_6的目录。键入./gradlew以调用Gradle包装器，并在Recipe_1_6下自动构建应用程序。输出将如图1-21所示。

■提示书的源代码可以用纯gradle或gradle包装。后者更可取，因为在开发示例时，代码将使用相同的级别版本构建。

总结

在本章中，您了解了如何设置最流行的开发工具来创建Spring应用程序。您了解了如何使用四个工具箱构建和运行Spring应用程序。两个工具箱由使用IDE组成:Spring框架创建者分发的Spring工具套件和JetBrains分发的IntelliJ IDE。另外两个工具箱包括使用命令行工具:Maven构建工具和更新的Gradle构建工具，它们比Maven构建工具更受欢迎