红帽全球峰会27.9. 消耗 REST 请求 - Simple Binding Style
从 Camel 2.11 开始
默认 绑定风格是低级，要求用户手动处理进入路由的 MessageContentsList 对象。因此，它将路由逻辑与 JAX-RS 操作的方法签名和参数索引紧密耦合，这稍微困难且容易出错。
相反，simple Consumer 绑定风格会执行以下映射，以便在 Camel 消息中 更方便地访问请求数据 ：
-
JAX-RS 参数(
@HeaderParam、@QueryParam等等)作为 IN 消息标头注入。标头名称与注解值匹配。 -
请求实体(POJO 或其他类型)成为 IN 消息正文。如果无法在 JAX-RS 方法签名中识别单个实体，它将回退到原始
MessageContentsList。 -
二进制
@Multipartbody parts become IN message attachments, supportDataHandler,InputStream,DataSource和 CXF 的Attachment类。 -
非二进制
@Multipartbody 部分映射为 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 响应中。
27.9.1. 启用简单绑定样式
复制链接链接已复制到粘贴板!
通过将消费者端点中的 bindingStyle 参数设置为 SimpleConsumer，可以激活此绑定风格：
from("cxfrs:bean:rsServer?bindingStyle=SimpleConsumer")
.to("log:TEST?showAll=true");
from("cxfrs:bean:rsServer?bindingStyle=SimpleConsumer")
.to("log:TEST?showAll=true");27.9.2. 使用不同方法签名的请求绑定示例
复制链接链接已复制到粘贴板!
以下是方法签名列表以及简单绑定的预期结果：
-
公共响应 doAction (BusinessObject request);：请求有效负载放置在 tbe IN 消息正文中，替换原始 MessageContentsList。 -
公共响应 doAction (BusinessObject request, @HeaderParam ("abcd") String abcd, @QueryParam ("defg") String defg);: 请求有效负载放置在 IN 消息正文中，替换原始MessageContentsList。这两个请求参数都映射为 IN 消息标头，其名称为 "abcd" 和 "defg "。 -
公共响应 doAction (@HeaderParam ("abcd") String abcd, @QueryParam ("defg") String defg);: 这两个请求参数都映射为 IN message 标头，名称为 "abcd" 和 "defg "。原始MessageContentsList被保留，即使它只包含两个参数。 -
公共响应 doAction (@Multipart (value="body1") BusinessObject request, @Multipart (value="body2") BusinessObject request2);: first 参数作为名为 "body1" 的标头传输，第二个参数被映射为标题 "body2 "。原始MessageContentsList保留为 IN 消息正文。 -
公共响应 doAction (InputStream abcd);:InputStreamis unwrapped from theMessageContentsListand reserved as the IN message body. -
公共响应 doAction (DataHandler abcd);: DataHandler 从MessageContentsList中分离，并保留为 IN 消息正文。
27.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）：
将打印消息：
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}