第一个MVC程序(注解版)SpringMVC的精髓

130 阅读3分钟

1、新建一个Moudle,springmvc-03-hello-annotation。

image.png

手动添加web支持!

image.png

image.png

image.png

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

<build>
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>false</filtering>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>false</filtering>
        </resource>
    </resources>
</build>

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

image.png

<!--导入依赖-->
<dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.1.9.RELEASE</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>jsp-api</artifactId>
        <version>2.2</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>jstl</artifactId>
        <version>1.2</version>
    </dependency>
</dependencies>

4、配置web.xml

注意点

<?xml version="1.0" encoding="UTF-8"?>
<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">


    <!--    配置DispatchServlet: 这个是SpringMVC的核心: 请求分发器,前端控制器-->
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--DispatcherServlet要绑定SpringMVC的配置文件    -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-servlet.xml</param-value>
        </init-param>
        <!--启动级别: 1-->
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!--
    在springMVC中,/ 和 /* 是有区别的
    /: 只匹配所有的请求,不会去匹配jsp页面
    /*: 不仅会匹配所有的请求,还会去匹配jsp页面
    -->
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>


</web-app>

/ 和 / 的区别:*

< url-pattern > / </ url-pattern > 不会匹配到.jsp, 只针对我们编写的请求;即:.jsp 不会进入spring的 DispatcherServlet类 。

< url-pattern > /* </ url-pattern > 会匹配 *.jsp,会出现返回 jsp视图 时再次进入spring的DispatcherServlet 类,导致找不到对应的controller所以报404错。

-   注意web.xml版本问题,要最新版!
-   注册DispatcherServlet
-   关联SpringMVC的配置文件
-   启动级别为1
-   映射路径为 / 【不要用/*,会404】

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

image.png

<?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"      
    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">

   <!-- 自动扫描包,让指定包下的注解生效,由IOC容器统一管理 -->   
   <context:component-scan base-package="com.aug.controller"/>   
   <!-- 让Spring MVC不处理静态资源 -->   
   <mvc:default-servlet-handler />   
   <!--   
   支持mvc注解驱动       
       在spring中一般采用@RequestMapping注解来完成映射关系       
       要想使@RequestMapping注解生效       
       必须向上下文中注册DefaultAnnotationHandlerMapping       
       和一个AnnotationMethodHandlerAdapter实例       
       这两个实例分别在类级别和方法级别处理。       
       而annotation-driven配置帮助我们自动完成上述两个实例的注入。    
   -->   
   <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的注解驱动
-   配置视图解析器

6、创建Controller 编写一个Java控制类:com.kuang.controller.HelloController , 注意编码规范

image.png

package com.aug.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中存放的值,或者对象;

image.png

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

8、配置Tomcat运行

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

image.png

OK,运行成功!

可能遇到的问题:访问出现404,排查步骤:

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


image.png

小结

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

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

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

原理

image.png