第一章 第一個spring boot程序

環境：

• jdk:1.8.0_73
• maven:3.3.9
• spring-boot:1.2.5.RELEASE（在pom.xml中指定了）

注意：關於spring-boot的支持，

• 最少使用jdk7（jdk6也可以，可能需要額外配置，沒試過，官方推薦jdk8）
• maven至少使用3.2

1、首先進入一個文件夾，例如"~/Desktop/project"，然后按照"第一章 企業項目開發--maven+springmvc+spring+mybatis+velocity整合"所說的手工建立一個maven工程，其中的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/maven-v4_0_0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>com.xxx</groupId>
    <artifactId>myboot</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!-- 
         引入spring-boot-starter-parent做parent是最好的方式，
         但是有時我們可能要引入我們自己的parent，此時解決方式有兩種：
         1）我們自己的parent的pom.xml的parent設為spring-boot-starter-parent（沒有做過驗證，但是感覺可行）
         2）使用springboot文檔中的方式:見spring-boot-1.2.5-reference.pdf的第13頁
    -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.2.5.RELEASE</version>
    </parent>

    <!-- 引入實際依賴 -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId> 
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!-- 
                用於將應用打成可直接運行的jar（該jar就是用於生產環境中的jar）
                值得注意的是，如果沒有引用spring-boot-starter-parent做parent，
                且采用了上述的第二種方式，這里也要做出相應的改動
             -->
            <plugin>
                <groupId>org.springframework.boot</groupId> 
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

之后，使用"mvn clean compile"成功后，引入eclipse，具體的方式見：第一章 企業項目開發--maven+springmvc+spring+mybatis+velocity整合

 

2、引入eclipse中的工程結構如下：

之后，創建紅框部分。

FirstBoot:

package com.xxx.firstboot;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @RestController:spring mvcd的注解，
 * 相當於@Controller與@ResponseBody的合體，可以直接返回json
 *
 * @EnableAutoConfiguration:spring boot的注解
 * 是無配置啟動的關鍵部分
 */
@RestController
@EnableAutoConfiguration
public class FirstBoot {
    
    @RequestMapping("/hello")
    public String testFirstMethod(){
        return "Hello jigang!!!";
    }
    
    /**
     * spring boot的入口，在整個項目中，包括其子項目在內，
     * 只能有一個main方法，否則spring boot啟動不起來
     */
    public static void main(String[] args) {
        SpringApplication.run(FirstBoot.class, args);
    }
    
}

解釋：

• @RestController：spring mvc的注解，相當於==>@Controller+@ResponseBody+啟動json轉換器注解，可以直接返回json

• @EnableAutoConfiguration：spring boot的注解，是無xml配置啟動的關鍵部分

• main方法：spring boot的入口，在整個項目中，包括其子項目在內，只能有一個main方法，否則spring boot啟動不起來
  • 注意：關於run方法的第一個參數，不適用全類名也行，推薦使用全類名

 

3、啟動spring boot

首次啟動，采用"mvn spring-boot:run"（會下載一些東西），之后啟動直接在主類（含有main方法的類）上"run as-->java application"即可

當看到console輸出以下的信息時，表示啟動spring-boot成功，

之后在瀏覽器輸入路徑"http://localhost:8080/hello"，輸出信息"Hello jigang!!!"，則成功！！！

 

4、打包成可執行的jar，該jar將是在生產環境下可用的jar

生產jar的過程依賴於引入的spring-boot-maven-plugin.jar。

執行"mvn package"，查看target下的文件：

后邊那一個包是maven自己打的，前邊那個是spring-boot自己又基於后邊那個重新打包了（repackage）

注意：如果沒有使用spring-boot-starter-parent做parent（看pom.xml的注釋），那么打包過程需要作出相應的調整。

 

5、運行打包好的jar

進入myboot文件夾下，執行命令"java -jar target/myboot-1.0-SNAPSHOT.jar"，得出如下結果：

之后訪問瀏覽器即可。

 

說明：

在沒有引入spring-boot-starter-web.jar之前，查看依賴樹：

引入spring-boot-starter-web.jar之后，查看依賴樹：

實際上，spring-boot-starter-web.jar這個jar引入5各方面的jar：

• spring-boot的啟動jar：spring-boot-starter.jar
• tomcat相關jar(spring-boot-1.2.5-->tomcat8)
• jackson
• hiberbate-validator
• spring相關jar(spring-boot-1.2.5-->spring4.1)

 

兩個問題：

1）若不采用spring-boot-starter-parent做parent，該怎么配置？

解決方案：

加入以下代碼即可。

    <dependencyManagement>
        <dependencies>
            <dependency>
                <!-- Import dependency management from Spring Boot -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>1.2.5.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

完整的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/maven-v4_0_0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>com.xxx</groupId>
    <artifactId>myboot</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!-- 引入spring-boot-starter-parent做parent是最好的方式， 但是有時我們可能要引入我們自己的parent，此時解決方式有兩種： 
        1）我們自己的parent的pom.xml的parent設為spring-boot-starter-parent（沒有做過驗證，但是感覺可行） 2）使用springboot文檔中的方式:見spring-boot-1.2.5-reference.pdf的第13頁 -->
    <!-- <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> 
        <version>1.2.5.RELEASE</version> </parent> -->

    <dependencyManagement>
        <dependencies>
            <dependency>
                <!-- Import dependency management from Spring Boot -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>1.2.5.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <!-- 引入實際依賴 -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!-- 用於將應用打成可直接運行的jar（該jar就是用於生產環境中的jar） 值得注意的是，如果沒有引用spring-boot-starter-parent做parent， 
                且采用了上述的第二種方式，這里也要做出相應的改動 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

注意：引入的是在dependencyManagement，spring-boot-dependencies的type=pom，scope=import

2）若不采用spring-boot-starter-parent做parent，打包插件spring-boot-maven-plugin該怎么配置？

這里采用上邊的配置，我直接執行"mvn package"也成功了，這里有知道的給解釋一下？與官方文檔不一樣啊