隐藏

SpringMVC、三层架构、组件、请求参数绑定、常用注解

发布:2021/8/27 9:53:10作者:管理员 来源:本站 浏览次数:910

一、SpringMVC的基本概念

1.1、关于三层架构和MVC

1.1.1、三层架构

开发架构一般都是基于两种形式,一种是 C/S 架构,也就是客户端/服务器,另一种是 B/S 架构,也就 是浏览器服务器。在 JavaEE 开发中,几乎全都是基于 B/S架构的开发。那么在 B/S架构中,系统标准的三层架构 包括:表现层、业务层、持久层。三层架构在实际开发中使用的非常多。


三层架构中:


表现层: 也就是我们常说的web层。它负责接收客户端请求,向客户端响应结果,通常客户端使用http协议请求 web 层,web 需要接收 http 请求,完成 http 响应。表现层包括展示层和控制层:控制层负责接收请求,展示层负责结果的展示。 表现层依赖业务层,接收到客户端请求一般会调用业务层进行业务处理,并将处理结果响应给客户端。 表现层的设计一般都使用 MVC 模型。(MVC 是表现层的设计模型,和其他层没有关系)


业务层: 也就是我们常说的 service 层。它负责业务逻辑处理,和我们开发项目的需求息息相关。web 层依赖业务层,但是业务层不依赖 web 层。 业务层在业务处理时可能会依赖持久层,如果要对数据持久化需要保证事务一致性。(也就是我们说的, 事务应该放到业务层来控制)。


持久层: 也就是我们是常说的 dao 层。负责数据持久化,包括数据层即数据库和数据访问层,数据库是对数据进行持久化的载体,数据访问层是业务层和持久层交互的接口,业务层需要通过数据访问层将数据持久化到数据库中。通俗的讲,持久层就是和数据库交互,对数据库表进行增删改查的。


1.1.2、MVC模型

MVC 全名是 Model View Controller,是模型(model)-视图(view)-控制器(controller)的缩写, 是一种用于设计创建 Web 应用程序表现层的模式。MVC 中每个部分各司其职:

Model(模型):  

通常指的就是我们的数据模型。作用一般情况下用于封装数据。

View(视图):  

通常指的就是我们的 jsp 或者 html。作用一般就是展示数据的。通常视图是依据模型数据创建的。

Controller(控制器):  

是应用程序中处理用户交互的部分。作用一般就是处理程序逻辑的。

它相对于前两个不是很好理解,这里举个例子:

例如:  

我们要保存一个用户的信息,该用户信息中包含了姓名,性别,年龄等等。  

这时候表单输入要求年龄必须是 1~100 之间的整数。姓名和性别不能为空。并且把数据填充到模型之中。  

此时除了 js 的校验之外,服务器端也应该有数据准确性的校验,那么校验就是控制器的该做的。  

当校验失败后,由控制器负责把错误页面展示给使用者。

如果校验成功,也是控制器负责把数据填充到模型,并且调用业务层实现完整的业务需求。


1.2、SpringMVC概述

1.2.1、SpringMVC


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

SpringMVC 已经成为目前最主流的 MVC 框架之一,并且随着 Spring3.0 的发布,全面超越 Struts2,成 为最优秀的 MVC 框架。

它通过一套注解,让一个简单的 Java 类成为处理请求的控制器,而无须实现任何接口。同时它还支持 RESTful 编程风格的请求。




1.2.2、SpringMVC在三层架构的位置


1.2.3、SpringMVC优势

1、清晰的角色划分:

复制代码


前端控制器(DispatcherServlet)  

请求到处理器映射(HandlerMapping)  

处理器适配器(HandlerAdapter)  

视图解析器(ViewResolver)  

处理器或页面控制器(Controller)  

验证器( Validator)  

命令对象(Command  请求参数绑定到的对象就叫命令对象)  

表单对象(Form Object 提供给表单展示和提交到的对象就叫表单对象)


复制代码


2、分工明确,而且扩展点相当灵活,可以很容易扩展,虽然几乎不需要。

3、由于命令对象就是一个 POJO,无需继承框架特定 API,可以使用命令对象直接作为业务对象。

4、和 Spring 其他框架无缝集成,是其它 Web 框架所不具备的。

5、可适配,通过 HandlerAdapter 可以支持任意的类作为处理器。

6、可定制性,HandlerMapping、ViewResolver 等能够非常简单的定制。

7、功能强大的数据验证、格式化、绑定机制。

8、利用 Spring 提供的 Mock 对象能够非常简单的进行 Web 层单元测试。

9、本地化、主题的解析的支持,使我们更容易进行国际化和主题的切换。

10、强大的 JSP 标签库,使 JSP 编写更容易。

…还有比如RESTful风格的支持、简单的文件上传、约定大于配置的契约式编程支持、基于注解的零配置支持等等。


1.2.4、SpringMVC和Struct2的优劣分析

共同点:

它们都是表现层框架,都是基于 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

2.1、SpringMVC案例


2.1.1、前期准备

解决maven项目创建过慢问题:

创建maven项目时,添加如下键值:


archetypeCatalog

internal


2.1.2、引入jar包

复制代码


<?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.itheima</groupId>

 <artifactId>day01_01start</artifactId>

 <version>1.0-SNAPSHOT</version>

 <packaging>war</packaging>


 <name>day01_01start Maven Webapp</name>

 <!-- FIXME change it to the project's website -->

 <url>http://www.example.com</url>


 <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>

   <!--版本锁定-->

   <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>


 <build>

   <finalName>day01_01start</finalName>

   <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->

     <plugins>

       <plugin>

         <artifactId>maven-clean-plugin</artifactId>

         <version>3.1.0</version>

       </plugin>

       <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->

       <plugin>

         <artifactId>maven-resources-plugin</artifactId>

         <version>3.0.2</version>

       </plugin>

       <plugin>

         <artifactId>maven-compiler-plugin</artifactId>

         <version>3.8.0</version>

       </plugin>

       <plugin>

         <artifactId>maven-surefire-plugin</artifactId>

         <version>2.22.1</version>

       </plugin>

       <plugin>

         <artifactId>maven-war-plugin</artifactId>

         <version>3.2.2</version>

       </plugin>

       <plugin>

         <artifactId>maven-install-plugin</artifactId>

         <version>2.5.2</version>

       </plugin>

       <plugin>

         <artifactId>maven-deploy-plugin</artifactId>

         <version>2.8.2</version>

       </plugin>

     </plugins>

   </pluginManagement>

 </build>

</project>


复制代码


2.1.3、配置核心控制器--一个Servlet

复制代码


<!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>

 

 <!--配置前端控制器-->

 <servlet>

   <servlet-name>dispatcherServlet</servlet-name>

   <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

   <init-param>

     <!--加载springmvc.xml配置文件。启动服务器加载-->

     <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>dispatcherServlet</servlet-name>

   <url-pattern>/</url-pattern>

 </servlet-mapping>

 

 <!--配置中文过滤器-->

 <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>

 </filter>

 <filter-mapping>

   <filter-name>characterEncodingFilter</filter-name>

   <url-pattern>/*</url-pattern>

 </filter-mapping>


</web-app>


复制代码


2.1.4、创建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="cn.itcast"></context:component-scan>

 

 <!--视图解析器对象-->

 <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">

   <property name="prefix" value="/WEB-INF/pages"></property>

   <property name="suffix" value=".jsp"></property>

 </bean>

 

 <!--开启SpringMVC框架注解的支持-->

 <mvc:annotation-driven/>

</beans>


复制代码


2.1.5、编写控制器并使用注解配置

复制代码


/**

* 控制器类

*/

@Controller

//@RequestMapping(path="/user")

public class HelloController {

   

   //入门案例

   @RequestMapping(path="/hello")

   public String sayHello(){

       System.out.println("Hello StringMVC");

       return "success";

   }

}


复制代码



2.2、执行过程及原理分析

2.2.1、案例的执行过程


1、启动服务器,加载应用的web.xml。

 在web.xml中配置了前端控制器:

复制代码


<!--配置前端控制器-->

<servlet>

   <servlet-name>dispatcherServlet</servlet-name>

   <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

   <init-param>

     <!--加载springmvc.xml配置文件。启动服务器加载-->

     <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>dispatcherServlet</servlet-name>

   <url-pattern>/</url-pattern>

</servlet-mapping>


复制代码


附注:

DispatcherServlet前端控制器负责接受请求,转发请求,不对业务进行处理。

DispatcherServlet是一个servlet,负责接受http;可以在web.xml中配置spring-mvc.xml,用于加载配置信息。

如果没有上下文会创建一个新的上下文。

2、实例化并初始化servlet


<load-on-startup>1</load-on-startup>


原本该servlet在第一请求才会被创建为对象。配置上述标签,则在服务器启动时创建DispatcherServlet对象。


3、加载springmvc配置文件创建spring容器,根据配置初始化容器中的对象。

复制代码


<!--开启注解扫描-->

<context:component-scan base-package="cn.itcast"/>


<!-- 视图解析器对象 -->

<bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">

   <property name="prefix" value="/WEB-INF/pages/"/>

   <property name="suffix" value=".jsp"/>

</bean>

 

<!--开启SpringMVC框架注解的支持-->

<mvc:annotation-driven/>


复制代码


<context:component-scan base-package="cn.payn"/>  可以在该标签中设置扫描的范围,如下:


<!--开启注解扫描,只扫描Controller注解-->

<context:component-scan base-package="cn.payn">

<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller" />

</context:component-scan>


开启注解扫描,扫描包“cn.payn”下的组件。HelloController类变成Bean对象,加载进Spring的IoC容器中。InternalResourceViewResolver视图解析器的Bean对象。


4、客户端发送请求:hello

5、请求到达前端控制器

6、到达前端控制器。截取请求的动名称hello。并从RequestMappiing中找。

7、找到后,执行控制器中的方法。

8、方法有返回值,根据返回值通过InternalResourceViewResolver(视图解析器)找到响应结果视图。

9、响应浏览器,展示结果。


更加详细的流程:



2.3、涉及到的组件

2.3.1、DispatcherServlet:前端控制器

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


2.3.2、HandlerMapping:处理映射器

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


2.3.3、Handler:处理器

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


2.3.4、处理器适配器

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


2.3.5、ViewResolver:视图解析器

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


2.3.6、View视图

SpringMVC 框架提供了很多的 View 视图类型的支持,包括:jstlView、freemarkerView、pdfView 等。我们最常用的视图就是 jsp。

一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户,需要由程序员根据业务需求开发具体的页面。


2.3.7、<mvc:annotation-driven/>说明

在 SpringMVC 的各个组件中,处理器映射器HandlerMapping、处理器适配器HandlerAdapter、视图解析器ViewResolver称为 SpringMVC 的三大组件。

使用<mvc:annotation-driven> 自动加载 RequestMappingHandlerMapping (处理映射器)和 RequestMappingHandlerAdapter ( 处理适配器 ),可用在SpringMVC.xml 配置文件中使用 <mvc:annotation-driven>替代注解处理器和适配器的配置。

它就相当于在 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.RequestMappingHandlerA dapter"></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.ExceptionHandlerExcept ionResolver"></bean>

<bean class="org.springframework.web.servlet.mvc.annotation.ResponseStatusExceptionResolv er"></bean>

<bean class="org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionResolver" ></bean>

<!-- End -->


复制代码



2.4、@RequestMapping


@Target({ElementType.METHOD, ElementType.TYPE})

@Retention(RetentionPolicy.RUNTIME)

@Documented

@Mapping

public @interface RequestMapping {


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

类上:  

请求 URL 的第一级访问目录。此处不写的话,就相当于应用的根目录。写的话需要以/开头。  

它出现的目的是为了使我们的 URL 可以按照模块化管理:

例如:

账户模块:

/account/add

/account/update

/account/delete ...

订单模块:

/order/add

/order/update

/order/delete

属性:

value:用于指定请求的 URL。它和 path 属性的作用是一样的。

method:用于指定请求的方式。

params:用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和配置的一模一样。

例如:    

params = {"accountName"},表示请求参数必须有 accountName    

params = {"moeny!100"},表示请求参数中 money 不能是 100。

headers:用于指定限制请求消息头的条件。 --->headers = {"Accept"}  即请求头必须带有 Accept

注意:以上四个属性只要出现 2 个或以上时,他们的关系是与的关系。


2.4.2、使用示例

2.4.2.1、出现位置的示例

复制代码


/**

* 控制器类

*/

@Controller

@RequestMapping(path="/user")

public class HelloController {

   //入门案例

   @RequestMapping(path="/hello")

   public String sayHello(){

       System.out.println("Hello StringMVC");

       return "success";

   }


   /**

    * RequestMapping注解

    * @return

    */

   @RequestMapping(value="/testRequestMapping")

   public String testRequestMapping(){

       System.out.println("测试RequestMapping注解...");

       return "success";

   }


}


复制代码

复制代码


<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>

<html>

<head>

   <title>Title</title>

</head>

<body>


   <h3>入门程序</h3>


   <%--相对路径的写法--%>

   <%--<a href="hello">入门程序</a>--%>


   <%--第一种访问方式  ${pageContext.request.contextPath}即/day01_01start --%>

   <a href="${pageContext.request.contextPath}/user/testRequestMapping">RequestMapping注解  访问一</a>

   

   <%--注意:加上/表示绝对路径--%>

   <a href="user/testRequestMapping">RequestMapping注解  访问二</a>


</body>

</html>


复制代码


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


2.4.2.2、mothod属性

方法上设置:@RequestMapping(value="/saveAccount",method=RequestMethod.POST)

注意:当使用 get 请求时,提示错误信息是 405,信息是方法不支持 get 方式请求 。



2.4.2.3、params属性的示例

@RequestMapping(value="/removeAccount",params= {"accountName","money>100"})

"money>100"-->是一个字符串、键。

<!-- 请求参数的示例 -->

<a href="account/removeAccount?accountName=aaa&money>100">删除账户,金额 100</a>

<br/>

<a href="account/removeAccount?accountName=aaa&money>150">删除账户,金额 150</a>

注意:  当我们点击第一个超链接时,可以访问成功。  当我们点击第二个超链接时,无法访问。如下图:



三、请求参数的绑定

3.1、绑定说明

3.1.1、绑定的机制

表单中请求参数都是基于 key=value 的。

SpringMVC 绑定请求参数的过程是通过把表单提交请求参数,作为控制器中方法参数进行绑定的。

例如:

<a href="param/testParam?username=payn&password=123">请求参数绑定</a>

中的请求参数:

username=payn&password =123

复制代码


@Controller

@RequestMapping("/param")

public class ParamController {


   /**请求参数绑定入门

    * @param username

    * @param password

    * @return

    */

   @RequestMapping("/testParam")

   public String testParam(String username,String password){

       System.out.println("执行了。。。");

       System.out.println("用户名:"+username);

       System.out.println("密码:"+password);

       return "success";

   }

   

   

}


复制代码


3.1.2、支持的数据类型

基本类型参数:

包括基本类型和 String 类型

POJO (Plain Ordinary Java Object)类型参数:  

包括实体类,以及关联的实体类

数组和集合类型参数:  

包括 List 结构和 Map 结构的集合(包括数组)

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


3.1.3、使用要求

如果是基本类型或者 String类型:

要求参数名称必须和控制器中方法的形参名称保持一致。(严格区分大小写)

如果是 POJO类型,或者它的关联对象:

要求表单中参数名称和 POJO 类的属性名称保持一致。并且控制器方法的参数类型是 POJO 类型。

如果是集合类型,有两种方式:

第一种:

要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。

给 List 集合中的元素赋值,使用下标。

给 Map 集合中的元素赋值,使用键值对。

第二种:

接收的请求参数是 json 格式数据。需要借助一个注解实现。


3.1.4、使用示例

3.1.4.1、基本类型和String类型作为参数

3.1.4.2、POJO类型作为参数

复制代码


public class Account implements Serializable {

   private String username;

   private String password;

   private Double money;

   

   private User user;


   public String getUsername() {

       return username;

   }


   public void setUsername(String username) {

       this.username = username;

   }


   public String getPassword() {

       return password;

   }


   public void setPassword(String password) {

       this.password = password;

   }


   public Double getMoney() {

       return money;

   }


   public void setMoney(Double money) {

       this.money = money;

   }


   public User getUser() {

       return user;

   }


   public void setUser(User user) {

       this.user = user;

   }


   @Override

   public String toString() {

       return "Account{" +

               "username='" + username + '\'' +

               ", password='" + password + '\'' +

               ", money=" + money +

               ", user=" + user +

               '}';

   }

}


复制代码

复制代码


public class User implements Serializable{

   private String uname;

   private Integer age;


   public String getUname() {

       return uname;

   }


   public void setUname(String uname) {

       this.uname = uname;

   }


   public Integer getAge() {

       return age;

   }


   public void setAge(Integer age) {

       this.age = age;

   }


   @Override

   public String toString() {

       return "User{" +

               "uname='" + uname + '\'' +

               ", age=" + age +

               '}';

   }

}


复制代码

复制代码


<%--把数据封装到Account类中  user  指的是Account的user属性--%>

<form action="param/saveAccount" method="post">

     账号:<input type="text" name="username"><br/>

     密码:<input type="password" name="password"><br/>

     金额:<input type="text" name="money"><br/>

     姓名:<input type="text" name="user.uname"><br/>

     年龄:<input type="text" name="user.age"><br/>

     <input type="submit" value="提交">

</form>


复制代码



3.1.4.3、POJO类中包含集合类型参数

注意:框架实现一些数据类型自动转换。内置转换器全都在: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

......


复制代码



3.1.4.4、请求参数乱码问题

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>


复制代码


在 springmvc.xml 的配置文件中可以配置,静态资源不过滤:


<!-- location 表示路径,mapping 表示文件,**表示该目录下的文件以及子目录的文件 -->  

<mvc:resources location="/css/" mapping="/css/**"/>  

<mvc:resources location="/images/" mapping="/images/**"/>  

<mvc:resources location="/scripts/" mapping="/javascript/**"/>


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"  即可。


3.2、特殊情况

3.2.1、自定义类型转换器

3.2.1.1、使用场景

2011/11/11  ---  可以进行自动转换(User{uname='root', age=23, date=Fri Nov 11 00:00:00 CST 2011})

2011-11-11  ---  无法进行自动转换   无法进行数据的封装


Failed to bind request element: org.springframework.web.method.annotation.MethodArgumentTypeMismatchExcept ion:  Failed to convert value of type 'java.lang.String' to required type 'java.util.Date'; nested exception is          

   org.springframework.core.convert.ConversionFailedException:  

   Failed to convert from type [java.lang.String] to type [java.util.Date] for value '2018-01-01'; nested exception is java.lang.IllegalArgumentException



3.2.1.2、实现

第一步:定义一个类,实现Convert接口,该接口由两个泛型

复制代码


@FunctionalInterface

public interface Converter<S, T> {   ///S:表示接受的类型,T:表示目标类型


   /**

    * Convert the source object of type {@code S} to target type {@code T}.

    * @param source the source object to convert, which must be an instance of {@code S} (never {@code null})

    * @return the converted object, which must be an instance of {@code T} (potentially {@code null})

    * @throws IllegalArgumentException if the source cannot be converted to the desired target type

    */

   @Nullable

   T convert(S source);


}


复制代码


自定义类型转换器:

复制代码


/**

* 将字符串转换日期

*/

public class StringToDateConverter implements Converter<String,Date> {

   

   @Override

   public Date convert(String source) {

       if(source==null){

           throw new RuntimeException("请传入数据");

       }

       DateFormat df = new SimpleDateFormat("yyyy-MM-dd");

       try {

           Date date = df.parse(source);

           return date;

       } catch (ParseException e) {

           throw new RuntimeException("输入日期有误。");

       }

   }

}


复制代码


第二步:在spring配置文件中配置类型转换器

spring 配置类型转换器的机制是,将自定义的转换器注册到类型转换服务中去。


public class ConversionServiceFactoryBean implements FactoryBean<ConversionService>, InitializingBean {


   @Nullable

   private Set<?> converters;


复制代码


<!--配置类型转换器工厂-->

 <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">

   <!--给工厂注入一个新的类型转换器-->

   <property name="converters">

     <set>

       <!--配置自定义类型转换器-->

       <bean class="cn.itcast.utils.StringToDateConverter"></bean>

     </set>

   </property>

 </bean>

 

 <!--开启SpringMVC框架注解的支持-->

 <mvc:annotation-driven conversion-service="conversionService"/>


复制代码


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


<mvc:annotation-driven conversion-service="conversionService"/>


运行结果:

User{uname='root', age=23, date=Fri Nov 11 00:00:00 CST 2011}


3.2.2、使用(原生)ServletAPI对象作为方法参数

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

HttpServletRequest

HttpServletResponse

HttpSession

java.security.Principal

Locale

InputStream

OutputStream

Reader

Writer

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

<a href="param/testServlet">Servlet原生的API</a>

复制代码


/**原生的API

    * @param request

    * @param response

    * @return

    */

   @RequestMapping("/testServlet")

   public String testServlet(HttpServletRequest request, HttpServletResponse response){

       System.out.println("执行了。。。");

       System.out.println(request);


       HttpSession session = request.getSession();

       System.out.println(session);


       ServletContext servletContext = session.getServletContext();

       System.out.println(servletContext);


       System.out.println(response);

       

       return "success";

   }


复制代码



四、常用注解

4.1、@RequestParam

把请求中指定名称的参数给控制器中的形参赋值。

属性:

value:请求参数中的名称。

required:请求参数中是否必须提供此参数。默认值:true。表示必须提供,如果不提供将报错。

示例:

<a href="anno/testRequestParam?name=哈哈">RequestParam</a>

复制代码


/**

* 常用注解

*/

@Controller

@RequestMapping("/anno")

public class annoController {

   

   @RequestMapping("/testRequestParam")

   public String testRequestParam(@RequestParam(name = "name") String username){

       System.out.println("执行了。。。");

       System.out.println(username);

       return "success";

   }

}


复制代码

复制代码


@Target(ElementType.PARAMETER)

@Retention(RetentionPolicy.RUNTIME)

@Documented

public @interface RequestParam {


   /**

    * Alias for {@link #name}.

    */

   @AliasFor("name")

   String value() default "";


   /**

    * The name of the request parameter to bind to.

    * @since 4.2

    */

   @AliasFor("value")

   String name() default "";


   /**

    * Whether the parameter is required.

    * <p>Defaults to {@code true}, leading to an exception being thrown

    * if the parameter is missing in the request. Switch this to

    * {@code false} if you prefer a {@code null} value if the parameter is

    * not present in the request.

    * <p>Alternatively, provide a {@link #defaultValue}, which implicitly

    * sets this flag to {@code false}.

    */

   boolean required() default true;


   /**

    * The default value to use as a fallback when the request parameter is

    * not provided or has an empty value.

    * <p>Supplying a default value implicitly sets {@link #required} to

    * {@code false}.

    */

   String defaultValue() default ValueConstants.DEFAULT_NONE;


}


复制代码



4.2、@RequestBody

用于获取请求体内容。直接使用得到是 key=value&key=value...结构的数据。

get 请求方式不适用。

属性:

required:是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值 为 false,get 请求得到是 null。

示例:


<form action="anno/testRequestBody" method="post">

     用户姓名:<input type="text" name="username" /><br/>

     用户年龄:<input type="text" name="age" /><br/>

     <input type="submit" value="提交" />

</form>


复制代码


@RequestMapping("/testRequestBody")

   public String testRequestBody(@RequestBody String body){

       System.out.println("执行了。。。");

       System.out.println(body);

       return "success";

   }


复制代码



4.3、@PathVariable

用于绑定 url 中的占位符。例如:请求 url 中 /delete/{id},这个{id}就是 url 占位符。

url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 rest 风格 URL 的一个重要标志。

属性:

value:用于指定 url 中占位符名称。

required:是否必须提供占位符

示例:

<a href="anno/testPathVariable/10">testPathVariable</a>

复制代码


/**PathVariable注解

    * @param id

    * @return

    */

   @RequestMapping("/testPathVariable/{sid}")

   public String testPathVariable(@PathVariable(name="sid") String id){

       System.out.println("执行了。。。");

       System.out.println(id);

       return "success";

   }


复制代码


4.3.3、关于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


复制代码



4.3.4、基于HiddentHttpMethodFilter的示例

作用:

由于浏览器 form 表单只支持 GET 与 POST 请求,而 DELETE、PUT 等 method 并不支持,Spring3.0 添加了一个过滤器,可以将浏览器请求改为指定的请求方式,发送给我们的控制器方法,使得支持 GET、POST、PUT 与 DELETE 请求。

使用方法:

第一步:在 web.xml 中配置该过滤器。

第二步:请求方式必须使用 post 请求。

第三步:按照要求提供_method 请求参数,该参数的取值就是我们需要的请求方式。


4.4、@RequestHeader

用于获取请求消息头。

属性:

value:提供消息头名称

required:是否必须有此消息头

注:在实际开发中一般不怎么用。

示例:

<a href="anno/testRequestHeader">testRequestHeader</a>

复制代码


/**获取请求头的值

    * @param header

    * @return

    */

   @RequestMapping("/testRequestHeader")

   public String testRequestHeader(@RequestHeader(value = "Accept") String header){

       System.out.println("执行了。。。");

       System.out.println(header);

       return "success";

   }


复制代码




4.5、@CookieValue

用于把指定 cookie 名称的值传入控制器方法参数。

属性:

value:指定 cookie 的名称。

required:是否必须有此 cookie

示例:

<a href="anno/testCookieValue">testCookieValue</a>

复制代码


/**获取cookie的值

    * @param cookieValue

    * @return

    */

   @RequestMapping("/testCookieValue")

   public String testCookieValue(@CookieValue(value = "JSESSIONID") String cookieValue){

       System.out.println("执行了。。。");

       System.out.println(cookieValue);

       return "success";

   }


复制代码


850F52E2652FB4B79DABDBC8341B1BA8


4.6、@ModelAttribute

该注解是 SpringMVC4.3 版本以后新加入的。它可以用于修饰方法和参数。

出现在方法上,表示当前方法会在控制器的方法执行之前,先执行。它可以修饰没有返回值的方法,也可以修饰有具体返回值的方法。

出现在参数上,获取指定的数据给参数赋值。

属性:

value:用于获取数据的 key。key 可以是 POJO 的属性名称,也可以是 map 结构的 key。

场景:

当表单提交数据不是完整的实体类数据时,保证没有提交数据的字段使用数据库对象原来的数据。

例如:

我们在编辑一个用户时,用户有一个创建信息字段,该字段的值是不允许被修改的。在提交表单数 据是肯定没有此字段的内容,一旦更新会把该字段内容置为 null,此时就可以使用此注解解决问题。


示例:

4.6.2.1、基于POJO属性的基本使用


<form action="anno/testModelAttribute" method="post">

   用户姓名:<input type="text" name="uname" /><br/>

   用户年龄:<input type="text" name="age" /><br/>

   <input type="submit" value="提交" />

</form>


复制代码


/**ModelAttribute注解

    * @param user

    * @return

    */

   @RequestMapping("/testModelAttribute")

   public String testModelAttribute(User user){

       System.out.println("执行了。。。");

       System.out.println(user);

       return "success";

   }

   

   @ModelAttribute

   public void showUser(){

       System.out.println("showUser执行了。。。");

   }


复制代码


4.6.2.2、基于Map的应用场景示例1:ModerAttribute修饰方法带返回值

复制代码


/**ModelAttribute注解

    * @param user

    * @return

    */

   @RequestMapping("/testModelAttribute")

   public String testModelAttribute(User user){

       System.out.println("执行了。。。");

       System.out.println(user);

       return "success";

   }

   

   @ModelAttribute

   public User showUser(String uname){

       System.out.println("showUser执行了。。。");

       User user = new User();

       user.setUname(uname);

       user.setAge(20);

       user.setDate(new Date());

       return user;

   }


复制代码


4.6.2.3、基于Map的应用场景示2:ModerAttribute修饰方法不带返回值

复制代码


/**ModelAttribute注解

    * @param user

    * @return

    */

   @RequestMapping("/testModelAttribute")

   public String testModelAttribute(@ModelAttribute("abc") User user){

       System.out.println("执行了。。。");

       System.out.println(user);

       return "success";

   }


   @ModelAttribute

   public void showUser(String uname, Map<String ,Object> map){

       System.out.println("showUser执行了。。。");

       User user = new User();

       user.setUname(uname);

       user.setAge(20);

       user.setDate(new Date());

       map.put("abc",user);

   }


复制代码



4.7、@SessionAttribute

用于多次执行控制器方法间的参数共享。

属性:

value:用于指定存入的属性名称

type:用于指定存入的数据类型。

示例:


<a href="anno/testSessionAttribute">存入---testSessionAttribute</a><br/>

<a href="anno/getSessionAttribute">获取---getSessionAttribute</a><br/>

<a href="anno/delSessionAttribute">清除---delSessionAttributes</a><br/>


复制代码


/**

* 常用的注解

*/

@Controller

@RequestMapping("/anno")

@SessionAttributes(value={"msg"})   // 把msg=美美存入到session域对中

public class AnnoController {

   /**添加值到request域中

    * SessionAttributes的注解

    * @return

    */

   @RequestMapping(value="/testSessionAttributes")

   public String testSessionAttributes(Model model){

       System.out.println("testSessionAttributes...");

       // 底层会存储到request域对象中

       model.addAttribute("msg","美美");

       return "success";

   }


   /**

    * 获取值

    * @param modelMap

    * @return

    */

   @RequestMapping(value="/getSessionAttributes")

   public String getSessionAttributes(ModelMap modelMap){

       System.out.println("getSessionAttributes...");

       String msg = (String) modelMap.get("msg");

       System.out.println(msg);

       return "success";

   }


   /**

    * 清除

    * @param status

    * @return

    */

   @RequestMapping(value="/delSessionAttributes")

   public String delSessionAttributes(SessionStatus status){

       System.out.println("delSessionAttributes执行了...");

       status.setComplete();    //清除session中的内容

       return "success";

   }

}


复制代码


也可以这么写:public String testSessionAttribute(HttpServletRequest request...)

但是和Servlet的AIP的耦合过高。

SpringMVC中提供了一个类Model接口

ModerMap extends LinkedHashMap

向model中存储数据,spring(底层实现)会将数据存储到request域对象中。


@SessionAttibute 注解只能是作用在类上。

此时存储在request域对象中的内容,现在session中也有。


存的时候可以使用Model model对象进行存储。-->spring会自行创建 Model 的实现类进行存储

取的时候,使用ModelMap modelMap进行取。ModelMap是Model的实现类。