Web MVC框架中除了最流行的Struts,还有Spring MVC,相对来说Spring MVC更加灵活、简便,如果你只是开发一个小型的web应用,我认为Spring MVC是更好的选择。
下面我就以一个简单的例子来说明Spring MVC的基本用法。(示例程序我已上传至gitcafe,https://gitcafe.com/xt/SpringMVC_Study)
首先下载相关的jar包:
spring:http://maven.springframework.org/release/org/springframework/spring/
jackson:http://repo1.maven.org/maven2/com/fasterxml/jackson/core/ (为实现前后台传递json数据)
commons logging:http://commons.apache.org/proper/commons-logging/download_logging.cgi
JSTL:http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/
导入的包如下图所示:
(当然,如果你懒得下载,可以直接下载我的工程,将里面lib文件夹下的包导入你自己的工程里去即可。)
新建一个web工程,名称为SpringMVC_Study,之后配置web.xml,内容如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
|
<? xml
version="1.0" encoding="UTF-8"?>
< web-app
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
xsi:schemaLocation=
"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id="WebApp_ID" version="3.0">
<!-- spring MVC配置 -->
< 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:springservlet-config.xml</ param-value >
</ init-param >
< load-on-startup >1</ load-on-startup >
</ servlet >
< servlet-mapping >
< servlet-name >SpringMVC</ servlet-name >
< url-pattern >/</ url-pattern >
</ servlet-mapping >
<!-- 配置post表单编码格式(避免中文乱码) -->
< filter >
< filter-name >CharacterEncodingFilter</ 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 >
</ filter >
< filter-mapping >
< filter-name >CharacterEncodingFilter</ filter-name >
< url-pattern >/*</ url-pattern >
</ filter-mapping >
</ web-app >
|
在配置中,设置了一个名为“springMVC”的servlet,其实现类为spring的DispatcherServlet。contextConfigLocation指定了这个servlet的配置文件位置和名称,load-on-startup的属性值为1,意为随着servlet容器一同启动,servlet-mapping设置为“/”,即拦截所有请求。
下面在src目录下新建Spring MVC的配置文件:springservlet-config.xml(其路径名称与web.xml中contextConfigLocation的值相对应:即classpath:springservlet-config.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:p="http://www.springframework.org/schema/p" xmlns:context="http://www.springframework.org/schema/context" xmlns:util="http://www.springframework.org/schema/util" xmlns:mvc="http://www.springframework.org/schema/mvc" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd" > <!-- 使用默认的注解映射 --> <mvc:annotation-driven/> <!-- 自动扫描controller包中的控制器 --> <context:component-scan base-package="controller"/> <!-- 视图解析路径配置 --> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/> <property name="contentType" value="text/html"/> <property name="prefix" value="/WEB-INF/page/"/> <property name="suffix" value=".jsp"/> </bean> <!-- Json转换器配置 --> <bean id="mappingJackson2HttpMessageConverter" class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"> <property name="supportedMediaTypes"> <list> <value>text/html;charset=UTF-8</value> </list> </property> </bean> <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter"> <property name="messageConverters"> <list> <ref bean="mappingJackson2HttpMessageConverter" /> </list> </property> </bean> <!-- 配置静态资源(JS、CSS、图片等)的访问路径 --> <mvc:resources location="/WEB-INF/plugin/" mapping="/plugin/**"/> </beans>
其中需要说明的是文件最后位置的mvc:resources属性,因之前在web.xml中设置的是拦截所有请求,因此页面文件访问服务器的JS、CSS、图片等文件时也会被拦截掉。这里配置了静态资源的访问路径,所以对“plugin”这个文件夹下内容的访问将不再被拦截(因此应将将这些文件放在plugin文件夹里),
以上就是Spring MVC的基本配置了,下面新建一个包:controller,在其下再新建一个类:LoginController,作为登录控制器,用来处理用户登录的请求,代码如下:
package controller; import java.util.HashMap; import java.util.List; import java.util.Map; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.servlet.ModelAndView; import service.PersonService; import entity.Person; @Controller public class LoginController { //域名访问跳转到登录页 @RequestMapping("/") public String index(){ return "login"; } //登录跳转到首页 @RequestMapping(value="/login",method = RequestMethod.POST) public ModelAndView login(String nickname){ ModelAndView mv = new ModelAndView(); mv.setViewName("home/index"); mv.addObject("nickname",nickname); return mv; } //获取人员信息 @RequestMapping(value="/getPersonData.do") @ResponseBody //添加该注释后,返回值将由转换器进行转换,转换器为Jackson,所以会转换成json格式 public Map<String,Object> getPersonData(){ Map<String,Object> personMap = new HashMap<String,Object>(); PersonService service = new PersonService(); List<Person> personData = service.getPersonInfo(); personMap.put("rows",personData); return personMap; } }
类前面前加了“@Controller”注释,因上面Spring MVC配置文件中配置了对controller包的扫描,所以加了注释的类会被spring容器自动识别。“@RequestMapping”注释用来配置跳转,可以直接返回一个字符串来匹配要跳转的JSP文件名称,也可以返回一个ModelAndView,里面除了包含跳转文件名称,还可以包含参数。添加了“@ResponseBody”注释的函数,其返回值会被转换器进行转换,因在配置文件中设置了转换器为Jackson,所以会转换成json格式。
为了模拟一个web应用的开发,再新建两个类:personService和PersonBean,作为业务逻辑和数据模型。
其代码如下:
Person:
package entity; public class Person { private Integer id; private String name; private String age; private String description; public Person(Integer id, String name, String age, String description) { this.id = id; this.name = name; this.age = age; this.description = description; } public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getAge() { return age; } public void setAge(String age) { this.age = age; } public String getDescription() { return description; } public void setDescription(String description) { this.description = description; } }
Person类为一个POJO,用来存储人员信息。
PersonService:
package service; import java.util.ArrayList; import java.util.List; import entity.Person; public class PersonService { public List<Person> getPersonInfo(){ List<Person> personData = new ArrayList<Person>(); //填充数据 Person p = null; p = new Person(1,"小明","25","中共党员"); personData.add(p); p = new Person(1,"小华","21","共青团员"); personData.add(p); p = new Person(1,"小丽","13","少先队员"); personData.add(p); return personData; } }
PersonService只包含一个方法getPersonInfo,返回3条含有数据的Person实例。
以上就是用到的JAVA代码了,下面新建两个JSP文件login.jsp和index.jsp作为前台页面,其代码分别如下:
login.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>登录</title> </head> <body> <form id="loginFrom" name="loginFrom" method="post" action="login.do"> <label>请输入昵称:</label> <input id="nickname" name="nickname" type="text"/> <button id="login" type="submit">登录</button> </form> <h2 id="errorMsg">${errorMsg}</h2> </body> </html>
index.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>欢迎</title> <script src="plugin/jquery-1.11.2.js"></script> <script type="text/javascript"> function getPersonData() { $.ajax({ url: "getPersonData.do", success: function (result) { var content = ""; for (var i = 0; i < result.rows.length; i++) { var item = result.rows[i]; content += item.name+","+item.age+","+item.description+"<br>"; } $("#personData").after(content); } }); } </script> </head> <body> 你好!${nickname}<br> <button onclick="getPersonData()" id="submitButton">获取人员信息</button> <div id="personData"></div> </body> </html>
这里使用了jQuery,将jQuery文件其放到plugin文件夹下即可。
以上就是整个示例工程的代码了,部署到Tomcat后,访问 http://localhost:8080/SpringMVC_Study/ ,弹出页面如下:
输入昵称后,点击“登录”,跳转至首页:
点击“获取人员信息”,会调用getPersonData方法,返回json格式数据,在index.jsp中对返回的json数据进行了解析,并输出到页面上:
OK,讲解完毕,希望能对你有所帮助 :)
另外,如果你是在一个项目组中,或者研发一个较大的系统,建议使用3.x版本,目前对4.x版本的资料还比较有限,而且一些接口也发生了变化,很容易造成麻烦(比如配置Jackson,3和4就不太一样,坑了我好久。。。)