第 326 章 SQL 组件
从 Camel 版本 1.4 开始提供
sql: 组件允许您使用 JDBC 查询处理数据库。此组件和 JDBC 组件之间的区别在于,如果 SQL 查询是端点的属性,它将消息有效负载用作传递给查询的参数。
此组件使用 spring-jdbc
在 scenes 后面进行实际 SQL 处理。
Maven 用户需要将以下依赖项添加到此组件的 pom.xml
中:
<dependency> <groupId>org.apache.camel</groupId> <artifactId>camel-sql</artifactId> <version>x.x.x</version> <!-- use the same version as your Camel core version --> </dependency>
SQL 组件还支持:
- 适用于 Idempotent Consumer EIP 模式的基于 JDBC 的存储库。请参阅 第 326.13 节 “使用基于 JDBC 的幂等存储库”。
- 用于聚合器 EIP 模式的基于 JDBC 的存储库。请参阅 第 326.14 节 “使用基于 JDBC 的聚合存储库”。
326.1. URI 格式
WARNING:From Camel 2.11.wards 此组件可以同时创建消费者(如 from ()
)和生成者端点(如 to ()
)。在以前的版本中,它只能充当制作者。
INFO:此组件可用作 交易客户端。
SQL 组件使用以下端点 URI 表示法:
sql:select * from table where id=# order by name[?options]
从 Camel 2.11 开始,您可以使用 :'#name_of_the_parameter' 样式来使用命名参数,如下所示:
sql:select * from table where id=:#myId order by name[?options]
当使用命名参数时,Camel 将在给定的优先级(
)中查找名称。来自消息正文(如果其 java.util.Map
2)。来自消息标头
如果无法解析命名参数,则会抛出异常。
在 Camel 2.14 之后,您可以使用 Simple 表达式作为参数,如下所示:
sql:select * from table where id=:#${property.myId} order by name[?options]
请注意,标准 ?
符号表示 SQL 查询的参数被替换为 #
符号,因为 ?
符号用于指定端点的选项。可以基于端点配置 ?
符号替换。
从 Camel 2.17 开始,您可以将 SQL 查询外部化到 classpath 或文件系统中的文件,如下所示:
sql:classpath:sql/myquery.sql[?options]
myquery.sql 文件位于 classpath 中,只是一个纯文本
-- this is a comment select * from table where id = :#${property.myId} order by name
在 文件中,您可以根据需要使用多行并格式化 SQL。和 也可使用 - dash 行等注释。
您可以使用以下格式在 URI 中附加查询选项 ?option=value& amp;option=value&…