SpringMVC | 快速上手SpringMVC

博主简介：
    Java领域新星创作者
    阿里云开发者社区专家博主、星级博主、技术博主
交流社区：BoBooY（优质编程学习笔记社区）

前言：在上一节中我们了解了什么是SpringMVC，这一节带大家来快速体验一下SpringMVC的使用！

第一个SpringMVC程序

1、配置版

1、新建一个Module ， springmvc-02-hello ， 添加web的支持！

2、确定导入了SpringMVC 的依赖！

3、配置web.xml ， 注册DispatcherServlet

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"        
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"        
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                             http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
      
    <servlet>       
        <servlet-name>springmvcservlet-name>       
        <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>       
               
        <init-param>           
            <param-name>contextConfigLocationparam-name>           
            <param-value>classpath:springmvc-servlet.xmlparam-value>       
        init-param>       
               
        <load-on-startup>1load-on-startup>   
    servlet>
      
       
    <servlet-mapping>       
        <servlet-name>springmvcservlet-name>       
        <url-pattern>/url-pattern>   
    servlet-mapping>
web-app>

4、编写SpringMVC 的 配置文件！名称：springmvc-servlet.xml : [servletname]-servlet.xml

说明，这里的名称要求是按照官方来的

<beans xmlns="http://www.springframework.org/schema/beans"      
       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.xsd">
beans>

5、添加 处理器映射器

<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>

6、添加 处理器适配器

<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>

7、添加 视图解析器

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

8、编写我们要操作业务Controller ，要么实现Controller接口，要么增加注解；需要返回一个ModelAndView，装数据，封视图；

package com.bby.controller;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
//注意：这里我们先导入Controller接口
public class HelloController implements Controller {
   public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {       
       //ModelAndView 模型和视图       
       ModelAndView mv = new ModelAndView();
       //此处应为调用业务层
       
       //封装对象，放在ModelAndView中。Model       
       mv.addObject("msg","HelloSpringMVC!");       
       //封装要跳转的视图，放在ModelAndView中       
       mv.setViewName("hello"); 
       //: /WEB-INF/jsp/hello.jsp       
       return mv;  
   }   
}

9、将自己的类交给SpringIOC容器，注册bean

<bean id="/hello" class="com.bby.controller.HelloController"/>

10、写要跳转的jsp页面，显示ModelandView存放的数据，以及我们的正常页面；

<%@ page contentType="text/html;charset=UTF-8" language="java" %>

       
        
    
    
        ${msg}
    

11、配置Tomcat 启动测试！

可能遇到的问题：访问出现404

排查步骤：

1. 查看控制台输出，看一下是不是缺少了什么jar包。
2. 如果jar包存在，显示无法输出，就在IDEA的项目发布中，添加lib依赖！
3. 重启Tomcat 即可解决！

2、注解版

1、新建一个Moudle，springmvc-03-hello-annotation 。添加web支持！

2、由于Maven可能存在资源过滤的问题，我们将配置完善

<build> 
    <resources>  
        <resource>    
            <directory>src/main/javadirectory>    
            <includes>          
                <include>**/*.propertiesinclude>         
                <include>**/*.xmlinclude>   
            includes>    
            <filtering>falsefiltering> 
        resource>     
        <resource>     
            <directory>src/main/resourcesdirectory>     
            <includes>        
                <include>**/*.propertiesinclude>      
                <include>**/*.xmlinclude>    
            includes>     
            <filtering>falsefiltering>  
        resource> 
    resources>
build>

3、在pom.xml文件引入相关的依赖：主要有Spring框架核心库、Spring MVC、servlet , JSTL等。我们在父依赖中已经引入了！

4、配置web.xml

注意点：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"        
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"      
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"        
         version="4.0">
     
    <servlet>    
        <servlet-name>SpringMVCservlet-name>   
        <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class> 
             
        <init-param>       
            <param-name>contextConfigLocationparam-name>       
            <param-value>classpath:springmvc-servlet.xmlparam-value>   
        init-param>   
          
        <load-on-startup>1load-on-startup> 
    servlet>
    
    <servlet-mapping>     
        <servlet-name>SpringMVCservlet-name>    
        <url-pattern>/url-pattern> 
    servlet-mapping>
web-app>

/ 和 /* 的区别：< url-pattern > / 不会匹配到.jsp， 只针对我们编写的请求；即：.jsp 不会进入spring的 DispatcherServlet类 。< url-pattern > /* 会匹配 *.jsp，会出现返回 jsp视图 时再次进入spring的DispatcherServlet 类，导致找不到对应的controller所以报404错。

• 注意web.xml版本问题，要最新版！

• 注册DispatcherServlet

• 关联SpringMVC的配置文件

• 启动级别为1

• 映射路径为 / 【不要用/*，会404】

5、添加Spring MVC配置文件

在resource目录下添加springmvc-servlet.xml配置文件，配置的形式与Spring容器配置基本类似，为了支持基于注解的IOC，设置了自动扫描包的功能，具体配置信息如下：

<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"     
       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/context       
                           https://www.springframework.org/schema/context/spring-context.xsd       
                           http://www.springframework.org/schema/mvc   
                           https://www.springframework.org/schema/mvc/spring-mvc.xsd">
    
    <context:component-scan base-package="com.bby.controller"/> 
     
    <mvc:default-servlet-handler />
     
    <mvc:annotation-driven />
    
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"   
          id="internalResourceViewResolver">  
            
         <property name="prefix" value="/WEB-INF/jsp/" />   
              
         <property name="suffix" value=".jsp" />   
    bean>
   beans>

在视图解析器中我们把所有的视图都存放在/WEB-INF/目录下，这样可以保证视图安全，因为这个目录下的文件，客户端不能直接访问。

• 让IOC的注解生效

• 静态资源过滤 ：HTML . JS . CSS . 图片 ， 视频 …

• MVC的注解驱动

• 配置视图解析器

补充： ssm访问页面404/静态资源的问题

我们在配置dispatchServlet时配置

<servlet>
  <servlet-name>SpringMVCservlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
  <init-param>
    <param-name>contextConfigLocationparam-name>
    <param-value>classpath:spring-mvc.xmlparam-value>
  init-param>
  <load-on-startup>1load-on-startup>
servlet>
<servlet-mapping>
  <servlet-name>SpringMVCservlet-name>
  <url-pattern>/url-pattern>
servlet-mapping>

/拦截所有请求包括静态资源，springMVC会将静态资源当做一个普通的请求处理,从而也找不到相应的处理器导致404错误.这时候dispatchServlet完全取代了default servlet，将不会再访问容器中原始默认的servlet，而对静态资源的访问就是通过容器默认servlet来处理的，故而这时候静态资源将不可访问。当然可以配置*.do 、 *.xhtml等方式,但这样就无法采用真正的REST风格的URL.spring是一个得到广泛应用的javaEE框架,在spring3后增加了rest,也是spring3里很重要的功能之一,固spring团队给出了静态资源处理的方法:

采用

在springmvc的配置文件中配置后,会在springMVC上下定义一个default servlet,从而
对请求进行筛查,如果发现是静态资源就由default servlet来处理,
如果不是静态资源才由DispatcherServlet接着处理.
这里有有一点要注意,default servlet对于使用beanName方式配置的处理器,是可以访
问的.但是对于@RequestMapping注解方式配置的处理器是不起作用的,
因为没有相应的HandlerMapping和HandlerAdapter支持注解的使用。这时候可以使
用配置在容器中注册支持@RequestMapping注解的组件即可.

6、创建Controller

编写一个Java控制类：com.kuang.controller.HelloController , 注意编码规范

package com.bby.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("/HelloController")
public class HelloController {
    //真实访问地址 : 项目名/HelloController/hello 
    @RequestMapping("/hello")  
    public String sayHello(Model model){       
        //向模型中添加属性msg与值，可以在JSP页面中取出并渲染       
        model.addAttribute("msg","hello,SpringMVC");  
        //web-inf/jsp/hello.jsp     
        return "hello";  
    }
}

• @Controller是为了让Spring IOC容器初始化时自动扫描到；
• @RequestMapping是为了映射请求路径，这里因为类与方法上都有映射所以访问时应该是/HelloController/hello；
• 方法中声明Model类型的参数是为了把Action中的数据带到视图中；
• 方法返回的结果是视图的名称hello，加上配置文件中的前后缀变成WEB-INF/jsp/hello.jsp。

7、创建视图层

在WEB-INF/ jsp目录中创建hello.jsp ， 视图可以直接取出并展示从Controller带回的信息；

可以通过EL表示取出Model中存放的值，或者对象；

 <%@ page contentType="text/html;charset=UTF-8" language="java" %>
 
       
         
     
     
         ${msg}
     
 

8、配置Tomcat运行

配置Tomcat ， 开启服务器 ， 访问 对应的请求路径！

OK，运行成功！

3、小结

实现步骤其实非常的简单：

1. 新建一个web项目
2. 导入相关jar包
3. 编写web.xml , 注册DispatcherServlet
4. 编写springmvc配置文件
5. 接下来就是去创建对应的控制类 , controller
6. 最后完善前端视图和controller之间的对应
7. 测试运行调试.

使用springMVC必须配置的三大件：

处理器映射器、处理器适配器、视图解析器

通常，我们只需要手动配置视图解析器，而处理器映射器和处理器适配器只需要开启注解驱动即可，而省去了大段的xml配置

再来回顾下原理吧~

尾言：创作不易，如果本文的内容对您有帮助，还望客官可以三连支持一下博主，（点赞）+✏️（评论）+⭐️（收藏）是我创作的巨大动力！