Spring回顾之二 —— 引入SpringMVC

    上篇笔记创建了一个maven的简单web项目，熟悉了下一个基本项目的组成结构，当然这样的项目没有什么实际功能，我们需要一步步添加元素。
    本系列文章初衷是想一步步回顾知识，不急于一次求成，所以本文只想展示如何在项目中集成SpringMVC这个模块。就使用Spring而言，一个完整的系统需要在Spring核心框架之上，集成一系列拥有各种功能的框架模块，才能将实际的业务逻辑按照分工进行协作。这里先简单认识下SpringMVC，一个小而美妙，功能强悍的MVC框架，SpringMVC的各种优点暂且不表，我们先下手。

第一步：相关依赖的引入
    现实使用中Maven最惊艳的地方就是对jar包的管理，记得当年刚接触编程的时候，没有用maven这类工具，创建项目的时候总是拿含着有一堆jar包的文件，往项目的lib文件下拷贝，然后又被各种兼容问题搞得烦恼不已，还要去不厌其烦的去找兼容的jar包资源，这也会导致在升级某些重要jar包的时候，可能要头疼一下。使用Maven就会方便多了，我们来感受一下这种惬意，修改项目中的pom.xml文件，添加部分内容，内容如下

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>test</groupId>
  <artifactId>demo</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>
  
  <properties>  
  	<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	<spring.version>4.3.5.RELEASE</spring.version>  
  </properties> 

  <dependencies>
	<!-- ============== spring begin  ============== -->
    <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-webmvc</artifactId>
         <version>${spring.version}</version>
     </dependency>
	<!-- ============== spring end ============== -->
</dependencies>

  <build>
    <finalName>demo</finalName>
    <plugins>    
      <plugin>    
          <groupId>org.apache.maven.plugins</groupId>    
          <artifactId>maven-compiler-plugin</artifactId>    
          <configuration>    
              <source>1.8</source>    
              <target>1.8</target>    
          </configuration>    
      </plugin>    
  </plugins>
  </build>
</project>

    properties元素的spring.version是做了一个类似于常量的定义，方便统一管理，我们用的是Spring的4.3.5.RELEASE。这里主要的就是这个spring-webmvc，我们添加了对spring-webmvc的依赖，保存文件后，项目右键执行Maven->Update Project，这时依赖相关的jar包会被下载到本地。注意这个动作的同时，不仅仅是下载我们pom文件中要引入的jar包，是连同spring-webmvc本身依赖的jar包，也一并给处理了，这个很爽，我们可以看到Libraries的Maven Dependencis下，会有一组jar包出现，如图


    这个感觉是蛮爽的，除此之外，Maven还有很多很实用的用法，有兴趣可以查查资料。在此基础上，即使有jar包的兼容问题，我们也不用漫山遍野的去找jar包了，我们只需要来回修改它的版本，这是相当方便的。接下来我们要看看怎么使用这个SpringMVC。

第二步：使用SpringMVC
    我们这里是体验SpringMVC功能的，所以没有引入其他的东西，修改web.xml，将项目交给SpringMVC的DispatcherServlet，代码如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC 
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
 "http://java.sun.com/dtd/web-app_3_1.dtd">

<web-app>
	<display-name>SpringDemo</display-name>

    <!-- spring mvc 配置 -->
    <servlet>
        <servlet-name>SpringDemo</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>  
            <param-name>contextConfigLocation</param-name>  
            <param-value>classpath*:/spring-mvc.xml</param-value>
        </init-param>  
        <load-on-startup>1</load-on-startup>  
    </servlet>
    <servlet-mapping>
        <servlet-name>SpringDemo</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <welcome-file-list>  
        <welcome-file>index.jsp</welcome-file>  
    </welcome-file-list>
</web-app>

    这段代码是用来配置DispatcherServlet的，意思的是该工程将采用springmvc。注意init-param参数的配置，指定了要加载Servlet的配置文件，没有这段代码则启动时也会默认去/WEB-INF目录下加载名为SpringMVCDemo-servlet(默认文件名是servlet名字+-servlet)的xml文件作为配置文件，前提是这个文件必须存在。
    紧接着我们在resources文件夹下（之后都会在这个文件夹下做配置文件的管理）创建一个名为spring-mvc.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:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd 
    http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd ">
    <!-- 自动扫描包，实现支持注解的IOC -->
    <context:component-scan base-package="test.demo"></context:component-scan>
	<!-- 视图解析器 -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">    
        <property name="prefix" value="/WEB-INF/views/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean> 
</beans>

    这里边指定了Servlet加载后，会去扫描注解的包目录，和返回显示文件的解析内容，注意这里边的/WEB-INF/views/，也就是说在DispatcherServlet管理下的页面文件将在这里进行管理。

第三步：添加测试用的文件
    首先我们先按刚才配置文件说的创建包路径，并在包内创建一个叫TestSpringController的java类，内容如下

package test.demo;

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;

@Controller
public class TestSpringController {
    
    @RequestMapping(value="/mvcIndex", method=RequestMethod.GET)
    public ModelAndView  mvcIndex() {
        return new ModelAndView("mvcIndex");
    }
    
    @RequestMapping(value="/getHello", method=RequestMethod.GET)
    @ResponseBody
    public String  getHello() {
        return "Hello Controller!";
    }

}

    注意这里边的两个测试方法，一个是想返回一个名字为mvcIndex的视图，根据配置文件的内容，这个将是/WEB-INF/views/下一个叫mvcIndex.jsp的文件。另外的getHello是想返回一个"Hello Controller!"的字符串。关于Controller有许多知识需要认真回顾，这里不多说，我们在WEB-INF下建立views/mvcIndex.jsp文件，以便区分，内容如下

<html>
	<body>
		<h1>Hello SpringMVC World!</h1>
	</body>
</html>

    以上的工作完成后，整个项目文件结构基本就是下图的样子


    接下来要试试运行起来是什么样子。

第四步：运行测试
    将项目打包，部署至Tomcat，启动运行，等启动之后，我们在浏览器输入：http://localhost:8080/demo/回车，还是原来的样子


    然后换个姿势：http://localhost:8080/demo/mvcIndex 回车


    接着再来个姿势：http://localhost:8080/demo/getHello 回车


    注意这个getHello，其实返回的是一个字符串，这里用的是火狐，直接在浏览器里显示了，不同的浏览器可能会有不同的表现。

    这里是对SpringMVC的一个独立的简单体验，注意包的引入、配置文件和Controller这里有不少知识，还是需要深入了解下的，希望对大家也有所帮助。