SpringMVC最详细笔记partⅠ
一、springMVC-quickStar
- 解决maven加载项目过慢
archetypeCatalog
internal
- 导入依赖
<!-- 版本锁定 -->
<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>
- web.xml配置
<!-- SpringMVC的核心控制器 -->
<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
- springMVC的配置文件
<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">
<!-- 配置spring创建容器时要扫描的包 -->
<context:component-scan base-package="club.leyvan"/>
<!-- 配置视图解析器 -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/pages/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
<!-- 配置spring开启注解mvc的支持 -->
<mvc:annotation-driven></mvc:annotation-driven>
</beans>
在 SpringMVC 的各个组件中,处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。 使 用 < mvc:annotation-driven> 自动加载 RequestMappingHandlerMapping (处理映射器) 和 RequestMappingHandlerAdapter ( 处 理 适 配 器 ) , 可 用 在 SpringMVC.xml 配 置 文 件 中 使 用 < mvc:annotation-driven>替代注解处理器和适配器的配置。
- 创建控制器类
package club.leyvan.controller
//控制器类
@Controller
public class HelloController {
@RequestMapping(path="/hello")
public String sayHello(){
System.out.println("Hello SpringMvc");
return "success";
}
}
二、@RequestMapping注解
-
RequestMapping注解的作用是建立请求URL和处理方法之间的对应关系
-
RequestMapping注解可以作用在方法和类上
-
作用在类上:第一级的访问目录
-
作用在方法上:第二级的访问目录
-
细节:路径可以不编写 / 表示应用的根目录开始
-
细节:${ pageContext.request.contextPath }也可以省略不写,但是路径上不能写 /
-
-
RequestMapping的属性
- path 指定请求路径的url
- value value属性和path属性是一样的 源码中声明了:@AliasFor("path")
- mthod 指定该方法的请求方式 例:method={RequestMethod.POST}
- params 指定限制请求参数的条件 例:params={"username=123"} 请求中必须含有username参数且值必须为123,否则不接受此请求
- headers 发送的请求中必须包含的请求头 例:设置一个防爬虫的请求头及值,如果不是用户请求头则不接受访问
三、请求参数绑定
-
请求参数的绑定说明
- 绑定机制
- 表单提交的数据都是k=v格式的 username=haha&password=123
- SpringMVC的参数绑定过程是把表单提交的请求参数,作为控制器中方法的参数进行绑定的
- 要求:提交表单的name和方法参数的名称是相同的
- 支持的数据类型
- 基本数据类型和字符串类型
- 实体类型(JavaBean)
- 集合数据类型(List、map集合等)
- 绑定机制
-
基本数据类型和字符串类型
-
提交表单的name和参数的名称是相同的
-
区分大小写
-
实体类型(JavaBean)
- 提交表单的name和JavaBean中的属性名称需要一致
- 如果一个JavaBean类中包含其他的引用类型,那么表单的name属性需要编写成:对象.属性 例如:address.name
-
给集合属性数据封装
- JSP页面编写方式:list[0].属性
-
请求参数中文乱码的解决 :在web.xml中配置Spring提供的过滤器类
<!-- 配置过滤器,解决中文乱码的问题 --> <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
-
-
不同类型参数绑定的举例:
/** * 1.基本类型和字符串的参数绑定 * 请求的连接:testParam?username=hehe&password=123 * 输出结果:username:hehe * password: 123 */ @RequestMapping("/testParam") public String testParam(String username,String password) { System.out.println("username:"+username); System.out.println("password:"+password); return "success"; } /** * 2.JavaBean的参数绑定 * account:Account->username:String;password:String;money:Double * 请求的连接:通过form提交post请求 * <form action="param/saveAccount" metohd="post"> * <input type="text" name="username"/> * <input type="password" name="password"/> * <input type="text" name="money"/> * <input type="submit" value="提交"/> * </form> */ @RequestMapping("/saveAccount") public String saveAccount(Account account) { System.out.println(account.toString()); return "success"; } /** * 3.JavaBean中含有User类型的参数的参数绑定 * account:Account->username:String;password:String;money:Double;user:User * user:User->uname:String;age:String * 请求的连接:通过form提交post请求 * <form action="param/saveAccount" metohd="post"> * <input type="text" name="username"/> * <input type="password" name="password"/> * <input type="text" name="money"/> * <input type="text" name="user.uname"/> * <input type="text" name="user.age"/> * <input type="submit" value="提交"/> * </form> */ @RequestMapping("/saveAccount") public String saveAccount(Account account) { System.out.println(account.toString()); return "success"; } /** * 4.集合数组的参数绑定 * account:Account->username:String;password:String;money:Double;user:User * list:List<User>;map:Map<String,User> * 请求的连接:通过form提交post请求 * <form action="param/saveAccount" metohd="post"> * <input type="text" name="username"/> * <input type="password" name="password"/> * <input type="text" name="money"/> * <input type="text" name="list[0].uname"/> * <input type="text" name="list[0].age"/> * <input type="text" name="map['随便'].uname"/> * <input type="text" name="map['随便']user.age"/> * <input type="submit" value="提交"/> * </form> */
四、自定义类型转换器解决日期格式转换的错误
由于页面提交的数据全都是字符串的形式但SpringMVC内部自动的将字符串类型的数据进行了转换,大多数的类型都帮助转换好了,但还有可能存在问题:
默认转换的日期格式:2020/3/28 但你想要的是2020-3-28这个时候就需要自定义类型转换器
1.定义一个类、实现接口Converter<S,T> S:源类型 T:目标类型
/**
* 把字符串转换成日期的转换器
*/
public class StringToDateConverter implements Converter<String, Date>{
/**
* String source 传入进来的字符串
*/
public Date convert(String source) {
// 判断
if(source == null) {
throw new RuntimeException("参数不能为空");
}
try {
DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
// 解析字符串
Date date = df.parse(source);
return date;
} catch (Exception e) {
throw new RuntimeException("类型转换错误");
}
}
}
2.在springMVC的配置文件中配置自定义类型转换器
<!-- 注册自定义类型转换器 -->
<bean id="conversionService"class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<set>
<bean class="cn.itcast.utils.StringToDateConverter"/>
</set>
</property>
</bean>
3.让自定义的类型转换器生效
<!-- 开启Spring对MVC注解的支持 -->
<mvc:annotation-driven conversion-service="conversionService"/>
五、@RequestParam
1.作用:把请求中指定名称的参数给控制器中的形参赋值(当形参于参数名不同时使用)。
2.位置:在方法的参数类型前
3.参数:
- value:请求参数中的名称。
- required:请求参数中是否必须提供此参数。默认值:true。表示必须提供,如果不提供将报错。
六、@RequestBody
1.作用:用于获取请求体内容。直接使用得到是 key=value&key=value...结构的数据,get 请求方式不适用。 用于异步请求的json数据获取
2.位置:在方法的参数类型前
3.参数:
- required:是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值为 false,get 请求得到是 null。
七、@PathVariable和RESTful风格
-
@PathVariable
1.作用:于@RequestMapping("/test/{id}")联合使用,用于获取RequestMapping中的sid的值;用于绑定 url 中的占位符。例如:请求 url 中 /delete/{id},这个{id}就是 url 占位符。 @PathVariable(name="id")
url:test/10
2.位置:在方法的参数类型前
3.参数:
- value:用于指定 url 中占位符名称。
- required:是否必须提供占位符。
-
什么是 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):把资源具体呈现出来的形式,叫做它的表现层。
比如,文本可以用 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
八、@RequestHeader
1.作用:用于获取请求消息头。
2.位置:在方法的参数类型前
3.参数:
- value:获取消息头名称
- required:是否必须有此消息头
九、@CookieValue
1.作用:用于把指定 cookie 名称的值传入控制器方法参数。
2.位置:在方法的参数类型前
3.参数:
- value:指定 cookie 的名称。
- required:是否必须有此 cookie。
十、@ModelAttribute
1.作用:它可以用于修饰方法和参数。出现在方法上,表示当前方法会在控制器的方法执行之前,先执行。它可以修饰没有返回值的方法,也可以修饰有具体返回值的方法。出现在参数上,获取指定的数据给参数赋值。
3.参数:
- value:用于获取数据的 key。key 可以是 POJO 的属性名称,也可以是 map 结构的 key
十一、@SessionAttribute
1.作用:用于将值存入session域中。
2.位置:在类上
3.参数:
- value:用于指定存入的属性名称
- type:用于指定存入的数据类型。
4.其他:
- Model类,将值存入request域中
- ModelMap类,可以从域中取值,包括session
- sessionStatus.setComplete();用于删除session中的内容