第一章 第一个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"也成功了，这里有知道的给解释一下？与官方文档不一样啊