需求
需求: 用户在页面发起一个请求, 请求交给springmvc的控制器对象, 并显示请求的处理结果(在结果页面显示一个欢迎语句)。
1.创建maven项目
补全缺失目录
原来的web版本太低,需要更换版本 找到工程模块的web,移除web.xml配置文件 加入新的web.xml,这里不能是web.xml,不然创建出来还是低版本的 OK,后回到项目修改web1.xml为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">
</web-app>
2. 加入依赖
spring-webmvc依赖,间接把spring的依赖都加入到项目 jsp,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.changsha</groupId>
<artifactId>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>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.2.5.RELEASE</version>
</dependency>
</dependencies>
<build>
<plugins>
<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. 创建 SpringMVC 配置文件
在工程的类路径即 src 目录下创建 SpringMVC 的配置文件 springmvc.xml。该文件名可以任意命名
4.重点: 在web.xml中注册springmvc框架的核心对象DispatcherServlet
1)DispatcherServlet叫做中央调度器, 是一个servlet, 它的父类是继承HttpServlet 2)DispatcherServlet页叫做前端控制器(front controller) 3)DispatcherServlet负责接收用户提交的请求, 调用其它的控制器对象,并把请求的处理结果显示给用户
需要在tomcat服务器启动后,创建DispatcherServlet对象的实例。因为DispatcherServlet在他的创建过程中, 会同时创建springmvc容器对象,读取springmvc的配置文件,把这个配置文件中的对象都创建好, 当用户发起请求时就可以直接使用对象了。
<?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>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>myWeb</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
</web-app>
解释:
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
是指定了配置文件的位置和名字。如果不指定的读取的配置文件默认是/WEB-INF/<servlet-name>-servlet.xml .
<load-on-startup>1</load-on-startup>
- 在<servlet/>中添加<load-on-startup/>的作用是,标记是否在Web服务器(这里是Tomcat)启动时会创建这个 Servlet 实例,即是否在 Web 服务器启动时调用执行该 Servlet 的 init()方法,而不是在真正访问时才创建。它的值必须是一个整数。
? 当值大于等于 0 时,表示容器在启动时就加载并初始化这个 servlet,数值越小,该 Servlet 的优先级就越高,其被创建的也就越早; ? 当值小于 0 或者没有指定时,则表示该 Servlet 在真正被使用时才会去创建。 ? 当值相同时,容器会自己选择创建顺序。
url-pattern
-
使用框架的时候, url-pattern可以使用两种值 1). 使用扩展名方式, 语法 *.xxxx , xxxx是自定义的扩展名。 常用的方式 *.do, *.action, *.mvc等等不能使用 *.jsp http://localhost:8080/myweb/some.do http://localhost:8080/myweb/other.do 静态资源和请求都能正常访问 2).使用斜杠 “/” 这个时候静态资源访问异常,因为"/"的uri地址会覆盖掉tomcat默认的default的servlet(用来处理静态资源和为映射到某个servlet的请求)。 解决方法: — 第一种:使用<mvc:default-servlet-handler/>—
需要在springmvc配置文件加入 <mvc:default-servlet-handler> 原理是: 加入这个标签后,框架会创健控制器对象DefaultServletHttpRequestHandler(类似我们自己创建MyController).DefaultServletHttpRequestHandler这个对象可以把接收的请求转发给 tomcat的default这个servlet。
需要加入驱动来解决冲突问题 — 第二种:使用<mvc:resources/>(常用)—
mvc:resources 加入后框架会创建ResourceHttpRequestHandler这个处理器对象。让这个对象处理静态资源的访问,不依赖tomcat服务器。 mapping:访问静态资源的uri地址, 使用通配符 ** location:静态资源在你的项目中的目录位置。 images/**:表示 images/p1.jpg , images/user/logo.gif , images/order/history/list.png
一般情况下把静态资源放在static文件夹下就可以省略很多resources标签 <mvc:resources mapping="/static/**" location="/static/" />
需要加入驱动来解决冲突问题
5.创建控制器(处理器)类
在类上与方法上添加相应注解即可。 @Controller:表示当前类为处理器 @RequestMapping:表示当前方法为处理器方法。该方法要对 value 属性所指定的 URI进行处理与响应。被注解的方法的方法名可以随意
package com.changsha.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
@Controller
public class Mycontroller {
@RequestMapping("/some.do")
public ModelAndView doSome(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("msg","第一个springmvc工程");
modelAndView.setViewName("/view/show.jsp");
return modelAndView;
}
}
若有多个请求路径均可匹配该处理器方法的执行,则@RequestMapping 的 value 属性中可以写上一个数组。 ModelAndView 类中的 addObject()方法用于向其 Model 中添加数据。Model 的底层为一个 HashMap。Model 中的数据存储在 request 作用域中,SringMVC 默认用转发的方式跳转到视图,本次请求结束,模型中的数据被销毁。
注册视图解析器
SpringMVC 框架为了避免对于请求资源路径与扩展名上的冗余,在视图解析器InternalResouceViewResolver 中引入了请求的前辍与后辍。而 ModelAndView 中只需给出要跳转页面的文件名即可,对于具体的文件路径与文件扩展名,视图解析器会自动完成拼接。
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/view/" />
<property name="suffix" value=".jsp" />
</bean>
使用逻辑视图名称,show 是逻辑视图名称
package com.changsha.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
@Controller
public class Mycontroller {
@RequestMapping("/some.do")
public ModelAndView doSome(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("msg","第一个springmvc工程");
modelAndView.setViewName("/show");
return modelAndView;
}
}
控制器方法的使用
控制器方法的参数
1) 逐个接收参数
只要保证请求参数名与该请求处理方法的参数名相同即可。 修改处理器类 MyController 显示结果页面
方法参数和接收参数名字不同
所谓校正请求参数名,是指若请求 URL 所携带的参数名称与处理方法中指定的参数名不相同时,则需在处理方法参数前,添加一个注解@RequestParam(“请求参数名”),指定请求 URL 所携带参数的名称。该注解是对处理器方法参数进行修饰的。value 属性指定请求参数的名称。 修改处理器类 MyController required 属性:
2)用对象接收参数
对象的属性名和需要接收参数的名字相同 修改处理器类 MyController
控制器方法的返回值
使用@Controller 注解的处理器的处理器方法,其返回值常用的有四种类型: ? 第一种:ModelAndView ? 第二种:String ? 第三种:无返回值 void ? 第四种:返回自定义类型对象 根据不同的情况,使用不同的返回值。
1)ModelAndView返回数据和页面跳转
若处理器方法处理完后,需要跳转到其它资源,且又要在跳转的资源间传递数据,此时处理器方法返回 ModelAndView 比较好。当然,若要返回 ModelAndView,则处理器方法中需要定义 ModelAndView 对象。在使用时,若该处理器方法只是进行跳转而不传递数据,或只是传递数据而并不向任何资源跳转(如对页面的 Ajax 异步响应),此时若返回ModelAndView,则将总是有一部分多余:要么 Model 多余,要么 View 多余。即此时返回 ModelAndView 将不合适。
2)String页面跳转
处理器方法返回的字符串可以指定逻辑视图名,通过视图解析器解析可以将其转换为物理视图地址
返回内部资源逻辑视图名 若要跳转的资源为内部资源,则视图解析器可以使用 InternalResourceViewResolver 内部资源视图解析器。此时处理器方法返回的字符串就是要跳转页面的文件名去掉文件扩展名后的部分。这个字符串与视图解析器中的 prefix、suffix 相结合,即可形成要访问的 URI。 直接修改处理器类 MyController 当然,也可以直接返回资源的物理视图名。不过,此时就不需要再在视图解析器中再配置前辍与后辍了
3)Void不返回数据也不页面跳转(可以响应ajax请求)
4)返回对象 Object
使用步骤: 1. 加入依赖 2. 开启注解驱动 3. 在方法上加@ResponseBody注解
处理器方法也可以返回 Object 对象。这个 Object 可以是 Integer,String,自定义对象,Map,List 等。但返回的对象不是作为逻辑视图出现的,而是作为直接在页面显示的数据出现的。返回对象,需要使用@ResponseBody 注解,将转换后的 JSON 数据放入到响应体中。
由于返回 Object 数据,一般都是将数据转化为了 JSON 对象后传递给浏览器页面的。而这个由 Object 转换为 JSON,是由 Jackson 工具完成的。所以需要导入 Jackson 的相关 Jar 包。
A.依赖:
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.9.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.0</version>
</dependency>
B、 声明注解驱动 将 Object 数据转化为 JSON 数据,需要由消息转换器 HttpMessageConverter 完成。而转换器的开启,需要<mvc:annotation-driven/>来完成。SpringMVC 使用消息转换器实现请求数据和对象,处理器方法返回对象和响应输出之间的自动转换当 Spring 容器进行初始化过程中,在<mvc:annotation-driven/>处创建注解驱动时,默认创建了七个 HttpMessageConverter 对象。也就是说,我们注册<mvc:annotation-driven/>,就是为了让容器为我们创建HttpMessageConverter 对象。
C. 方法上加入ResponseBody注解,把数据返回形式变成json数据
6. 声明组件扫描器
在 springmvc.xml 中注册组件扫描器
<context:component-scan base-package="com.changsha.controller"/>
7.创建一个发起请求的页面 index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<p>第一个springmvc项目</p>
<p><a href="some.do">发起some.do的请求</a> </p>
</body>
</html>
8.创建一个作为结果的jsp,显示请求的处理结果。
放在WEB-INF 目录下的资源是不能被直接访问的
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h1>msg = ${msg}</h1>
</body>
</html>
解决post请求乱码问题
在web.xml配置文件中声明过滤器
<filter>
<filter-name>characterEncodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>utf-8</param-value>
</init-param>
<init-param>
<param-name>forceRequestEncoding</param-name>
<param-value>true</param-value>
</init-param>
<init-param>
<param-name>forceResponseEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
SpringMVC 执行流程
流程图
使用 SpringMVC 框架 web 请求处理顺序
执行流程简单分析
(1)浏览器提交请求到中央调度器 (2)中央调度器直接将请求转给处理器映射器。 (3)处理器映射器会根据请求,找到处理该请求的处理器,并将其封装为处理器执行链后 返回给中央调度器。 (4)中央调度器根据处理器执行链中的处理器,找到能够执行该处理器的处理器适配器。 (5)处理器适配器调用执行处理器。 (6)处理器将处理结果及要跳转的视图封装到一个对象 ModelAndView 中,并将其返回给 处理器适配器。 (7)处理器适配器直接将结果返回给中央调度器。 (8)中央调度器调用视图解析器,将 ModelAndView 中的视图名称封装为视图对象。 (9)视图解析器将封装了的视图对象返回给中央调度器 (10)中央调度器调用视图对象,让其自己进行渲染,即进行数据填充,形成响应对象。 (11)中央调度器响应浏览器
|