Spring MVC 多个视图解析器配置

摘要: Spring MVC 多个视图解析器配置

背景:

在web开发中，我们在前端通常使用视图来展示我的数据模型，常用的视图有JSP、XML、JSON、velocity、FreeMarker等。在Spring MVC应用程序中，常用的视图解析器有InternalResourceViewResolver、ResourceBundleViewResolver和XmlViewResolver等。

问题一:

那么，在程序中怎么配置JSP、XML、JSON、velocity、FreeMarker他们的解析器呢？

解决方法:

<!-- jsp视图解析器 -->
<!-- <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" p:prefix="/jsp/" p:suffix=".jsp" /> -->
<bean id="jspViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
<property name="prefix" value="/jsp/"/>
<property name="suffix" value=".jsp"/>
</bean>

<!-- velocity视图解析器 -->
<bean id="velocityViewResolver" class="org.springframework.web.servlet.view.velocity.VelocityViewResolver">
<property name="cache" value="true"/>
<property name="prefix" value="/velocity/"/>
<property name="suffix" value=".vm"/>
</bean>

<!-- velocity环境配置 -->
<bean id="velocityConfig" class="org.springframework.web.servlet.view.velocity.VelocityConfigurer">
<!-- velocity配置文件路径 -->
<property name="configLocation" value="/WEB-INF/velocity.properties"/>
<!-- velocity模板路径 -->
<property name="resourceLoaderPath" value="/WEB-INF/velocity/"/>
</bean>

<!-- FreeMarker环境配置 -->
<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
<!-- freemarker模板位置 -->
<property name="templateLoaderPath" value="/WEB-INF/freemarker/"/>
</bean>

<!-- FreeMarker视图解析 -->
<bean id="freeMarkerViewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
<property name="cache" value="true"/>
<property name="prefix" value="/freemaker/"/>
<property name="suffix" value=".ftl"/>
</bean>

<!-- Json视图解析 -->
<bean name="jsonView" class="org.springframework.web.servlet.view.json.MappingJacksonJsonView">
<property name="encoding">
<value type="org.codehaus.jackson.JsonEncoding">UTF8</value>
</property>
<property name="extractValueFromSingleKeyModel" value="true"></property>
<property name="contentType" value="application/json;charset=UTF-8" />
</bean>

<!-- xml jaxb视图解析 -->
<bean id="xmlViewer" class="org.springframework.web.servlet.view.xml.MarshallingView">
<constructor-arg>
<bean class="org.springframework.oxm.jaxb.Jaxb2Marshaller">
<property name="classesToBeBound">
<list>
</list>
</property>
</bean>
</constructor-arg>
<property name="contentType" value="application/xml;charset=UTF-8" />
</bean>

<!-- xml Xstream视图解析 -->
<bean id="xmlViewer" class="org.springframework.web.servlet.view.xml.MarshallingView">
<property name="xStreamMarshaller">
<bean class="org.springframework.oxm.xstream.XStreamMarshaller">
<!-- 启用annotation -->
<property name="autodetectAnnotations" value="true" />
<!-- 支持在dto列表 -->
<property name="supportedClasses"><array></array></property>
</property>
</bean>

<!-- 文件上传 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--1024**1024*5即5M-->
<property name="maxUploadSize" value="5242880"/>
</bean>

问题二:

如果想用多个视图解析器，那么又怎么配置呢？

解决方法一:

在问题一解决方法的配置中，通过“order”属性来声明优先级，order值越低，则优先级越高。例如：

<bean class="org.springframework.web.servlet.view.ResourceBundleViewResolver">
<property name="basename">
<value>spring-views</value>
</property>
<property name="order" value="0" />
</bean>

<bean class="org.springframework.web.servlet.view.XmlViewResolver">
<property name="location">
<value>/WEB-INF/spring-views.xml</value>
</property>
<property name="order" value="1" />
</bean>

<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver" >
<property name="prefix">
<value>/WEB-INF/pages/</value>
</property>
<property name="suffix">
<value>.jsp</value>
</property>
<property name="order" value="2" />
</bean>

注意：InternalResourceViewResolver必须总是赋予最低的优先级（最大的order值），因为不管返回什么视图名称，它都将解析视图。如果它的优先级高于其它解析器的优先级的话，它将使得其它具有较低优先级的解析器没有机会解析视图。

解决方法二： 使用org.springframework.web.servlet.view.ContentNegotiatingViewResolver进行配置，如下：

<!-- 多视图解析 .json .xml -->
<bean class="org.springframework.web.servlet.view.ContentNegotiatingViewResolver">
<property name="order" value="1" />
<!-- 用于开启 /userinfo/123?format=json 的支持 默认是true -->
<property name="favorParameter" value="false" />
<!-- 用于关闭 /userinfo/123.json 的支持 默认是true -->
<property name="favorPathExtension" value="true" />
<!-- 设置为true以忽略对Accept Header的支持 -->
<property name="ignoreAcceptHeader" value="true" />
<!-- 在没有扩展名时即: "/user/1" 时的默认展现形式 -->
<property name="defaultContentType" value="text/html" />
<!-- 扩展名至mimeType的映射,即 /user.json => application/json -->
<property name="mediaTypes">
<map>
<entry key="json" value="application/json" />
<entry key="xml" value="application/xml" />
</map>
</property>
<property name="defaultViews">
<list>
<ref bean="jsonView" />
<ref bean="xmlViewer" />
</list>
</property>
</bean>

<!-- json 视图 -->
<bean name="jsonView" class="org.springframework.web.servlet.view.json.MappingJacksonJsonView">
<property name="encoding">
<value type="org.codehaus.jackson.JsonEncoding">UTF8</value>
</property>
<property name="extractValueFromSingleKeyModel" value="true"></property>
<property name="contentType" value="application/json;charset=UTF-8" />
</bean>

<!-- xml 视图 -->
<bean id="xmlViewer" class="org.springframework.web.servlet.view.xml.MarshallingView">
<constructor-arg>
<bean class="org.springframework.oxm.jaxb.Jaxb2Marshaller">
<property name="classesToBeBound">
<list>
</list>
</property>
</bean>
</constructor-arg>
<property name="contentType" value="application/xml;charset=UTF-8" />
</bean>

注意：方法一和方法二不要混合使用！！！！