第 325 章 SQL 组件
作为 Camel 版本 1.4 可用
sql: 组件允许您使用 JDBC 查询来处理数据库。此组件与 JDBC 组件之间的区别是,如果 SQL 查询是端点的属性,它会使用消息有效负载作为传递给查询的参数。
此组件使用 spring-jdbc
在 scenes 后面进行实际处理。
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 的存储库。请参阅 第 325.13 节 “使用基于 JDBC 的幂等存储库”。
- 适用于聚合器 EIP 模式的基于 JDBC 的存储库。请参阅 第 325.14 节 “使用基于 JDBC 的聚合存储库”。
325.1. URI 格式
警告:从该组件开始的 Camel 2.11 可同时创建使用者(例如,来自()
)和制作者端点(如 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 将从给定的优先级查找名称:
1。如果消息正文使用 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&option=value&…