SpringBoot+vue信息管理系统(3)

1、SpringBoot整合视图层技术

目前流行的模板引擎有两种:1、官方推荐的模板引擎Thymeleaf 2、FreeMarker,下面就来讲解一下这两者的区别:

1.1 Thymeleaf

作为新一代的Java模板引擎,类似于Velocity、FreeMarker等传统Java引擎。与传统的Java引擎不同的是:Thymeleaf支持HTML原型,同时SpringBoot也提供了Thymeleaf自动化配置解决方案,因此在springboot中使用Thymeleaf非常方便。SpringBoot整合Thymeleaf,主要步骤如下:

(1)pom.xml 引入依赖


            org.springframework.boot
            spring-boot-starter-web
           
        
        
            org.springframework.boot
            spring-boot-starter-thymeleaf
        

(2)配置Thymeleaf

SpringBoot为Thymeleaf提供了自动化配置类ThymeleafAutoConfiguration,相关的配置属性在ThymeleafProperties类中,ThymeleafProperties部分源码如下:

public class ThymeleafProperties {
    private static final Charset DEFAULT_ENCODING;
    public static final String DEFAULT_PREFIX = "classpath:/templates/";
    public static final String DEFAULT_SUFFIX = ".html";
    private boolean checkTemplate = true;
    private boolean checkTemplateLocation = true;
    private String prefix = "classpath:/templates/";
    private String suffix = ".html";
    private String mode = "HTML";
    private Charset encoding;
    private boolean cache;
    private Integer templateResolverOrder;
    private String[] viewNames;
    private String[] excludedViewNames;
    private boolean enableSpringElCompiler;
    private boolean renderHiddenMarkersBeforeCheckboxes;
    private boolean enabled;
    private final ThymeleafProperties.Servlet servlet;
    private final ThymeleafProperties.Reactive reactive;

    public ThymeleafProperties() {
        this.encoding = DEFAULT_ENCODING;
        this.cache = true;
        this.renderHiddenMarkersBeforeCheckboxes = false;
        this.enabled = true;
        this.servlet = new ThymeleafProperties.Servlet();
        this.reactive = new ThymeleafProperties.Reactive();
    }

由此可知默认的模板位置为:classpath:/templates/,默认模板文件的后缀为.html,如果用开发工具idea创建springBoot项目,模板目录会自动创建

如果开发者想自定义,可以在application.properties,中配置如下:

是否开启缓存,开发时可设置成false,默认为TRUE
spring.thymeleaf.cache=true
#检验模板是否存在,默认为true
spring.thymeleaf.check-template=true
#检验模板位置是否存在,默认为TRUE
spring.thymeleaf.check-template-location=true
#模板文件编码
spring.thymeleaf.encoding=UTF-8
#模板文件地址
spring.thymeleaf.prefix=classpath:/templates/
#Content-Type 配置
spring.thymeleaf.servlet.content-type=text/html
#模板文件后缀
spring.thymeleaf.suffix=.html

(3)配置控制器

创建实体类Book,然后创建Controller中的类,然这个类的返回类型变成ModelAndView,代码如下:

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "book")
public class Book {
	private Integer id;
	private String name;
	private String author;
	private Float price;
//省略 get\set方法
}
import org.sang.model.Book;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.servlet.ModelAndView;
import java.util.ArrayList;
import java.util.List;

@Controller
public class HelloController {

	@Autowired
	Book book;

	@GetMapping("/books")
	public ModelAndView hello(){
		List books=new ArrayList<>();
		Book book1=new Book();
		book1.setId(1);
		book1.setName("三国演义");
		book1.setAuthor("罗贯中");
		book1.setPrice(12f);
		books.add(book1);
		ModelAndView modelAndView=new ModelAndView();
		modelAndView.addObject("books",books);//页面遍历的属性名
		modelAndView.setViewName("books");//模板文件名
		return modelAndView;
	}
}

(4)创建视图


 //这是 th标签使用的关键,一定要引入

    
    Title


 //books为属性名 book为别名 //th:each 为遍历 //th:text 为输出
        
图书编号 图书名称 图书作者 图书价格

(5)运行结果

浏览器输入:https://localhost:8081/chapter02/books

SpringBoot+vue信息管理系统(3)_第1张图片

关于Thymeleaf的相关信息可以https://www.thymeleaf.org 观看

1.2 整合FreeMarker

FreeMarker作为一个古老的模板引擎,可以用于web环境或者为web环境中。与Thymeleaf不同的是Freemarker需要经过解析才能在浏览器上看到数据显示。Freemarker不仅用来配置HTML页面模块,也可以用来配置电子邮件模块、配置文模板以及源码模板等。SpringBoot对FreeMarker也有很好的支持。步骤如下:

(1)在pom.xml添加项目依赖:


         org.springframework.boot
         spring-boot-starter-freemarker


         org.springframework.boot
         spring-boot-starter-web

        

(2)、配置FreeMarker

SpringBoot对FreeMarker也提供了自动化配置类FreeMarkerAutoConfiguration,相关的配置属性也在此类中,请看如下源码:

@ConfigurationProperties(
    prefix = "spring.freemarker"
)
public class FreeMarkerProperties extends AbstractTemplateViewResolverProperties {
    public static final String DEFAULT_TEMPLATE_LOADER_PATH = "classpath:/templates/";
    public static final String DEFAULT_PREFIX = "";
    public static final String DEFAULT_SUFFIX = ".ftlh";
    private Map settings = new HashMap();
    private String[] templateLoaderPath = new String[]{"classpath:/templates/"};
    private boolean preferFileSystemAccess = true;

    public FreeMarkerProperties() {
        super("", ".ftlh");
    }

    public Map getSettings() {
        return this.settings;
    }

    public void setSettings(Map settings) {
        this.settings = settings;
    }

    public String[] getTemplateLoaderPath() {
        return this.templateLoaderPath;
    }

    public boolean isPreferFileSystemAccess() {
        return this.preferFileSystemAccess;
    }

    public void setPreferFileSystemAccess(boolean preferFileSystemAccess) {
        this.preferFileSystemAccess = preferFileSystemAccess;
    }

    public void setTemplateLoaderPath(String... templateLoaderPaths) {
        this.templateLoaderPath = templateLoaderPaths;
    }
}

从源码上可以看出FreeMarker默认的模板文件地址和Thymeleaf一样,都是classpath:/template/,但是模板文件的后缀确实.ftlh;如果开发者想自定义配置可以在application.propertie中配置,配置如下:

#HttpServletRequest的属性是否可以考虑覆盖controller中model的同名项
spring.freemarker.allow-request-override=false
#HttpSession的属性是否可以覆盖controller中model的同名项
spring.freemarker.allow-session-override=false
#是否开启缓存
spring.freemarker.cache=false

#检验模板位置是否存在,默认为TRUE
spring.freemarker.check-template-location=true
#模板文件编码
spring.freemarker.encoding=UTF-8
#Content-Type 配置
spring.freemarker.servlet.content-type=text/html
#是否将HttpServletRequest中的属性添加到model中
spring.freemarker.expose-request-attributes=false
#是否将HttpSession中的属性添加到model中
spring.freemarker.expose-session-attributes=false
#模板文件后缀
spring.freemarker.suffix=.ftl
#模板文件地址
spring.freemarker.template-loader-path=classpath:/templates/

(3)配置控制器

控制器和thymeleaf一样,这里就不重复写

(4)创建视图

在模块目录下创建books.ftl,内容如下:




    
    Title



    <#if books ??&& (books?size>0)> //判断集合是否为空
    <#list books as book> //给集合取别名
    //集合属性
        
图书编号 图书名称 图书作者 图书价格
${book.id}${book.name} ${book.author}

(5)运行和thymeleaf一样

2、SpringBoot整合Web开发

2.1、返回JSON数据

(1)默认实现

目前JSON方式是最流行的的前后端数据传输方式,SpringMvc中使用消息转换器HttpMessageConverter对JSON的转换器提供了很好的支持,SpringBoot对相关的配置做了更一步的简化,web依赖,pom.xml如下:


            org.springframework.boot
            spring-boot-starter-web
 

这个依赖中默认加入了jackson-databind作为JSON处理器,此时不需要添加格外的JSON处理器,就可以返回一段JSON,创建实体类:

import com.fasterxml.jackson.annotation.JsonFormat;
import com.fasterxml.jackson.annotation.JsonIgnore;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

import java.util.Date;

@Component
@ConfigurationProperties(prefix = "book")
public class Book {
	private Integer id;
	private String name;
	private String author;
	@JsonIgnore
	private Float price;

	@JsonFormat(pattern = "yyyy-MM-dd")
	private Date publicationDate;

//省略 set 、get方法
}

创建Controller,创建类执行方法,返回结果:

import org.sang.model.Book;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.ModelAndView;

import java.util.Date;
import java.util.ArrayList;
import java.util.List;

@Controller
public class HelloController {

	@Autowired
	Book book;

	@GetMapping("/book")
	@ResponseBody
	public Book Book(){
		Book book1=new Book();
		book1.setId(1);
		book1.setName("三国演义");
		book1.setAuthor("罗贯中");
		book1.setPrice(12f);
		book1.setPublicationDate(new Date());
		return book1;
	}
}

注意:如果频繁使用@ResponseBody注解,可以采用@RestController组合注解代替@Controller和@ResponseBody

这是SpringBoot自带的处理方式,如果采用这种方式,对于字段忽略、日期格式化等常见问题都可以用注解解决

这就是通过Spring中提供的默认的MappingJackson2HttpMessageConverter来实现的,当然开发者也可以根据需求自定义JSON转换器,常见的JSON处理器除了jackson-databind之外,还有Gson和fastjson

(2)自定义转换器(Gson

Gson是谷歌的一个开源的JSON解析框架。使用Gson,需要先去除默认的jackson-databind,依赖如下:


            org.springframework.boot
            spring-boot-starter-web
          
            
                
                    com.fasterxml.jackson.core
                    jackson-databind
                
            
        

            com.google.code.gson
            gson
            2.6.2
        

由于SpringBoot中默认提供了Gson的自动转换类GsonHttpMessageConvertersConfiguration,所以使用Gson就需要把jackson-databing去掉,如果对日期数据进行格式化,那就需要开发者自定义 HttpMessageConverter

首次看GsonHttpMessageConverterConfiguration源码:

@Bean
@ConditionalOnMessingBean
public GsonHttpMessageConverter gsonHttpMessageConverter(Gson gson){
    GsonHttpMessageConverter converter=new GsonHttpMessageConverter();
    converter.setGson(gson);
    return converter;
}

@ConditionalOnMissingBean 注解表示该项目中没有提供GsonHttpMessageConverter时才会使用默认的GsonHttpMessageConverter,所以开发者只需要提供一个GsonHttpMessageConverter即可,代码如下:

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.json.GsonHttpMessageConverter;

import java.lang.reflect.Modifier;

@Configuration
public class GsonConfig {
	
	@Bean
	GsonHttpMessageConverter gsonHttpMessageConverter(){
		GsonHttpMessageConverter converter=new GsonHttpMessageConverter();
		GsonBuilder builder=new GsonBuilder();
		builder.setDateFormat("yyyy-MM-dd");
		builder.excludeFieldsWithModifiers(Modifier.PROTECTED);
		Gson gson=builder.create();
		converter.setGson(gson);
		return converter
	}
}

结果:

SpringBoot+vue信息管理系统(3)_第2张图片

(3)自定义转换器(fastjson)

fastjson是阿里巴巴中的一个开源JSON解析框架,是目前JSON解析速度最快的开源框架,该框架也可以集成到SpringBoot中,不同于Gson、fastjson继承完成之后并不能马上使用,需要开发者提供相应的HttpMessageConverter后才能使用,集成fastjson步骤如下:

除去jackson-databind依赖,引入fastjson依赖:

 
            org.springframework.boot
            spring-boot-starter-web
          
            
                
                    com.fasterxml.jackson.core
                    jackson-databind
                
            
        
        
            com.alibaba
            gson
            2.6.2
        

然后配置fastjson的HttpMessageConverter

import com.alibaba.fastjson.serializer.SerializerFeature;
import com.alibaba.fastjson.support.config.FastJsonConfig;
import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.json.GsonHttpMessageConverter;

import java.lang.reflect.Modifier;
import java.nio.charset.Charset;

@Configuration
public class GsonConfig {
	@Bean
	FastJsonHttpMessageConverter fastJsonHttpMessageConverter(){
		FastJsonHttpMessageConverter converter=new FastJsonHttpMessageConverter();
		FastJsonConfig fastJsonConfig=new FastJsonConfig();
		fastJsonConfig.setDateFormat("yyyy-MM-dd"); //配置日期格式
		fastJsonConfig.setCharset(Charset.forName("UTF-8")); //数据格式
		fastJsonConfig.setSerializerFeatures(
				SerializerFeature.WriteClassName, //是否在生成的JSon中输出类名
				SerializerFeature.WriteMapNullValue, //是否输出value为null的数据
				SerializerFeature.PrettyFormat, //生成的JSON格式化
				SerializerFeature.WriteNullListAsEmpty, //空集合输出,而非null
				SerializerFeature.WriteNullStringAsEmpty //空字符串“”而为null
		);
		converter.setFastJsonConfig(fastJsonConfig);
		return converter;
	}
}

除了GsonConfig配置的,还需要配置一下响应编码,否则返回的JSON中文会乱码,需要在application.properties添加如下配置:

spring.http.encoding.force-response=true

结果:

SpringBoot+vue信息管理系统(3)_第3张图片

对于FastJsonHttpMessageConverter的配置,除了上面的方式,下面还有一种方式:

项目还是需要引入spring-boot-starter-web依赖,还需要引入spring-boot-autoconfigure,在这个自动化配置中,有一个WebMvcAutoConfiguration类提供了对SpringMVC最基础的配置,如果自动化配置不满开发需求,开发者可以自定义配置,只需要实现WebMvcConfigurer接口即可在(在Spring5之前通过继承WebMvcConfigurerAdapter类实现的),源码如下:

import com.alibaba.fastjson.serializer.SerializerFeature;
import com.alibaba.fastjson.support.config.FastJsonConfig;
import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter;
import org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;

import java.nio.charset.Charset;
import java.util.List;

@Configuration
public class MyWebMvcConfig implements WebMvcConfigurer {

	public void configureMessageConverter(List > converters){
		FastJsonHttpMessageConverter converter=new FastJsonHttpMessageConverter();
		FastJsonConfig config=new FastJsonConfig();
		config.setDateFormat("yyyy-MM-dd");
		config.setCharset(Charset.forName("UTF-8"));
		config.setSerializerFeatures(
				SerializerFeature.WriteClassName,
				SerializerFeature.WriteMapNullValue,
				SerializerFeature.PrettyFormat,
				SerializerFeature.WriteNullListAsEmpty,
				SerializerFeature.WriteNullStringAsEmpty
		);
		converter.setFastJsonConfig(config);
		converters.add(converter);
	}
}

代码解析:

自定义MyWebMvcConfig 类并实现WebMvcConfigurer接口中的configureMessageConverters方法

将自定义FastJsonHttpMessageConverter加入converters中

 注意:

Gson也采用这种方式,但不推荐。因为当项目中没有GsonHttpMessageConverter时,SpringBoot自己提供一个GsonHttpMessageConverter,此时重写configureMessageConverters方法,参数converters中已经有GsonHttpMessageConverter的实例了,需要替换已有的GsonHttpMessageConverter实例,操作比较麻烦,所以对于Gson,推荐直接提供GsonHttpMessageConverter

2.2、静态资源访问

对于静态资源访问,SpringBoot提供了自动化配置,可以简化静态资源过滤配置

(1)默认策略

SpringBoot对于SpringMVC的自动化配置都在WebMvcAutoConfiguration类中,因此对于默认的静态资源过滤策略可以从这个类中一探究竟

在WebMVCAutoConfiguration类中有个静态内部类WebMvcAutoConfigurationAdapter,实现了WebMvcConfigurer接口。WebMvcConfigurer接口中有个方法addResourceHandlers,是用来配置静态资源过滤的。方法在WebMvcAutoConfigurationAdapter类中得到了实现,部分代码如下:

 public void addResourceHandlers(ResourceHandlerRegistry registry) {
            if (!this.resourceProperties.isAddMappings()) {
                logger.debug("Default resource handling disabled");
            } else {
                Duration cachePeriod = this.resourceProperties.getCache().getPeriod();
                CacheControl cacheControl = this.resourceProperties.getCache().getCachecontrol().toHttpCacheControl();
                if (!registry.hasMappingForPattern("/webjars/**")) {
                    this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{"/webjars/**"}).addResourceLocations(new String[]{"classpath:/META-INF/resources/webjars/"}).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl));
                }

                String staticPathPattern = this.mvcProperties.getStaticPathPattern();
                if (!registry.hasMappingForPattern(staticPathPattern)) {
                    this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{staticPathPattern}).addResourceLocations(WebMvcAutoConfiguration.getResourceLocations(this.resourceProperties.getStaticLocations())).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl));
                }

            }
        }

SpringBoot在这里进行了默认的静态资源的过滤配置,其中staticPathPattern默认定义在WebMvcProperties中,内容如下:

private String staticPathPattern="/**"

 this.resourceProperties.getStaticLocations():获取默认静态资源地址定义在ResourceProperties中

 private static final String[] CLASSPATH_RESOURCE_LOCATIONS = new String[]{"classpath:/META-INF/resources/", "classpath:/resources/", "classpath:/static/", "classpath:/public/"};
    

在getResourceLocations方法中,对于4个静态资源地址做了扩充:

static String[] getResourceLocations(String[] staticLocations){
    String[] locations=new String[staticLocations.length+SERVLET_LOCATIONS.length];
    System.arraycopy(staticLocations,0,locations,0,staticLocations.length);
    System.arraycody(SERVLET_LOCATIONS,0,locations,staticLocations.length,
    SERVLET_LOCATIONS.length);
    return locations;
}

其中,SERVLET_LOCATIONS定义就是{"/"}

综上而已:SpringBoot默认过滤所有的静态资源,一般静态资源地址分为:"classpath:/META-INF/resources/","classpath:/resources/","classpath:/static/","classpath:/public/"、"/",优先级依次降低

(2)自定义策略

1、在配置文件(application.properties)中配置(过滤规则:/static/**   静态资源地址:classpath:/static/)

spring.mvc.static-path-pattern=/static/**
spring.resources.static-locations=classpath:/static/

2、java编码定义:

import com.alibaba.fastjson.serializer.SerializerFeature;
import com.alibaba.fastjson.support.config.FastJsonConfig;
import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter;
import org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;

import java.nio.charset.Charset;
import java.util.List;

@Configuration
public class MyWebMvcConfig implements WebMvcConfigurer {
	
	@Override
	public void addResourceHandlers(ResourceHandlerRegistry registration){
		registration.addResourceHandler("/static/**")
				.addResourceLocations("classpath:/static/");
	}
}

 

你可能感兴趣的:(SpringBoot)