1.SpringMVC 绑定请求参数
(1)支持的数据类型
基本类型参数:
包括基本类型和 String 类型
POJO 类型参数:
包括实体类,以及关联的实体类
数组和集合类型参数:
包括 List 结构和 Map 结构的集合(包括数组)
(2)使用要求
SpringMVC 绑定请求参数是自动实现的,但是要想使用,必须遵循使用要求。
<1>如果是基本类型或者 String 类型:
要求我们的参数名称必须和控制器中方法的形参名称保持一致。(严格区分大小写)
<2>如果是 POJO 类型,或者它的关联对象:
要求form表单中参数名称和实体类javabean的属性名称保持一致。并且控制器方法的参数类型是 POJO 类型。
SpringMVC 会将请求参数名和 POJO 属性名进行自动匹配, 自动为该对象填充属性值。
<3>如果是集合类型,有两种方式:
第一种:
要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。
给 List 集合中的元素赋值,使用下标。
给 Map 集合中的元素赋值,使用键值对。
第二种:
接收的请求参数是 json 格式数据。需要借助一个注解实现。
2.绑定请求参数代码测试
注意:以下代码的运行环境是day18_spring_test01_quickstart这个web工程
(1)请求参数为基本的数据类型
ParamsController.java这个控制器类
package lucky.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* 请求参数绑定
*/
@Controller
@RequestMapping(path = "/params")
public class ParamsController {
/**
* 请求参数绑定入门
* @return
*/
@RequestMapping(path = "/testParam")
public String testParam(String username,String password){
System.out.println("testParam方法执行了");
System.out.println("用户名:"+username+",密码:"+password);
return "success";
}
}
jsp页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>params_bind</title>
</head>
<body>
<%--请求参数的绑定--%>
<a href="/day18_spring_test01_quickstart/params/testParam?username=lucky&password=plj666">请求参数绑定</a>
</body>
</html>
控制台输出:
(2)将请求参数封装到javabean中
Account.java
package lucky.domain;
import java.io.Serializable;
public class Account implements Serializable {
private String username;
private String password;
private Double money;
private User user;
public User getUser() {
return user;
}
public void setUser(User user) {
this.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;
}
@Override
public String toString() {
return "Account{" +
"username='" + username + '\'' +
", password='" + password + '\'' +
", money=" + money +
", user=" + user +
'}';
}
}
User.java
package lucky.domain;
import java.io.Serializable;
public class User implements Serializable {
private String name;
private Integer age;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
@Override
public String toString() {
return "User{" +
"name='" + name + '\'' +
", age=" + age +
'}';
}
}
ParamsController.java
package lucky.controller;
import lucky.domain.Account;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* 请求参数绑定
*/
@Controller
@RequestMapping(path = "/params")
public class ParamsController {/**
* 把请求参数封装绑定到javabean的类中
* @return
*/
@RequestMapping(path = "/testParamAccount")
public String testParamAccount(Account account){
System.out.println("testParamAccount方法执行了");
System.out.println(account);
return "success";
}
}
jsp页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>params_bind</title>
</head>
<body>
<%--请求参数的绑定--%>
<%--name 属性用于对提交到服务器后的表单数据进行标识,或者在客户端通过 JavaScript 引用表单数据。--%>
<%--只有设置了 name 属性的表单元素才能在提交表单时传递它们的值。--%>
<%--注意:name属性值必须与javabean的成员变量名称一模一样,否则无法识别--%>
<form action="/day18_spring_test01_quickstart/params/testParamAccount" method="post">
姓名:<input type="text" name="username"><br>
密码:<input type="text" name="password"><br>
金额:<input type="text" name="money"><br>
用户名:<input type="text" name="user.name"><br>
年龄:<input type="text" name="user.age"><br>
<input type="submit" value="提交">
</form>
</body>
</html>
控制台输出:
3.常用注解
(1)@RequestParam
<1>作用:把请求中指定名称的参数给控制器中的形参赋值。
<2>属性:
value:请求参数中的名称。
required:请求参数中是否必须提供此参数。默认值:true。表示必须提供,如果不提供将报错。
<3>使用案例
AnnotationController.java
package lucky.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
/**
* 常用的注解
* @RequestParam(value= "name") 把(annotation.jsp)请求中指定名称的参数(name)给控制器中的形参(username)赋值。
*/
@Controller
@RequestMapping(path = "/annotation")
public class AnnotationController {
@RequestMapping(path = "/testRequestParam")
public String testRequestParam(@RequestParam(value= "name") String username){
System.out.println("执行了testRequestParam");
System.out.println(username);
return "success";
}
}
jsp页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>annotation</title>
</head>
<body>
<%--常用的注解--%>
<a href="/day18_spring_test01_quickstart/annotation/testRequestParam?name=lucky">RequestParam</a>
</body>
</html>
(2)@PathVaribale
<1>作用:
{id},这个{id}就是 url 占位符。
url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 restful 风格 URL 的一个重要标志。
<2>属性:
value:用于指定 url 中占位符名称。
required:是否必须提供占位符。
<3>REST 风格的URL
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
/account/1 HTTP DELETE: 删除 id = 1 的 account
/account/1 HTTP PUT: 更新 id = 1 的 account
<4>使用案例
AnnotationController.java
package lucky.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
/**
* 常用的注解
* @RequestParam(value= "name") 把(annotation.jsp)请求中指定名称的参数(name)给控制器中的形参(username)赋值。
*/
@Controller
@RequestMapping(path = "/annotation")
public class AnnotationController {
/**
* PathVariable注解使用案例
* @param id
* @return
*/
@RequestMapping(path = "/testPathVariable/{id}")
public String testPathVariable(@PathVariable(value = "id") String id){
System.out.println("执行了testPathVariable");
System.out.println(id);
return "success";
}
}
jsp页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>annotation</title>
</head>
<body>
<%--常用的注解--%>
<a href="/day18_spring_test01_quickstart/annotation/testPathVariable/10">PathVariable</a>
</body>
</html>
(3)@RequestBody
作用:@RequestBody注解用于读取http请求的内容(字符串),通过springmvc提供的HttpMessageConverter接口将读到的内容(json数据)转换为java对象并绑定到Controller方法的参数上。
相关代码:
/**
* 模拟异步请求
* springmvc会自动的将json数据转为javabean对象
*/
@RequestMapping(path = "/testAjax")
public @ResponseBody User testAjax(@RequestBody User user) throws Exception{
System.out.println("testAjax方法执行了");
System.out.println(user);
//模拟查询数据库操作
user.setUsername("linda");
user.setAge(31);
return user;
}