《Spring Boot官方指南》（二）入門（一）

2.1 Servlet容器

3.1 Java開發者使用的安裝教程

Spring Boot與Apache Maven 3.2或者更高的版本兼容。如果您還沒有安裝Maven，可以去maven.apache.org閱讀相關教程。

	Tip
	很多操作係統可以使用包管理工具來安裝Maven，蘋果的OSX操作係統Homebrew使用者可以試試brew install maven。Ubuntu用戶可以運行這個命令sudo apt-get install maven。

Spring Boot 依賴的groupId是org.springframework.boot。通常情況下，您的MavenPOM文件繼承自spring-boot-starter-parent項目，並且聲明為一些“Starters”。Spring Boot也提供了一些創建可執行jar文件的Maven插件。

這是一個典型的pom.xml文件:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://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>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.4.1.BUILD-SNAPSHOT</version>
    </parent>

    <!-- Additional lines to be added here... -->

    <!-- (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，或者僅僅是和我們的默認配置有所區別。查看Section 13.2.2, “Using Spring Boot without the parent POM”，這是使用了導入方式的一種解決方案。

Spring Boot與Gradle 1.12或者更高的版本兼容。如果您還沒有安裝Gradle，可以去www.gradle.org/閱讀相關教程。

Spring Boot依賴的group是org.springframework.boot。一般情況下，您的項目可能需要為一個或多個“Starters”聲明依賴項。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:1.4.1.BUILD-SNAPSHOT")
    }
}

apply plugin: 'java'
apply plugin: 'spring-boot'

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")
}

3.2 安裝Spring Boot CLI

到Spring軟件倉庫下載Spring CLI的發布包：

也可以去snapshot distributions下載最新的快照發布版本。

下載以後，閱讀一下解壓縮包裏麵的說明文檔：INSTALL.txt。大概是這樣，bin/目錄下的.zip文件裏麵有一個spring腳本（Windows係統是spring.bat），或者您也可以使用命令java -jar來運行.jar文件（腳本是幫您確保classpath是否設置正確了）。

SDKMAN!(一個軟件開發工具管理器)可以用用來管理多版本的二進製SDKs,包括 Groovy 與 Spring Boot CLI。到sdkman.io下載SDKMAN!，用下麵的方式來安裝Spring Boot：

$ sdk install springboot
$ spring --version
Spring Boot v1.4.1.BUILD-SNAPSHOT

如果您正在開發一些命令行工具CLI的組件，並且想要方便的使用到您剛剛構建的版本，下麵這個介紹可以幫到您。

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-1.4.1.BUILD-SNAPSHOT-bin/spring-1.4.1.BUILD-SNAPSHOT/
$ sdk default springboot dev
$ spring --version
Spring CLI v1.4.1.BUILD-SNAPSHOT

這樣做可以安裝一個被叫做dev實例的本地spring實例，它指向了您的目標生成路徑，所以每次您重新構建Spring Boot，spring都會是保持最新版本。

應該可以看到下麵的這些輸出信息：

$ sdk ls springboot

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

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

如果您在Mac環境下，並且使用Homebrew，運行下麵的命令來安裝Spring Boot CLI：

$ brew tap pivotal/tap
$ brew install springboot

Homebrew把`spring`安裝到了/usr/local/bin。

	Note
	如果沒有順利安裝的話，大概是您的brew庫已經太舊了，執行brew update以後，再試一試。

如果您在Mac環境下，並且使用MacPorts，運行下麵的命令來安裝Spring Boot CLI：

$ sudo port install spring-boot-cli