springMVC详细教程

最新推荐文章于 2023-06-25 16:22:05 发布

丁大勺

最新推荐文章于 2023-06-25 16:22:05 发布

阅读量892

点赞数 1

分类专栏： springMVC 文章标签： springMVC

本文链接：https://blog.csdn.net/weixin_43869318/article/details/99694755

版权

springMVC 专栏收录该内容

4 篇文章 0 订阅

订阅专栏

一、三层架构与MVC

1. 三层架构

开发服务器端程序，一般都基于两种形式，一种C/S架构程序，一种B/S架构程序；
使用Java语言基本上都是开发B/S架构的程序，B/S架构又分成了三层架构。

三层架构：

表现层：WEB层，用来和客户端进行数据交互的。表现层一般会采用MVC的设计模型
业务层：处理公司具体的业务逻辑的
持久层：用来操作数据库的

2. MVC模型

MVC全名是Model View Controller 模型视图控制器，每个部分各司其职：

Model：数据模型，JavaBean的类，用来进行数据封装。
View：指JSP、HTML用来展示数据给用户。
Controller：用来接收用户的请求，整个流程的控制器。用来进行数据校验等。

二、springMVC简介

1. 概述

springMVC是一种基于Java实现的MVC设计模型的请求驱动类型的轻量级WEB框架。
Spring MVC属于SpringFrameWork的后续产品，已经融合在Spring Web Flow里面。Spring 框架提供了构建 Web 应用程序的全功能 MVC 模块。
使用 Spring 可插入的 MVC 架构，从而在使用Spring进行WEB开发时，可以选择使用Spring的SpringMVC框架或集成其他MVC开发框架，如Struts2。
springMVC在三层架构中属于 “表现层”。

2. springMVC的优势

清晰的角色划分：
前端控制器（DispatcherServlet）
请求到处理器映射（HandlerMapping）
处理器适配器（HandlerAdapter）
视图解析器（ViewResolver）
处理器或页面控制器（Controller）
验证器（ Validator）
命令对象（Command 请求参数绑定到的对象就叫命令对象）
表单对象（Form Object 提供给表单展示和提交到的对象就叫表单对象）。
分工明确，扩展点相当灵活，可以很容易扩展。
由于命令对象就是一个 POJO，无需继承框架特定 API，可以使用命令对象直接作为业务对象。
和 Spring 其他框架无缝集成，是其它 Web 框架所不具备的。
可适配，通过 HandlerAdapter 可以支持任意的类作为处理器。
可定制性，HandlerMapping、ViewResolver 等能够非常简单的定制。
功能强大的数据验证、格式化、绑定机制。
利用 Spring 提供的 Mock 对象能够非常简单的进行 Web 层单元测试。
本地化、主题的解析的支持，使我们更容易进行国际化和主题的切换。
强大的 JSP 标签库，使 JSP 编写更容易。
………还有比如RESTful风格的支持、简单的文件上传、约定大于配置的契约式编程支持、基于注解的零配
置支持等等。

3. SpringMVC 和 Struts2 的对比

共同点：

都是表现层框架，都是基于 MVC 模型编写的。
底层都离不开原始 ServletAPI。
处理请求的机制都是一个核心控制器。

区别：

Spring MVC 的入口是 Servlet, 而 Struts2 是 Filter
Spring MVC 是基于方法设计的，而 Struts2 是基于类，Struts2 每次执行都会创建一个动作类，所
以 Spring MVC 会稍微比 Struts2 快些。
Spring MVC 使用更加简洁,同时还支持 JSR303, 处理 ajax 的请求更方便；
(JSR303 是一套 JavaBean 参数校验的标准，它定义了很多常用的校验注解，我们可以直接将这些注
解加在我们 JavaBean 的属性上面，就可以在需要校验的时候进行校验了。)
Struts2 的 OGNL 表达式使页面的开发效率相比 Spring MVC 更高些，但执行效率并没有比 JSTL 提
升，尤其是 struts2 的表单标签，远没有 html 执行效率高。

三、springMVC入门程序

1. IDEA创建web项目

1) 新建一个maven项目，选择webapp模板

在这里插入图片描述

2) 新建webapp项目后会自动生成一些目录，但不全，需要手动创建部分目录

需要手动创建java, resources等目录，并右键选择 “make directory as” 将其设置为相应性质目录。
完整目录结构如下：
在这里插入图片描述

java目录：java代码所在目录
resources目录：配置文件所在目录，如springMVC配置文件
index.jsp：自动生成的jsp文件，位于webapp目录下，是默认访问的页面
WEB-INF目录：web配置文件所在目录
target目录：项目部署的输出目录
pom.xml：maven的配置文件

3) 在pom.xml文件中配置依赖包

<!-- 版本锁定 -->
<properties>
	<spring.version>5.0.2.RELEASE</spring.version>
</properties>
<!-- 依赖包-->
<dependencies>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-context</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-web</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-webmvc</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>javax.servlet</groupId>
		<artifactId>servlet-api</artifactId>
		<version>2.5</version>
		<scope>provided</scope>
	</dependency>
	<dependency>
		<groupId>javax.servlet.jsp</groupId>
		<artifactId>jsp-api</artifactId>
		<version>2.0</version>
		<scope>provided</scope>
	</dependency>
</dependencies>

4) 配置核心控制器(配置DispatcherServlet)

在web.xml配置文件中核心控制器DispatcherServlet

  <!--前端控制器-->
  <servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置Servlet的初始化参数，读取springmvc的配置文件，创建spring容器 -->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!-- 服务器启动时即加载servlet-->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

5）编写springmvc.xml (springMVC配置文件)

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">
    <!-- 开启注解扫描-->
    <context:component-scan base-package="controller"/>

    <!-- 视图解析器对象 -->
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- 配置spring开启注解mvc的支持 -->
    <mvc:annotation-driven />
</beans>

6)编写index.jsp和HelloController控制器类

a) index.jsp

<body>
	<h3>入门案例</h3>
	<a href="${ pageContext.request.contextPath }/hello">入门案例</a>
</body>

${ pageContext.request.contextPath } 也可以省略，如：

<body>
	<h3>入门案例</h3>
	<a href="/hello">入门案例</a>
</body>

b) HelloController

package cn.itcast.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* 控制器
*/
@Controller
public class HelloController {
	@RequestMapping(path="/hello")
	public String sayHello() {
		System.out.println("Hello SpringMVC!!");
		return "success";
	}
}

7) 在WEB-INF目录下创建pages文件夹，编写success.jsp的成功页面

<body>
	<h3>入门成功！！</h3>
</body>

8)配置Tomcat服务器，部署项目，进行测试

在这里插入图片描述

2.项目执行过程及原理分析

1）执行过程

在这里插入图片描述

当启动Tomcat服务器的时候，因为配置了load-on-startup标签，所以会创建DispatcherServlet对象，
就会加载springmvc.xml配置文件；
开启了注解扫描，那么HelloController对象就会被创建；
从index.jsp发送请求，请求会先到达DispatcherServlet核心控制器，根据配置@RequestMapping注解
找到执行的具体方法；
根据执行方法的返回值，再根据配置的视图解析器，去指定的目录下查找指定名称的JSP文件；
Tomcat服务器渲染页面，做出响应；

在这里插入图片描述

2）请求响应流程

在这里插入图片描述

3）springMVC各组件分析

a. DispatcherServlet：前端控制器
用户请求到达前端控制器，它就相当于 mvc 模式中的 c，dispatcherServlet 是整个流程控制的中心，由
它调用其它组件处理用户的请求，dispatcherServlet 的存在降低了组件之间的耦合性。

b. HandlerMapping：处理器映射器
HandlerMapping 负责根据用户请求找到 Handler 即处理器，SpringMVC 提供了不同的映射器实现不同的
映射方式，例如：配置文件方式，实现接口方式，注解方式等。

c. Handler：处理器
它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由
Handler 对具体的用户请求进行处理。

d. HandlAdapter：处理器适配器
通过 HandlerAdapter 对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理
器进行执行。

e. View Resolver：视图解析器
View Resolver 负责将处理结果生成 View 视图，View Resolver 首先根据逻辑视图名解析成物理视图名
，即具体的页面地址，再生成 View 视图对象，最后对 View 进行渲染将处理结果通过页面展示给用户。

f. View：视图
SpringMVC 框架提供了很多的 View 视图类型的支持，包括：jstlView、freemarkerView、pdfView 等。我们最常用的视图就是 jsp。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开发具体的页面。

4）<mvc:annotation-driven />说明

在 SpringMVC 的各个组件中，处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。
使用 <mvc:annotation-driven /> 自动加载 RequestMappingHandlerMapping （处理映射器）和
RequestMappingHandlerAdapter （处理适配器），可用在 SpringMVC.xml 配置文件中使用
<mvc:annotation-drivenb />替代注解处理器和适配器的配置。
它就相当于在 xml 中配置了：

<!-- Begin -->
<!-- HandlerMapping -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"></bean>
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"></bean>
<!-- HandlerAdapter -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"></bean>
<bean class="org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter"></bean>
<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"></bean>
<!-- HadnlerExceptionResolvers -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.ExceptionHandlerExceptionResolver"></bean>
<bean class="org.springframework.web.servlet.mvc.annotation.ResponseStatusExceptionResolver"></bean>
<bean class="org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionResolver"></bean>
<!-- End -->

注意：
一般开发中，我们都需要写上此标签。
明确：
我们只需要编写处理具体业务的控制器以及视图。

3. RequestMapping 注解

3.1 使用说明

3.1.1 RequestMapping 源码：

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping {
}

3.1.2 作用：

用于建立请求 URL 和处理请求方法之间的对应关系。

3.1.3 使用的位置：

类上：
请求 URL 的第一级访问目录。此处不写的话，就相当于应用的根目录；写的话需要以/开头。
它出现的目的是为了使我们的 URL 可以按照模块化管理。
例如：
账户模块：
/account/add
/account/update
/account/delete
…
订单模块：
/order/add
/order/update
/order/delete
红色的部分就是把 RequsetMappding 写在类上，使我们的 URL 更加精细。
方法上：
请求 URL 的第二级访问目录。如下所示：

控制器代码：

@RequestMapping(path="/order")
@Controller
public class HelloController {
	@RequestMapping(path="/add")
	public String add() {
		System.out.println("add");
		return "success";
	}

	@RequestMapping(path="/delete")
	public String add() {
		System.out.println("delete");
		return "success";
	}
}

jsp代码：

<%@ page language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>requestmapping 的使用</title>
	</head>
	<body>
		<!-- 第一种访问方式 -->
		<a href="${pageContext.request.contextPath}/order/add">
		添加订单
		</a>
		<br/>
		<!-- 第二种访问方式 -->
		<a href="order/add">查询账户</a>
	</body>
</html>

注意：
当我们使用此种方式配置时，在 jsp 中第二种写法时，不要在访问 URL 前面加 /，否则无法找到资源。

3.1.4 属性：

value：用于指定请求的 URL。
path: 作用与value是一样的。
method：用于指定请求的方式,，如 POST, GET, PUT, DELETE。
params：用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和params要求的一致。例如：
params = {"accountName"}，表示请求参数必须有 accountName
params = {"moeny!100"}，表示请求参数中 money 不能是 100。
params = {"moeny>100"}，表示请求参数中 money 要大于100。
headers：用于指定限制请求消息头的条件。

注意：
以上四个属性只要出现 2 个或以上时，他们的关系是**“与”**的关系，即所有属性的要求都要满足。

@RequestMapping(path = "/hello", params = {"name", "age=10"}, method = RequestMethod.GET)
// url中的请求参数会传值给方法中名字相同的形参
public String sayHello(String name, int age){
    System.out.println("hello, " + name);
    System.out.println(age);
    return "success";
}

对应的jsp为：

<a href="/hello?name=aaa&age=10">将请求参数传给控制器方法中对应的形参</a>

四、请求参数的绑定

1. 绑定说明

1.1 绑定的机制

表单中请求参数都是基于 key=value 的。
SpringMVC 绑定请求参数的过程是通过“把表单提交请求参数作为控制器中方法参数进行绑定的”。
例如：
<a href="/hello?name=aa&age=10">将请求参数传给控制器方法中对应的形参</a>
中的请求参数为name=aa和age=10，可以将其绑定到控制器方法的具有相同名称的形参中：

@RequestMapping(path = "/hello", params = {"name", "age=10"}, method = RequestMethod.GET)
// url中的请求参数会传值给方法中名字相同的形参
public String sayHello(String name, int age){
   System.out.println("hello, " + name);
   System.out.println(age);
   return "success";
}

1.2支持的数据类型

基本类型参数：包括基本类型和 String 类型。
POJO 类型参数：包括实体类，以及关联的实体类。
数组和集合类型参数：包括 List 结构和 Map 结构的集合（包括数组）。

SpringMVC 绑定请求参数是自动实现的，但是要想使用，必须遵循使用要求。

1.3 使用要求

基本类型或者 String 类型：
要求我们的参数名称必须和控制器中方法的形参名称保持一致(严格区分大小写)
POJO 类型，或者它的关联对象：
要求表单中参数名称和 POJO 类的属性名称保持一致，并且控制器方法的参数类型是 POJO 类型。
集合类型,有两种方式：
第一种：
要求集合类型的请求参数必须在 POJO 中，在表单中请求参数名称要和 POJO 中集合属性名称相同。
给 List 集合中的元素赋值，使用下标。
给 Map 集合中的元素赋值，使用键值对。
第二种：
接收的请求参数是 json 格式数据。需要借助一个注解实现。，

注意:
springMVC还可以实现一些数据类型自动转换。
内置转换器全都在org.springframework.core.convert.support包下:

java.lang.Boolean -> java.lang.String : ObjectToStringConverter
java.lang.Character -> java.lang.Number : CharacterToNumberFactory
java.lang.Character -> java.lang.String : ObjectToStringConverter
java.lang.Enum -> java.lang.String : EnumToStringConverter
java.lang.Number -> java.lang.Character : NumberToCharacterConverter
java.lang.Number -> java.lang.Number : NumberToNumberConverterFactory
java.lang.Number -> java.lang.String : ObjectToStringConverter
java.lang.String -> java.lang.Boolean : StringToBooleanConverter
java.lang.String -> java.lang.Character : StringToCharacterConverter
java.lang.String -> java.lang.Enum : StringToEnumConverterFactory
java.lang.String -> java.lang.Number : StringToNumberConverterFactory
java.lang.String -> java.util.Locale : StringToLocaleConverter
java.lang.String -> java.util.Properties : StringToPropertiesConverter
java.lang.String -> java.util.UUID : StringToUUIDConverter
java.util.Locale -> java.lang.String : ObjectToStringConverter
java.util.Properties -> java.lang.String : PropertiesToStringConverter
java.util.UUID -> java.lang.String : ObjectToStringConverter
......

如遇特殊类型转换要求，需要我们自己编写自定义类型转换器。

1.4 使用示例

1.4.1 基本类型和 String 类型作为参数

jsp代码：
<a href="/hello?name=aa&age=10">将请求参数传给控制器方法中对应的形参</a>

java代码：

@RequestMapping(path = "/hello")
// url中的请求参数会传值给方法中名字相同的形参
public String sayHello(String name, int age){
   System.out.println("hello, " + name);
   System.out.println(age);
   return "success";
}

1.4.2 POJO 类型作为参数

jsp 代码：

<!-- pojo 类型演示 -->
<form action="account/saveAccount" method="post">
	账户名称：<input type="text" name="name" ><br/>
	账户金额：<input type="text" name="money" ><br/>
	账户省份：<input type="text" name="address.provinceName" ><br/>
	账户城市：<input type="text" name="address.cityName" ><br/>
	<input type="submit" value="保存">
</form>

java代码：

实体类代码：
/**
* 账户信息
*/
public class Account implements Serializable {
	private Integer id;
	private String name;
	private Float money;
	private Address address;
	//getters, setters, toString 等函数省略。。。
}

/**
* 地址的实体类
*/
public class Address implements Serializable {
	private String provinceName;
	private String cityName;
//getters and setters
}

控制器代码：
/**
* 保存账户
*/
@RequestMapping("/saveAccount")
//表单中的参数将会自动装配到acount中(前提是与属性名一致)
public String saveAccount(Account account) {
	System.out.println("保存了账户。。。。"+account);
	return "success";
}

1.4.3 POJO 类中包含集合类型参数

jsp代码：

<!-- POJO 类包含集合类型演示 -->
<form action="account/updateAccount" method="post">
	用户名称：<input type="text" name="username" ><br/>
	用户密码：<input type="password" name="password" ><br/>
	用户年龄：<input type="text" name="age" ><br/>
	账户 1 名称：<input type="text" name="accounts[0].name" ><br/>
	账户 1 金额：<input type="text" name="accounts[0].money" ><br/>
	账户 2 名称：<input type="text" name="accounts[1].name" ><br/>
	账户 2 金额：<input type="text" name="accounts[1].money" ><br/>
	账户 3 名称：<input type="text" name="accountMap['one'].name" ><br/>
	账户 3 金额：<input type="text" name="accountMap['one'].money" ><br/>
	账户 4 名称：<input type="text" name="accountMap['two'].name" ><br/>
	账户 4 金额：<input type="text" name="accountMap['two'].money" ><br/>
	<input type="submit" value="保存">
</form>

java代码：

实体类代码：
/**
* 用户实体类
*/
public class User implements Serializable {
	private String username;
	private String password;
	private Integer age;
	private List<Account> accounts;
	private Map<String, Account> accountMap;
	//getters and setters
	@Override
	public String toString() {
		return "User [username=" + username + ", password=" + password + ", age="
		+ age + ",\n accounts=" + accounts + ",\n accountMap=" + accountMap + "]";
	}
}

控制器代码：
/**
* 更新账户
*/
@RequestMapping("/updateAccount")
public String updateAccount(User user) {
	System.out.println("更新了账户。。。。"+user);
	return "success";
}

1.4.4 请求参数乱码问题

1) post 请求方式：
在 web.xml 中配置一个过滤器：

<!-- 配置 springMVC 编码过滤器 --> 
<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>forceEncoding</param-name> 
 <param-value>true</param-value> 
</init-param> 
</filter> 
<!-- 过滤所有请求 --> 
<filter-mapping> 
<filter-name>CharacterEncodingFilter</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping>

2) get 请求方式：
tomacat 对 GET 和 POST 请求处理方式是不同的，GET 请求的编码问题，要改 tomcat 的 server.xml
配置文件，如下：
将
<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>
改为
<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true"/>
如果遇到 ajax 请求仍然乱码，把：useBodyEncodingForURI="true"改为 URIEncoding="UTF-8"

2. 特殊情况

2.1 自定义类型转换器

考虑如下场景：

<!-- 特殊情况之：类型转换问题 -->
<a href="account/deleteAccount?date=2018-01-01">根据日期删除账户</a>

控制器代码：
/**
* 删除账户
*/
@RequestMapping("/deleteAccount")
public String deleteAccount(String date) {
System.out.println("删除了账户。。。。"+date);
return "success";
}

当我们把控制器中方法参数的类型改为Date时，将会报错，springMVC不支持将2018-01-01转换为Date类型：

控制器代码：
/**
* 删除账户
*/
@RequestMapping("/deleteAccount")
public String deleteAccount(Date date) {
System.out.println("删除了账户。。。。"+date);
return "success";
}

此时，我们需要自己定义一个类型转换器：
第一步，定义一个类，实现 Converter 接口，该接口有两个泛型。

public interface Converter<S, T> { //S:表示接受的类型，T：表示目标类型
/**
* 实现类型转换的方法
*/
	@Nullable
	T convert(S source);
}

/**
* 自定义类型转换器
*/
public class StringToDateConverter implements Converter<String, Date> {
/**
* 用于把 String 类型转成日期类型
*/
	@Override
	public Date convert(String source) {
		DateFormat format = null;
		try {
			if(StringUtils.isEmpty(source)) {
			throw new NullPointerException("请输入要转换的日期");
		}
		format = new SimpleDateFormat("yyyy-MM-dd");
		Date date = format.parse(source);
		return date;
		} catch (Exception e) {
			throw new RuntimeException("输入日期有误");
		}
	}
}

第二步：在 springMVC 配置文件springmvc.xml中配置类型转换器
spring 配置类型转换器的机制是，将自定义的转换器注册到类型转换服务中去。

<!-- 配置类型转换器工厂 -->
<bean id="converterService" class="org.springframework.context.support.ConversionServiceFactoryBean">
	 <!-- 给工厂注入一个新的类型转换器 -->
	 <property name="converters">
		 <array>
 		<!-- 配置自定义类型转换器 -->
		 <bean class="com.itheima.web.converter.StringToDateConverter"></bean>
		 </array>
	 </property>
</bean>

第三步：在 annotation-driven 标签中引用配置的类型转换服务

<!-- 引用自定义类型转换器 -->
<mvc:annotation-driven conversion-service="converterService"></mvc:annotation-driven>

2.2 使用 ServletAPI 对象作为方法参数

SpringMVC 还支持使用原始 ServletAPI 对象作为控制器方法的参数。支持原始 ServletAPI 对象有：

HttpServletRequest
HttpServletResponse
HttpSession
java.security.Principal
Locale
InputStream
OutputStream
Reader Writer

我们可以把上述对象，直接写在控制的方法参数中使用。

@RequestMapping("/testServletAPI")
public String testServletAPI(HttpServletRequest request, HttpServletResponse response, HttpSession session) {
	System.out.println(request);
	System.out.println(response);
	System.out.println(session);
	return "success";
}

五、常用注解

1. RequestParam

使用说明

作用：把请求中指定名称的参数给控制器中的形参赋值。
属性：
value：请求参数中的名称。
required：请求参数中是否必须提供此参数。默认值：true。表示必须提供，如果不提供将报错。

示例

jsp 代码：

<!-- requestParams 注解的使用 -->
<a href="springmvc/useRequestParam?name=test">requestParam 注解</a>

控制器代码：

@RequestMapping("/useRequestParam")
public String useRequestParam(@RequestParam("name")String username,
@RequestParam(value="age",required=false)Integer age){
	System.out.println(username+","+age);
	return "success";
}

2. RequestBody

使用说明

作用： 用于获取请求体内容。直接使用得到是 key=value&key=value…结构的数据。get 请求方式不适用。
属性：
required：是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值为 false，get 请求得到是 null。

示例

jsp代码：

<!-- request body 注解 -->
<form action="springmvc/useRequestBody" method="post">
	用户名称：<input type="text" name="username" ><br/>
	用户密码：<input type="password" name="password" ><br/>
	用户年龄：<input type="text" name="age" ><br/>
	<input type="submit" value="保存">
</form>

控制器代码：

@RequestMapping("/useRequestBody")
public String useRequestBody(@RequestBody(required=false) String body){
	System.out.println(body);
	return "success";
}

在这里插入图片描述

3. PathVaribale

使用说明

作用： 用于绑定 url 中的占位符。例如：请求 url 中 /delete/{id}，这个{id}就是 url 占位符。
url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 rest 风格 URL 的一个重要标志。
属性：
value：用于指定 url 中占位符名称，只有此一个属性时value可省略不写，直接写占位符名称。
required：是否必须提供占位符。

示例

jsp 代码：

<!-- PathVariable 注解 -->
<a href="springmvc/usePathVariable/100">pathVariable 注解</a>

控制器代码：

@RequestMapping("/usePathVariable/{id}")
public String usePathVariable(@PathVariable("id") Integer id){
	System.out.println(id);
	return "success";
}

4. RequestHeader

使用说明

作用： 用于获取请求消息头。
属性：
value：提供消息头名称
required：是否必须有此消息头

(在实际开发中一般不常用该注解)

示例

jsp 代码：

<!-- RequestHeader 注解 -->
<a href="springmvc/useRequestHeader">获取请求消息头</a>

控制器代码：

@RequestMapping("/useRequestHeader")
public String useRequestHeader(@RequestHeader(value="Accept-Language",required=false)String requestHeader){
	System.out.println(requestHeader);
	return "success";
}

5. CookieValue

使用说明

作用： 用于把指定 cookie 名称的值传入控制器方法参数。
属性：
value：指定 cookie 的名称。
required：是否必须有此 cookie。

示例

jsp 代码：

<!-- CookieValue 注解 -->
<a href="springmvc/useCookieValue">绑定 cookie 的值</a>

控制器代码：

@RequestMapping("/useCookieValue")
public String useCookieValue(@CookieValue(value="JSESSIONID",required=false) String cookieValue){
	System.out.println(cookieValue);
	return "success";
}

6. ModelAttribute

使用说明

作用：
该注解是 SpringMVC4.3 版本以后新加入的。它可以用于修饰方法和参数。
a) 用方法上：表示当前方法会在控制器的方法执行之前，先执行。它可以修饰没有返回值的方法，也可以修饰有具体返回值的方法。
b) 用参数上：获取指定的数据给参数赋值。
属性：
value：用于获取数据的 key。key 可以是 POJO 的属性名称，也可以是 map 结构的 key。
应用场景：
当表单提交数据不是完整的实体类数据时，保证没有提交数据的字段使用数据库对象原来的数据。
例如：
我们在编辑一个用户时，用户有一个创建信息字段，该字段的值是不允许被修改的。在提交表单数
据是肯定没有此字段的内容，一旦更新会把该字段内容置为 null，此时就可以使用此注解解决问题。

使用示例

示例1：基于 POJO 属性

jsp代码：

<a href="springmvc/testModelAttribute?username=test">测试 modelattribute</a>

控制器代码：

/**
* 被 ModelAttribute 修饰的方法
*/
@ModelAttribute
public void showModel(User user) {
	System.out.println("执行了 showModel 方法"+user.getUsername());
}
/**
* 接收请求的方法
*/
@RequestMapping("/testModelAttribute")
public String testModelAttribute(User user) {
	System.out.println("执行了控制器的方法"+user.getUsername());
	return "success";
}

在这里插入图片描述

示例2：基于 Map 的应用场景：ModelAttribute 修饰方法带返回值

需求：修改用户信息，要求用户的密码不能修改

jsp 的代码：

<!-- 修改用户信息 -->
<form action="springmvc/updateUser" method="post">
	用户名称：<input type="text" name="username" ><br/>
	用户年龄：<input type="text" name="age" ><br/>
	<input type="submit" value="保存">
</form>

控制器代码：

/**
* 查询数据库中用户信息
*/
@ModelAttribute
public User showModel(String username) {
	//模拟去数据库查询
	User abc = findUserByName(username);
	System.out.println("执行了 showModel 方法"+abc);
	return abc;
}
/**
* 模拟修改用户方法
*/
@RequestMapping("/updateUser")
public String testModelAttribute(User user) {
	System.out.println("控制器中处理请求的方法：修改用户："+user);
	return "success";
}
/**
* 模拟去数据库查询
*/
private User findUserByName(String username) {
	User user = new User();
	user.setUsername(username);
	user.setAge(19);
	user.setPassword("123456");
	return user;
}

在这里插入图片描述

示例3：基于 Map 的应用场景：ModelAttribute 修饰方法不带返回值

需求：修改用户信息，要求用户的密码不能修改

jsp 的代码：

<!-- 修改用户信息 -->
<form action="springmvc/updateUser" method="post">
	用户名称：<input type="text" name="username" ><br/>
	用户年龄：<input type="text" name="age" ><br/>
	<input type="submit" value="保存">
</form>

控制器代码：

/**
* 查询数据库中用户信息
*/
@ModelAttribute
public void showModel(String username, Map<String,User> map) {
	//模拟去数据库查询
	User user = findUserByName(username);
	System.out.println("执行了 showModel 方法"+user);
	map.put("abc",user);
}

/**
* 模拟修改用户方法
*/
@RequestMapping("/updateUser")
public String testModelAttribute(@ModelAttribute("abc")User user) {
	System.out.println("控制器中处理请求的方法：修改用户："+user);
	return "success";
}

/**
 * 模拟去数据库查询
*/
private User findUserByName(String username) {
	User user = new User();
	user.setUsername(username);
	user.setAge(19);
	user.setPassword("123456");
	return user;
}

在这里插入图片描述

7. SessionAttribute

使用说明

作用： 用于多次执行控制器方法间的参数共享。
属性：
value：用于指定存入的属性名称
type：用于指定存入的数据类型。

示例

jsp代码：

<!-- SessionAttribute 注解的使用 -->
<a href="springmvc/testPut">存入 SessionAttribute</a>
<hr/>
<a href="springmvc/testGet">取出 SessionAttribute</a>
<hr/>
<a href="springmvc/testClean">清除 SessionAttribute</a>

控制器代码：

@Controller("sessionAttributeController")
@RequestMapping("/springmvc")
@SessionAttributes(value ={"username","password", "age"}, types={String.class, Integer.class}) 
public class SessionAttributeController {
	/**
	* 把数据存入 SessionAttribute
	* Model 是 spring 提供的一个接口，该接口有一个实现类 ExtendedModelMap
	* 该类继承了 ModelMap，而 ModelMap 就是 LinkedHashMap 子类
	*/
	@RequestMapping("/testPut") 
	public String testPut(Model model){ 
		System.out.println("向session域中保存数据");
		model.addAttribute("username", "泰斯特"); 
		model.addAttribute("password","123456"); 
		model.addAttribute("age", 31); 
		//跳转之前将数据保存到 username、password 和 age 中，因为注解@SessionAttribute 中有这几个参数 
		return "success"; 
	 } 
	 /**
	* 从session中获取值
	*/
	 @RequestMapping("/testGet") 
	 public String testGet(ModelMap model){  
		System.out.println(model.get("username")+";"+model.get("password")+";"+model.get("age")); 
		return "success"; 
	 } 
	 /**
	* 清除值
	*/
	 @RequestMapping("/testClean") 
	 public String complete(SessionStatus sessionStatus){ 
		 sessionStatus.setComplete(); 
		 return "success"; 
	 } 
}

六、REST 风格 URL

什么是rest ?

REST（英文：Representational State Transfer，简称 REST）描述了一个架构样式的网络系统，
比如 web 应用程序。它首次出现在 2000 年 Roy Fielding 的博士论文中，他是 HTTP 规范的主要编写者之
一。在目前主流的三种 Web 服务交互方案中，REST 相比于 SOAP（Simple Object Access protocol，简单
对象访问协议）以及 XML-RPC 更加简单明了，无论是对 URL 的处理还是对 Payload 的编码，REST 都倾向于用更加简单轻量的方法设计和实现。值得注意的是 REST 并没有一个明确的标准，而更像是一种设计的风格。
它本身并没有什么实用性，其核心价值在于如何设计出符合 REST 风格的网络接口。

restful优点

它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。

restful 的特性

资源（Resources）：
网络上的一个实体，或者说是网络上的一个具体信息。
它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的存在。可以用一个 URI（统一
资源标识符）指向它，每种资源对应一个特定的 URI 。要获取这个资源，访问它的 URI 就可以，因此 URI 即为每一个资源的独一无二的识别符。
表现层（Representation）：
把资源具体呈现出来的形式，叫做它的表现层（Representation）。
比如，文本可以用 txt 格式表现，也可以用 HTML 格式、XML 格式、JSON 格式表现，甚至可以采用二进制格式。
状态转化（State Transfer）：
每发出一个请求，就代表了客户端和服务器的一次交互过程。
HTTP 协议，是一个无状态协议，即所有的状态都保存在服务器端。因此，如果客户端想要操作服务器，
必须通过某种手段，让服务器端发生“状态转化”（State Transfer）。而这种转化是建立在表现层之上的，所以
就是 “表现层状态转化”。具体说，就是 HTTP 协议里面，四个表示操作方式的动词：GET 、POST 、PUT、
DELETE。它们分别对应四种基本操作：GET 用来获取资源，POST 用来新建资源，PUT 用来更新资源，DELETE 用来删除资源。

restful 的示例：

/account/1 HTTP GET ：得到 id = 1 的 account
/account/1 HTTP DELETE：删除 id = 1 的 account
/account/1 HTTP PUT：更新 id = 1 的 account
/account HTTP POST：新增 account

基于 HiddentHttpMethodFilter 的示例

作用：
由于浏览器 form 表单只支持 GET 与 POST 请求，而 DELETE、PUT 等 method 并不支持，Spring3.0 添
加了一个过滤器，可以将浏览器请求改为指定的请求方式，发送给我们的控制器方法，使得支持 GET、POST、PUT 与 DELETE 请求。
使用方法：
第一步：在 web.xml 中配置该过滤器。
第二步：请求方式必须使用 post 请求。
第三步：按照要求提供_method 请求参数，该参数的取值就是我们需要的请求方式。

jsp代码：

<!-- 保存 -->
<form action="springmvc/testRestPOST" method="post">
	用户名称：<input type="text" name="username"><br/>
	<!-- <input type="hidden" name="_method" value="POST"> -->
	<input type="submit" value="保存">
</form>
<hr/>
<!-- 更新 -->
<form action="springmvc/testRestPUT/1" method="post">
	用户名称：<input type="text" name="username"><br/>
	<input type="hidden" name="_method" value="PUT">
	<input type="submit" value="更新">
</form>
<hr/>
<!-- 删除 -->
<form action="springmvc/testRestDELETE/1" method="post">
	<input type="hidden" name="_method" value="DELETE">
	<input type="submit" value="删除">
</form>
<hr/>
<!-- 查询一个 -->
<form action="springmvc/testRestGET/1" method="post">
	<input type="hidden" name="_method" value="GET">
	<input type="submit" value="查询">
</form>

控制器代码：

/**
* post 请求：保存
*/
@RequestMapping(value="/testRestPOST", method=RequestMethod.POST)
public String testRestfulURLPOST(User user){
	System.out.println("rest post"+user);
	return "success";
}

/**
* put 请求：更新
*/
@RequestMapping(value="/testRestPUT/{id}",method=RequestMethod.PUT)
public String testRestfulURLPUT(@PathVariable("id")Integer id, User user){
	System.out.println("rest put "+id+","+user);
	return "success";
}

/**
* post 请求：删除
*/
@RequestMapping(value="/testRestDELETE/{id}", method=RequestMethod.DELETE)
public String testRestfulURLDELETE(@PathVariable("id")Integer id){
	System.out.println("rest delete "+id);
	return "success";
}

/**
* post 请求：查询
*/
@RequestMapping(value="/testRestGET/{id}",method=RequestMethod.GET)
public String testRestfulURLGET(@PathVariable("id")Integer id){
	System.out.println("rest get "+id);
	return "success";
}

在这里插入图片描述

七、响应数据和结果视图

7.1 返回值分类

7.1.1 字符串

controller 方法返回字符串可以指定逻辑视图名，通过视图解析器解析为物理视图地址。
例如：

//指定逻辑视图名，经过视图解析器解析为 jsp 物理路径：/WEB-INF/pages/success.jsp
@RequestMapping("/testReturnString")
public String testReturnString() {
System.out.println("AccountController 的 testReturnString 方法执行了。。。。");
return "success";
}

7.1.2 void

通过前面我们知道， Servlet 原始 API 可以作为控制器中方法的参数：

@RequestMapping("/testReturnVoid")
public void testReturnVoid(HttpServletRequest request,HttpServletResponse response) 
throws Exception {
}

在 controller 方法形参上可以定义 request 和 response，使用 request 或 response 指定响应结果：

1、使用 request 转发页面，如下：

request.getRequestDispatcher("/WEB-INF/pages/success.jsp").forward(request, response);

2、通过 response 页面重定向：

response.sendRedirect("testRetrunString")

3、也可以通过 response 指定响应结果，例如响应 json 数据：

response.setCharacterEncoding("utf-8");
response.setContentType("application/json;charset=utf-8");
response.getWriter().write("json 串");

7.1.3 ModelAndView

ModelAndView 是 SpringMVC 为我们提供的一个对象，该对象也可以用作控制器方法的返回值，可以用来调整具体的JSP视图。该对象中有两个方法：

ModelAndView addObject(String attributeName, Object attributeValue)
2. void setViewName(String viewName)
示例代码：

/**
* 返回 ModeAndView
*/
@RequestMapping("/testReturnModelAndView")
public ModelAndView testReturnModelAndView() {
	ModelAndView mv = new ModelAndView();
	mv.addObject("username", "张三");
	mv.setViewName("success");
	return mv;
}

响应的 jsp 代码：

<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>执行成功</title>
	</head>
	<body>
		执行成功！
		${requestScope.username}
	</body>
</html>

7.2 转发和重定向

在这里插入图片描述

7.2.1 forward 转发

controller 方法在提供了 String 类型的返回值之后，默认就是请求转发。我们也可以写成：

@RequestMapping("/testForward")
public String testForward() {
	System.out.println("AccountController 的 testForward 方法执行了。。。。");
	return "forward:/WEB-INF/pages/success.jsp";
}

需要注意的是，如果用了 formward：则路径必须写成实际视图 url，不能写逻辑视图。
它相当于“request.getRequestDispatcher(“url”).forward(request,response)”。使用请求转发，既可以转发到 jsp，也可以转发到其他的控制器方法。

7.2.2 Redirect 重定向

contrller 方法提供了一个 String 类型返回值之后，它需要在返回值里使用 redirect :

@RequestMapping("/testRedirect")
public String testRedirect() {
	System.out.println("AccountController 的 testRedirect 方法执行了。。。。");
	return "redirect:testReturnModelAndView";
}

它相当于“response.sendRedirect(url)”。需要注意的是，如果是重定向到 jsp 页面，则 jsp 页面不
能放在 WEB-INF 目录中，否则无法找到。

7.2.3 ResponseBody 响应 json 数据

作用：

该注解用于将 Controller 的方法返回的对象，通过 HttpMessageConverter 接口转换为指定格式的数据，如：json,xml 等，通过 Response 响应给客户端。

使用示例：

需求： 使用@ResponseBody 注解实现将 controller 方法返回对象转换为 json 响应给客户端。
前置知识点： Springmvc 默认用 MappingJacksonHttpMessageConverter 对 json 数据进行转换，需要加入jackson 的包。

jsp 中的代码：

<script type="text/javascript" src="${pageContext.request.contextPath}/js/jquery.min.js"></script>
<script type="text/javascript">
	$(function(){
		$("#testJson").click(function(){
			$.ajax({
				type:"post",
				url:"${pageContext.request.contextPath}/testResponseJson",
				contentType:"application/json;charset=utf-8",
				data:'{"id":1,"name":"test","money":999.0}',
				dataType:"json",
				success:function(data){
					alert(data);
				}
			});
		});
	})
</script>
<!-- 测试异步请求 -->
<input type="button" value="测试 ajax 请求 json 和响应 json" id="testJson"/>

控制器中的代码：

/**
* 响应 json 数据的控制器
*/
@Controller("jsonController")
public class JsonController {
	/**
	* 测试响应 json 数据
	*/
	@RequestMapping("/testResponseJson")
	public @ResponseBody Account testResponseJson(@RequestBody Account account) {
		System.out.println("异步请求："+account);
		return account;
	}
}

运行结果：
在这里插入图片描述

八、SpringMVC 实现文件上传

8.1 文件上传的回顾

8.1.1 文件上传的必要前提：

form 表单的 enctype 取值必须是：multipart/form-data (默认值是:application/x-www-form-urlencoded)
enctype:是表单请求正文的类型
method 属性取值必须是 Post
提供一个文件选择域<input type=”file” />

8.1.2 文件上传的原理分析

当 form 表单的 enctype 取值不是默认值时，request.getParameter()将失效。

enctype=”application/x-www-form-urlencoded”时，form 表单的正文内容是：
key=value&key=value&key=value
当 form 表单的 enctype 取值为 Mutilpart/form-data 时，请求正文内容就变成每一部分都是 MIME
类型描述的正文：

-----------------------------7de1a433602ac                 分界符
Content-Disposition: form-data; name="userName"            协议头
aaa                                  					 协议的正文
-----------------------------7de1a433602ac
Content-Disposition: form-data; name="file"; 
filename="C:\Users\zhy\Desktop\fileupload_demofile\b.txt"
Content-Type: text/plain 							协议的类型（MIME 类型）
bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb
-----------------------------7de1a433602ac--

8.2 传统方式的文件上传

传统方式的文件上传，指的是我们上传的文件和访问的应用存在于同一台服务器上。并且上传完成之后，浏览器可能跳转。

第一步：引入依赖包

<dependency>
	<groupId>commons-fileupload</groupId>
	<artifactId>commons-fileupload</artifactId>
	<version>1.3.1</version>
</dependency>
<dependency>
	<groupId>commons-io</groupId>
	<artifactId>commons-io</artifactId>
	<version>2.4</version>
</dependency>

第二步：编写 jsp 页面

<form action="/fileUpload" method="post" enctype="multipart/form-data">
	名称：<input type="text" name="picname"/><br/>
	图片：<input type="file" name="uploadFile"/><br/>
	<input type="submit" value="上传"/>
</form>

第三步：编写控制器

@Controller("fileUploadController")
public class FileUploadController {
	@RequestMapping(value="/fileupload")
	public String fileupload(HttpServletRequest request) throws Exception {
		// 先获取到要上传的文件目录
		String path = request.getSession().getServletContext().getRealPath("/uploads");
		// 创建File对象，一会向该路径下上传文件
		File file = new File(path);
		// 判断路径是否存在，如果不存在，创建该路径
		if(!file.exists()) {
			file.mkdirs();
		}
		// 创建磁盘文件项工厂
		DiskFileItemFactory factory = new DiskFileItemFactory();
		ServletFileUpload fileUpload = new ServletFileUpload(factory);
		// 解析request对象
		List<FileItem> list = fileUpload.parseRequest(request);
		// 遍历
		for (FileItem fileItem : list) {
			// 判断文件项是普通字段，还是上传的文件
			if(fileItem.isFormField()) {
				//普通表单项
			}else {
				// 上传文件项
				// 获取到上传文件的名称
				String filename = fileItem.getName();
				//将文件名设置为唯一值，uuid
				String uuid = UUID.randomUUID().toString().replace("-", "");
				filename = uuid +"_" + filename;
				// 上传文件
				fileItem.write(new File(file, filename));
				// 删除临时文件（上传文件大于10kb会在磁盘生成临时文件，需要手动处理，否则只会在内存生成临时文件，不需手动处理）
				fileItem.delete();
			}
		}
		return "success";
	}

8.3 springmvc 方式的文件上传

SpringMVC框架提供了MultipartFile对象，该对象表示上传的文件，要求变量名称必须和表单file标签的
name属性名称相同。
在这里插入图片描述

第一步：引入依赖包

<dependency>
	<groupId>commons-fileupload</groupId>
	<artifactId>commons-fileupload</artifactId>
	<version>1.3.1</version>
</dependency>
<dependency>
	<groupId>commons-io</groupId>
	<artifactId>commons-io</artifactId>
	<version>2.4</version>
</dependency>

第二步：编写 jsp 页面

<form action="/fileUpload" method="post" enctype="multipart/form-data">
	选择文件：<input type="file" name="upload"/><br/>
	<input type="submit" value="上传"/>
</form>

第三步：编写控制器

@Controller("fileUploadController")
public class FileUploadController {
	@RequestMapping("/fileUpload")
	public String uploadFile(MultipartFile upload, HttpServletRequest request) throws Exception{
		// 先获取到要上传的文件目录
		String path = request.getSession().getServletContext().getRealPath("/uploads");
		// 创建File对象，一会向该路径下上传文件
		File file = new File(path);
		// 判断路径是否存在，如果不存在，创建该路径
		if(!file.exists()) {
			file.mkdirs();
		}
		// 获取到上传文件的名称
		String filename = upload.getOriginalFilename();
		String uuid = UUID.randomUUID().toString().replaceAll("-", "").toUpperCase();
		// 把文件的名称唯一化
		filename = uuid + "_" + filename;
		// 上传文件
		upload.transferTo(new File(file, filename));
		return "success";
	}
}

第四步：在springmvc.xml中配置文件解析器

<!-- 配置文件上传解析器 -->
<!-- id 的值是固定的-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
	<!-- 设置上传文件的最大尺寸为 5MB -->
	<property name="maxUploadSize">
		<value>5242880</value>
	</property>
</bean>

注意：
文件上传的解析器 id 是固定的，不能起别的名称，否则无法实现请求参数的绑定。（不光是文件，其他
字段也将无法绑定）

8.4 springmvc 跨服务器方式的文件上传

8.4.1 使用多服务器的目的

在实际开发中，我们会有很多处理不同功能的服务器。例如：

应用服务器：负责部署我们的应用
数据库服务器：运行我们的数据库
缓存和消息服务器：负责处理大并发访问的缓存和消息
文件服务器：负责存储用户上传文件的服务器。

(注意：此处说的不是服务器集群）
分服务器处理的目的是让服务器各司其职，从而提高我们项目的运行效率。
在这里插入图片描述

8.4.2 跨服务器文件上传的实现

在这里插入图片描述

第一步：在IDEA中配置两个 tomcat 服务器，端口号不能相同

第二步：创建两个web项目，分别部署到前面配置的服务器中

假设第一个web项目叫“myAPP”，用于上传文件；第二个web项目叫“fileServer”，用于存放文件。
在fileServer项目的webapp目录下新建一个文件夹"uploads"用于存放文件。

第三步：配置myAPP项目

导入开发需要的jar包

<dependency>
	<groupId>com.sun.jersey</groupId>
	<artifactId>jersey-core</artifactId>
	<version>1.18.1</version>
</dependency>
<dependency>
	<groupId>com.sun.jersey</groupId>
	<artifactId>jersey-client</artifactId>
	<version>1.18.1</version>
</dependency>

编写文件上传的JSP页面

<h3>跨服务器的文件上传</h3>
<form action="user/fileupload" method="post" enctype="multipart/form-data">
	选择文件：<input type="file" name="upload"/><br/>
	<input type="submit" value="上传文件"/>
</form>

编写控制器

@RequestMapping(value="/user")
public class FileUploadController {
	@RequestMapping(value="/fileupload")
	public String fileupload3(MultipartFile upload) throws Exception {
		System.out.println("SpringMVC跨服务器方式的文件上传...");
		// 定义图片服务器的请求路径
		String path = "http://localhost:9090/uploads/";
		// 获取到上传文件的名称
		String filename = upload.getOriginalFilename();
		String uuid = UUID.randomUUID().toString().replaceAll("-", "").toUpperCase();
		// 把文件的名称唯一化
		filename = uuid+"_"+filename;
		// 向图片服务器上传文件
		// 创建客户端对象
		Client client = Client.create();
		// 连接图片服务器
		WebResource webResource = client.resource(path+filename);
		// 上传文件
		webResource.put(upload.getBytes());
		return "success";
	}
}

九、SpringMVC 中的异常处理

9.1 异常处理的思路

系统中异常包括两类：预期异常和运行时异常 RuntimeException，前者通过捕获异常从而获取异常信息，
后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。
项目的 dao、service、controller 出现异常都通过 throws Exception 向上抛出，最后由 springmvc 前端
控制器有DispatcherServlet交由异常处理器进行异常处理，如下图：在这里插入图片描述

9.2 实现步骤

第一步：自定义异常类

public class CustomException extends Exception {
	private String message;
	public CustomException(String message) {
		this.message = message;
	}
	public String getMessage() {
		return message;
	}
}

第二步：编写错误页面

error.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>执行失败</title>
	</head>
	<body>
		执行失败！
		${message }
	</body>
</html>

第三步：自定义异常处理器

public class CustomExceptionResolver implements HandlerExceptionResolver {
	@Override
	public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
		ex.printStackTrace();
		CustomException customException = null;
		//如果抛出的是自定义异常则直接转换
		if(ex instanceof CustomException){
		customException = (CustomException)ex;
		}else{
		//如果抛出的不是自定义异常则重新构造一个系统错误异常。
		customException = new CustomException("系统错误，请与系统管理 员联系！");
		}
		ModelAndView modelAndView = new ModelAndView();
		modelAndView.addObject("message", customException.getMessage());
		modelAndView.setViewName("error");
		return modelAndView;
	}
}

第四步：配置异常处理器

在springmvc.xml 文件中配置：

<!-- 配置自定义异常处理器 -->
<bean id="handlerExceptionResolver" class="com.itheima.exception.CustomExceptionResolver"/>

十、 SpringMVC 中的拦截器

10.1 拦截器的作用

Spring MVC 的处理器拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。
用户可以自己定义一些拦截器来实现特定的功能。
拦截器链（Interceptor Chain）：拦截器链就是将拦截器按一定的顺序联结成一条链。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。
拦截器和过滤器是有几分相似，但是也有区别：
1. 过滤器是 servlet 规范中的一部分，任何 java web 工程都可以使用。拦截器是 SpringMVC 框架自己的，只有使用了 SpringMVC 框架的工程才能用。
2. 过滤器在 url-pattern 中配置了/*之后，可以对所有要访问的资源拦截。拦截器只会拦截访问的控制器方法，如果访问的是 jsp，html,css,image 或者 js 是不会进行拦截的。

拦截器是 AOP 思想的具体应用。我们要想自定义拦截器，要求必须实现 HandlerInterceptor 接口。

10.2 自定义拦截器步骤

10.2.1 第一步：创建类，实现HandlerInterceptor接口

public class HandlerInterceptorDemo1 implements HandlerInterceptor {
	/**
	* controller方法执行前，进行拦截的方法
	* return true放行
	* return false拦截
	* 可以使用转发或者重定向直接跳转到指定的页面。
	*/
	@Override
	public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
		System.out.println("preHandle 拦截器拦截了");
		return true;
	}
	
	@Override
	public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
		System.out.println("postHandle 方法执行了");
	}
	
	@Override
	public void afterCompletion(HttpServletRequest request, HttpServletResponse	response, Object handler, Exception ex)	throws Exception {
		System.out.println("afterCompletion 方法执行了");
	}
}

10.2.2 第二步：在springmvc.xml中配置拦截器类

<!-- 配置拦截器 -->
<mvc:interceptors>
	<mvc:interceptor>
		<!-- 哪些方法进行拦截 -->
		<mvc:mapping path="/**"/>
		<!-- 哪些方法不进行拦截
		<mvc:exclude-mapping path=""/>
		-->
		<!-- 注册拦截器对象 -->
		<bean id="handlerInterceptorDemo1" class="web.interceptor.HandlerInterceptorDemo1"></bean>
	</mvc:interceptor>
</mvc:interceptors>

10.3 拦截器执行细节

HandlerInterceptor接口中的方法：

preHandle方法：

controller方法执行前调用
可以使用request或者response跳转到指定的页面
return true放行，执行下一个拦截器；如果没有拦截器，则执行controller中的方法。
return false不放行，不会执行controller中的方法。

postHandle方法：

controller方法执行后执行的方法，在JSP视图执行前。
可以使用request或者response跳转到指定的页面
如果指定了跳转的页面，那么controller方法跳转的页面将不会显示。

afterCompletion方法：

只有 preHandle 返回 true 才调用，是在JSP执行后执行
request或者response不能再跳转页面了
可以在该方法中进行一些资源清理的操作

如果有2个拦截器，拦截器 1 的 preHandle 方法返回 true，但是拦截器 2 的 preHandle 方法返
回 false，此时的执行顺序为：
preHandle 1 ----> preHandle 2 -----> afterCompletion 1

10.4 多个拦截器的执行顺序

在这里插入图片描述

配置多个拦截器的方法

<!-- 配置拦截器 -->
<mvc:interceptors>
	<mvc:interceptor>
		<!-- 哪些方法进行拦截 -->
		<mvc:mapping path="/user/*"/>
		<!-- 哪些方法不进行拦截
		<mvc:exclude-mapping path=""/>
		-->
		<!-- 注册拦截器对象 -->
		<bean class="demo.MyInterceptor1"/>
	</mvc:interceptor>
	<mvc:interceptor>
		<!-- 哪些方法进行拦截 -->
		<mvc:mapping path="/**"/>
		<!-- 注册拦截器对象 -->
		<bean class="demo.MyInterceptor2"/>
	</mvc:interceptor>
</mvc:interceptors>

10.5 拦截器的简单案例（验证用户是否登录）

实现思路

1、有一个登录页面，需要写一个 controller 访问页面
2、登录页面有一提交表单的动作，需要在 controller 中处理。

2.1、判断用户名密码是否正确
2.2、如果正确向 session 中写入用户信息
2.3、返回登录成功。

3、拦截用户请求，判断用户是否登录

3.1、如果用户已经登录，放行
3.2、如果用户未登录，跳转到登录页面

控制器代码

//登录页面
@RequestMapping("/login")
public String login(Model model)throws Exception{
	return "login";
}

//登录提交
//userid：用户账号，pwd：密码
@RequestMapping("/loginsubmit")
public String loginsubmit(HttpSession session,String userid,String pwd) throws Exception{
	//向 session 记录用户身份信息
	session.setAttribute("activeUser", userid);
	return "redirect:/main.jsp";
}

//退出
@RequestMapping("/logout")
public String logout(HttpSession session)throws Exception{
	//session 过期
	session.invalidate();
	return "redirect:index.jsp";
}

拦截器代码

public class LoginInterceptor implements HandlerInterceptor{
	@Override
	Public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
		//如果是登录页面则放行
		if(request.getRequestURI().indexOf("login.action")>=0){
			return true;
		}
		
		HttpSession session = request.getSession();
		//如果用户已登录也放行
		if(session.getAttribute("user")!=null){
			return true;
		}
		//用户没有登录挑战到登录页面
		request.getRequestDispatcher("/WEB-INF/jsp/login.jsp").forward(request, 
		response);
			return false;
	}
}

丁大勺

关注

1
点赞
踩
13

收藏

觉得还不错? 一键收藏
0
评论
springMVC详细教程

一、三层架构与MVC1. 三层架构开发服务器端程序，一般都基于两种形式，一种C/S架构程序，一种B/S架构程序；使用Java语言基本上都是开发B/S架构的程序，B/S架构又分成了三层架构。三层架构：3. 表现层：WEB层，用来和客户端进行数据交互的。表现层一般会采用MVC的设计模型4. 业务层：处理公司具体的业务逻辑的5. 持久层：用来操作数据库的2. MVC模型MVC全名是...
复制链接

扫一扫

专栏目录