SpringBoot实战教程之新手入门篇_Java教程

1. SpringBoot 简介

Spring Boot 是由 Pivotal 团队提供的全新框架，其设计目的是用来简化 Spring 应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置，从而使开发人员不再需要定义样板化的配置。Spring Boot 可以轻松创建一个基于 Spring 且独立运行的生产级应用。

2. SpringBoot 安装

SpringBoot 的安装有很多种方式，最简单的一种是直接将 spring-boot-*.jar 等文件添加到工程的 classpath 下，这种你就可以运行并调试你的应用了。如果是企业级应用，推荐使用构建工具来管理项目的依赖，比如：Maven 或者 Gradle 等。对于直接添加 classpath 的方式，这里不做多余的介绍，下面主要描述基于构建工具的安装指导。

2.1. 基于 Maven 的安装

Spring Boot 与 Apache Maven 3.2兼容。如果你还没有安装 Maven，可以按照 maven.apache.org 上的说明进行操作。

Spring Boot 依赖使用 org.springframework.boot 作为 groupId。通常情况下，你的 POM 文件会继承 spring-boot-starter-parent 工程，然后再声明一个或多个 Starters 的依赖。Spring Boot 同时也提供了一个可选的Maven 插件用来生成可执行的 Jar 包。

典型的 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>com.example</groupId>

									    <artifactId>myproject</artifactId>

									    <!-- 继承 Spring Boot 的默认值 -->

									    <parent>

									        <groupId>org.springframework.boot</groupId>

									        <artifactId>spring-boot-starter-parent</artifactId>

									        <version>1.5.3.RELEASE</version>

									    </parent>

									    <!-- 为 Web 应用添加能用依赖 -->

									    <dependencies>

									        <dependency>

									            <groupId>org.springframework.boot</groupId>

									            <artifactId>spring-boot-starter-web</artifactId>

									        </dependency>

									    </dependencies>

									    <!-- 打包成一个可执行 jar 包 -->

									    <build>

									        <plugins>

									            <plugin>

									                <groupId>org.springframework.boot</groupId>

									                <artifactId>spring-boot-maven-plugin</artifactId>

									            </plugin>

									        </plugins>

									    </build>

									</project>

提示：

spring-boot-starter-parent 是使用 Spring Boot 的一种比较好的方式，但它并不适用于所有场景。有时，你可能需要继承一个不同的父级 Pom，或者你不喜欢这种默认的配置。你也可以通过声明一个 scope=import 的依赖来使用它：

				?

									<dependencyManagement>

									     <dependencies>

									        <dependency>

									            <!-- 从 Spring Boot 导入依赖管理 -->

									            <groupId>org.springframework.boot</groupId>

									            <artifactId>spring-boot-dependencies</artifactId>

									            <version>1.5.3.RELEASE</version>

									            <type>pom</type>

									            <scope>import</scope>

									        </dependency>

									    </dependencies>

									</dependencyManagement>

2.2. 基于 Gradle 的安装

相对 Maven 庞大的 XML 配置，我更喜欢 Gradle 多一点，不但简洁而且灵活性也好很多。Spring Boot 与 Gradle（2.9或以上）、Gradle 3兼容。如果你还没有安装 Gradle，你可以按照 www.gradle.org 上的操作说明来进行安装。

典型的 build.gradle 文件：

				?

									plugins {

									    id 'org.springframework.boot' version '1.5.3.RELEASE'

									    id 'java'

									}

									jar {

									    baseName = 'myproject' version = '0.0.1-SNAPSHOT'

									}

									repositories {

									    jcenter()

									    maven { url "http://maven.aliyun.com/nexus/content/groups/public/" }

									}

									dependencies { 

									    compile("org.springframework.boot:spring-boot-starter-web")

									    testCompile("org.springframework.boot:spring-boot-starter-test")

									}

3. 创建 HelloWorld 应用

创建一个简单的 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);

									    }

									}

Example 类上的第一个注解 @RestController 是 @Controller 及 @ResponseBody 的组合，表明这是一个控制器，且所有响应数据都会被序列化到响应体里面返回。而方法上的 @RequestMapping 注解会为请求处理提供路由信息。这些注解都是 Spring 的，而不是 Spring Boot 特有的。

类上的第二个注解 @EnableAutoConfiguration 会告诉 Spring Boot 去通过依赖的 Jar 包配置 Spring 工程。因为 spring-boot-starter-web 里面包含有 Tomcat 及 Spring MVC，所以它会认为这是一个 Web 工程，并进行相应的 Spring 配置。

应用的最后一部分是一个 main 方法，它通过调用 SpringApplication 的 run 方法将应用程序委托给 Spring Boot。SpringApplication 将引导我们的应用程序启动 Spring 及自动配置的 Tomcat Web 服务。我们需要将 Example.class 作为一个参数传递给 run 方法来告诉 SpringApplication 它是主要的 Spring 组件。

运行 main 方法后，即可以使用浏览器打开地址 localhost:8080 会得到输出：

Hello World!

4. 代码结构

一般的应用都会使用域名的反转 + 项目名作为项目的统一包名前缀。如：com.qchery.funda。在 SpringBoot 的项目中，推荐使用如下布局：

com
+- qchery
+- funda
+- Application.java
|
+- entity
| +- Customer.java
|
+- dao
| +- CustomerRepository.java
|
+- service
| +- CustomerService.java
|
+- web
+- CustomerController.java

其中，Application.java 文件如下：

				?

									import org.springframework.boot.SpringApplication;

									import org.springframework.boot.autoconfigure.EnableAutoConfiguration;

									import org.springframework.context.annotation.ComponentScan;

									import org.springframework.context.annotation.Configuration;

									@Configuration

									@EnableAutoConfiguration

									@ComponentScan

									public class Application {

									    public static void main(String[] args) {

									        SpringApplication.run(Application.class, args);

									    }

									}

一般来说，我们会将 @EnableAutoConfiguration 注解放置在主类上，也就是上面结构中的 Application.java。它隐式定义了包含某些搜索项的搜索包，例如，如果你正编写一个 JPA 的应用程序，那么带 @EnableAutoConfiguration 注解的类将会被用来搜索带有 @Entity 的类。

而 @ComponentScan 会用来自动扫描相应组件，由于 Application.java 是的根包名下，所以它不需要声明 basePackage 去指定需要扫描的包，默认为根包名，即：com.qchery.funda。

5. Configuration 类

SpringBoot 同时支持 Java-based 配置及 XML 文件配置。但推荐使用 Java-based 形式的配置，如果现在的系统中已经存在一些 XML 形式的配置，建议使用相同效果的 Java-based 配置进行替换，你可以通过搜索 Enable* 来查找对应的 Java-based 配置。

5.1. 导入其它配置

在 SpringBoot 工程里面，我们不需要把所有的配置放置到一个类文件里面。它的 @Import 注解可以帮助我们导入其它的配置类，如果想要导入 XML 形式的配置，可以使用 @ImportResource 注解。另外，还可以使用 @ComponentScan 注解去扫描所有带有 @Configuration 注解的类。

6. 自动化配置

当你在某一个带有 @Configuration 的类里加上 @EnableAutoConfiguration 或 @SpringBootApplication 注解时，SpringBoot 会根据所添加的依赖包自动完成项目配置。例如，如果你在类路径下添加 HSQLDB 的包，但你没有配置任何数据库属性，SpringBoot 会自动配置一个 In-Memory 数据库。其中 @EnableAutoConfiguration 只能添加一个类上，建议将其加在主要的 @Configuration 类上。

6.1. 逐渐替换自动化配置

自动化配置并不是侵入式的，在任何地方你都可以通过自定义配置来替换它。例如，如果你添加自己的数据库配置，那么默认的嵌入式数据库支持将会被退回。如果想要查看自动化配置是否生效，可以在运行程序时，加上 –debug 参数进行查看。

6.2. 禁止特定的自动化配置

当你发现自动化配置不能按自己的意愿进行工作的时候，可以通过 @EnableAutoConfiguration 的 exclude 属性来禁用掉它们。

				?

									import org.springframework.boot.autoconfigure.*;

									import org.springframework.boot.autoconfigure.jdbc.*;

									import org.springframework.context.annotation.*;

									@Configuration

									@EnableAutoConfiguration(exclude={DataSourceAutoConfiguration.class})

									public class MyConfiguration {

									}

7. 使用 @SpringBootApplication 注解

由于大多数情况下，@Configuration，@EnableAutoConfiguration 及 @ComponentScan 注解都是一起使用的。SpringBoot 提供了 @SpringBootApplication 这个更加方便的选择，它等同于前三个注解。

				?

									import org.springframework.boot.SpringApplication;

									import org.springframework.boot.autoconfigure.SpringBootApplication;

									@SpringBootApplication // 等同于 @Configuration @EnableAutoConfiguration @ComponentScan

									public class Application {

									    public static void main(String[] args) {

									        SpringApplication.run(Application.class, args);

									    }

									}