4-springboot知识点（1）-json解析方案（jackson、gson、fastjson）、静态资源访问、文件上传、@ControllerAdvice、异常数据处理、Cors、拦截器

最新推荐文章于 2024-04-16 02:23:43 发布

一朵欢快的蘑菇

最新推荐文章于 2024-04-16 02:23:43 发布

阅读量173

点赞数

文章标签： ajax CORS 跨域 json fileupload

本文链接：https://blog.csdn.net/weixin_43293227/article/details/107134049

版权

SpringBoot 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

一、JSON解析方案

实际上：HttpMessageConverter起作用
功能：

服务端返回的对象序列化成json字符串
将前端传入的json字符串反序列化成java对象

jackson

pom.xml（web下自带了json）

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

在这里插入图片描述

对日期进行格式化
第一种方法：@JsonFormat(Pattern=“yyyy-MM-dd”)

 public class User {
    private Integer id;
    private String name;
    private String address;

    //第一种方式：json日期格式化。该方法只在jackson中有效
    //弊端：要在每个实体类日期属性上加
    //@JsonFormat(pattern = "yyyy-MM-dd")
    private Date birthday;
  }

第二种方法：MappingJackson2HttpMessageConverter
注：若是需要设置编码的格式，还是需要该方式

 @Bean
    MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() {
        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
        ObjectMapper objectMapper = new ObjectMapper();
        //第二种方式：对日期进行格式化（源码在JacksonHttpMessageConvertersConfiguration中的MappingJackson2HttpMessageConverter）
        //原则上是ObjectMapping在起作用
        SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy/MM/dd");
        objectMapper.setDateFormat(dateFormat);
        converter.setObjectMapper(objectMapper);
        return converter;
    }

第三种方法：ObjectMapper

@Bean
ObjectMapper objectMapper() {
    ObjectMapper objectMapper = new ObjectMapper();
    objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd"));
    return objectMapper;
}

gson

pom.xml
注：需要先把web中的json去除

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-json</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
<!--        导入gson依赖，不需要版本号，因为spring-boot-dependencies中导入了版本号-->
        <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
        </dependency>

时间格式化
第一种方法

//第一种方式：源码在GsonHttpMessageConvertersConfiguration.class中的GsonHttpMessageConverter
	@Bean
    GsonHttpMessageConverter gsonHttpMessageConverter() {
        GsonHttpMessageConverter converter = new GsonHttpMessageConverter();
        converter.setGson(new GsonBuilder().setDateFormat("yyyy-MM-dd").create());
        return converter;
    }

第二种方法

	@Bean
    Gson gson() {
        return new GsonBuilder().setDateFormat("yyyy/MM/dd").create();
    }

fastjson

pom.xml

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-json</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!--导入fastjson依赖-->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.49</version>
</dependency>

FastJsonHttpMessageConverter（必须定义）

@Configuration
public class WebMvcConfig {

    //fastjson:必须要自定义一个FastJsonHttpMessageConverter
    @Bean
    FastJsonHttpMessageConverter fastJsonHttpMessageConverter() {
        FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
        //设置编码格式
/*        List<MediaType> fastMediaTypes = new ArrayList<>();
        fastMediaTypes.add(MediaType.APPLICATION_JSON_UTF8);
        converter.setSupportedMediaTypes(fastMediaTypes);*/
        FastJsonConfig fastJsonConfig = new FastJsonConfig();
        fastJsonConfig.setDateFormat("yyyy-MM-dd");
        converter.setFastJsonConfig(fastJsonConfig);
        return converter;
    }
}

二、静态资源访问

自定义静态文件位置

配置文件

#第一种方式：采用配置文件的方式
#源码在WebMvcAutoConfiguration.class
#自定义静态资源的位置。默认五个:"classpath:/META-INF/resources/", "classpath:/resources/", "classpath:/static/", "classpath:/public/","/"(最后一个/代表在webapp下)
spring.resources.static-locations=classpath:/lyl/
#静态资源中的内容将采用/hello/**（具体文件）进行访问。默认是/**
spring.mvc.static-path-pattern=/hello/**

java代码

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    //第二种：采用java的方式进行静态资源的访问
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/hello/**").addResourceLocations("classpath:/lyl/");
    }
}

三、文件上传

单文件上传

@RestController
public class FileUploadController {

    //上传文件需要注意：
    //1.上传的文件需要分类，不然文件过多，会导致加载很慢
    //2.文件上传要限制大小
    //3.重新命名文件名
    @PostMapping("/upload")
    public String upload(MultipartFile file, HttpServletRequest request) {
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("/yyyy-MM-dd/");
        //获取传入的文件名
        String originalFilename = file.getOriginalFilename();
        //获取重命名的文件名
        String filename = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));
        //存取文件的位置
        String dateFormat = simpleDateFormat.format(new Date());
        //request.getServletContext().getRealPath("/img"):返回的是一个临时文件的路径
        String filePath = request.getServletContext().getRealPath("/img") + dateFormat;
        File folder = new File(filePath);
        //判断文件夹是否存在
        if(!folder.exists()) {
            folder.mkdirs();
        }
        try {
            file.transferTo(new File(folder,filename));
            String url = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + "/img" + dateFormat + filename;
            return url;
        } catch (IOException e) {
            e.printStackTrace();
        }
        return "error";
    }
    
！application.properties
#单个文件上传大小。MB需要大写
spring.servlet.multipart.max-file-size=1MB

！表单的方式：
static/index.html
<!--静态资源存放的五个位置可以直接访问文件名。因为制定了addResourceHandle("/**")。
    访问：localhost:8080/index.html
    注：表单必须为post请求、enctype="multipart/form-data"、输入框的type为file、name必须与控制器的形参对应。
    -->
    <form action="/upload" method="post" enctype="multipart/form-data">
        <input type="file" name="file">
        <input type="submit" value="提交">
    </form>

！ajax的方式
<head>
    <meta charset="UTF-8">
    <title>ajax进行文件上传</title>
    //引入jquery
    <script src="jquery-3.5.1.js"></script>
</head>
<body>
    <div id="result"></div>
    <input type="file" id="file">
    <input type="button" value="上传" onclick="upload()">
    <script>
        function upload() {
            var file = $("#file")[0].files[0];
            var formData = new FormData();
            formData.append("file",file);
            //processData:默认是true。是否将上传的数据处理为对象
            //contentType:设置请求头。该处false:是避免让jquery去设置请求头，因为会破坏分隔符（用来确认上传文件的起始位置）
            $.ajax({
                type:'post',
                url:"/upload",
                processData: false,
                contentType:false,
                data: formData,
                success:function(msg) {
                    $('#result').html(msg);
                }
            })
        }
    </script>
</body>

多文件上传

/**
     * 多文件上传
     * 情况：1.多个input。2.一个input上传多个文件
     * @param files
     * @param request
     * @return
     */
    @PostMapping("/uploads")
    public String uploadS(MultipartFile[] files, HttpServletRequest request) {
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("/yyyy-MM-dd/");
        //存取文件的位置.
        String dateFormat = simpleDateFormat.format(new Date());
        //request.getServletContext().getRealPath("/img"):返回的是一个临时文件的路径
        String filePath = request.getServletContext().getRealPath("/img") + dateFormat;
        File folder = new File(filePath);
        //判断文件夹是否存在
        if(!folder.exists()) {
            folder.mkdirs();
        }

        for (MultipartFile file : files) {
            //获取传入的文件名
            String originalFilename = file.getOriginalFilename();
            //获取重命名的文件名
            String filename = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));
            try {
                file.transferTo(new File(folder,filename));
                String url = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + "/img" + dateFormat + filename;
                System.out.println(url);
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

        return "success";
    }

！多个input
    <form action="/uploads" method="post" enctype="multipart/form-data">s
<!--        name的属性要与/uploads对应的那个控制器的形参一致-->
        <input type="file" name="files"><br>
        <input type="file" name="files"><br>
        <input type="submit" value="提交">
    </form>

！一个input上传多个文件
    <form action="/uploads" method="post" enctype="multipart/form-data">
        <input type="file" name="files" multiple>
        <input type="submit" value="提交">
    </form>

四、@ControllerAdvice

处理全局异常

自定义全局异常

@ControllerAdvice
public class MyException {
    //使用基本的信息输出
/*    @ExceptionHandler(MaxUploadSizeExceededException.class)
    public void exception(MaxUploadSizeExceededException m, HttpServletResponse response) throws IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        out.write("上传文件大小超出限制");
        out.flush();
        out.close();
    }*/

    //使用静态页面进行错误输出
    //thymeleaf模板默认是在templates下
    @ExceptionHandler(MaxUploadSizeExceededException.class)
    public ModelAndView exception(MaxUploadSizeExceededException m) throws IOException {
        ModelAndView modelAndView = new ModelAndView("MyError");
        modelAndView.addObject("error","上传文件大小超出限制");
        return modelAndView;
    }
}

---classpath:/templates/MyError.html
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1 th:text="${error}"></h1>
</body>
</html>

预设全局数据

GlobalData .java

@ControllerAdvice
public class GlobalData {

    //@ControllerAdvice第二种用法：预设全局数据
    //在当前项目的任何一个controller中都能获取得到
    //获取到的是一个map，其中key为info,value为maps
    @ModelAttribute(value = "info")
    public Map<String,Object> myData() {
        Map<String, Object> maps = new HashMap<>();
        maps.put("name","蘑菇");
        maps.put("address","重庆");
        return maps;
    }

HelloController

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello(Model model) {
        //获取到GlobalData中的数据
        Map<String, Object> map = model.asMap();
        Set<String> set = map.keySet();
        for (String string : set) {
            System.out.println(string + ":" + map.get(string));
        }
        return "hello";
    }
}

请求参数预处理

GlobalData

@ControllerAdvice
public class GlobalData {
    //@ControllerAdvice第三种用法：请求参数预处理
    //@InitBinder的内容与@ModelAttribute()的内容对应
    @InitBinder("a")
    public void initA(WebDataBinder binder) {
        binder.setFieldDefaultPrefix("a.");
    }

    @InitBinder("b")
    public void initB(WebDataBinder binder) {
        binder.setFieldDefaultPrefix("b.");
    }
}

BookController

@PostMapping("/book")
public void book(@ModelAttribute("b") Book book, @ModelAttribute("a") Author author) {
    System.out.println(book);
    System.out.println(author);
}

测试时：输入b.name,b.price
		   a.name,a.age

五、异常数据处理

自定义错误页

查看错误页面的规则（优先级）：先动态后静态，先精确（404）后模糊（4xx）
在静态/动态页面下，新建【error/状态码.html】，项目运行出现问题时会自动调用对应的html

自定义异常数据

MyDefaultAttribute

//自定义异常数据
//注册了@Component ，则源码ErrorMvcAutoConfiguration中的DefaultErrorAttribute就会失效。
@Component
public class MyDefaultAttribute extends DefaultErrorAttributes {
    @Override
    public Map<String, Object> getErrorAttributes(WebRequest webRequest, boolean includeStackTrace) {
        Map<String, Object> map = super.getErrorAttributes(webRequest, includeStackTrace);
        map.put("myError","自定义异常处理数据");
        return map;
    }
}

classpath:resources/error/500.html

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>500</title>
</head>
<body>
    <table border="1">
        <tr>
            <td>path</td>
            <td th:text="${path}"></td>
        </tr>
        <tr>
            <td>timestamp</td>
            <td th:text="${timestamp}"></td>
        </tr>
        <tr>
            <td>status</td>
            <td th:text="${status}"></td>
        </tr>
        <tr>
            <td>error</td>
            <td th:text="${error}"></td>
        </tr>
        <tr>
            <td>message</td>
            <td th:text="${message}"></td>
        </tr>
        <tr>
            <td>myError</td>
            <td th:text="${myError}"></td>
        </tr>
    </table>
    <h1>500</h1>
</body>
</html>

自定义异常视图

MyErrorViewResolver

@Component
public class MyErrorViewResolver extends DefaultErrorViewResolver {


    public MyErrorViewResolver(ApplicationContext applicationContext, ResourceProperties resourceProperties) {
        super(applicationContext, resourceProperties);
    }

    //自定义结果视图
    //Map<String, Object> model:是一个不可修改的map
    @Override
    public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status, Map<String, Object> model) {
        ModelAndView mv = new ModelAndView();
        //lyl.html需要放在templates下面
        mv.setViewName("lyl");
        mv.addAllObjects(model);
        return mv;
    }
}

classpath:resources/error/lyl.html

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>自定义异常视图</title>
</head>
<body>
    <h1>自定义异常视图</h1>
    <table border="1">
        <tr>
            <td>path</td>
            <td th:text="${path}"></td>
        </tr>
        <tr>
            <td>timestamp</td>
            <td th:text="${timestamp}"></td>
        </tr>
        <tr>
            <td>status</td>
            <td th:text="${status}"></td>
        </tr>
        <tr>
            <td>error</td>
            <td th:text="${error}"></td>
        </tr>
        <tr>
            <td>message</td>
            <td th:text="${message}"></td>
        </tr>
        <tr>
            <td>myError</td>
            <td th:text="${myError}"></td>
        </tr>
    </table>
    <h1>lyl</h1>
</body>
</html>

六、Cors

第一种方法

@RestController
public class HelloController {

    //第一种方式
    //允许cors2（端口8081）进行访问.
    //@CrossOrigin：可以放在方法和类上.
    //缺点：多个controller要写多次
    //愿意接收来自http://localhost:8081的请求
    //@CrossOrigin(origins = "http://localhost:8081")
    @GetMapping("/get")
    public String get() {
        return "hello get";
    }

    @PutMapping("/put")
    public String put() {
        return "hello put";
    }
}

第二种方法

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    /**
     * 配置跨域请求
     * @param registry
     */
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        //第二种方式：仅需设置一次
        //addMapping:哪些接口允许跨域
        //maxAge：有效时间（例：如果发送的请求是PUT请求，那么会发送两次，第一次发送PUT，是一个探测请求，发送到服务器判断是否支持PUT请求
        // ，存在就发送第二次请求。maxAge代表的是探测请求的有效时间，在有效时间内，就不用发送探测请求了。
        // ）
        registry.addMapping("/**").allowedOrigins("http://localhost:8081")
                .allowedHeaders("*")
                .allowedMethods("*")
                .maxAge(30*1000);
    }
}

Cors2访问Cors1

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Cors</title>
    <script src="jquery-3.5.1.js"></script>
</head>
<body>
    <div id="app"></div>
    <input type="button" value="GET" onclick="getData()">
    <input type="button" value="PUT" onclick="putData()">
    <script>
        function getData() {
            $.get("http://localhost:8080/get",function(msg) {
                $('#app').html(msg);
            });
        }

        function putData() {
            $.ajax({
                type:'put',
                url:"http://localhost:8080/put",
                success:function(msg) {
                    $('#app').html(msg)
                }
            })
        }
    </script>
</body>
</html>

六、拦截器

MyInterceptor

public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("preHandle");
        //return true :以下两个方法才能执行
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("postHandle");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion");
    }
}

WebMvcConfig

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        //addPathPatterns:需要拦截的
        registry.addInterceptor(myInterceptor()).addPathPatterns("/**");
    }

    @Bean
    MyInterceptor myInterceptor() {
        return new MyInterceptor();
    }
}

一朵欢快的蘑菇

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
4-springboot知识点（1）-json解析方案（jackson、gson、fastjson）、静态资源访问、文件上传、@ControllerAdvice、异常数据处理、Cors、拦截器

一、JSON解析方案jacksongsonfastjson
复制链接

扫一扫