【java后端】通过一个小demo快速上手SpringMVC

于小毛
545 阅读6分钟

介绍

框架介绍：

参考：c.biancheng.net/spring_mvc/…

Spring MVC

Spring MVC 是 Spring 提供的一个基于 MVC 设计模式的轻量级 Web 开发框架，本质上相当于 Servlet。

MVC开发介绍

MVC 设计模式一般指 MVC 框架，M（Model）指数据模型层，V（View）指视图层，C（Controller）指控制层。使用 MVC 的目的是将 M 和 V 的实现代码分离，使同一个程序可以有不同的表现形式。其中，View 的定义比较清晰，就是用户界面。

总结如下：

  • 视图层（View）：负责格式化数据并把它们呈现给用户，包括数据展示、用户交互、数据验证、界面设计等功能。
  • 控制层（Controller）：负责接收并转发请求，对请求进行处理后，指定视图并将响应结果发送给客户端。
  • 数据模型层（Model）：模型对象拥有最多的处理任务，是应用程序的主体部分，它负责数据逻辑（业务规则）的处理和实现数据操作（即在数据库中存取数据）。

请求处理流程

熟悉javaweb开发的小伙伴可能知道，tomcat在接收用户对动态资源的请求时，会调用servlet处理请求，一个servlet对应一个请求，在开发时需要编写多个servlet类（继承HttpServlet的类）实现对请求的处理。

web开发底层是servlet， springmvc中有一个对象是Servlet ： DispatherServlet(中央调度器)

DispatherServlet: 负责接收用户的所有请求， 用户把请求给了DispatherServlet， 之后DispatherServlet把请求转发给我们的Controller对象， 最后是Controller对象处理请求。

1)DispatcherServlet叫做中央调度器， 是一个servlet， 它的父类是继承HttpServlet

2)DispatcherServlet页叫做前端控制器（front controller）

3)DispatcherServlet负责接收用户提交的请求， 调用其它的控制器对象，并把请求的处理结果显示给用户

我们要做的是 使用@Contorller创建控制器对象， 把对象放入到springmvc容器中， 把创建的对象作为控制器使用这个控制器对象能接收用户的请求， 显示处理结果，就当做是一个servlet使用。

本项目完成功能：

用户在页面发起不同请求， 请求交给springmvc的控制器对象，浏览器显示请求对应的处理结果。

编写第一个 Spring MVC 程序

1.在 IDEA 中新建 Maven 项目

1）新建 Maven 项目

image.png

2）完成基本的设置

image.png

3）创建好项目后，在main下创建java和resources文件夹，分别用于存放代码和配置文件。

image.png

image.png

2.编写pom.xml文件

修改pom文件，加入spring-webmvc依赖（包括了spring依赖），servlet依赖

<?xml version="1.0" encoding="UTF-8"?>
​
<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>com.bjpowernode</groupId>
  <artifactId>ch01-hello-springmvc</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>
​
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>
​
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
    <!--servlet依赖-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>
    <!--springmvc依赖-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>5.2.5.RELEASE</version>
    </dependency>
  </dependencies>
​
  <build>
    <plugins>
      <!-- 编码和编译和JDK版本 -->
      <plugin>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.1</version>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>
​

3.编写默认欢迎文件index.jsp

当访问网站时，会默认提供此欢迎文件以便于用户发出请求

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<p>hello springmvc</p>
<p><a href="hello.do">Say Hello~</a> </p>
<p><a href="bye.do">Say Bye~</a> </p>
</body>
</html>

发起的超链接请求省略了网站名称，等同于：

http://localhost:8080/myweb/hello.do

http://localhost:8080/myweb/bye.do

4.编写web.xml文件

4.1更新文件版本

新建项目的servlet版本较低，很多功能不支持（如el表达式等），需手动更改

image.png

点击File->Project Structure...，如图进行设置：

image.png

image.png

image.png

image-20210820110101489.png

4.2编写web.xml文件

1）在web.xml注册springmvc的核心对象DispatcherServlet

servlet对象会在用户请求到来时由tomcat自动创建，但是我们希望在tomcat服务器启动后，就创建好DispatcherServlet对象的实例。这是因为DispatcherServlet在创建过程中， 会读取springmvc的配置文件，创建springmvc容器对象，并把这个配置文件中的对象都创建好（如controller对象）， 当用户发起请求时就可以直接使用对象了。

springmvc创建容器对象时，读取的配置文件默认是/WEB-INF/<servlet-name>-servlet.xml，需手动配置配置文件地址。

2）将请求名称（等同于index.jsp中的请求）与servlet对应起来，本例将请求*.do与myweb，即DispatcherServlet对应起来，表示名字以.do结尾的请求都会交给DispatcherServlet这个servlet处理。（习惯上springmvc会把所有请求交给DispatcherServlet，并分派给controller对象的不同方法）

具体代码如下：

<?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">
​
    <servlet>
        <servlet-name>myweb</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        
        <!--自定义springmvc读取的配置文件的位置-->
        <init-param>
            <!--springmvc的配置文件的位置的属性-->
            <param-name>contextConfigLocation</param-name>
            <!--指定自定义文件的位置-->
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        
        <load-on-startup>1</load-on-startup>
        <!--在tomcat启动后，创建Servlet对象
            load-on-startup:值为大于等于0的整数，表示tomcat启动后创建对象的顺序，数值越小，
            tomcat创建对象的时间越早。 
        -->
    </servlet>
​
    <servlet-mapping>
        <servlet-name>myweb</servlet-name>
        <!--
            使用框架的时候， url-pattern可以使用两种值
            1)使用扩展名方式， 语法 *.xxxx , xxxx是自定义的扩展名。 
            2)使用斜杠 "/"
        -->
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>
​
</web-app>

5.配置tomcat服务器

需提前在电脑中安装tomcat，如图将tomcat服务器配置到项目中：

image.png

image.png

image.png

设置好后，点击deployment，点击加号，添加要部署的网站： \

image.png

选择部署的项目：

image.png

设置网站名称：

image.png

6.创建展示结果的jsp

在WEB-INF.view包中创建showHello.jsp和showBye.jsp用于完成对请求结果的展示。

注：将页面放到WEB-INF下是因为其对用户不可见，用户无法通过浏览器地址栏直接访问WEB-INF中的资源，提高了安全性。

showHello.jsp代码如下：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<h3>showHello.jsp页面</h3><br/>
<h3>${msg}</h3><br/>
<h3>${fun}</h3>
</body>
</html>

showBye.jsp代码如下：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<h3>showBye.jsp页面</h3><br/>
<h3>${msg}</h3><br/>
<h3>${fun}</h3>
</body>
</html>

7.创建控制器类

DispatcherServlet接收到请求后把请求分派给控制器（本例中的controller），控制器根据@RequestMapping注解得到请求与方法的对应关系，通过调用对应的方法实现对请求的处理。

如图创建控制器类：

image.png

具体代码如下：

package com.bupt.controller;
​
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.view.RedirectView;
​
import javax.xml.ws.RequestWrapper;
​
/**
 *  @Controller:创建处理器对象，对象放在springmvc容器中。
 *  能处理请求的都是控制器（处理器）。
 */
@Controller
public class MyController {
    /**
     * 准备使用doSome方法处理some.do请求。
     * @RequestMapping: 请求映射，作用是把一个请求地址和一个方法绑定在一起。一个请求指定一个方法处理。
     * 属性： 1. value 是一个String，表示请求的uri地址的（如hello.do），value的值必须是唯一的，推荐地址以“/”开头
     * 使用RequestMapping修饰的方法叫做处理器方法或者控制器方法，可以处理请求。
     *
     * 返回值：ModelAndView 表示本次请求的处理结果
     *   Model: 数据，请求处理完成后，要显示给用户的数据
     *   View: 视图， 比如jsp等等。
     */
    @RequestMapping(value = {"/hello.do"})
    public ModelAndView doHello(){
        //实际开发中会调用service处理请求，得到处理结果。
        ModelAndView mv  = new ModelAndView();
        //最后把处理结果的数据放入到request作用域。
        //相当于request.setAttribute(key,value);
        mv.addObject("msg","Hello!");
        mv.addObject("fun","doHello方法执行...");
​
        //指定视图
        //框架对视图执行的forward操作， request.getRequestDispather("/showHello.jsp).forward(...)
        //如果没有配置视图解析器，需要指定视图的完整路径
        //mv.setViewName("/WEB-INF/view/showHello.jsp");
​
        //当配置了视图解析器后，可以使用逻辑名称（文件名），指定视图
        //框架会使用视图解析器的前缀 + 逻辑名称 + 后缀 组成完成路径
        ///WEB-INF/view/ + show + .jsp
        mv.setViewName("showHello");
        return mv;
    }
​
    @RequestMapping(value = {"/bye.do"})
    public ModelAndView doBye(){
        ModelAndView mv  = new ModelAndView();
        mv.addObject("msg","Bye!");
        mv.addObject("fun","doBye方法执行...");
        mv.setViewName("showBye");
        return mv;
    }
}

8.编辑springmvc配置文件

包括两部分：

1）声明组件扫描器，扫描base-package包中的所有注解，完成对象的创建

2）声明 springmvc框架中的视图解析器，框架会使用视图解析器的前缀 + 逻辑名称 + 后缀 组成完成路径

具体代码如下：

<?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 https://www.springframework.org/schema/context/spring-context.xsd">
​
    <!--声明组件扫描器-->
    <context:component-scan base-package="com.bjpowernode.controller" />
​
    <!--声明 springmvc框架中的视图解析器， 帮助开发人员设置视图文件的路径-->
    <bean  class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--前缀：视图文件的路径-->
        <property name="prefix" value="/WEB-INF/view/" />
        <!--后缀：视图文件的扩展名-->
        <property name="suffix" value=".jsp" />
    </bean>
</beans>

9.项目目录结构

至此第一个springmvc项目完成，项目总体的结构如下：

image-20210822193732339.png

10.测试网站功能

1）点击debug启动服务器

image.png

2）浏览器输入http://localhost:8080/hello_springmvc/，显示欢迎页面：

image.png

3）点击Say Hello，浏览器展示对应的页面：

image.png

4）返回，点击Say Bye，浏览器展示对应的页面：

image.png

avatar
文章
阅读
粉丝