Spring3.2.3 MVC多视图解析范例

Spring3.2.3 MVC多视图解析实例
这个架构当中,没有整合进数据库连接及事务管理等的配置,单纯介绍采用ContentNegotiatingViewResolver来做视图解析的一个配置实例,其它的一些配置,相信也难不倒各位亲。源代码实例见附件。
好了,我们接下来将按
项目构建-->配置文件-->后端实现-->前端实现 来讲解。下面先从构建项目开始


采用Gradle做项目构建
这里只描述一些基本的要用到的构建语法,基础的应用是很简单的。
1. 命令行下进入项目的根目录,即build.gradle配置文件所在的目录。
2. 执行命令:gradle eclipse  自动下载build.gradle配置中的依赖包并生成eclipse的环境配置文件如:.project等等。
3. 上步完成后,在eclipse导入现成项目即可。
如果您想进一步了解gradle,可访问博文:http://yidwo.iteye.com/blog/1848990
或访问其官方网站:http://gradle.org


Spring MVC的配置
web.xml:
Xml代码  Spring3.2.3 MVC多视图解析范例
  1. <!-- Spring Web Dispatcher Configuration -->  
  2.     <servlet>  
  3.         <servlet-name>Dispatcher Servlet</servlet-name>  
  4.         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
  5.         <init-param>  
  6.             <param-name>contextConfigLocation</param-name>  
  7.             <param-value>  
  8.                 /WEB-INF/spring-web.xml  
  9.             </param-value>  
  10.         </init-param>  
  11.         <load-on-startup>1</load-on-startup>  
  12.     </servlet>  
  13.   
  14.     <servlet-mapping>  
  15.         <servlet-name>Dispatcher Servlet</servlet-name>  
  16.         <url-pattern>/do/*</url-pattern>  
  17. </servlet-mapping>  


重点标注url-pattern部分,url的请求匹配,只要是满足的,都会被Spring mvc 适匹器捕获并处理。
mvc的配置
下面只是列出了主要的ContentNegotiatingViewResolver的相关配置:
Xml代码  Spring3.2.3 MVC多视图解析范例
  1. <bean  
  2.         class="org.springframework.web.servlet.view.ContentNegotiatingViewResolver">  
  3.         <property name="order" value="1" />  
  4.         <property name="favorParameter" value="false" />  
  5.         <property name="ignoreAcceptHeader" value="true" />  
  6.   
  7.         <property name="defaultContentType" value="application/json" />  
  8.   
  9.         <property name="mediaTypes">  
  10.             <map>  
  11.                 <entry key="atom" value="application/atom+xml" />  
  12.                 <entry key="html" value="text/html" /><!-- 真正静态页面,使用htm后缀(文件格式) -->  
  13.                 <entry key="json" value="application/json" />  
  14.                 <entry key="xml" value="application/xml" />  
  15.             </map>  
  16.         </property>  
  17.         <property name="viewResolvers">  
  18.             <list>  
  19.                 <bean class="org.springframework.web.servlet.view.BeanNameViewResolver" />  
  20.                 <!-- 页面请求时先找此配置,无的话再找jsp的视图配置 -->  
  21.                 <bean  
  22.                     class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">  
  23.                     <property name="cache" value="true" />  
  24.                     <property name="prefix" value="" />  
  25.                     <property name="suffix" value=".ftl" />  
  26.                     <property name="exposeSpringMacroHelpers" value="true" />  
  27.                     <property name="exposeRequestAttributes" value="true" />  
  28.                     <property name="exposeSessionAttributes" value="true" />  
  29.                     <property name="contentType" value="text/html;charset=UTF-8" />  
  30.                 </bean>  
  31.     <!--   
  32.                 <bean  
  33.                     class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
  34.                     <property name="viewClass"   value="org.springframework.web.servlet.view.JstlView" />  
  35.                     <property name="prefix" value="/WEB-INF/jsp/" />  
  36.                     <property name="suffix" value=".jsp" />  
  37.                 </bean>  
  38.             -->  
  39.                 <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">   
  40.                     <property name="prefix" value="/WEB-INF/jsp/" />   
  41.                     <property name="suffix" value=".jsp" />   
  42.                 </bean>   
  43.             </list>  
  44.         </property>  
  45.         <!-- view 接口 下的视图解析对象 -->  
  46.         <property name="defaultViews">  
  47.             <list>  
  48.                 <bean  
  49.                     class="org.springframework.web.servlet.view.json.MappingJackson2JsonView" />  
  50.                 <!-- <bean class="org.springframework.web.servlet.view.json.MappingJacksonJsonView"   
  51.                     /> -->  
  52.                 <!-- XML View -->  
  53.                 <bean class="org.springframework.web.servlet.view.xml.MarshallingView">  
  54.                     <constructor-arg>  
  55.                         <bean class="org.springframework.oxm.jaxb.Jaxb2Marshaller">  
  56.                             <property name="packagesToScan">  
  57.                                 <list>  
  58.                                     <value>com.sample.model</value>  
  59.                                 </list>  
  60.                             </property>  
  61.                         </bean>  
  62.                     </constructor-arg>  
  63.                 </bean>  
  64.             </list>  
  65.         </property>  
  66.     </bean>  

默认视图配置为json格式
Xml代码  Spring3.2.3 MVC多视图解析范例
  1. <property name="defaultContentType" value="application/json" />  

这么做是因为现今Ajax技术用得比较多。
查看spring-web.xml配置,里面有较详细的注释。

后端REST注解实现
后端的实现实例详见SimpleController.java

text/html
需要mediaType为text/html 的数据时,采用*.htm的uri请求,如:/do/sample.html请求sample.ftl页面或是sample.jsp页面,因为ftl的视 图解析配置在jsp的视图解析之前,所以会先查找Freemarker的目录,没发现的话,则会继续查找jsp的目录。

application/json
因为默认配置数据格式为json,所以需要josn格式的数据时,uri可 以不加后缀。以下json的请求都是有效的 /do/sample  和  /do/sample.json  请求处理完成后,直接返回客户端需要的数据对象,spring 会自动调用jackson组件将其转换成json格式。不用加 @ResponseBody注解,是不是更清爽呀。

application/xml
配置采用JAXB做为xml数据的转换组件,只需要在javabean对象的getter方法上加上xml相关注解(详见TestModel.java),在返回该对象及其包装对象时Spring自动转换成xml格式文档。

前端实现
由于我们在web.xml配置文件的url-pattern配置了/do/*. 所以在Controller的注解uri前面需要加上”/do”.
更详细的实现见index.jsp


参考:http://static.springsource.org/spring/docs/3.2.x/spring-framework-reference/html/mvc.html#mvc-multiple-representations