【SpringMVC】基础配置

本词介绍以Maven项目为例。

先来看以下目录结构

介绍一下，java下面的包com.dongle.spring.web为Controller层，src下的resources为相关配置和属性设置内容，webapp为网站页面内容区，web.xml是网站的配置配置信息，views为页面如jsp、html等位置，webapp下的resources为静态资源（可以根据自己需要更改名字，后续只要对应即可），pom.xml为maven项目的配置内容。

下面来看以下详细的内容

首先要了解springmvc最基本的需要内容，方便通过maven进行配置（主要是dependencies的要有）

<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/maven-v4_0_0.xsd">
    <parent>
        <artifactId>demo-spring</artifactId>
        <groupId>com.dongle.demo</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>spring-mvc</artifactId>
    <packaging>war</packaging>
    <name>spring-mvc</name>

    <dependencies>
        <!--必须存在，否则找不到@Controller等注解-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
        </dependency>
        <!--spring-web必须配置，否则找不到@RequestMapping等注解-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
        </dependency>
        <!-- 必须：在web.xml中的前端控制器中使用的控制器时spring-webmvc中的，而不是spring-web包中的-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
        </dependency>
    </dependencies>
    <build>
        <finalName>spring-mvc</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

上面配置完成之后，可以选择创建Controller了，需要了解Controller需要有注解@Controller来修饰，方便springmvc容器扫描到Controller。

以HomeController为例

package com.dongle.spring.web;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import javax.servlet.http.HttpServletRequest;

/**
 * @author Kevin
 */
@Controller
public class HomeController {

    @RequestMapping(value = "/",method = RequestMethod.GET)
    public String index(){
        return "index";
    }

    @RequestMapping(value = "/redict",method = RequestMethod.GET)
    public String home(){
        return "home";
    }

    @RequestMapping(value = "/login",method = RequestMethod.POST)
    public String login(HttpServletRequest request){
        String username = request.getParameter("username");
        String password = request.getParameter("password");
        System.out.println("username = [" + username + "]");
        System.out.println("password = [" + password + "]");
        return "home";
    }
}

注解@RequestMapping是对应的url访问路径，不仅每个方法可以设置（但必须确保不同），Controller也可以设立自己独有的url（当然也必须唯一）

配置springmvc.xml，用来配置Controller，以便可以访问Controller内容。

<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:contest="http://www.springframework.org/schema/context"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
    http://www.springframework.org/schema/mvc
    http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context-3.2.xsd">

    <!-- Spring启用注解驱动 -->
    <!-- 激活基于注解的配置 @RequestMapping, @ExceptionHandler,数据绑定 ,@NumberFormat ,
    @DateTimeFormat ,@Controller ,@Valid ,@RequestBody ,@ResponseBody等  -->
    <!--相当于注册了DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter两个bean，配置一些messageconverter。-->
    <mvc:annotation-driven/>

    <!-- 配置根视图 -->
    <mvc:view-controller path="/" view-name="index"/>

    <!--必须：扫描包，扫描Controller-->
    <!--以下方式扫描所有的符合spring注解的文件，不仅仅是Controller-->
    <!-- base-package到包即可，不要多加*  -->
    <contest:component-scan base-package="com.dongle.spring.web"/>
    <!-- 当在web.xml 中   DispatcherServlet使用 <url-pattern>/</url-pattern> 映射时，能映射静态资源 -->
    <mvc:default-servlet-handler />
    <!-- 必须：静态资源文件路径映射；在springmvc中无法直接访问静态资源，必须进行静态资映射才能访问-->
    <mvc:resources mapping="/resources/**" location="/resources/"/>

    <!-- 对模型视图添加前后缀;视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 前缀 -->
        <property name="prefix" value="/WEB-INF/views/"/>
        <!-- 后缀 -->
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

上面的配置只是仅仅只是配置能访问Controller，但是由于webapp的特性，不能直接获取和使用其它配置，所以就需要通过web.xml来进行关联配置，这里面主要是配置到servlet也就是前端控制器，用来控制访问可以到Controller。

下面内容即web.xml的相关配置

<?xml version="1.0" encoding="UTF-8"?>
<web-app>

    <!--<description>描述信息</description>-->
    <!--<display-name>显示名称</display-name>-->
    <!--<servlet-name>Servlet的名称</servlet-name>-->
    <!--<servlet-class>Servlet所引用的类名</servlet-class>-->

    <display-name>spring mvc</display-name>

    <!-- spring监听程序 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- 必须：springMVC核心配置，前端控制器DispatcherServlet 如下图映射配置表示控制所有路径-->
    <servlet>
        <servlet-name>action</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 初始化 -->
        <init-param>
            <!-- 配置文件初始化 -->
            <!-- 不是必须配置的，如果没有配置，则默认为 WEB-INF/springMVC-servlet.xml -->
            <param-name>contextConfigLocation</param-name>
            <!-- springmvc.xml 配置文件路径 -->
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>
        <!-- 加载顺序；数值越小，越先被加载 -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <!-- servlet 映射 -->
    <servlet-mapping>
        <!-- 与上面配置的servlet-name要一致 -->
        <servlet-name>action</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!-- 过滤器 Filter-->
    <filter>
        <filter-name>SpringEncodingFilter</filter-name>
        <!-- 过滤器类 -->
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <!-- 编码格式属性设置：用来指定一个具体的字符集-->
            <param-name>encoding</param-name>
            <param-value>UTF8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <!-- 与上面配置的filter-name保持一直-->
        <filter-name>SpringEncodingFilter</filter-name>
        <!-- 过滤所有请求：这里和servlet不同，/* 代表全部请求，而servlet中/ 即代表全部-->
        <url-pattern>/*</url-pattern>
    </filter-mapping>

</web-app>