SpringBoot框架基础知识（1）

1. SpringBoot框架

SpringBoot框架可以简单的理解为是一个“增强版的SpringMVC框架，极大程度的简化了各种配置，默认就已经集成了绝大部分常用的依赖”。

2. 创建SpringBoot项目的方式

创建SpringBoot的方式主要有3种：

基于SpringBoot的父级项目来创建子级项目；

使用开发工具的创建向导进行创建，如果使用的是Eclipse，需要安装Spring Tools Suite插件，如果使用的是Intellijia IDEA则不需要安装任何插件，可以直接创建；

通过

https://start.spring.io

网站创建项目，然后在开发工具中导入项目。

3. 创建SpringBoot项目

打开

网站，确定以下参数：

【Project】：Maven Project

【Language】：Java

【SpringBoot】：2.1.14

【Group】：cn.tedu

【Artifact】：sample

【Name】：sample

【Package Name】：cn.tedu.sample

【Packaging】：war

【Java】：8

【Dependencies】：无

确定无误后，点击页面中的 Generate 按钮，将会开始自动下载，将得到sample.zip压缩包。

解压sample.zip将得到sample文件夹，这个文件夹就是创建好的SpringBoot项目，推荐将该文件放到Workspace中，便于统一管理。

在Eclipse中，通过Import > Existing Maven Projects导入项目，如果是第1次使用SpringBoot项目，可能本地仓库中没有相关的jar包，所以，会下载大量的依赖的jar包，在这个过程中，必须保证网络畅通，能够顺利的连接到Maven服务器，如果没有开始自动下载，可以对项目点击右键，选择Maven > Update Project以更新项目，甚至强制更新项目。

注意：根据开发工具安装插件的不同，项目结构中可能有一些额外的分支，或图标不同，并不影响正常开发和运行。

注意：如果使用较低的Eclipse，可能内置的是较低版本的Maven环境，在创建完SpringBoot项目后，pom.xml文件可能报错，但是，可以无视，并不影响开发和运行。

4. 启动SpringBoot项目

在生成好的项目中，默认，在src/main/java下就存在cn.tedu.sample包，这个包的名字是由创建项目时填写的Group和Artifact决定的，同时，这是当前SpringBoot项目默认已经配置的组件扫描的包，所以，后续自行创建的组件类必须放在这个包或其子孙包中！

【小结】默认就存在的包，不能随便修改名称，且推荐将所有类都放在这个包或其子孙包中。

在cn.tedu.sample包下，默认就存在SampleApplication类，这个类的名称是根据创建项目时填写的Artifact决定的，这个类中有main()方法，运行该方法，就会启动整个项目！所以，SampleApplication也称之为当前项目的启动类！

SpringBoot项目是内置Tomcat的，当启动项目时，就会将项目编译、打包，并部署到内置的Tomcat中，再启动这个Tomcat！

由于内置的Tomcat默认也是占用8080端口的，所以，在启动项目之前，必须将已经运行的Tomcat停止，也不可以反复启动项目！

另外，在src/test/java下也有cn.tedu.sample包，且包中已经有SampleApplicationTests测试类，类中有contextLoads()方法，该方法的方法体中并没有任何代码，通过单元测试执行该方法应该能通过测试。

在SpringBoot中执行单元测试时，会加载项目的所有环境（读取配置、加载Spring容器等），要求所有的单元测试类必须放在cn.tedu.sample包或其子孙包中，并且，测试类的声明之前必须添加和SampleApplicationTests类相同的注解！

使用SpringBoot 2.1.x系列版本时，单元测试类之前需要添加2个注解，使用SpringBoot 2.2.x系列版本时，只需要添加1个注解！无论使用哪个版本，参考默认即存在的单元测试类来配置注解即可！

5. 在项目中添加静态资源

静态资源：网页文件(.html文件)、图片文件、.css文件、.js文件等，放在服务器端，可以被客户端直接请求的文件。

在SpringBoot项目中，在src/main/resources下，默认就存在static文件夹，是专门用于存放静态资源的文件夹！

其实，静态资源也可以放到项目的webapp文件夹下，SpringBoot推荐将静态资源放在static下。

可以在static下创建index.html文件，文件内容可以随意设计。

然后，启动项目，打开浏览器，输入网址http://localhost:8080即可看到自行设计的网页。

在启动项目时，控制台中有如下日志：

Tomcat started on port(s): 8080 (http) with context path ''

1

可以看到，内部的Tomcat在部署当前项目时，设置的context path值是空字符串，所以，在访问项目的URL中，不需要添加项目名称！

由于此次尝试访问的资源是index.html，是默认的资源名，所以，在URL中也不必显式的添加资源名！

在SpringBoot项目中，在src/main/resources下，默认就存在application.properties文件，这个文件就是项目的配置文件。

可以在配置文件中修改Tomcat占用的端口，需要添加以下配置：

server.port=80

由于80端口是HTTP协议的默认端口，当修改为80端口后，重新启动项目（先停止，再启动），在浏览器通过http://localhost即可访问到此前的网页！

注意：如果使用的是Linux系列操作系统，或Mac OS等Unix衍生操作系统，这些操作系统对端口号的使用管理相对严格，默认情况下，不允许将端口号修改为80，除非另行在操作系统中进行设置，开放80端口的修改权限。

6. 使用控制器接收客户端的请求

在src/main/java的cn.tedu.sample包下创建子级的controller包，并在这个子包中创建HelloController控制器类，设计请求并处理：

package cn.tedu.sample.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HelloController {
    @RequestMapping("hello")
    @ResponseBody
    public String hello() {
  return "SpringBoot真好用！！！";
    }
}      

重启项目，在浏览器通过http://localhost/hello即可访问到以上控制器的方法。

在SpringBoot项目中，默认已经将DispatcherServlet映射的路径设置为/*，也就是所有资源（当然，static和webapp这些文件夹已经被设置静态资源文件夹，所以，允许直接访问），所以，在使用@RequestMapping注解配置请求路径时，不需要使用.do或其它后缀，当然，添加了后缀也可以，只要访问时保持一致即可。

在SpringBoot项目中，已经将所以可以设置的编码全部设置成了UTF-8，所以，SpringBoot项目默认是完全支持中文的！

当确定服务器端的响应方式是“响应正文”时，在控制器类之前原本添加的@Controller可以替换为@RestController，该注解相当于@Controller + @ResponseBody，当类的声明之前使用的是@RestController时，该类中的每一个方法都不需要再添加@ResponseBody即可“响应正文”。