---
id: usecase
sidebar_position: 2
title: 安装与配置
description: 介绍如何引入 jdbc-mongo 依赖以及配置 JDBC 连接。
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

## 引入依赖

在使用 `jdbc-mongo` 之前，需要在项目中引入相应的 Maven 依赖。

<Tabs>
  <TabItem value="maven" label="Maven" default>
    ```xml
    <dependency>
        <groupId>net.hasor</groupId>
        <artifactId>jdbc-mongo</artifactId>
        <version>5.3.0</version> <!-- 请使用最新版本 -->
    </dependency>
    ```
  </TabItem>
  <TabItem value="gradle" label="Gradle">
    ```groovy
    implementation 'net.hasor:jdbc-mongo:5.3.0' // 请使用最新版本
    ```
  </TabItem>
</Tabs>

## JDBC 连接

`jdbc-mongo` 使用标准的 JDBC URL 格式进行连接。

### URL 格式

```text
jdbc:mongo://<host>:<port>/<database>?<parameters>
```

- `host`: MongoDB 服务器地址。
- `port`: MongoDB 服务器端口（默认 27017）。
- `database`: 数据库名称。
- `parameters`: 连接参数，详见 [连接参数](./params)。

### 示例代码

```java
public class MongoJdbcExample {
    public static void main(String[] args) throws Exception {
        String url = "jdbc:mongo://127.0.0.1:27017/testdb";
        try (Connection conn = DriverManager.getConnection(url)) {
            // Statement Example
            try (Statement stmt = conn.createStatement()) {
                try (ResultSet rs = stmt.executeQuery("find my_collection limit 10")) {
                    while (rs.next()) {
                        System.out.println(rs.getString("name"));
                    }
                }
            }

            // PreparedStatement Example
            try (PreparedStatement pstmt = conn.prepareStatement("test.user_info.insert({name: ?, age: ?})")) {
                pstmt.setString(1, "acc");
                pstmt.setString(2, "123");
                pstmt.executeUpdate();
            }
        }
    }
}
```