SpringMVC注解式开发示例完整过程

Spring MVC注解式开发 Spring注解开发 2023-02-27 11:02:39 130人浏览泡泡鱼

Python 官方文档：入门教程 => 点击学习

摘要

目录项目案例实现步骤项目创建添加依赖配置WEB.xml文件配置spring-config.xml文件编写一个Controller类创建响应页面运行并测试程序项目案例 &

项目案例

用 RequestMapping 注解式开发开发设置一个项目，实现在浏览器中输入 Http://localhost:8080/springMVC02/first/show，输出网页内容 “我的第一个注解式 Spring mvc 开发程序!”。

实现步骤

项目创建添加依赖

在 idea 中新建一个项目 springmvc02，创建如下图所示的目录结构：

项目创建好之后，打开 pom.xml 文件，添加依赖内容如下：

<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">
  <modelVersion>4.0.0</modelVersion>
  <groupId>cn.kGC.springmvc02</groupId>
  <artifactId>springmvc02</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>springmvc02 Maven Webapp</name>
  <url>http://maven.apache.org</url>
<!--第1步：添加需要的 jar 包-->
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>5.3.19</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>springmvc02</finalName>
  </build>
</project>

配置web.xml文件

在 web.xml 文件里配置 DispatcherServlet 前端控制器，项目 webapp/WEB-INF 目录里的 web.xml 文件配置如下：

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
  <display-name>Archetype Created Web Application</display-name>
  <!--第2步：配置前端控制器-->
  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-config.xml</param-value>
    </init-param>
  </servlet>
  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

客户端发出的 URL 请求都会被 DispatcherServlet（前端控制器）拦截，DispatcherServlet 再交给 spring-config.xml 进行处理。

配置spring-config.xml文件

配置 handlerMapping 处理器映射器。

在 src/main/resources 目录下新建一个 xml 文件,命名为 spring-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 https://www.springframework.org/schema/context/spring-context.xsd">
    <!--配置处理器映射器-->
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"></bean>
</beans>

上面代码意思是创建一种类型为 RequestMappingHandlerMapping 的处理器映射器，即定义一种 “请求/响应” 映射规则，客户端的 Url 请求如果跟某一个 bean 的 name 属性匹配，则由该 bean 的 class 属性指定的控制器 Controller 类进行响应处理。

配置 HandlerAdapter 处理器适配器。

配置完处理器映射器后，接着在 spring-config.xml 中插入如下内容(插入位置在处理器映射器下方，节点 </beans> 的上方):

 <!--配置处理器适配器-->
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"></bean>

该代码的意思是创建一种处理器适配器，类型为 RequestMappingHandlerAdapter，用于对上述指定的控制器 Controller 类的 handleRequest() 方法的调用与执行。

配置视图解析器。

视图解释器用来解释控制器返回的逻辑视图的真实路径，这样更方便，易于扩展。在 spring-config.xml 中输入代码:

    <!--配置视图解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--前缀配置-->
        <property name="prefix" value="/"></property>
        <!--后缀配置-->
        <property name="suffix" value=".jsp"></property>
    </bean>

上面代码的意思是控制器 Controller 返回的逻辑视图，需要加上前缀 “/” 和后缀 “.jsp”，最后拼接成完整的视图路径。比如本例中，Controller 返回的视图为 “show”，视图解释器将为它加上前缀后缀，最终构成完整路径为 “/ show.jsp”。视图解释器不是非要不可，如果没有视图解释器，则 Controller 返回的视图必须打上完整路径的视图名称。

配置组件扫描器

	<!--开启包扫描  base-package  设置需要扫描的包 -->
    <context:component-scan base-package="cn.kgc.springmvc02"></context:component-scan>

编写一个Controller类

在 cn.kgc.springmvc02.controller 下新建一个类 TestController，代码如下：

package cn.kgc.springmvc02.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("first")
public class TestController {
    @RequestMapping("show")
    private String show(){
        return "show";
    }
}

第一个注解 @Controller 表示将本类定义为一个控制器类，这个类无须再实现 Controller 接口。

第二个注解 @RequestMapping(“first”) 表示定义一种 “请求/响应” 的映射关系，即如果客户端浏览器发出 “first” 的 url 请求则由该注解下面的 show() 方法来响应，即浏览器通过 url 路径+“first/show” 就可访问到本方法，url 请求能够直接映射到控制器类的方法级别。这样一个简单的注解，就轻松的取代了之前的处理器映射器和 bean 的配置，大大减少了配置工作量。

创建响应页面

在 webapp 目录下创建文件 show.jsp 页面，内容如下：

<%--
  Created by IntelliJ IDEA.
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h1>我的第一个注解式 Spring MVC 开发程序!</h1>
</body>
</html>