视图与视图解析器
通常像spring mvc 这样的web框架都会有相应的定位视图技术,spring提供了视图解析器来解析ModelAndView模型数据到特定的视图上,spring提供了ViewResolver和View两个特别重要的接口,ViewResolver提供了从视图名称到实际视图的映射,View处理请求的准备的工作,并将该请求提交给某种具体的视图解析器
1.使用Excel作为视图(了解)
步骤一:建立后端控制器ExcelControl.java,主要代码如下:
package com.asm;
//...省略导入的相关类
public class ExcelControl extends AbstractController {
@Override
protected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response) throws Exception {
Map map = new HashMap();
List wordList = new ArrayList();
wordList.add("first");
wordList.add("second");
wordList.add("third");
map.put("wordList", wordList);
return new ModelAndView("exl", map);
}
}
步骤二:编写web.xml(参前面实例),编写配置spmvc-servlet.xml文件,主要代码如下:
<bean id="rbViewResolver" class="org.springframework.web.servlet.view.ResourceBundleViewResolver"> <property name="order" value="2" /> <property name="basename" value="view" /> </bean> <bean id="simpleUrlHandlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"> <property name="mappings"> <props> <prop key="/getExcel.do">excelControl</prop> </props> </property> </bean> <bean id="excelControl" class="com.asm.ExcelControl"></bean>
简析:ResourceBundleViewResolver视图解析器会在classpath中寻找properties属性文件,根据此bean配置的<property name="basename" value="view" />说明寻找的properties文件名为view.properties。<property name="order" value="2" />说明了此解析器在整个解析链接中的顺序。
步骤三:编写view.properties文件,主要代码如下:
exl.(class)=com.asm.ExcelViewBuilder
说明:在控制器中返回的视图名称exl——>return new ModelAndView("exl", map),所以这里要用exl.(class)。而exl视图会交给com.asm.ExcelViewBuilder进行预处理。
步骤四:编写AbstractExcelView.java,由于此类用到了生成Excel文件相关的jar包,所以应先下载poi-2.5.1.jar并导入。主要代码如下:
package com.asm;
//...省略导入的相关类
public class ExcelViewBuilder extends AbstractExcelView {
protected void buildExcelDocument(Map model, HSSFWorkbook wb, HttpServletRequest req, HttpServletResponse resp) throws Exception {
HSSFSheet sheet;
HSSFCell cell;
sheet = wb.createSheet("Spring's Excel"); // 创建一张表;
// sheet = wb.getSheetAt(0);//根据索引,得到第一张存在的表
sheet.setDefaultColumnWidth((short) 10); // 设置列数为10:即A-J
cell = getCell(sheet, 0, 0); //第二个参数-->excel表数字序号;第三个参数-->excel表字母序号,比如此处,构建A1单元格
setText(cell, "Spring-Excel test"); // 把内容写入A1
List words = (List) model.get("wordList");
for (int i = 0; i < words.size(); i++) {
cell = getCell(sheet, 2, i);// A3-B3-C3
setText(cell, (String) words.get(i));
}
}
}
步骤五 :启动服务器,输入… /getExcel.do ,将访问到 excel 文件。
简析执行过程 :当后端控制器接受到前端控制派发的请求时,后端控制器会首先准备Model ,这里即Map 对象,然后返回exl 视图。在返回视图前,会查找spmvc-servlet.xml 配置文件,当查找名为exl 的视图是由 ResourceBundleViewResolver 视图解析器进行解析时,这时根据此视图解析的解析规则,会 对每个待解析的视图, ResourceBundle 里(这时即 view.properties 文件) 的[ 视图名].class
所对应的值就是实现该视图的类。 同样, [
视图名].url
所对应的值是该视图所对应的 URL 。当视图类成功完成视图的预处理工作后,会把此视图返回给客户端。
2.使用FreeMarker作为视图
步骤一:建立后端控制器FreeMarkerController.java,主要代码如下:
package com.asm;
//...省略导入的相关类
@SuppressWarnings("deprecation")
public class FreeMarkerController extends AbstractCommandController {
@Override
protected ModelAndView handleRequestInternal(HttpServletRequest reqeust, HttpServletResponse response)
throws Exception {
ModelAndView mav = new ModelAndView("base");
mav.addObject("username", "张三");
mav.addObject("time", new Date().toString());
return mav;
}
@Override
protected ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object command,
BindException errors) throws Exception {
return null;
}
}
步骤二:在spmvc-servlet.xml中配置:
<!-- freemarker相关的配置 --> <bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"> <property name="defaultEncoding" value="UTF-8" /> <property name="templateLoaderPath" value="/WEB-INF/freemarker/" /> </bean> <!—freemarker视图解析器 --> <bean id="fmViewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver"> <property name="contentType" value="text/html;charset=utf-8" /> <property name="cache" value="true" /> <property name="prefix" value="" /> <property name="suffix" value=".ftl" /> </bean> <bean id="fmControl" class="com.asm.FreeMarkerController"></bean>
并在映射处理器中配置映射路径为:<prop key="/freeMarker.do">fmControl</prop>
步骤三:通过步骤二的配置,我们还需在WEB-INF/freemarker路径下编写base.ftl(base即后端控制器返回的视图名),主要代码如下:
<body>
欢迎来到:FreeMarker模板页面<br/>
welcome ${username}<br/>
当前时间:${time}
</body>
步骤四:启动服务器,输入…/freemarker.do完成测试。
3.小结视图技术
(1)ModelAndView所表示的视图名很关键,视图解析链会依此名来选择一个正确的视图。
(2)不同的视图解析器解析视图规则不相同,但是他们实质都是实现了ViewResolver接口,并会依赖于配置View对象来处理请求的准备工作。
(3)spring 内置了多种视图解析器,列表如下:
ViewResolver | 描述 |
AbstractCachingViewResolver | 抽象视图解析器实现了对视图的缓存。在视图被使用之前,通常需要进行一些准备工作。 从它继承的视图解析器将对要解析的视图进行缓存。 |
XmlViewResolver | XmlViewResolver 实现ViewResolver ,支持XML 格式的配置文件。 该配置文件必须采用与Spring XML Bean Factory 相同的DTD 。默认的配置文件是 /WEB-INF/views.xml 。 |
ResourceBundleViewResolver | ResourceBundleViewResolver 实现ViewResolver , 在一个ResourceBundle 中寻找所需bean 的定义。 这个bundle 通常定义在一个位于classpath 中的属性文件中。默认的属性文件是views.properties 。 |
UrlBasedViewResolver | UrlBasedViewResolver 实现ViewResolver , 将视图名直接解析成对应的URL ,不需要显式的映射定义。 如果你的视图名和视图资源的名字是一致的,就可使用该解析器,而无需进行映射。 |
InternalResourceViewResolver | 作为UrlBasedViewResolver 的子类, 它支持InternalResourceView (对Servlet 和JSP 的包装), 以及其子类JstlView 和TilesView 。 通过setViewClass 方法,可以指定用于该解析器生成视图使用的视图类。 更多信息请参考UrlBasedViewResolver 的Javadoc 。 |
VelocityViewResolver / FreeMarkerViewResolver | 作为UrlBasedViewResolver 的子类, 它能支持VelocityView (对Velocity 模版的包装)和FreeMarkerView 以及它们的子类。 |
(4)Spring支持多个视图解析器一起使用,即视图解析链。 视图解析链包含一系列视图解析器,更方便开发人员处理某些特殊请求,比如在特定情况下重新定义某些视图(为某个视图解析器使用order,可以改变此视图解析器在整个视图解析链中的解析顺序:order值越大,它在整个视图解析链中的顺序越靠前,即它越会被优先选作为视图解析器)。
4.视图解析链
通过前面的两个实例,在spmvc-servlet.xml配置文件便具备了两个视图解析器,它们共同构成了视图解析链。下面我们将再增加一个视图解析器来解析jsp视图,并编写一个后端控制器来负责调用特定的请求。
步骤一:编写后端控制器.java,主要代码如下:
package com.asm;
//...省略导入的相关类
public class SelectViewController implements Controller {
public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
String param = request.getParameter("op");
ModelAndView mav = new ModelAndView("display");
if ("fm".equals(param)) {
// mav = new ModelAndView(new RedirectView("freeMarker.do"));
// mav =new ModelAndView("redirect:freeMarker.do");
mav = new ModelAndView("forward:freeMarker.do");
return mav;
} else if ("excel".equals(param)) {
mav = new ModelAndView(new RedirectView("getExcel.do"));
return mav;
} else {
return mav;
}
}
}
简析:如果请求参数op为fm,则调用freemarker.do,如果op为excel,则调用getExcel.do,否则显示display.jsp视图。调用freemarker.do和getExcel.do我们可以使用重定向技术和直接使用forward跳转:使用forward跳转,forward:视图名;使用重定向,redirect:视图名(也可以RedirectView对象实现)。
步骤二:在spmvc-servlet.xml中增加jsp视图解析器(它与前面定义的两个视图解析器共同构成了视图解析链),并配置后端处理器及映射路径。
<bean id="irViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/page/" /> <property name="suffix" value=".jsp" /> </bean> <bean id="simpleUrlHandlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"> <property name="mappings"> <props> <prop key="/getExcel.do">excelControl</prop> <prop key="/freeMarker.do">fmControl</prop> <prop key="/sv.do">svControl</prop> </props> </property> </bean> <bean id="svControl" class="com.asm.SelectViewController"></bean>
说明:irViewResolver视图解析器应放在前面两个视图解析器后面,理解视图解析顺序,可以把irViewResolver视图解析器放在视图解析链的最前面试下执行效果,当然也可以为视图解析器定义order值来进一步理解视图解析顺序。
步骤三:在WEB-INF/page目录下编写display.jsp, 主要代码如下:
<body>
欢迎来到display页面,你可以选择如下操作:<br/>
<a href="<%=request.getContextPath()%>/sv.do?op=excel">Excel页面</a>
<a href="<%=request.getContextPath()%>/sv.do?op=fm">freeMarker页面</a>
<a href="<%=request.getContextPath()%>/sv.do">jsp页面</a>
</body>
步骤四:index.jsp页面主要代码如下:
<body>
<a href="<%=request.getContextPath()%>/sv.do?op=excel">Excel页面</a>
<a href="<%=request.getContextPath()%>/sv.do?op=fm">freeMarker页面</a>
<a href="<%=request.getContextPath()%>/sv.do">jsp页面</a>
</body>
步骤五:启动服务器,访问首面测试。