第二章 第二个spring-boot程序

上一节的代码是spring-boot的入门程序，也是官方文档上的一个程序。这一节会引入spring-boot官方文档推荐的方式来开发代码，并引入我们在spring开发中service层等的调用。

1、代码结构如下

2、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>

     <properties>
         <java.version>1.8</java.version><!-- 官方推荐 -->
     </properties>
     <!-- 引入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>

说明：pom.xml文件与上一节的完全一样。

3、Application.java

 package com.xxx.firstboot;

 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;

 /**
  * @EnableAutoConfiguration:spring boot的注解，一般只用于主类，
  * 是无xml配置启动的关键部分,明确指定了扫描包的路径为其修饰的主类的包（这也就是为什么主类要放在根包路径下的原因）
  *
  * @ComponentScan 进行包的扫描，扫描路径由@EnableAutoConfiguration指定了
  *
  * 主类要位于根包路径下，方便之后的扫描(We generally recommend that you locate your main application class in a root package above other classes.)
  */
 @SpringBootApplication        //same as @Configuration+@EnableAutoConfiguration+@ComponentScan
 public class Application {
     /**
      * spring boot的入口，在整个子项目在内，
      * 只能有一个main方法，否则spring boot启动不起来
      */
     public static void main(String[] args) {
         SpringApplication.run(Application.class, args);
     }

 }

注意：

• 主类要位于根包路径下（例如，com.xxx.firstboot），这是推荐做法，方便扫描
• 每一个jar（即每一个子项目）都要有一个主方法，用于启动该jar（也就是一个微服务）
• 在主类上添加注解@SpringBootApplication，该注解相当于添加了如下三个注解
  • @Configuration：该注解指明该类由spring容器管理
  • @EnableAutoConfiguration：该注解是无xml配置启动的关键部分
  • @ComponentScan：该注解指定扫描包（如果主类不是位于根路径下，这里需要指定扫描路径），类似于spring的包扫描注解

4、application.properties

 #user info
 user.id=1
 user.username=zhaojigang
 user.password=123

注意：

• application.properties文件是spring-boot的默认文件，一般各种配置（包括：数据源配置，httpclient配置等）都配在这里就好

5、User.java

 package com.xxx.firstboot.domain;

 import org.springframework.boot.context.properties.ConfigurationProperties;
 import org.springframework.stereotype.Component;

 /**
  * @ConfigurationProperties(prefix="user")
  * 自动读取application.properties（是spring-boot默认查找的文件）文件中的user.*的属性
  * 在没有使用@ConfigurationProperties的情况下，可以使用@Value("${user.id}")来一个个指定属性的值
  *
  * 注意：如果要使用@ConfigurationProperties和@Value，需要将该bean添加@Component，
  * 因为在后边的对该类的使用中，需要直接将该类使用@Autowire注解注入，这样这些属性的自动注入才起作用，
  * 具体使用查看"UserService"
  */
 @Component
 @ConfigurationProperties(prefix="user")
 public class User {

     //@Value("${user.id}")
     private int id;

     //@Value("wangna")
     private String username;

     private String password;

     public int getId() {
         return id;
     }

     public void setId(int id) {
         this.id = id;
     }

     public String getUsername() {
         return username;
     }

     public void setUsername(String username) {
         this.username = username;
     }

     public String getPassword() {
         return password;
     }

     public void setPassword(String password) {
         this.password = password;
     }

 }

注意：

• 该类就是一个普通的model，在ssm框架中我们并没有将这样的model归给spring容器去管理，在这里使用@Component注解将其交由spring容器去处理，这样在之后的使用中，就可以直接将该model注入到其使用类中。
• 在该类上添加了@ConfigurationProperties(prefix="user")注解，这样的意思就是可以自动扫描application.properties文件相关前缀的配置，并根据名称配置到该类的每一个属性上去
• 也可以在属性上使用@Value注解单独复值，当然前提是没有配置@ConfigurationProperties，如果配置了，@Value注解失效

6、UserService.java

 package com.xxx.firstboot.service;

 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;

 import com.xxx.firstboot.domain.User;

 @Service
 public class UserService {

     @Autowired
     private User user;

     public User getUser(){
         return user;
     }

 }

注意：

• 这里直接注入了User，这和类正是上边的那个model

7、UserController.java

 package com.xxx.firstboot.web;

 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;

 import com.xxx.firstboot.domain.User;
 import com.xxx.firstboot.service.UserService;
 /**
  * @RestController:spring mvc的注解，
  * 相当于@Controller与@ResponseBody的合体，可以直接返回json
  */
 @RestController
 @RequestMapping("/user")
 public class UserController {

     @Autowired
     private UserService userService;

     @RequestMapping("/getUser")
     public User getUser() {
         return userService.getUser();
     }

 }

说明：

• 这个类其实就是开发中，开发一个spring-boot程序的最基本最常用的方式。（在微服务应用中，用到类似于"Java企业应用开发实践"系列中的父子模块开发，之后再说）
• 相对于ssm而言，spring-boot的读取属性文件的方式也相当容易，读取属性文件常用的三种方式
  • 使用FileUtil去读：见第一章 属性文件操作工具类
  • 使用如上的注解实现（最推荐的方式）
  • 使用Environment这个类来获取就行（这个可能写错类名了）

对于spring-boot而言，其本身有很多集成的jar包（见下边），我们可以根据自己的需求引入相应的jar，但是暂无与mybatis集成的jar。

spring-boot相关的依赖包（可以根据需求自己引入）：