SpringBoot技术框架总结(三)

  • Post author:
  • Post category:其他




✍、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开发,主要提供了以下自动化配置功能特性:

  1. 内置了两个视图解析器:ContentNegotiationViewResolver 和 BeanNameViewResolver
  2. 支持静态资源以及WebJars
  3. 自动注册了转换器和格式化器
  4. 支持HTTP消息转换器
  5. 支持静态项目首页 index.html
  6. 支持定制应用图标 favicon.ico
  7. 自动初始化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-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.6</version>
</dependency>
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.3</version>
</dependency>
  1. 编写文件上传的表单页面

    在项目中的 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>
  1. 在全局配置文件中添加文件上传的相关配置

    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。开发过程中,需要结合实际需求合理设置文件大小。

  1. 进行文件上传处理,实现文件上传功能

    在 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"
    }
}

如果上传的文件是图片,且需要在页面中将图片显示,则需要对图片进行数据回显,需要完成两个步骤,分别是:

  1. 创建并编写图片回显页面

    在项目中的 resources/templates 目录下创建 show.html 页面,代码如下所示:

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>图片回显</title>
</head>
<body>
    <img th:src="@{/images/}+${image}"
</body>
</html>
  1. 创建并编写文件上传配置类

    在项目中的 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浏览器。

  1. 添加文件下载依赖

    在 pom.xml 文件中引入文件下载的工具依赖 commons-io

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.6</version>
</dependency>
  1. 创建文件下载页面

    在 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>
  1. 创建控制器

    在 controller 包下创建 DownloadController 控制器



3、SpringBoot应用的打包和部署

​ 传统的Web应用进行打包部署时,通常会打成War包的形式,然后将War包部署到 Tomcat 等服务器中,而 SpringBoot 应用使用的是嵌入式Servlet容器。默认以 jar 包方式进行打包部署。

​ 由于SpringBoot应用已经嵌入了Tomcat服务器,所以将SpringBoot应用以默认jar包形式进行打包部署则非常简便。

  1. 创建 SpringBoot 应用程序时,打包方式设置为 jar

在这里插入图片描述

  1. 创建HelloController
@RestController
public class HelloController{
    @GetMapping("/hello")
    public String hello(){
        return "Hello,SpringBoot";
    }
    
    @GetMapping("/index")
    public String index(){
        return "Hello,Spring MVC";
    }
}
  1. 修改 Tomcat 端口号

    在 application.properties 全局配置文件中修改 Tomcat 端口的目的是避免多个 Spring Boot 同时运行导致端口冲突的异常。

#修改端口号
server.port = 8888
  1. 添加springmvc支持及maven打包插件
<dependency>
	<groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<build>
    <plugins>
    	<plugin>
        	<groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>
  1. 打开IDEA开发工具界面右侧边栏,单击右侧边框 Maven 视图,在对应项目目录选择 Lifecycle 下的 package 选项,双击运行即可

  2. 打包完成可以使用IDEA开发工具提供的Terminal终端界面或者利用系统自带的终端窗口进行项目 jar 部署运行,运行命令如下:

java -jar jar包名称
java -jar springboot.jar
  1. 启动成功后,我们进行测试: localhost:8888/hello



4、SpringBoot缓存管理

​ 缓存是分布式系统中的重要组件,主要解决数据库数据的高并发访问,在实际开发中,尤其是用户访问量较大的网站,用户对高频热点数据的访问非常频繁,为了提高服务器的访问性能,减少数据库的压力、提高用户体验,使用缓存显得尤为重要。

​ Spring框架支持透明地向应用程序添加缓存并对缓存进行管理,其管理缓存的核心是将缓存应用于操作数据的方法中,从而减少操作数据的次数,同时不会对程序本身造成任何影响。

​ SpringBoot继承了Spring框架的缓存管理功能,通过使用

@EnableCaching

注解开启基于注解的缓存支持,SpringBoot可以启动缓存管理的自动化配置。

​ 使用SpringBoot默认缓存的步骤如下所示:

  1. 在项目启动器类上使用

    @EnableCaching

    注解开启基于注解的缓存支持。
  2. 在 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的值。



版权声明:本文为Augenstern_QXL原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。