[原]Spring Boot(1)-快速构建应用

Spring 框架作为目前非常流行的一个 Java 应用开发框架，它所包含的内容是非常繁多的。Spring 框架包含几十个不同的子项目，涵盖应用开发的不同方面。要在这些子项目之间进行选择，并快速搭建一个可以运行的应用是比较困难的事情。Spring Boot 的目的在于快速创建可以独立运行的 Spring 应用。通过 Spring Boot 可以根据相应的模板快速创建应用并运行。Spring Boot 可以自动配置 Spring 的各种组件，并不依赖代码生成和 XML 配置文件。Spring Boot 可以大大提升使用 Spring 框架时的开发效率。

官方文档： http://docs.spring.io/spring-boot/docs/current/reference/html/

Spring Boot提供了一个强大的一键式Spring的集成开发环境，能够单独进行一个Spring应用的开发，其中：
（1）集中式配置（application.properties）+注解，大大简化了开发流程
（2）内嵌的Tomcat和Jetty容器，可直接打成jar包启动，无需提供Java war包以及繁琐的Web配置
（3）提供了Spring各个插件的基于Maven的pom模板配置，开箱即用，便利无比。
（4）可以在任何你想自动化配置的地方，实现可能
（5）提供更多的企业级开发特性，如何系统监控，健康诊断，权限控制
（6） 无冗余代码生成和XML强制配置
（7）提供支持强大的Restfult风格的编码，非常简洁

1、安装

• 一个称手的文本编辑器（例如Vim、Emacs、Sublime Text）或者IDE（Eclipse、Idea Intellij）
• Java环境（JDK 1.7或以上版本）
• Maven 3.0+（Eclipse和Idea IntelliJ内置，如果使用IDE并且不使用命令行工具可以不安装）

1. spring-boot是一个mavan项目，所以其使用的jar包全部是通过maven管理，当然，使用maven也是非常方便的。

2. spring-boot打出来的包是一个可执行jar包的状态，使用的是内置的tomcat服务器，所以不需要将项目转成EJB项目。

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

@SpringBootApplication
@RestController
public class Application {

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

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

在IDE中直接直接执行main方法，然后访问http://localhost:8080即可。

另外可以使用maven打包为可执行jar包，然后执行java -jar xxx.jar。

或者执行mvn spring-boot:run运行项目。

在浏览器中访问http://localhost:8080/，Hello World!就出现在了页面中。只用了区区十几行Java代码，一个Hello World应用就可以正确运行.

3、spring boot项目结构

3.1、 pom.xml文件

 pom.xml文件就是项目依赖文件，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/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>guisu</groupId>
  <artifactId>guisu-demo</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>guisu</name>
  <description>Demo project for Spring WebMvc</description>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.2.5.RELEASE</version>
    <relativePath/>
  </parent>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <java.version>1.8</java.version>
  </properties>

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

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


</project>

在Maven依赖中引入了 spring-boot-starter-web ，它包含了Spring Boot预定义的一些Web开发的常用依赖:

• spring-web ,  spring-webmvc  Spring WebMvc框架
• tomcat-embed-*  内嵌Tomcat容器
• jackson  处理json数据
• spring-*  Spring框架
• spring-boot-autoconfigure  Spring Boot提供的自动配置功能

“org.springframework.boot:spring-boot-starter-web”是 Spring Boot 所提供的推荐的基础 POM 文件之一，用来提供创建基于 Spring MVC 的 Web 应用所需的第三方库依赖。除了这个 POM 文件之外，Spring Boot 还提供了其他类似的 POM 文件。所有这些基础 POM 依赖都在“org.springframework.boot”组中。一些重要 POM 文件的具体说明见：

Spring Boot 推荐的基础 POM 文件

所有这些 POM 依赖的好处在于为开发 Spring 应用提供了一个良好的基础。Spring Boot 所选择的第三方库是经过考虑的，是比较适合产品开发的选择。但是 Spring Boot 也提供了不同的选项，比如日志框架可以用 Logback 或 Log4j，应用服务器可以用 Tomcat 或 Jetty。

3.2  java代码

创建 src/main/java/Application.java :

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

@SpringBootApplication
@RestController
public class Application {

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

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

类似如下结构：

com
 +- example
     +- myproject
         +- Application.java
         |
         +- domain //<span style="color: rgb(51, 51, 51); font-family: Helvetica, Tahoma, Arial, sans-serif; font-size: 14px; line-height: 24px; background-color: rgb(245, 245, 245);">用来管理javaBean实体对象</span>
         |   +- Customer.java
         |   +- CustomerRepository.java
         |
         +- service //业务逻辑层，处理数据逻辑，验证数据

         |   +- CustomerService.java
         |
         +- web //Controller控制器
             +- CustomerController.java

Spring Boot建议将我们 main 方法所在的这个 主要的配置类 配置在根包名下。

运行应用后，那么这段代码究竟做了什么呢？我们从程序的入口 SpringApplication.run(Application.class, args); 开始分析：

Java代码中没有任何配置，和传统的Spring应用相比，多了两个我们不认识的符号：

• @EnableAutoConfiguration
• SpringApplication

它们都是由Spring Boot框架提供。在 SpringApplication.run() 方法执行后，Spring Boot的 autoconfigure 发现这是一个Web应用（根据类路径上的依赖确定），于是在内嵌的Tomcat容器中启动了一个Spring的应用上下文，并且监听默认的tcp端口8080（默认约定）。同时在Spring Context中根据默认的约定配置了Spring WebMvc：

• Servlet容器默认的Context路径是 /
• DispatherServlet 匹配的路径( servlet-mapping 中的 url-patterns )是 /*
• @ComponentScan 路径被默认设置为 SampleController 的同名package，也就是该package下的所有 @Controller ， @Service ,  @Component ,  @Repository 都会被实例化后并加入Spring Context中。

没有一行配置代码、也没有 web.xml 。基于Spring Boot的应用在大多数情况下都不需要我们去显式地声明各类配置，而是将最常用的默认配置作为约定，在不声明的情况下也能适应大多数的开发场景。

1. SpringApplication 是Spring Boot框架中描述Spring应用的类，它的 run() 方法会创建一个Spring应用上下文（Application Context）。另一方面它会扫描当前应用类路径上的依赖，例如本例中发现 spring-webmvc （由  spring-boot-starter-web 传递引入）在类路径中，那么Spring Boot会判断这是一个Web应用，并启动一个内嵌的Servlet容器（默认是Tomcat）用于处理HTTP请求。

2. Spring WebMvc框架会将Servlet容器里收到的HTTP请求根据路径分发给对应的 @Controller 类进行处理， @RestController 是一类特殊的 @Controller ，它的返回值直接作为HTTP Response的Body部分返回给浏览器。 @RestController注解是@Controller和@ResponseBody的合集，表 示这是个控制器bean，并且是将函数的返回值直接填入HTTP响应体中，是REST风格的控制器。@RequestMapping("/books")表示该控制器处理所有“/books”的URL请求，具体由那个函数处理，要根据HTTP的方法来区分：GET表示查询、POST表示提交、PUT表示更新、DELETE表示删除。

3. @RequestMapping 注解表明该方法处理那些URL对应的HTTP请求，也就是我们常说的URL路由（routing)，请求的分发工作是有Spring完成的。例如上面的代码中 http://localhost:8080/ 根路径就被路由至 greeting() 方法进行处理。如果访问 http://localhost:8080/hello ，则会出现 404 Not Found 错误，因为我们并没有编写任何方法来处理 /hello 请求。

SpringApplication.run(Application.class, args);

SpringApplication application = new SpringApplication(Application.class);
application.run(args);

new SpringApplicationBuilder()
        .showBanner(false)
        .sources(Application.class)
        .run(args);

@Configuration
@EnableAutoConfiguration(exclude={DataSourceAutoConfiguration.class})
public class MyConfiguration {
}

spring.datasource.url=jdbc:mysql://localhost/test
spring.datasource.username=dbuser
spring.datasource.password=dbpass
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

spring:
  datasource:
    url: jdbc:mysql://localhost/test
    username: dbuser
    password: dbpass
    driver-class: com.mysql.jdbc.Driver

# Server settings (ServerProperties)
server:
  port: 8080
  address: 127.0.0.1
  sessionTimeout: 30
  contextPath: /

  # Tomcat specifics
  tomcat:
    accessLogEnabled: false
    protocolHeader: x-forwarded-proto
    remoteIpHeader: x-forwarded-for
    basedir:
    backgroundProcessorDelay: 30 # secs

4、Sping boot处理请求

4.1 URL路由

现代Web应用往往包括很多页面，不同的页面也对应着不同的URL。对于不同的URL，通常需要不同的方法进行处理并返回不同的内容。

使用@Controller实现URL路由使用@Controller实现URL路由

匹配多个URL

@RestController
public class Application {

    @RequestMapping("/")
    public String index() {
        return "Index Page";
    }

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

@RequestMapping 可以注解 @Controller 类：

@RestController
@RequestMapping("/classPath")
public class Application {
    @RequestMapping("/methodPath")
    public String method() {
        return "mapping url is /classPath/methodPath";
    }
}

method 方法匹配的URL是 /classPath/methodPath" 。

提示： 可以定义多个 @Controller 将不同URL的处理方法分散在不同的类中

URL中的变量——PathVariable

在Web应用中URL通常不是一成不变的，例如微博两个不同用户的个人主页对应两个不同的URL: http://weibo.com/user1 ， http://weibo.com/user2 。我们不可能对于每一个用户都编写一个被 @RequestMapping 注解的方法来处理其请求，Spring MVC提供了一套机制来处理这种情况：

@RequestMapping("/users/{username}")
public String userProfile(@PathVariable("username") String username) {
    return String.format("user %s", username);
}

@RequestMapping("/posts/{id}")
public String post(@PathVariable("id") int id) {
    return String.format("post %d", id);
}

在上述例子中，URL中的变量可以用 {variableName} 来表示，同时在方法的参数中加上 @PathVariable("variableName") ，那么当请求被转发给该方法处理时，对应的URL中的变量会被自动赋值给被 @PathVariable 注解的参数（能够自动根据参数类型赋值，例如上例中的 int ）。

4.2 HTTP请求方法

对于HTTP请求除了其URL，还需要注意它的方法（Method）。例如我们在浏览器中访问一个页面通常是GET方法，而表单的提交一般是POST方法。 @Controller 中的方法同样需要对其进行区分：

@RequestMapping(value = "/login", method = RequestMethod.GET)
public String loginGet() {
    return "Login Page";
}

@RequestMapping(value = "/login", method = RequestMethod.POST)
public String loginPost() {
    return "Login Post Request";
}

4.3 请求响应

在之前所有的 @RequestMapping 注解的方法中，返回值字符串都被直接传送到浏览器端并显示给用户。但是为了能够呈现更加丰富、美观的页面，我们需要将HTML代码返回给浏览器，浏览器再进行页面的渲染、显示。

一种很直观的方法是在处理请求的方法中，直接返回HTML代码，但是这样做的问题在于——一个复杂的页面HTML代码往往也非常复杂，并且嵌入在Java代码中十分不利于维护。更好的做法是将页面的HTML代码写在模板文件中，渲染后再返回给用户。为了能够进行模板渲染，需要将 @RestController 改成 @Controller ：

import org.springframework.ui.Model;

@Controller
public class HelloController {

    @RequestMapping("/hello/{name}")
    public String hello(@PathVariable("name") String name, Model model) {
        model.addAttribute("name", name);
        return "hello"
    }
}

在上述例子中，返回值 "hello" 并非直接将字符串返回给浏览器，而是寻找名字为 hello 的模板进行渲染，假如我们使用 Thymeleaf 模板引擎进行模板渲染，需要引入依赖：

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

接下来需要在默认的模板文件夹 src/main/resources/templates/ 目录下添加一个模板文件 hello.html ：

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Getting Started: Serving Web Content</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
    <p th:text="'Hello, ' + ${name} + '!'" />
</body>
</html>

th:text="'Hello, ' + ${name} + '!'" 也就是将我们之前在 @Controller 方法里添加至 Model 的属性 name 进行渲染，并放入 <p> 标签中（因为 th:text 是 <p> 标签的属性）。模板渲染还有更多的用法，请参考 Thymeleaf官方文档 。

4.4 处理静态文件

浏览器页面使用HTML作为描述语言，那么必然也脱离不了CSS以及JavaScript。为了能够浏览器能够正确加载类似 /css/style.css ,  /js/main.js 等资源，默认情况下我们只需要在 src/main/resources/static 目录下添加 css/style.css 和 js/main.js 文件后，Spring MVC能够自动将他们发布，通过访问 /css/style.css ,  /js/main.js 也就可以正确加载这些资源。

5、实例：数据库访问

除了最基本的Web框架，另一种非常普遍的开发场景是访问数据库。在传统的Spring应用中，访问数据库我们需要配置：

• 类路径上添加数据库访问驱动
• 实例化 DataSource 对象，指定数据库 url ,  username ,  password 等信息
• 注入 JdbcTemplate 对象，如果使用 Hibernate ， Mybatis 等框架，还需要进一步配置框架信息

在Spring Boot中，上述过程会被简化。首先在Maven项目依赖中定义：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web-jdbc</artifactId>
</dependency>
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
</dependency>

spring-boot-starter-web-jdbc 引入了 spring-jdbc 依赖， h2 是一个内存关系型数据库。在引入了这些依赖并启动Spring Boot应用程序后， autoconfigure 发现 spring-jdbc 位于类路径中，于是：

• 根据类路径上的JDBC驱动类型（这里是 h2 ，预定义了 derby ,  sqlite ,  mysql ,  oracle ,  sqlserver 等等），创建一个 DataSource 连接池对象，本例中的 h2 是内存数据库，无需任何配置，如果是 mysql ,  oracle 等类型的数据库需要开发者配置相关信息。
• 在Spring Context中创建一个 JdbcTemplate 对象（使用 DataSource 初始化）

接下来开发者的工作就非常简单了，在业务逻辑中直接引入 JdbcTemplate 即可：

@Service
public class MyService {

    @Autowired
    JdbcTemplate jdbcTemplate;

}

除了 spring-jdbc ，Spring Boot还能够支持JPA，以及各种NoSQL数据库——包括MongoDB，Redis，全文索引工具 elasticsearch ,  solr 等等。

6、Production特性

从前面的例子可以看出，Spring Boot能够非常快速的做出一些原型应用，但是它同样可以被用于生产环境。为了添加生产环境特性支持，需要在Maven依赖中引入：

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

加入 actuator 依赖后，应用启动后会创建一些基于Web的Endpoint：

• /autoconfig ，用来查看Spring Boot的框架自动配置信息，哪些被自动配置，哪些没有，原因是什么。
• /beans ，显示应用上下文的Bean列表
• /dump ，显示线程dump信息
• /health ，应用健康状况检查
• /metrics
• /shutdown , 默认没有打开
• /trace

参考资料：

• 参考 Spring Boot 项目的 官方网站 ，了解更多信息。
• 查看 Spring Boot 的 参考文档 ，学习更多关于 Spring Boot 的用法。
• 查看 InfoQ 上关于  Spring Boot  的介绍文章。
• 下载  Spring Boot 命令行工具 。
• developerWorks Java 技术专区 。