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

在上一篇博文《基于纯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