Spring MVC基本配置

前言

原创文章转载请注明出处,文中错误欢迎指正。

使用Spring MVC已经有很长一段时间了,但在使用中还有存在一些模棱两可的细节,趁这次机会争取将所有的这些问题一一解决,以便今后更加熟练地使用这个框架来解决问题。

创建一个基于Maven的Web项目

使用的IDE是IDEA,简单介绍一下步骤:

  1. 新建一个空的maven类型的module;
  2. 为这个module添加web支持(本质上是在src/main/下面添加了一个webapp目录,其中webapp目录包含WEB-INF/web.xml目录和文件)。事实上,webapp这个目录的名字可以随便取,但是需要在IDEA中配置这个目录的路径,以便于在打包的时候,IDEA可以帮你将该目录中的内容复制到项目的根目录下;
基于maven的web项目的目录结构

添加Spring MVC的maven依赖

使用maven管理jar包依赖非常的方便。对于Spring MVC而言,只需要引入一个依赖。在项目的pom.xml文件中添加spring-webmvc的依赖:

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>3.2.3.RELEASE</version>
</dependency>

之后,maven会自动解决依赖,并把其依赖的所有jar包引入,如下图所示:

maven自动引入了所有依赖的jar包

由上图可见,在Spring3.2.3中,Spring MVC依赖了如下几个包:

  • spring-beans:
  • spring-context:
  • spring-aop:
  • spring-core:
  • spring-web:
  • spring-expression:
  • commons-logging:
  • aopalliance:

配置Spring MVC

首先,在resources目录下面添加一个config目录,在config目录中创建一个名为spring-mvc-config.xml的文件(resouces/config/spring-mvc-config.xml)来作为Spring MVC的配置文件。这个文件的名字可以随便取,因为之后我们可以在web.xml文件中自定义指定这个文件的位置和名称。

配置web.xml文件

Spring MVC之所以可以整合到web应用中,是通过名为一个由框架提供的名为DispatcherServlet的servlet拦截请求实现的。因此,在web.xml中添加这个servlet,如下:

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <servlet>
        <servlet-name>springmvc-app</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:config/spring-mvc-config.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>springmvc-app</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

需要注意两点:

  • <init-param>中指定了该servlet启动时的参数contextConfigLocation,这个参数的值用来指定Spring MVC的配置文件的位置。
  • <load-on-startup>通常应为正整数,指定启动顺序,值越小优先级越高。此处设置为1表示第一个启动。

<url-pattern>写成//*的区别

注意到,<servlet-mapping>中的<url-pattern>参数为/,而如果写成/*又有什么区别呢?

先看结论:

  • <url-pattern>/</url-pattern>:会匹配到/springmvc这样的路径型url,不会匹配到模式为*.jsp这样的后缀型url。
  • <url-pattern>/*</url-pattern>:会匹配所有的url:路径型的和后缀型的url(包括/springmvc,.jsp,.js和*.html等)。

下面是关于这个问题在stack overflow上的解释:
原文链接:http://stackoverflow.com/questions/4140448/difference-between-and-in-servlet-mapping-url-pattern
简单的翻译如下:
<url-pattern>/*</url-pattern>这种形式将会覆盖所有其它的servlet。不管你发出了什么样的请求,最终都会在这个servlet中结束。因此,对于servlet来说,这是一个很糟糕的URL模式。通常来讲,你只会想要在一个Filter中使用这种模式。它可以通过调用doFilter()方法来使请求继续。
<url-pattern>/</url-pattern>这种形式不会覆盖任何其它的servlet。它仅仅替换了servlet容器中内建的默认servlet。这种形式通常只用来请求静态资源(CSS/JS/image等)和展示目录的列表。servlet容器内建的默认servlet同样可以处理HTTP cache请求、媒体(声音/视频)流以及文件的下载。通常来说,你不会想要覆盖这个默认的servlet,否则,你将不得不自己处理一些琐碎的任务。因此,对于sevlet来说,这同样是一个糟糕的URL模式。说到为什么JSP页面的请求并不会命中这个servlet,那是因为servlet容器内建的JSP servlet将会被调用,而这个容器内建的JSP servlet已经默认地映射在了*.jsp上。
<url-pattern></url-pattern>这种空串的形式。当上下文的根被请求的时候,它将被调用。这与<welcome-file>的方式是不同的,因为这种形式在当任何子目录被请求的时候不会被调用。当你期望一个“首页servlet”的时候,这种URL模式就是适合你的。

配置spring-mvc-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:context="http://www.springframework.org/schema/context"
       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">

    <context:component-scan base-package="me.johnshen.springmvc.controller"/>

    <bean id="viewResolver"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

使用注解标识Controller类

package me.johnshen.springmvc.controller;

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

@Controller
@RequestMapping("/springmvc")
public class HelloWorldController {
    @RequestMapping("/helloworld")
    public String sayHello(){
        System.out.println("Hello World!");
        return "helloworld";
    }
}

@Controller表示该类作为项目的控制器组件;
类级别@RequestMapping表示所有该类中方法级别@RequestMapping都要相对于这个类级别@RequestMapping的值;
方法级别@RequestMapping相对于类级别@RequestMapping的映射路径。

请求的处理过程

当有请求http://localhost:8080/springmvc/helloworld时,请求会被Spring MVC的DispatcherServlet拦截,并映射到HelloWorldControllersayHello()方法上处理。

返回的helloworld将被交给配置在spring-mvc-config.xml文件中的InternalResourceViewResolver视图处理器处理。

这个处理器的配置将controller中返回的字符串"success",加上前缀"/WEB-INF/views/jsp/",加上后缀".jsp",拼成资源的完整路径"/WEB-INF/views/jsp/helloworld.jsp",最后返回该jsp视图。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,406评论 5 475
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,976评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,302评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,366评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,372评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,457评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,872评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,521评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,717评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,523评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,590评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,299评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,859评论 3 306
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,883评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,127评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,760评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,290评论 2 342

推荐阅读更多精彩内容