基于纯Java代码的Spring容器和Web容器零配置的思考和实现(2) - 静态资源、视图和消息器-阿里云开发者社区

开发者社区> developerguy> 正文

基于纯Java代码的Spring容器和Web容器零配置的思考和实现(2) - 静态资源、视图和消息器

简介: 在上一篇博文《基于纯Java代码的Spring容器和Web容器零配置的思考和实现(1) - 数据源与事务管理》中我们介绍了怎么基于Java代码去设计和配置一个具有可扩展性的数据源和事务管理器。在这篇博文中,我们将介绍怎么配置静态资源处理、视图解析器以及消息转换器。
+关注继续查看

 

在上一篇博文《基于纯Java代码的Spring容器和Web容器零配置的思考和实现(1) - 数据源与事务管理》中我们介绍了怎么基于Java代码去设计和配置一个具有可扩展性的数据源和事务管理器。在这篇博文中,我们将介绍怎么配置静态资源处理、视图解析器以及消息转换器。

我们知道,Spring的配置分为两个部分,
一部分是配置Spring容器,一般配置在applicationContext.xml
另一部分是Web容器,也叫Web子容器,一般配置在xxx-servlet.xml

所以,遵循配置分离的原则,我们提供两个类来分别代替这两个XML文件

 

我们首先提供一个SpringContextConfig类,这个类用于配置原本配置在applicationContext.xml中的信息。由于我们已经将数据源和事务管理器的配置单独配置到了DBConfig,对于最基本配置这个范围而言,这个类暂时没有其他的东西需要配置。当然以后我们自定义的一些需要Spring管理的内容可以在这里配置。比如我在这里面配置了一个RPC工具,源码如下:

package com.kiiwow.framework.config.context.spring;

import org.springframework.context.annotation.Bean;

import com.kiiwow.framework.platform.service.KiiwowApiClient;

/**
 * Spring容器上下文配置
 * 对rest请求发起客户端以及其他工具进行配置
 *
 * @author leon.gan
 *
 */
public class SpringContextConfig {
    
    /**
     * RestClient
     */
    @Bean
    public KiiwowApiClient kiiwowApiClient() {
        return new KiiwowApiClient();
    }
    
}

 

我们接着提供一个WebContextConfig类,这个类用于配置原本配置在xxx-servlet.xml中的信息。我们需要继承org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter这个抽象类,
通过重写其void addResourceHandlers(ResourceHandlerRegistry registry)方法实现静态资源过滤
重写void addInterceptors(InterceptorRegistry registry)方法来配置我们的监听器

我们先给出源码,再对源码作出解释:

package com.kiiwow.framework.config.context.spring;

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

import javax.inject.Inject;

import org.springframework.context.annotation.Bean;
import org.springframework.http.MediaType;
import org.springframework.http.converter.ByteArrayHttpMessageConverter;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.StringHttpMessageConverter;
import org.springframework.http.converter.json.MappingJacksonHttpMessageConverter;
import org.springframework.http.converter.xml.Jaxb2RootElementHttpMessageConverter;
import org.springframework.http.converter.xml.XmlAwareFormHttpMessageConverter;
import org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter;
import org.springframework.web.servlet.view.InternalResourceViewResolver;
import org.springframework.web.servlet.view.JstlView;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;
import org.springframework.web.servlet.view.freemarker.FreeMarkerView;
import org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver;

import com.kiiwow.framework.json.JSONBinder;

/**
 * Web容器上下文配置
 * 
 * @author leon.gan
 *
 */
public class WebContextConfig extends WebMvcConfigurerAdapter  {

    @Inject
    KiiwowEnvironment environment;
    
    /**
     * 静态资源过滤
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler(environment.getProperty("static.handler", "/site-static/**"))
                .addResourceLocations(environment.getProperty("static.locations", "/site-static/"))
                .setCachePeriod(environment.getRequiredProperty("static.cachePeriod", int.class, 31556926));
    }

    /**
     * 将对于静态资源的请求转发到Servlet容器的默认处理静态资源的servlet
     * 因为将spring的拦截模式设置为"/"时会对静态资源进行拦截
     */
    @Override
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        configurer.enable();
    }
    
    /**
     * JSP视图解析器
     */
    @Bean
    public InternalResourceViewResolver internalResourceViewResolver() {
        InternalResourceViewResolver internalResourceViewResolver = new InternalResourceViewResolver();
        internalResourceViewResolver.setViewClass(JstlView.class);
        internalResourceViewResolver.setPrefix(environment.getProperty("view.jsp.prefix", "/WEB-INF/website/"));
        internalResourceViewResolver.setSuffix(environment.getProperty("view.jsp.suffix", ".jsp"));
        internalResourceViewResolver.setOrder(environment.getRequiredProperty("view.jsp.order", int.class, 0));
        return internalResourceViewResolver;
    }
    
    /**
     * FreeMarker视图解析器
     */
    @Bean
    public FreeMarkerViewResolver freeMarkerViewResolver() {
        FreeMarkerViewResolver freeMarkerViewResolver = new FreeMarkerViewResolver();
        freeMarkerViewResolver.setViewClass(FreeMarkerView.class);
        freeMarkerViewResolver.setContentType(environment.getProperty("view.freemarker.contentType", "text/html; charset=utf-8"));
        freeMarkerViewResolver.setCache(true);
        freeMarkerViewResolver.setRequestContextAttribute("basePath");
        freeMarkerViewResolver.setSuffix(environment.getProperty("view.freemarker.suffix", ".ftl"));
        freeMarkerViewResolver.setOrder(environment.getRequiredProperty("view.freemarker.order", int.class, 1));
        return freeMarkerViewResolver;
    }
    
    /**
     * FreeMarker模板配置
     */
    @Bean
    public FreeMarkerConfigurer freeMarkerConfigurer() {
        FreeMarkerConfigurer freeMarkerConfigurer = new FreeMarkerConfigurer();
        freeMarkerConfigurer.setTemplateLoaderPath(environment.getProperty("view.freemarker.templateLoaderPath", "/WEB-INF/website/"));
        freeMarkerConfigurer.setDefaultEncoding(environment.getProperty("view.freemarker.defaultEncoding", "UTF-8"));
        return freeMarkerConfigurer;
    }
    
    /**
     * 消息转换器,Spring默认是注册了以下转换器的,但是为了让json转换器使用我们自定义的日期格式,所以需要全部重新配置
     */
    @SuppressWarnings("deprecation")
    private List<HttpMessageConverter<?>> createMessageConverters() {
        List<HttpMessageConverter<?>> converters = new ArrayList<HttpMessageConverter<?>>();
        // 字节数组消息转换器
        converters.add(new ByteArrayHttpMessageConverter());
        
        // 文本消息转换器
        StringHttpMessageConverter stringConverter = new StringHttpMessageConverter();
        stringConverter.setWriteAcceptCharset(false);
        
        // 文本消息转换器所支持的文本类型
        ArrayList<MediaType> textTypes = new ArrayList<MediaType>();
        // 原生格式
        textTypes.add(MediaType.TEXT_PLAIN);
        // HTML格式
        textTypes.add(MediaType.TEXT_HTML);
        // 以us-ascii编码XML内容
        textTypes.add(MediaType.TEXT_XML);
        // 以指定字符集编码XML内容
        textTypes.add(MediaType.APPLICATION_XML);
        
        stringConverter.setSupportedMediaTypes(textTypes);
        converters.add(stringConverter);
        
        // XML消息转换器
        converters.add(new XmlAwareFormHttpMessageConverter());
        converters.add(new Jaxb2RootElementHttpMessageConverter());
        
        //Json消息转换器
        MappingJacksonHttpMessageConverter jsonConverter = new MappingJacksonHttpMessageConverter();
        jsonConverter.setObjectMapper(JSONBinder.createMapper());
        converters.add(jsonConverter);
        
        return converters;
    }
    
    /**
     * 为映射请求处理器配置消息转换器
     * @return
     */
    @Bean
    public RequestMappingHandlerAdapter requestMappingHandlerAdapter() {
        RequestMappingHandlerAdapter requestMappingHandlerAdapter = new RequestMappingHandlerAdapter();
        requestMappingHandlerAdapter.setMessageConverters(createMessageConverters());
        return requestMappingHandlerAdapter;
    }
    
}

 

 

我们首先配置了静态资源所在位置和请求路径,以避免静态资源被拦截成请求。
重写的void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)方法是为了开启默认处理静态资源的Servlet
然后我们配置了JSP和FreeMarker两种视图解析器,通过设置order属性来配置其优先级,当找不到优先级高的视图时会自动搜寻下一优先级的视图。
最后就是最重要的消息转换器的配置了。
我们知道,Spring是默认注册了这几个消息转换器的,那为什么我们还需要配置一次呢?

众所周知,Java8以前的时间API是设计的很丧心病狂的,我们通常需要花费大量的精力去处理时间格式。
而Spring默认配置的Json消息转换器的日期格式并不是我们需要的"yyyy-MM-dd HH:mm:ss"格式,所以为了统一我们在JSON返回时间时格式统一,我们在采用的Json转换工具Jackson的配置中设定了固定的日期格式,所以我们需要将Json消息转换器重新配置。
如果您清楚Java对于无参构造器的默认提供策略了解的话,相信您就能明白我们为什么需要重新配置这些消息转换器了。对于Jackson工具的封装源码如下:

package com.kiiwow.framework.json;

import java.io.IOException;
import java.text.SimpleDateFormat;

import org.codehaus.jackson.map.ObjectMapper;
import org.codehaus.jackson.xc.JaxbAnnotationIntrospector;

import com.kiiwow.framework.exception.KiiwowException;

/**
 * 
 * JSONBinder
 *
 * @Description: json与Obj互相转换
 * @author leon.gan
 *
 */
public final class JSONBinder<T> {
    
    private final Class<T> beanClass;

    private final Class<?>[] elementClasses;
    
    private JSONBinder(Class<T> beanClass, Class<?>... elementClasses) {
        this.beanClass = beanClass;
        this.elementClasses = elementClasses;
    }
    
    public static final String DATE_FORMAT_DATETIME = "yyyy-MM-dd HH:mm:ss";
    
    public static <T> JSONBinder<T> binder(Class<T> beanClass, Class<?>... elementClasses) {
        return new JSONBinder<T>(beanClass, elementClasses);
    }

    public static ObjectMapper createMapper() {
        ObjectMapper mapper = new ObjectMapper();
        SimpleDateFormat dateFormat = new SimpleDateFormat(DATE_FORMAT_DATETIME);
        mapper.setSerializationConfig(mapper.getSerializationConfig().withDateFormat(dateFormat));
        mapper.setDeserializationConfig(mapper.getDeserializationConfig().withDateFormat(dateFormat));
        mapper.setAnnotationIntrospector(new JaxbAnnotationIntrospector());
        return mapper;
    }

    public T fromJSON(String json) {
        ObjectMapper mapper = createMapper();
        try {
            return elementClasses == null || elementClasses.length == 0 ? mapper.readValue(json, beanClass) : fromJSONToGeneric(json);
        } catch (IOException e) {
            throw new KiiwowException(e);
        }
    }

    private T fromJSONToGeneric(String json) throws IOException {
        ObjectMapper mapper = createMapper();
        return mapper.readValue(json, mapper.getTypeFactory().constructParametricType(beanClass, elementClasses));
    }

    public String toJSON(T object) {
        ObjectMapper mapper = createMapper();
        try {
            return mapper.writeValueAsString(object);
        } catch (IOException e) {
            throw new KiiwowException(e);
        }
    }
}

 

 

至此,我们对于Spring的所有基本配置就都完成了,我们彻底抛弃了XML配置文件,只需要使用继承就可以获得这些配置并应用于我们的项目中。在下一篇博文中,我们将讲解怎么在我们项目中使用这些配置,并怎么使用Java类代替web.xml文件。

http://my.oschina.net/devleon/blog/530902

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
Spring的AOP配置以及常见错误(内附代码)
首先我们可以新建一个包,目录结构如下: User类: package com.hqj.aop; public class User {     @Override     public String toString() {         re...
868 0
走进JavaWeb技术世界16:极简配置的SpringBoot
SpringBoot详解(一)-快速入门 SpringBoot详解系列文章:SpringBoot详解(一)-快速入门SpringBoot详解(二)-Spring Boot的核心SpringBoot详解(三)-Sprin.
2359 0
从 pingcap tidb 学习使用静态检查工具提升代码质量
今天想跟大家简单介绍一下如何使用一些 golang 的静态代码检查工具来提升代码质量! 此博客在 GitHub 上公开发布. 如果您有任何问题或疑问,请在此处打开一个 issue。 简介 从去年接触到 TiDB 就开始尝试在社区帮忙修复一些简单的 Bug。最近,我在阅读代码的过程中发现 TiDB 的代码库中有大量的没有必要的类型转换,我就用 GoLand 分析检查出大部分的无效的类型转化, 然后提了一个 PR (CEO 半夜 review 代码,哈哈哈)修复。在这个 PR 中 zz-jason 大神 评论希望能够通过静态检查工具来检测无效的类型转换。 我经过一些研究,决定使用 uncon
26 0
spring profile 多环境配置管理
本地、测试、开发、产品等不同环境文件配置 现象   如果在开发时进行一些数据库测试,希望链接到一个测试的数据库,以避免对开发数据库的影响。   开发时的某些配置比如log4j日志的级别,和生产环境又有所区别。
697 0
[Spring MVC] - JSP + Freemarker视图解释器整合(转)
Spring MVC中如果只使用JSP做视图,可以使用下面这段即可解决:   但很多时候我们需要的不只是JSP做view,可能会引用velocity、freemarker等做为view引擎时,需要加入额外的配置。
798 0
x3d
一些java3d比较精彩的资源(转自 中国VR技术社区)
偶然在java3d邮件组上遇到了斑竹icess,来到这里看到斑竹的热情很高,我接触java3d也有2-3年了,我愿意把我的一些资源与大家分享。有些资源太大,我尽量提供网址,大家自己去下载 【1】java3d邮件组上比较活跃的人物alessandro borges,巴西技术牛人,用java3d实现了凹凸贴图,环境贴图等精彩实例,去网站上看看吧http://paginas.
846 0
linux进程的堆栈空间_代码段(指令,只读)、数据段(静态变量,全局变量)、堆栈段(局部变量)、栈【转】
转自:http://blog.csdn.net/gongweijiao/article/details/8207333 原文参见:http://blog.163.com/xychenbaihu@yeah/blog/static/132229655201215115845553/    一)概述   .堆栈是一个用户空间的内存区域,进程使用堆栈作为临时存储。
797 0
+关注
developerguy
A code cleanliness code farmers, A programmer concentrate on elegant design, A want to do with the product architect
1663
文章
0
问答
文章排行榜
最热
最新
相关电子书
更多
《2021云上架构与运维峰会演讲合集》
立即下载
《零基础CSS入门教程》
立即下载
《零基础HTML入门教程》
立即下载