随着TDengine-2.0.14.0版本的发布，我们在这个版本中为JDBC Connector添加了一种新的实现：JDBC-RESTful。它内部使用RESTful接口, 而不是taosc连接TDengine服务器，这样能够跨平台，不仅在Linux, Windows, 在Mac上都能开发TDengine应用了。特别的是，你也不用担心升级TDengine需要同步升级客户端了。

01 使用JDBC-RESTful的好处

no taos in java.library.path

02 JDBC-RESTful的实现原理

• JDBC-JNI ：使用JNI调用客户端 libtaos.so（或 taos.dll ）的本地方法，通过socket与taosd通信。
• JDBC-RESTful ：在内部封装了 TDengine的RESTful 接口，将SQL封装成HTTP请求发送给server端的taosd示例。

• JDBC-JNI：Java 应用在物理节点1（pnode1）上使用 JDBC-JNI 的 API ，直接调用客户端 API（libtaos.so 或 taos.dll）将写入和查询请求发送到位于物理节点2（pnode2）上的 taosd 实例。
• RESTful：应用将 SQL 发送给位于物理节点2（pnode2）上的 RESTful 连接器，再调用客户端 API（libtaos.so）。
• JDBC-RESTful：Java 应用通过 JDBC-RESTful 的 API ，将 SQL 封装成一个 RESTful 请求，发送给物理节点2的 RESTful 连接器。

03 JDBC-RESTful的使用示例

1. driverClass 指定为“com.taosdata.jdbc.rs.RestfulDriver”；
2. jdbcUrl 以“jdbc:TAOS-RS://”开头；
3. 使用 6041 作为连接端口。

<dependency>
  <groupId>com.taosdata.jdbc</groupId>
  <artifactId>taos-jdbcdriver</artifactId>
  <version>2.0.18</version>
</dependency>

public class JdbcRestfulDemo {
    private static final String host = "taos-server";
    public static void main(String[] args) {
        try {
            // load JDBC-restful driver
            Class.forName("com.taosdata.jdbc.rs.RestfulDriver");
            // use port 6041 in url when use JDBC-restful
            String url = "jdbc:TAOS-RS://" + host + ":6041/?user=root&password=taosdata";
            Properties properties = new Properties();
            properties.setProperty("charset", "UTF-8");
            properties.setProperty("locale", "en_US.UTF-8");
            properties.setProperty("timezone", "UTC-8");
            Connection conn = DriverManager.getConnection(url, properties);
            Statement stmt = conn.createStatement();
            stmt.execute("create database if not exists restful_test");
            stmt.execute("use restful_test");
            stmt.execute("create table restful_test.weather(ts timestamp, temperature float) tags(location nchar(64))");
            stmt.executeUpdate("insert into t1 using restful_test.weather tags(\'北京\') values(now, 18.2)");
            ResultSet rs = stmt.executeQuery("select * from restful_test.weather");
            ResultSetMetaData meta = rs.getMetaData();
            while (rs.next()) {
                for (int i = 1; i <= meta.getColumnCount(); i++) {
                    System.out.print(meta.getColumnLabel(i) + ": " + rs.getString(i) + "\t");
                }
                System.out.println();
            }
            rs.close();
            
            stmt.close();
            conn.close();
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

04 JDBC-RESTful的性能

1. 在每条SQL中插入的记录数少的情况下，JDBC-RESTful的写入性能是JDBC-JNI的50%左右；
2. 在每条SQL中插入的记录数多的情况下，JDBC-RESTful的写入性能是JDBC-JNI性能的90%左右；
3. JDBC-RESTful与JDBC-JNI在查询性能上，没有明显差异。

总结

1. JDBC-RESTful提供了跨平台开发的特性，可以在开发环境中使用。
2. JDBC-JNI相比JDBC-RESTful有一定的性能优势，如果在生产环境中希望最大化发挥TDengine的性能，可以使用JDBC-JNI的方式。
3. JDBC-RESTful到JDBC-JNI的切换十分简单，一般只需要修改配置文件即可。

点击这里，开始尝试TDengine JDBC-RESTful吧！