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

如果想要從舊版本的Spring Boot升級，檢查一下存放在這裏project wiki 的 “release notes”。您可以找到升級信息與每個版本的“新的和值得關注的”功能列表以及說明。

使用相關的包管理工具升級您已經使用命令行安裝過的早期版本（比如，brew upgrade），另外，如果您是手動安裝的CLI，閱讀這個標準說明，同時記得更新環境變量PATH的值，以便移除舊版本的引用。

4. 開發第一個Spring Boot應用程序

	Tip
	這個網站spring.io有很多使用了Spring Boot的 “入門”級別教程。如果需要解決個別的問題，可以先去這個網站找找看。可以簡化下麵的開發步驟。訪問網站start.spring.io，在依賴搜索裏麵選擇web啟動。這樣就可以自動生成一個新的項目框架，以便您以恰當的方式開始編寫您的代碼。更多有關的細節，可以查看文檔。

$ java -version
java version "1.7.0_51"
Java(TM) SE Runtime Environment (build 1.7.0_51-b13)
Java HotSpot(TM) 64-Bit Server VM (build 24.51-b03, mixed mode)

$ mvn -v
Apache Maven 3.2.3 (33f8c3e1027c3ddde99d3cdebad2656a31e8fdf4; 2014-08-11T13:58:10-07:00)
Maven home: /Users/user/tools/apache-maven-3.1.1
Java version: 1.7.0_51, vendor: Oracle Corporation

	Note
	這個實例創建在自己的目錄中。接下來內容假定您已經創建好了恰當的目錄，這個目錄叫“當前目錄”。

我們從創建一個Mavenpom.xml文件開始。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>

像這樣，應該可以進行構建工作了，運行一下命令mvn package看看輸出信息（現在暫時忽略這個警告信息“jar will be empty – no content was marked for inclusion!”）。

Spring Boot提供了一些“Starters”，讓您方便把jar文件添加到您的classpath。我們的實例已經在POM文件的parent部分添加了
spring-boot-starter-parent。spring-boot-starter-parent是一個添加了一些默認Maven配置的特殊的starter。也添加了dependency-management部分，這個部分可以讓您省掉某些依賴項的version標簽。

其他的 “Starters”添加了在您開發其他特定類型應用程序的時候，您很可能需要添加的一些依賴項。我們目前正在開發Web應用，我們需要添加依賴項spring-boot-starter-web，不過我們先通過下麵的方式看看目前的情況。

$ mvn dependency:tree

[INFO] com.example:myproject:jar:0.0.1-SNAPSHOT

mvn dependency:tree命令輸出了項目依賴項的樹狀示意圖。您會發現spring-boot-starter-parent本身並沒有引入任何依賴。編輯pom.xml文件， 把spring-boot-starter-web依賴添加到parent部分的下麵：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

再次運行一下mvn dependency:tree，您可以發現現在增加了一些依賴項，包括Tomcat Web服務器和Spring Boot。

需要編寫一個簡單的Java文件來完成我們的應用程序。Maven默認在src/main/java這個目錄下編譯源文件，所以您創建好目錄，然後新建一個源文件src/main/java/Example.java：

import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.stereotype.*;
import org.springframework.web.bind.annotation.*;

@RestController
@EnableAutoConfiguration
public class Example {

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

    public static void main(String[] args) throws Exception {
        SpringApplication.run(Example.class, args);
    }

}

雖然代碼量不多，不多其實內容很豐富。我們逐步理解一下關鍵步驟。

現在我們的程序應該可以工作了。因為我們在POM文件裏麵使用了spring-boot-starter-parent，所以我們可以使用run指令來啟動應用程序了。在項目根目錄輸入mvn spring-boot:run啟動應用程序：

$ mvn spring-boot:run

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::  (v1.4.1.BUILD-SNAPSHOT)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.222 seconds (JVM running for 6.514)

打開瀏覽器訪問localhost:8080，您應該可以看到輸出了下麵的內容：

Hello World!

敲擊ctrl-c就能退出程序了。

就像生產一個真正的軟件產品，我們創建一個完整自足的可執行jar文件，把我們的第一個實例完成。可執行的jar文件（有時候我們也叫“富jar文件”）是一個歸檔文件，包含了編譯好的類文件與我們運行程序所需要的所有jar依賴項。

為了創建可執行jar文件，我們把spring-boot-maven-plugin添加到pom.xml。把下麵的代碼添加到dependencies部分下麵：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

保存pom.xml，並從命令行運行mvn package：

$ mvn package

[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building myproject 0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] .... ..
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ myproject ---
[INFO] Building jar: /Users/developer/example/spring-boot-example/target/myproject-0.0.1-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:1.4.1.BUILD-SNAPSHOT:repackage (default) @ myproject ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

如果查看target目錄，你應該可以看到myproject-0.0.1-SNAPSHOT.jar，該文件大概有10Mb。想查看內部結構，可以運行jar tvf：

$ jar tvf target/myproject-0.0.1-SNAPSHOT.jar

在該目錄下，你應該還能看到一個很小的名為myproject-0.0.1-SNAPSHOT.jar.original的文件， 這是在Spring Boot重新打包前，Maven創建的原始jar文件。

使用java -jar命令運行該程序：

$ java -jar target/myproject-0.0.1-SNAPSHOT.jar

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::  (v1.4.1.BUILD-SNAPSHOT)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.536 seconds (JVM running for 2.864)

正如剛才一樣，敲擊ctrl-c退出應用。

5. 接下來閱讀什麼