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>

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