这里我使用的开发工具是Intelij Idea,直接创建Spring MVC框架的项目,将默认的dispatcher-servlet.xml改名为springmvc.xml并放到了config目录下,删掉了spring的applicationContext.xml配置文件,这里只针对Spring MVC做简单的演示。
1. web.xml的配置
在web.xml文件中添加Spring MVC的DispatcherServlet,用于拦截符合配置的url请求。配置如下:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<!--SpringMVC前端控制器-->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>*.action</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<!--不加过滤器会导致中文传参乱码-->
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>utf-8</param-value>
</init-param>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
关于上面的配置,首先看<servlet-mapping>标签对,其中定义了当url符合“.action”的形式(也即任何字符后面跟“.action”的形式)时,映射一个名为“springmvc”的Servlet配置,那么在上面的Servlet配置中,定一个一个名为“springmvc”的servlet配置,其中实现类为DispatcherServlet,即Spring MVC的前端控制器类。
然后在下面的<init-param>标签对中放置了DispatcherServlet需要的初始化参数,配置的是contextConfigLocation上下文参数变量,其加载的配置文件为编译目录下的“springmvc.xml”。
2. 核心配置文件springmvc.xml
在配置文件中添加xml版本声明和一个包含spring标签声明规则的<beans>标签对。
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<beans>
关于处理器映射器(HandlerMapping)、处理器适配器(HandlerAdapter)和视图解析器(ViewResolver)下面会有更详细的介绍:HadnlerMapping和HandlerAdapte、ViewResolver
下面只是配置方法之一,做简单介绍:
-
HandlerMapping
Spring MVC拥有多种HandlerMapping,它们都实现了HandlerMapping接口。以BeanNameUrlHandlerMapping类为例,其映射的规则为:将bean的name作为url进行查找,需要配置Handler时指定beanname(即url)。
在springmvc.xml中添加配置:
<!--配置合适的处理器映射器(HandleMapping)-->
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>
-
HandlerAdapter
常用的HandlerAdapter有HttpRequestHandlerAdapter、SimpleControllerHandlerAdapter、AnnotationMethodHandlerAdapter,它们都实现了HandlerAdapter接口。
<!--配置一个处理器适配器(HandleAdapter)-->
<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>
-
ViewResolver
常用的ViewResolver有XMLViewResolver(从xml配置文件解析视图)、ResourceBundleViewResolver(从properties资源集解析视图)、InternalResourceViewResolver(根据模块名称和位置解析视图)。
这里使用默认的InternalResourceViewResolver:
<!-- 配置视图解析器 如何把 handler 方法返回值解析为实际的物理视图 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/jsp/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
3. 编写Handler处理器与视图
这里使用非注解的方式来实现来感受一下Handler的原理。
由于我们使用的处理器时SimpleControllerHandlerAdapter,所以Handler只要实现Controller接口即可。
在cn.com.mvc.controller包下创建Controller类,用于加载一个水果商城的水果列表信息。新建一个FruitsControllerTest的类,让其实现Controller接口,然后实现handlerRequest方法,并编写其具体逻辑,代码如下:
//实体类
package cn.com.mvc.model;
public class Fruits {
private String name;
private double price;
private String producing_area;//产地
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public double getPrice() {
return price;
}
public void setPrice(double price) {
this.price = price;
}
public String getProducing_area() {
return producing_area;
}
public void setProducing_area(String producing_area) {
this.producing_area = producing_area;
}
}
package cn.com.mvc.controller;
import cn.com.mvc.model.Fruits;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.ArrayList;
import java.util.List;
public class FruitsControllerTest implements Controller{
@Override
public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
//模拟Service获取水果商品列表
FruitsService fruitsService = new FruitsService();
List<Fruits> fruitsList = fruitsService.queryFruitsList();
//返回ModelAndView
ModelAndView modelAndView = new ModelAndView();
//相当于request的setAttribut,在JSP页面中通过fruitsList获取数据
modelAndView.addObject("fruitsList",fruitsList);
//指定视图
modelAndView.setViewName("fruitsList");
return modelAndView;
}
//模拟Service的内部类
class FruitsService{
public List<Fruits> queryFruitsList(){
List<Fruits> fruitsList = new ArrayList<Fruits>();
Fruits apple = new Fruits();
apple.setName("红富士苹果");
apple.setPrice(2.3);
apple.setProducing_area("山东");
Fruits banana = new Fruits();
banana.setName("香蕉");
banana.setPrice(1.5);
banana.setProducing_area("上海");
fruitsList.add(apple);
fruitsList.add(banana);
return fruitsList;
}
}
}
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" language="java" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<html>
<head>
<title>水果列表</title>
</head>
<body>
<h3>新鲜水果</h3>
<table width="300px;" border=1>
<tr>
<td>名称</td>
<td>价格</td>
<td>产地</td>
</tr>
<c:forEach items="${fruitsList}" var="fruit">
<tr>
<td>${fruit.name}</td>
<td>${fruit.price}</td>
<td>${fruit.producing_area}</td>
</tr>
</c:forEach>
</table>
</body>
</html>
由于HandlerMapping为BeanNameUrlHandlerMapping,在接收到用户的请求时,它会将bean的name作为url进行查找。配置:
<bean name="/queryFruits_test.action" class="cn.com.mvc.controller.FruitsControllerTest"/>
springmvc.xml的所有内容:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<!--配置合适的处理器映射器(HandleMapping)-->
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>
<!--配置一个处理器适配器(HandleAdapter)-->
<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>
<!-- 配置视图解析器 如何把 handler 方法返回值解析为实际的物理视图 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/jsp/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
<!--可以被url映射的Handler的bean-->
<bean name="/queryFruits_test.action" class="cn.com.mvc.controller.FruitsControllerTest"/>
</beans>
配置好Tomcat运行项目,访问以下路径:
http://localhost:8080/queryFruits_test.action
得到以下结果表示运行成功。
注:这里的Controller层的开发模式仅仅作为演示来了解SpringMVC,并不是其主流开发模式,之后的文章会详细介绍。