Spring MVC入门（4.1版本）

Love The Way You Lie 2022-08-18 08:33 154阅读 0赞

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/

导入的包如下图所示：

![271609569527052.jpg][]

（当然，如果你懒得下载，可以直接下载我的工程，将里面lib文件夹下的包导入你自己的工程里去即可。）

新建一个web工程，名称为SpringMVC\_Study，之后配置web.xml，内容如下：

<?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">
     	
     	       
        <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> 
      	
      	
      	<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/>
    
        
        <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>
        
        
        <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>  
        
        
        <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作为前台页面，其代码分别如下：

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/ ，弹出页面如下：

![271708479059125.jpg][]

输入昵称后，点击“登录”，跳转至首页：

![271709132027264.jpg][]

点击“获取人员信息”，会调用getPersonData方法，返回json格式数据，在index.jsp中对返回的json数据进行了解析，并输出到页面上：

![271711130621646.jpg][]

OK，讲解完毕，希望能对你有所帮助 ：）

另外，如果你是在一个项目组中，或者研发一个较大的系统，建议使用3.x版本，目前对4.x版本的资料还比较有限，而且一些接口也发生了变化，很容易造成麻烦（比如配置Jackson，3和4就不太一样，坑了我好久。。。）

转自：[http://www.csdn123.com/html/topnews201408/66/12066.htm][http_www.csdn123.com_html_topnews201408_66_12066.htm]

[271609569527052.jpg]: /images/20220731/75a3d45b38484454804a446b9917b0b9.png
[271708479059125.jpg]: /images/20220731/3b3b346e8a3746a0838d11f3def3b2f0.png
[271709132027264.jpg]: /images/20220731/dd1a3292e8424a46bfb8c4ba5448e197.png
[271711130621646.jpg]: /images/20220731/256a20bb60f942ebb42eee95b1ee729f.png
[http_www.csdn123.com_html_topnews201408_66_12066.htm]: http://www.csdn123.com/html/topnews201408/66/12066.htm