SpringBoot官方文档个人学习总结(一)

SpringBoot官方文档个人学习总结(一)

文档链接：Spring Boot Reference Guide 2.0.0.RELEASE
为了让印象深刻点，具体到读了什么所以写下来。

一、 第一大部分 ： Spring Boot Documentation

主要就从入门到高级部分的重点进行了汇集，略过，从下一部分入门开始看，等看完全部再返回来有目的地看。

二、第二大部分：Getting Started

1. Introducing Spring Boot：介绍spring boot
简单介绍了springboot的特点：约定大于配置，简单易上手。我的理解是没有像ssm框架还要设置复杂的xml设置只有简单的一个yml或properties配置文件。然后致力于什么目标之类的，目前不重要略过。

2. System Requirements：系统要求
2.0.0版本要求java8或9、Spring Framework 5.0.4.RELEASE 及以上版本、Maven 3.2+、Gradle 4。Servlet容器可以是Tomcat 8.5、Jetty 9.4、Undertow 1.4，可以部署到任意兼容Servlet 3.0+的容器中。

3.Installing Spring Boot：安装spring boot
太多安装方法了，暂时只记录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>com.example</groupId>
	<artifactId>myproject</artifactId>
	<version>0.0.1-SNAPSHOT</version>

	<!-- Inherit defaults from Spring Boot -->
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.0.0.RELEASE</version>
	</parent>

	<!-- Add typical dependencies for a web application -->
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
	</dependencies>

	<!-- Package as an executable jar -->
	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

4.Developing Your First Spring Boot Application ：开发第一个spring boot项目

可以利用官方的spring.io来创建项目，也可以用IDEA创建，创建好项目后开始，这里以创建web项目为例。

第一步：pom.xml的spring boot继承父类

<?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>
	<version>0.0.1-SNAPSHOT</version>

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

	<!-- Additional lines to be added here... -->

</project>

第二步：增加类路径依赖
因为是web项目所以增加spring-boot-starter-web依赖

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

第三步：编写实现代码
下面是一个简单的实现，需要在src/main/java目录下创建一个java文件，也就是src/main/java/Example.java，内容如下：

import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
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);
	}

}

基本上就完成了，可以启动查看效果。
接下来是对上面代码的部分介绍解释：
（1） @RestController 和 @RequestMapping 是Spring MVC 的注解

@RestController 相当于 @Controller 和 @ResponseBody 的结合体，表示这个类既可以接收HTTP请求，也可以返回指定格式的数据，写入到response对象的body区，通常用来返回JSON数据或者是XML数据。

@RequestMapping 用来提供路径信息，表示任何 “/” 路径的HTTP请求都应映射到该方法

（2） @EnableAutoConfiguration注解
根据所添加的jar依赖关系“猜测”如何配置Spring，但是还可以自定义自己需要的依赖设置，spring boot会尽量配合设置。

（3） main 方法
是一个标准方法，遵循应用程序入口点的java约定，通过调用run来委托Spring Boot的SpringApplication类。SpringApplication引导我们的应用程序，启动Spring，而Spring又启动自动配置的Tomcat web服务器。我们需要传递Example.class作为run方法的参数来告诉SpringApplication哪个是主要的Spring组件。args数组也被传递来公开任何命令行参数。（官方解释机翻）

第四步：启动程序
一般启动程序然后在localhost：8080的网址打开就可以看到。

第五步：打包可执行 jar 包
如果是maven的话只要在pom.xml的依赖下面添加如下插件，就可以自动打包

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

maven项目的话点击在lifecycle里的package进行打包，然后在IDEA的Terminal运行命令

java -jar target/test1-0.0.1-SNAPSHOT.jar

5.What to Read Next：
提供了快速上手的部分指南，如果着急使用的话可以按第一大部分跳转，也可以在这跳转