创建应用

📄字数 2.1K

👁️阅读量 加载中...

本文主要为应用程序开发者编写。重点介绍 Java 应用开发，其他语言应用开发，参考 应用开发 章节。

创建 Java 示例应用

本文将展示 JDBC 应用程序如何使用 Xugu-JDBC 驱动连接并执行基础 CRUD 操作。

前置条件

1. 确保配置基础的数据库开发环境，xgconsole 或 DBeaver 客户端工具能正常连接 XuguDB。
2. 本地环境需正确配置 Java 开发环境，Java JDK 8 及以上。
3. 获取虚谷 JDBC 驱动包，在虚谷官网-下载中心 中 XuguDB API编程接口，下载 JDBC 标准接口（xugu-jdbc）。

创建 Java 应用程序

本章节展示在 Linux x86_64 环境上，加载 Xugu-JDBC 12.3.4 驱动，进行简单应用程序开发。

获取数据库连接字串

联系虚谷数据库部署人员，获取相应的数据库连接字串。

数据库连接字串中包含访问数据库所需的连接参数，必须参数包含 IP 地址、端口号、目标库名、登录用户及口令。

创建示例应用前，可通过客户端工具 xgconsole 或 DBeaver 验证连接，保证连接字串参数正确。

Xugu-JDBC 驱动访问数据库的 URL 字串格式为：

String url="jdbc:xugu://ip:port/databaseName?user=SYSDBA&password=SYSDBA";

• url: 访问数据库的URL路径。
• ip: 数据库的连接IP地址。
• port: 数据库的端口号。
• databaseName:登录的数据库名称。
• user：登录用户名。
• password：登录用户口令。

示例：
使用控制台工具 xgconsole 可正常连接数据库，IP： 192.168.2.xxx，端口 5138，系统库，SYSDBA 用户。

xgconsole -s nssl -h 192.168.2.xxx -P 5138 -d SYSTEM -u SYSDBA -p SYSDBA

对应 JDBC URL为：

String url="jdbc:xugu://192.168.2.xxx:5138/SYSTEM?user=SYSDBA&password=SYSDBA";

更多连接字符串说明，参考JDBC开发手册-连接字串及参数设置。

安装虚谷 JDBC 驱动

将虚谷 JDBC 驱动包 xugu-jdbc-12.3.4.jar 上传至环境指定目录下。

设置临时环境变量 CLASSPATH 。

export CLASSPATH=./xugu-jdbc-12.3.4.jar:$CLASSPATH

提示

重新 SSH 连接开发环境，需再次设置临时环境变量 CLASSPATH。

编写应用程序

在驱动包的同级目录下创建Java文件 Demo.java 。

.
├── Demo.java
└── xugu-jdbc-12.3.4.jar

编写 Java 应用程序，包含连接 XuguDB，创建表、插入数据、查询数据、删除表，Demo.java内容如下：

import java.sql.*;

public class Demo {
    public static void main(String[] args) {
        Connection xgConn = null;
        Statement xgStmt = null;
        try {
            //定义JDBC驱动
            Class.forName("com.xugu.cloudjdbc.Driver");
            //定义URL连接字串
            String url = "jdbc:xugu://192.168.2.xxx:5138/SYSTEM?user=SYSDBA&password=SYSDBA";

            xgConn = DriverManager.getConnection(url);
            xgStmt = xgConn.createStatement();
            //建表 tab_jdbc_demo
            xgStmt.execute("Create table tab_jdbc_demo(id int, pkg varchar(64))");
            //插入数据
            xgStmt.execute("insert into tab_jdbc_demo values(1,'java.sql.Driver')");
            //查询
            ResultSet rSet = xgStmt.executeQuery("select * from tab_jdbc_demo");
            System.out.println("select * from tab_jdbc_demo;");
            System.out.println("|int|pkg");
            while (rSet.next()){
                Integer id = rSet.getInt("id");
                String pkg = rSet.getString("pkg");
                System.out.println("|" + id + "|" + pkg);
            }
            //删除表 tab_jdbc_demo
            xgStmt.execute("Drop table tab_jdbc_demo");

        } catch (SQLException | ClassNotFoundException e){
            e.printStackTrace();
        }

        //关闭连接
        try {
            xgStmt.close();
            xgConn.close();
        }catch (SQLException e){
            e.printStackTrace();
        }
    }
}

提示

1. 应用程序创建的 ResultSet、Statement、PreparedStatement 等数据库资源对象，在使用完成后必须关闭。
2. 当不需要和 XuguDB 交互数据时，应用程序需主动关闭数据库连接，释放连接上所有数据库资源。

执行应用程序

代码编辑完后，使用javac命令编译。

javac Demo.java

编译成功后，使用命令java执行应用程序。

java Demo

获得如下运行结果，说明连接与表操作均成功。

select * from tab_jdbc_demo;
|int|pkg
|1|java.sql.Driver

更多 Xugu Java 应用程序的开发，详情参考应用开发-JDBC开发手册。

创建 C 示例应用

C 应用程序的开发，详情参考应用开发-XGCI开发手册 。