JDBC 转义

JDBC 规范（如 ODBC 规范）承认对于某些 RDBMS 的功能可能需要用到某些供应商特定的 SQL。为了帮助开发人员跨多个数据库产品编写可移植的 JDBC 应用程序，特殊的转义语法用于指定开发人员希望运行的通用命令。JDBC 驱动程序翻译这些转义序列，转换为特定数据库的相关语法。有关更多信息，请参阅 Java DB 技术文档。

可以使用Statement.setEscapeProcessing(false)禁用这些转义的 sql 语句解析。

Connection.nativeSQL(String sql)提供另一种处理转义的方法。它将给定的 SQL 转换为适用于PostgreSQL后端的 SQL。

例 8.1.使用 JDBC 转义

要使用 JDBC 转义，您只需编写 SQL 将日期/时间文字值、外部连接和函数替换为 JDBC 转义语法。例如：

ResultSet rs = st.executeQuery("SELECT {fn week({d '2005-01-24'})}");

它是下面SQL的可移植性的版本

ResultSet rs = st.executeQuery("SELECT extract(week from DATE '2005-01-24')");

您可以指定在字符串比较（使用LIKE）中使用的转义字符，通过添加以下转义：{escape 'escape-character'}，以保护通配符（’%’ 和 ‘_’）。驱动程序仅在比较表达式的末尾支持此功能。

例如，您可以在比较字符串值时使用 ‘|’ 作为转义字符来保护 ‘_’ ：

rs = stmt.executeQuery("select str2 from comparisontest where str1 like '|_abcd' {escape '|'} ");

可以使用以下语法指定外部连接：{oj table (LEFT|RIGHT|FULL) OUTER JOIN (table | outer-join) ON search-condition}

例如：

ResultSet rs = stmt.executeQuery("select * from {oj a left outer join b on (a.i=b.i)} ");

JDBC 规范定义了用于指定驱动程序支持的日期、时间和时间戳值的转义。

• date : {d 'yyyy-mm-dd'} 转换为 DATE 'yyyy-mm-dd'
• time : {t 'hh:mm:ss'} 转换为 TIME 'hh:mm:ss'
• timestamp : {ts 'yyyy-mm-dd hh:mm:ss.f...'} 转换为 TIMESTAMP 'yyyy-mm-dd hh:mm:ss.f'。时间戳中秒数后面的小数部分（.f…）可以省略。

JDBC 规范使用转义调用语法定义函数：{fn function_name(arguments)}。下表显示 PostgreSQL 驱动程序支持哪些函数。驱动程序支持嵌套和混合转义函数和转义值。JDBC 规范的附录 C 章节描述了这些函数。

下表中的某些函数都已被翻译，但由于它们重复或更改他们的参数顺序而报告为不受支持。虽然这对文字值或列无害，但在使用预备语句时会导致问题。例如{fn right(?,?)}将被转换为substring(? from (length(?)+1-?))。请注意，有些转换后的 SQL 需要比转换前更多的参数，但驱动程序不会自动处理此问题。

表 8.1.支持的转义数值函数

表 8.2.支持的转义字符串函数

表 8.3.支持的转义日期/时间函数

表 8.4.其他支持的转义函数