红帽全球峰会30.9. 消耗 REST 请求 - Simple Binding Style
从 Camel 2.11 开始
Default 绑定风格是低级的，要求用户手动处理来自路由的 MessageContentsList 对象。因此，它会把路由逻辑与 JAX-RS 操作的方法签名和参数索引紧密连接，这在某种程度上比较困难、困难和容易出错。
相反，SimpleConsumer 绑定样式执行以下映射，以便可以在 Camel Message 中更轻松地访问请求数据：
-
JAX-RS 参数(
@HeaderParam、@QueryParam等)注入 IN 消息标头。标头名称与注解值匹配。 -
请求实体(POJO 或其他类型)成为 IN 消息正文。如果无法在 JAX-RS 方法签名中识别单个实体，它将回退到原始的
MessageContentsList。 -
二进制
@Multipart正文部分成为 IN 消息附件，支持DataHandler、InputStream、DataSource和 CXF 的Attachment类。 -
非二进制
@Multipart正文部分映射为 IN 消息标头。标头名称与 Body Part 名称匹配。
另外，以下规则适用于 Response 映射 ：
-
如果消息正文类型与
javax.ws.rs.core.Response(user-built response)不同，则创建新的响应，并且消息正文设置为实体（因此其不是 null）。响应状态代码从Exchange.HTTP_RESPONSE_CODE标头获取，如果不存在，则默认为 200 OK。 -
如果消息正文类型等于
javax.ws.rs.core.Response，这表示用户已构建自定义响应，因此它会被遵守，并成为最终响应。 -
在所有情况下，自定义或默认
HeaderFilterStrategy允许的 Camel 标头都添加到 HTTP 响应中。
30.9.1. 启用 Simple Binding Style
通过将消费者端点中的 bindingStyle 参数设置为 SimpleConsumer，可以激活这个绑定风格：
from("cxfrs:bean:rsServer?bindingStyle=SimpleConsumer")
.to("log:TEST?showAll=true");
from("cxfrs:bean:rsServer?bindingStyle=SimpleConsumer")
.to("log:TEST?showAll=true");30.9.2. 使用不同方法签名的请求绑定示例
以下是方法签名列表以及简单绑定的预期结果：
-
公共响应 doAction (BusinessObject 请求)；：请求有效负载放置在波be IN 消息正文中，替换原始 MessageContentsList。 -
公共响应 doAction (BusinessObject 请求, @HeaderParam ("abcd") String abcd, @QueryParam ("defg") String defg")；请求有效负载放置在 IN 消息正文中，替换原始MessageContentsList。两个请求参数都映射为 IN 消息标头，其名称为 "abcd" 和 "defg "。 -
公共响应 doAction (@HeaderParam ("abcd") String abcd, @QueryParam ("defg") String defg);: 两个请求参数都映射为名为 "abcd" 和 "defg" 的 IN 消息标头。原始MessageContentsList被保留，即使它只包含两个参数。 -
公共响应 doAction (@Multipart (value="body1") BusinessObject 请求, @Multipart (value="body2") BusinessObject request2);: 第一个参数作为名为 "body1" 的标头传输，第二个参数被映射为标题 "body2 "。原始MessageContentsList保留为 IN message body。 -
公共响应 doAction (InputStream abcd);:InputStreamis unwrapped from theMessageContentsListand preserved as the IN message body. -
Public Response doAction (DataHandler abcd);: DataHandler is unwrapped from theMessageContentsListand preserved as the IN message body.
30.9.3. Simple Binding Style 的示例
使用此方法给定 JAX-RS 资源类：
@POST @Path("/customers/{type}")
public Response newCustomer(Customer customer, @PathParam("type") String type, @QueryParam("active") @DefaultValue("true") boolean active) {
return null;
}
@POST @Path("/customers/{type}")
public Response newCustomer(Customer customer, @PathParam("type") String type, @QueryParam("active") @DefaultValue("true") boolean active) {
return null;
}通过以下路由提供服务：
from("cxfrs:bean:rsServer?bindingStyle=SimpleConsumer")
.recipientList(simple("direct:${header.operationName}"));
from("direct:newCustomer")
.log("Request: type=${header.type}, active=${header.active}, customerData=${body}");
from("cxfrs:bean:rsServer?bindingStyle=SimpleConsumer")
.recipientList(simple("direct:${header.operationName}"));
from("direct:newCustomer")
.log("Request: type=${header.type}, active=${header.active}, customerData=${body}");以下带有 XML 有效负载的 HTTP 请求（代表客户 DTO 是 JAXB-annotated）：
POST /customers/gold?active=true Payload: <Customer> <fullName>Raul Kripalani</fullName> <country>Spain</country> <project>Apache Camel</project> </Customer>
POST /customers/gold?active=true
Payload:
<Customer>
<fullName>Raul Kripalani</fullName>
<country>Spain</country>
<project>Apache Camel</project>
</Customer>将打印消息：
Request: type=gold, active=true, customerData=<Customer.toString() representation>
Request: type=gold, active=true, customerData=<Customer.toString() representation>
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}