276.2. URI 选项
REST 组件支持 4 个选项,如下所列。
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
componentName (common) | 用于 REST 传输的 Camel Rest 组件,如 restlet、spark-rest。如果没有明确配置组件,则 Camel 将查找是否有与 Rest DSL 集成的 Camel 组件,或者 org.apache.camel.spi.RestConsumerFactory (consumer)或 org.apache.camel.spi.RestProducerFactory (producer)是否在 registry 中注册。如果找到其中任一个,则使用它。 | 字符串 | |
apidoc (producer) | 要使用的 OpenAPI api doc 资源。默认情况下,资源从 classpath 加载,必须采用 JSon 格式。 | 字符串 | |
host (producer) | 要使用的 HTTP 服务的主机和端口(在 OpenAPI 模式中设置主机) | 字符串 | |
resolveProperty Placeholders (advanced) | 组件是否应在启动时解析属性占位符。只有 String 类型的属性可以使用属性占位符。 | true | 布尔值 |
REST 端点使用 URI 语法进行配置:
rest:method:path:uriTemplate
使用以下路径和查询参数:
276.2.1. 路径参数(3 参数):
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
方法 | 要使用 所需的 HTTP 方法。 | 字符串 | |
path | 必需 的基本路径 | 字符串 | |
uriTemplate | uri 模板 | 字符串 |
276.2.2. 查询参数(15 参数):
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
componentName (common) | 用于 REST 传输的 Camel Rest 组件,如 restlet、spark-rest。如果没有明确配置组件,则如果有一个与 Rest DSL 集成的 Camel 组件,或者 org.apache.camel.spi.RestConsumerFactory 在 registry 中注册,则 Camel 将查找。如果找到其中任一个,则使用它。 | 字符串 | |
consume (common) | 介质类型,如 'text/xml' 或 'application/json' this REST 服务接受。默认情况下,我们接受所有类型。 | 字符串 | |
inType (common) | 将传入的 POJO 绑定类型声明为 FQN 类名称 | 字符串 | |
outType (common) | 将传出的 POJO 绑定类型声明为 FQN 类名称 | 字符串 | |
generate (common) | 介质类型,如 'text/xml' 或 'application/json' this REST 服务返回。 | 字符串 | |
routeId (common) | 此 REST 服务创建的路由的名称 | 字符串 | |
bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外,该处理程序记录在 WARN/ERROR 级别并忽略。 | false | 布尔值 |
description (consumer) | 记录此 REST 服务的人员描述 | 字符串 | |
ExceptionHandler ( consumer) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,该例外记录在 WARN/ERROR 级别并忽略。 | ExceptionHandler | |
exchangePattern (consumer) | 在创建交换时设置默认交换模式。 | ExchangePattern | |
apidoc (producer) | 要使用的 OpenAPI api doc 资源。默认情况下,资源从 classpath 加载,必须采用 JSon 格式。 | 字符串 | |
bindingMode (producer) | 配置制作者的绑定模式。如果设置为 'off' 以外的任何一个,则生成者将尝试将传入消息的正文从 inType 转换为 json 或 xml,并将 json 或 xml 的响应转换为 outType。 | RestBindingMode | |
host (producer) | 要使用的 HTTP 服务的主机和端口(在 OpenAPI 模式中设置主机) | 字符串 | |
queryParameters (producer) | 要调用的 HTTP 服务的查询参数 | 字符串 | |
同步 (高级) | 设置是否应严格使用同步处理,还是允许 Camel 使用异步处理(如果支持)。 | false | 布尔值 |