47.2.4. 从 HTML 表单注入数据
概述
HTML 表单是一种从用户获取信息的简单方法，也易于创建。表单数据可用于 HTTP GET 请求和 HTTP POST 请求：
- GET
-
当表单数据作为 HTTP
GET请求的一部分发送时，数据会作为一组查询参数附加到 URI 中。“使用查询参数”一节 中讨论从查询参数注入数据。 - POST
-
当表单数据作为 HTTP
POST请求的一部分发送时，数据将放置在 HTTP 消息正文中。表格数据可使用支持表单数据的常规实体参数进行处理。它还可以通过使用@FormParam注释来提取数据并将部分注入资源方法参数来实现。
使用 @FormParam 注释来注入表单数据
javax.ws.rs.FormParam 注解从表单 data 中提取字段值，并将值注入到资源方法参数中。该注释采用单一参数，用于指定它提取值的字段键。关联的参数必须符合 “支持的数据类型”一节 中描述的数据类型。
重要
JAX-RS API Javadoc指出 @FormParam 注释可以放在字段、方法和参数上。但是，@FormParam 注释仅在放置资源方法参数时有意义。
示例
将表单数据注入资源方法参数 显示将表单数据注入参数的资源方法。该方法假定客户端的格式包含三个字段：标题、标签 和 body- 包含字符串数据。
将表单数据注入资源方法参数
import javax.ws.rs.FormParam;
import javax.ws.rs.POST;
...
@POST
public boolean updatePost(@FormParam("title") String title,
@FormParam("tags") String tags,
@FormParam("body") String post)
{
...
}
