使用 JDBC 连接

在 Java 中，我们可以通过 Java 代码使用 JDBC 连接器（Java Database Connectivity）连接到 MatrixOne。JDBC 是用于数据库连接的标准 API 之一，使用它我们可以轻松地运行 SQL 语句并且从数据库中获取数据。

开始前准备

使用 JDBC 连接 MatrixOne 前，需要完成以下下载安装任务：

  1. 已完成安装并启动 MatrixOne。
  2. 下载安装 JDK 8+ version。
  3. 下载安装 MySQL 客户端。
  4. 下载安装 JAVA IDE，本篇文档以 IntelliJ IDEA 为例，你也可以下载其他 IDE 工具。

步骤

  1. 使用 MySQL 客户端连接 MatrixOne。在 MatrixOne 新建一个名为 test 数据库和一个新的表 t1：

1. create database test; 2. use test; 3. create table t1 4. ( 5. code int primary key, 6. title char(35) 7. ); 2. 在 IDEA 中新建 Java 名称为 testJDBC 的项目并选择在 Build System 中选择 Maven 作为构建系统，点击 Create。

JDBC create project 3. 点击 File > Project Structure，进入到 Project Setting，点选 Library，并点击 + 按钮，添加 From Maven。

JDBC project structure

JDBC add library 4. 输入框中输入 mysql-connector-java 搜索整个库，选择 mysql:mysql-connector-java:8.0.30，应用到本项目中。

JDBC add driver 5. 修改 src/main/java/org/example/Main.java 中的默认 Java 源代码。如下面的代码示例中所示，这段代码使用连接地址和凭据创建连接。连接到 MatrixOne 后，你可以使用 Java 语言对 MatrixOne 数据库和表进行操作。

有关如何使用 JDBC 在 MatrixOne 中开发 CRUD（创建、读取、更新、删除）应用程序的完整示例，参考 Java CRUD 示例。

``` package org.example;

import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException;

1. public class Main {

4. private static String jdbcURL = "jdbc:mysql://127.0.0.1:6001/test";
5. private static String jdbcUsername = "root";
6. private static String jdbcPassword = "111";

8. public static void main(String[] args) {

11. try {
12. Connection connection = DriverManager.getConnection(jdbcURL, jdbcUsername, jdbcPassword);
13. // Do something with the Connection

15. } catch (SQLException ex) {
16. // handle any errors
17. System.out.println("SQLException: " + ex.getMessage());
18. System.out.println("SQLState: " + ex.getSQLState());
19. System.out.println("VendorError: " + ex.getErrorCode());
20. }
21. }
22. }
23. ```

参考文档

有关 MatrixOne 对 JDBC 特性支持的完整列表，参见 MatrixOne 的 JDBC 功能支持列表。