Spring MVC注解式开发示例完整过程
Java Fans 人气:0项目案例
用 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>
运行并测试程序
启动运行 Tomcat,打开浏览器后,运行 “http://localhost:8080/springmvc02/first/show”,运行效果如下:
加载全部内容