章节 II. 新手入门

Spring Boot 兼容 Apache Maven 3.3 或以上。如果你没有安装 Maven，可以根据 maven.apache.org 上的说明来安装。

	Tip
	在大多数操作系统上，都可以通过包管理器来安装 Maven。如果你使用 OSX Homebrew，请尝试一下 brew install maven。Ubuntu 用户可以运行 sudo apt-get install maven。使用 Chocolatey 的 Windows 用户可以用高级 (administrator) 权限运行 choco install maven。

Spring Boot 依赖使用 org.springframework.boot groupId。通常你的 Maven POM 文件将继承 spring-boot-starter-parent 项目并声明依赖一个或多个启动器。Spring Boot 也提供一个可选的 Maven 插件 来创建可执行的 jar。

下面的列展示了一个典型的 pom.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.example</groupId>
	<artifactId>myproject</artifactId>
	<version>0.0.1-SNAPSHOT</version>

	<!-- Inherit defaults from Spring Boot -->
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.1.0.BUILD-SNAPSHOT</version>
	</parent>

	<!-- Add typical dependencies for a web application -->
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
	</dependencies>

	<!-- Package as an executable jar -->
	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

	<!-- Add Spring repositories -->
	<!-- (you don't need this if you are using a .RELEASE version) -->
	<repositories>
		<repository>
			<id>spring-snapshots</id>
			<url>https://repo.spring.io/snapshot</url>
			<snapshots><enabled>true</enabled></snapshots>
		</repository>
		<repository>
			<id>spring-milestones</id>
			<url>https://repo.spring.io/milestone</url>
		</repository>
	</repositories>
	<pluginRepositories>
		<pluginRepository>
			<id>spring-snapshots</id>
			<url>https://repo.spring.io/snapshot</url>
		</pluginRepository>
		<pluginRepository>
			<id>spring-milestones</id>
			<url>https://repo.spring.io/milestone</url>
		</pluginRepository>
	</pluginRepositories>
</project>

	Tip
	spring-boot-starter-parent 是使用 Spring Boot 的一种极好的方式，但它并不能适用于所有情况。有时你可能需要继承一个不同的父 POM，或者你可能不喜欢我们的默认设置。在这些情况下，请参阅  13.2.2 小节, “ 不继承父 POM 使用 Spring Boot”，来获得一种可替代的解决方案，它使用了 import 作用域。

Spring Boot 兼容 Gradle 4.4 和更新。如果你没有安装 Gradle，可以根据 www.gradle.org 上的说明来安装。

Spring Boot 依赖项可以用 org.springframework.boot group来声明。通常你的项目将会声明依赖于一个或多个启动器。Spring Boot 也提供一个有用的 Gradle 插件 来简化声明依赖和创建可执行的 jar。

下面的示例展示了一个典型的 build.gradle 文件：

buildscript {
	repositories {
		jcenter()
		maven { url 'https://repo.spring.io/snapshot' }
		maven { url 'https://repo.spring.io/milestone' }
	}
	dependencies {
		classpath 'org.springframework.boot:spring-boot-gradle-plugin:2.1.0.BUILD-SNAPSHOT'
	}
}

apply plugin: 'java'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'

jar {
	baseName = 'myproject'
	version =  '0.0.1-SNAPSHOT'
}

repositories {
	jcenter()
	maven { url "https://repo.spring.io/snapshot" }
	maven { url "https://repo.spring.io/milestone" }
}

dependencies {
	compile("org.springframework.boot:spring-boot-starter-web")
	testCompile("org.springframework.boot:spring-boot-starter-test")
}

你可以从 Spring 软件仓库下载 Spring CLI 发行版：

也可以获取最新的 snapshot 版。

下载完成后，请按照解压文件中的 INSTALL.txt 介绍文件来安装。总结：bin/ 目录的 .zip 文件中有一个 spring 脚本（Windows 中是 spring.bat）。或者，你可以使用 java -jar 运行 .jar 文件（这个脚本帮你确保正确设置类路径）。

SDKMAN! (The Software Development Kit Manager) 能用来管理各种二进制 SDK 的多个版本, 包括 Groovy 和 Spring Boot CLI。从 sdkman.io 获取 SDKMAN! 并安装 Spring Boot ：

$ sdk install springboot
$ spring --version
Spring Boot v2.1.0.BUILD-SNAPSHOT

如果你正在使用 CLI 中的开发特性，并希望能方便地访问你刚刚构建的版本，请使用下面的命令：

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.1.0.BUILD-SNAPSHOT-bin/spring-2.1.0.BUILD-SNAPSHOT/
$ sdk default springboot dev
$ spring --version
Spring CLI v2.1.0.BUILD-SNAPSHOT

这将会安装一个名为 dev 的本地 spring 实例。它指向你的目标构建位置，因此你每次重新构建 Spring Boot，spring 将是最新的。

运行下面的命令你将会看到：

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 2.1.0.BUILD-SNAPSHOT

================================================================================
+ - local version
* - installed
> - currently in use
================================================================================

如果你在 Mac 上使用 Homebrew，你可以使用下面的命令安装 Spring Boot CLI：

$ brew tap pivotal/tap
$ brew install springboot

Homebrew 会在 /usr/local/bin 安装 spring。

	Note
	如果你没有看到对应的方法，可能是你安装的 brew 过时了。请执行 brew update 并重试一次。

如果你在 Mac 上使用 MacPorts，你可以使用下面的命令安装 Spring Boot CLI：

$ sudo port install spring-boot-cli

Spring Boot CLI 附带的脚本为 BASH 和 zsh shells 提供了命令行实现。你可以在任何 shell 中 source 脚本（也称为 spring），或将它放在用户或系统范围内的 bash 完成初始化。在 Debian 系统中系统范围内的脚本是在 /shell-completion/bash 目录中，当新 shell 启动时，目录下的所有脚本都被执行。如果你装了 SDKMAN!，为了手动运行脚本，执行下面的命令：

$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring
$ spring <HIT TAB HERE>
  grab  help  jar  run  test  version

	Note
	如果你使用 Homebrew 或 MacPorts 安装 Spring Boot CLI，命令行实现脚本会自动在 shell 中注册。

如果你是在 windows 平台上并使用 Scoop，你可以使用下面的命令安装 Spring Boot CLI：

> scoop bucket add extras
> scoop install springboot

Scoop 会在 ~/scoop/apps/springboot/current/bin 安装 spring。

	Note
	如果你没有看到对应的方法，可能是你安装的 scoop 过时了。请执行 scoop update 并重试一次。

你可以使用下面的 web 应用程序来测试你的安装。首先，创建一个名叫 app.groovy 的文件，如下：

@RestController
class ThisWillActuallyRun {

	@RequestMapping("/")
	String home() {
		"Hello World!"
	}

}

然后从 shell 中运行它，如下：

$ spring run app.groovy

	Note
	第一次运行你的应用程序时会很慢，因为它需要一些时间去下载依赖。后续运行会非常快。

在你最喜欢的浏览器中打开 localhost:8080，你应该会看到下面的内容：

Hello World!