SpringBoot技术框架总结(三)
✍、SpringBoot技术框架总结(三)
| SpringBoot框架技术总结 | 地址 |
|---|---|
| SpringBoot框架技术总结(一) | https://blog.csdn.net/Augenstern_QXL/article/details/120802556 |
| SpringBoot框架技术总结(二) | https://blog.csdn.net/Augenstern_QXL/article/details/120816431 |
| SpringBoot框架技术总结(三) | https://blog.csdn.net/Augenstern_QXL/article/details/120866816 |
| SpringBoot框架技术总结(四) | https://blog.csdn.net/Augenstern_QXL/article/details/120866908 |
| SpringBoot框架技术总结(五) | https://blog.csdn.net/Augenstern_QXL/article/details/120867244 |
1、SpringBoot实现Web常用功能
通常在Web开发中，会涉及到静态资源的访问支持、视图解析器的配置、转换器和格式化的定制、文件上传和下载等功能，甚至还需要考虑web服务器关联的Servlet相关组件的定制。SpringBoot框架支持整合一些常用的Web技术，从而实现Web开发，并默认支持Web开发中的一些通用功能。
1.1、SpringMVC整合支持
为了简化Web开发，SpringBoot为一些常用的Web开发技术提供了整合支持，例如SpringMVC框架。使用SpringBoot在进行Web开发时，只需要引入对应的Web开发技术的依赖启动器即可。
在SpringBoot应用程序中，一旦引入了Web依赖启动器spring-boot-starter-web，那么SpringBoot整合SpringMVC框架默认实现的一些 xxxAutoConfiguration 自动配置类就会自动生效，几乎可以在无任何额外配置的情况下进行Web开发，SpringBoot为整合SpringMVC框架实现Web开发，主要提供了以下自动化配置功能特性：
- 内置了两个视图解析器：ContentNegotiationViewResolver 和 BeanNameViewResolver
- 支持静态资源以及WebJars
- 自动注册了转换器和格式化器
- 支持HTTP消息转换器
- 支持静态项目首页 index.html
- 支持定制应用图标 favicon.ico
- 自动初始化Web数据绑定器 ConfigurableWebBindingInitializer
1.2、定制视图控制
在SpringBoot项目中，页面放在 template 目录下是无法访问到的，必须通过控制器来跳转。那么我们如果不想写控制器，也可以通过自定义MVC扩展类来实现。
使用SpringBoot整合SpringMVC进行Web开发，页面跳转可以通过自定义MVC扩展配置类的方式实现，自定义配置类需要继承 WebMvcConfigurationSupport类或实现 WebMvcConfigurer 接口，代码如下：
/**
* 自定义MVC扩展类
*/
@Configuration
public class MyMVCConfig implements WebMvcConfigurer{
/**
* 添加视图管理
* @param registry
*/
@Override
public void addViewControllers(ViewControllerRegistry registry){
// 请求/login 或login.html 映射路径都会自动映射到 login.html页面
registry.addViewController("/login").setViewName("login");
registry.addViewController("/login.html").setViewName("login");
}
}
上述代码中采用 addViewController() 方法实现视图管理器的注册，改方式相比传统的请求处理方法而言，这种方法更加简洁、直观和方便，但是使用这种方式跳转页面无法获取后台处理的数据，需要注意的是，addViewControllers() 方法定制视图控制，只适合比较简单的无参数视图Get方式的请求跳转，对于有参数或需要处理业务的请求，最好还是采用传统方式处理请求。
在SpringBoot2.0版本之前，使用WebMvcConfigurerAdapter类实现视图管理器注册，该类在SpringBoot2.0版本已经过时，推荐使用 WebMvcConfigurationSupport或者实现WebMvcConfigurer接口的方法实现功能扩展开发。
1.3、拦截器的使用
在SpringBoot整合SpringMVC进行Web开发，实现拦截器的配置与定制视图控制的方式一致，都是采用继承 WebMvcConfigurationSupport 类或者实现 WebMvcConfigurer接口的方式实现，使用 addInterceptors() 方法注册自定义拦截器。
2、文件上传与下载
在开发Web应用时，文件上传和下载是很常见的一个需求。浏览器通过表单形式将文件以流的形式传递给服务器，服务器再对上传的数据进行解析处理。下载文件通过 IO 流实现，大多数框架并没有对文件下载进行封装处理，并且文件下载时涉及不同浏览器的解析处理，可能会出现中文乱码的情况。
2.1、文件上传
实现文件上传，需要满足三个要素。
- 首先表单提交方式必须是 POST
- 其次是表单需要设置 enctype 属性，且值为
multipart/form-data - 最后表单需要设置一个文件域，也就是表单项
type = "file"
需要注意的是，SpringBoot并没有提供文件上传所需要的 jar 包或依赖，需要再项目中加入文件上传的相关 jar 包或 maven 依赖，代码如下所示：
<dependency>
<groupId>commons-iogroupId>
<artifactId>commons-ioartifactId>
<version>2.6version>
dependency>
<dependency>
<groupId>commons-fileuploadgroupId>
<artifactId>commons-fileuploadartifactId>
<version>1.3.3version>
dependency>
-
编写文件上传的表单页面
在项目中的 resources/templates 目录创建一个名为 upload.html 页面
<form th:action="@{/upload}" method="post" enctype="multipart/form-data">
<div>
<label>选择文件：label>
<input type="file" name="attach">
div>
<div style="margin-top:20px">
<input type="submit" value="确认上传">
div>
form>
-
在全局配置文件中添加文件上传的相关配置
application.properties
#设置单个文件大小
spring.servlet.multipart.max-file-size=50MB
#设置总上传数据大小
spring.servlet.multipart.max-request-size=50MB
#自定义属性
#设置文件上传位置(绝对路径)
file.upload.path=E:/temp/
#设置文件上传后回显位置(相对路径)
file.upload.path.relative=/images/**
需要注意的是，通过 spring.servlet.multipart.max-file-size 属性设置单个上传文件的大小限制，默认1MB，通过 spring.servlet.multipart.max-request-size 属性设置所有上传文件的大小限制，默认为 10MB。开发过程中，需要结合实际需求合理设置文件大小。
-
进行文件上传处理，实现文件上传功能
在 controller 包下创建控制器
@Controller
public class FileController{
// 文件上传位置
@Value("${file.upload.path}")
private String filePath;
/**
* 向文件上传页面跳转
* @return
*/
@RequestMapping("/toUpload")
public String toUpload(){
return "upload";
}
/**
* 文件上传
* @param attach
* @param model
* @return
*/
@RequestMapping("/upload")
public String upload(MultipartFile attach,Model model){
// 判断文件是否为空,不为空则进行文件上传
if(!attach.isEmpty()){
// 获取源文件名称
String fileName = attach.getOriginalFilename();
// 获取源文件后缀名
String suffix = FilenameUtils.getExtension(fileName);
// 使用UUID重命名文件名称
String newFileName = UUID.randomUUID().toString().replace("-","")+(".")+suffix;
// 使用日期解决同一文件夹中文件过多问题(以当前日期命名文件夹)
String datePath = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
// 组装最终文件名
String finalName = datePath+"/"+newFileName;
// 构建文件对象
File dest = new File(filePath + finalName);
// 判断该文件夹是否存在,不存在则创建
if(!dest.getParentFile().exists()){
dest.getParentFile.mkdirs(); // 创建文件夹
}
try{
// 将文件保存到硬盘
attach.transferTo(dest);
// 将当前图片放到模型中,便于页面回显
model.addAttribute("image",finalName);
}catch(IOException e){
e.printStackTrace();
}
}
// 返回页面(该页面是templates目录下的页面)
return "show"
}
}
如果上传的文件是图片，且需要在页面中将图片显示，则需要对图片进行数据回显，需要完成两个步骤，分别是：
-
创建并编写图片回显页面
在项目中的 resources/templates 目录下创建 show.html 页面，代码如下所示：
DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>图片回显title>
head>
<body>
![]()
body>
html>
-
创建并编写文件上传配置类
在项目中的 config 包下新建 UploadConfig 类
@Configuration
public class UploadConfig implements WebMvcConfigurer{
// 上传地址
@Value("${file.upload.path}")
private String filePath;
// 显示相对地址
@Value("${file.upload.path.relative}")
private String fileRelativePath;
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry){
// 读取本地文件需要加上 file:/
registry.addResourceHandler(fileRelativePath).addResourceLoacation("file:/"+filePath;)
}
}
2.2、文件下载
在Web开发中，文件下载能够通过IO流实现，所以多数框架并没有对文件下载进行封装处理。文件下载时涉及不同浏览器的解析处理，可能会出现中文乱码情况，并且不同浏览器之间的解析处理方式也会有所不同，例如谷歌和IE浏览器。
-
添加文件下载依赖
在 pom.xml 文件中引入文件下载的工具依赖 commons-io
<dependency>
<groupId>commons-iogroupId>
<artifactId>commons-ioartifactId>
<version>2.6version>
dependency>
-
创建文件下载页面
在 resuources/templates 目录下创建 download.html 页面，代码如下：
<h2>文件下载h2>
<a href= "#" th:href="@{/download{filename='MyBatis.pdf'}}">文件下载(英文)a>
<hr>
<a href= "#" th:href="@{/download{filename='SQL映射文件.pdf'}}">文件下载(中文)a>
-
创建控制器
在 controller 包下创建 DownloadController 控制器
3、SpringBoot应用的打包和部署
传统的Web应用进行打包部署时，通常会打成War包的形式，然后将War包部署到 Tomcat 等服务器中，而 SpringBoot 应用使用的是嵌入式Servlet容器。默认以 jar 包方式进行打包部署。
由于SpringBoot应用已经嵌入了Tomcat服务器，所以将SpringBoot应用以默认jar包形式进行打包部署则非常简便。
- 创建 SpringBoot 应用程序时，打包方式设置为 jar
- 创建HelloController
@RestController
public class HelloController{
@GetMapping("/hello")
public String hello(){
return "Hello,SpringBoot";
}
@GetMapping("/index")
public String index(){
return "Hello,Spring MVC";
}
}
-
修改 Tomcat 端口号
在 application.properties 全局配置文件中修改 Tomcat 端口的目的是避免多个 Spring Boot 同时运行导致端口冲突的异常。
#修改端口号
server.port = 8888
- 添加springmvc支持及maven打包插件
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-webartifactId>
dependency>
<build>
<plugins>
<plugin>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-maven-pluginartifactId>
plugin>
plugins>
build>
-
打开IDEA开发工具界面右侧边栏，单击右侧边框 Maven 视图，在对应项目目录选择 Lifecycle 下的 package 选项，双击运行即可
-
打包完成可以使用IDEA开发工具提供的Terminal终端界面或者利用系统自带的终端窗口进行项目 jar 部署运行，运行命令如下：
java -jar jar包名称
java -jar springboot.jar
- 启动成功后，我们进行测试： localhost:8888/hello
4、SpringBoot缓存管理
缓存是分布式系统中的重要组件，主要解决数据库数据的高并发访问，在实际开发中，尤其是用户访问量较大的网站，用户对高频热点数据的访问非常频繁，为了提高服务器的访问性能，减少数据库的压力、提高用户体验，使用缓存显得尤为重要。
Spring框架支持透明地向应用程序添加缓存并对缓存进行管理，其管理缓存的核心是将缓存应用于操作数据的方法中，从而减少操作数据的次数，同时不会对程序本身造成任何影响。
SpringBoot继承了Spring框架的缓存管理功能，通过使用 @EnableCaching 注解开启基于注解的缓存支持，SpringBoot可以启动缓存管理的自动化配置。
使用SpringBoot默认缓存的步骤如下所示：
- 在项目启动器类上使用
@EnableCaching注解开启基于注解的缓存支持。 - 在 Service 类的查询方法上使用
@Cacheable注解对数据操作方法进行缓存管理。
- 开启注解缓存支持
@EnableCaching // 开启缓存配置
@SpringBootApplication
public class Springboot{
public static void main(String[] args){
SpringApplication.run(SpringBoot.class,args);
}
}
-
使用
@Cacheable注解进行缓存管理在Service类的查询方法上使用
@Cacheable注解对数据操作方法进行缓存管理
// 使用注解进行缓存管理
@Cacheable(cacheNames="user")
public User findById(Integer id){
return userMapper.findById(id);
}
上述代码中，在 UserServiceImpl 实现类中的 findById() 方法上添加了缓存注解@Cacheable，该注解的作用是将查询结果 User 放在SpringBoot默认缓存中名称为 user 的命名空间中，对应缓存的唯一标识默认为方法的参数id的值。