以下內(nèi)容是 Spring Framework 官方文檔中關(guān)于 JDBC 支持的兩個重要章節(jié)（3.8 和 3.9），主要講解了在使用 Spring 的 JdbcTemplate 和相關(guān)工具時，如何處理一些常見的、復(fù)雜的數(shù)據(jù)庫操作問題，以及如何使用嵌入式數(shù)據(jù)庫（Embedded Database）進(jìn)行開發(fā)和測試。

下面我將用通俗易懂的方式，幫你系統(tǒng)地理解這段內(nèi)容的核心思想和關(guān)鍵知識點，并說明它們在實際開發(fā)中的意義。

?? 一、整體結(jié)構(gòu)概覽

?? 二、深入理解 3.8 節(jié)：參數(shù)與數(shù)據(jù)值處理的常見問題

? 3.8.1 提供 SQL 類型信息（SQL Type for Parameters）

? 問題背景：

Java 中的 null 值傳給數(shù)據(jù)庫時，JDBC 不知道它對應(yīng)的是 VARCHAR 還是 INTEGER，所以無法正確設(shè)置類型。這會導(dǎo)致插入 NULL 失敗。

? 解決方案：

Spring 允許你在設(shè)置參數(shù)時顯式指定 SQL 類型（來自 java.sql.Types 的常量）。

三種方式：

int 數(shù)組方式（適用于位置參數(shù)）

jdbcTemplate.update(
    "INSERT INTO users(name, age) VALUES(?, ?)",
    "Tom", 25,
    new int[]{Types.VARCHAR, Types.INTEGER}  // 顯式指定類型
);

使用 SqlParameterValue 包裝參數(shù)

new SqlParameterValue(Types.VARCHAR, "Tom")

可以更精細(xì)控制，比如設(shè)置 scale（小數(shù)位數(shù)）。

命名參數(shù) + SqlParameterSource
使用 MapSqlParameterSource 或 BeanPropertySqlParameterSource 并注冊類型：

MapSqlParameterSource params = new MapSqlParameterSource();
params.addValue("name", "Tom", Types.VARCHAR);
params.addValue("age", 25, Types.INTEGER);

?? 關(guān)鍵點：主要用于處理 NULL 插入或類型模糊的情況。

? 3.8.2 處理 BLOB 和 CLOB（大對象）

? 什么是 BLOB / CLOB？

• BLOB：Binary Large Object → 圖片、音頻、PDF 等二進(jìn)制文件。
• CLOB：Character Large Object → 大段文本（如文章、日志）。

? 為什么需要特殊處理？

普通 String 或 byte[] 在讀寫大文件時會占用大量內(nèi)存。理想做法是流式處理。

? Spring 的解決方案：LobHandler+LobCreator

示例：插入圖片和文本文件

jdbcTemplate.execute(
    "INSERT INTO docs(id, content, image) VALUES (?, ?, ?)",
    new AbstractLobCreatingPreparedStatementCallback(lobHandler) {
        protected void setValues(PreparedStatement ps, LobCreator lc) throws SQLException {
            ps.setLong(1, 1L);
            lc.setClobAsCharacterStream(ps, 2, reader, (int)file.length()); // CLOB
            lc.setBlobAsBinaryStream(ps, 3, inputStream, (int)image.length()); // BLOB
        }
    }
);

?? 注意：lobHandler 通常是 DefaultLobHandler，但注意它不支持流式讀取超過 Integer.MAX_VALUE 的數(shù)據(jù)。

? 優(yōu)勢：避免一次性加載整個大文件到內(nèi)存。

? 3.8.3 為IN子句傳遞列表（List in IN Clause）

? 問題：

SQL 不允許預(yù)編譯語句動態(tài)占位符數(shù)量，比如：

SELECT * FROM users WHERE id IN (?)

但如果要傳 (1,2,3)，就需要三個 ?。

? Spring 的解決方案：

自動拼接 SQL，根據(jù) List 長度生成對應(yīng)數(shù)量的 ?。

List<Long> ids = Arrays.asList(1L, 2L, 3L);
List<User> users = jdbcTemplate.query(
    "SELECT * FROM users WHERE id IN (:ids)",
    new MapSqlParameterSource("ids", ids),
    userRowMapper
);

? 使用 NamedParameterJdbcTemplate 自動處理。

?? 注意限制：

• 大多數(shù)數(shù)據(jù)庫對 IN 列表有上限（如 Oracle 是 1000）。
• 如果超過，應(yīng)分批查詢。

? 3.8.4 存儲過程調(diào)用中的復(fù)雜類型（Complex Types）

? 問題：

某些數(shù)據(jù)庫（如 Oracle）支持自定義對象類型（如 STRUCT, ARRAY），Java 如何傳遞和接收？

? 解決方案：

輸出參數(shù)（返回復(fù)雜類型）→ SqlReturnType

declareParameter(new SqlOutParameter("item", OracleTypes.STRUCT, "ITEM_TYPE",
    (cs, idx, sqlType, typeName) -> {
        STRUCT struct = (STRUCT) cs.getObject(idx);
        // 轉(zhuǎn)換為 Java 對象
        return new TestItem(...);
    }));

輸入?yún)?shù)（傳入復(fù)雜類型）→ SqlTypeValue

SqlTypeValue value = new AbstractSqlTypeValue() {
    protected Object createTypeValue(Connection conn, ...) {
        StructDescriptor desc = new StructDescriptor("ITEM_TYPE", conn);
        return new STRUCT(desc, conn, new Object[]{id, name, date});
    }
};

然后作為參數(shù)傳入：

Map<String, Object> in = new HashMap<>();
in.put("item", value);
storedProc.execute(in);

? 適用于 Oracle、PostgreSQL 等支持復(fù)雜類型的數(shù)據(jù)庫。

??? 三、深入理解 3.9 節(jié)：嵌入式數(shù)據(jù)庫（Embedded Database）

? 3.9.1 為什么要用嵌入式數(shù)據(jù)庫？

• 輕量快速：無需安裝 MySQL/PostgreSQL。
• 啟動快：內(nèi)存中運行，適合單元測試。
• 隔離性好：每個測試獨立數(shù)據(jù)庫，不污染真實數(shù)據(jù)。
• 便于自動化測試：CI/CD 中無需外部依賴。

常見用途：單元測試、集成測試、原型開發(fā)

? 3.9.2 通過 XML 創(chuàng)建嵌入式數(shù)據(jù)庫

<jdbc:embedded-database id="dataSource" generate-name="true">
    <jdbc:script location="classpath:schema.sql"/>
    <jdbc:script location="classpath:test-data.sql"/>
</jdbc:embedded-database>

• 自動創(chuàng)建 HSQL 內(nèi)存數(shù)據(jù)庫。
• 執(zhí)行建表腳本和測試數(shù)據(jù)腳本。
• 生成一個 DataSource Bean，可注入 DAO。

? 3.9.3 編程方式創(chuàng)建（推薦用于測試）

EmbeddedDatabase db = new EmbeddedDatabaseBuilder()
    .generateUniqueName(true)
    .setType(H2)
    .addScript("schema.sql")
    .addScripts("data.sql")
    .build();

? EmbeddedDatabase 實現(xiàn)了 DataSource，可以直接傳給 JdbcTemplate。

? 測試結(jié)束后記得 db.shutdown()。

? 3.9.4 支持的嵌入式數(shù)據(jù)庫類型

推薦使用 H2，功能最全，調(diào)試方便。

? 3.9.5 測試數(shù)據(jù)訪問邏輯（最佳實踐模板）

class DataAccessTest {
    private EmbeddedDatabase db;
    @BeforeEach
    void setUp() {
        db = new EmbeddedDatabaseBuilder()
            .generateUniqueName(true)
            .addDefaultScripts() // 自動加載 schema.sql + data.sql
            .build();
    }
    @Test
    void shouldFindUserById() {
        JdbcTemplate template = new JdbcTemplate(db);
        List<User> users = template.query("SELECT * FROM users WHERE id = ?", 
            new Object[]{1}, userRowMapper);
        assertThat(users).hasSize(1);
    }
    @AfterEach
    void tearDown() {
        db.shutdown();
    }
}

? 這是典型的 集成測試模板。

? 3.9.6 為什么需要“唯一數(shù)據(jù)庫名”？

? 問題：

多個測試類都用相同的配置創(chuàng)建嵌入式數(shù)據(jù)庫，Spring 會復(fù)用同一個實例（因為默認(rèn)名字是 testdb），導(dǎo)致數(shù)據(jù)污染。

? 解決方案：

啟用唯一名稱生成：

.generateUniqueName(true)

或 XML 中：

<jdbc:embedded-database generate-name="true">

? 每次創(chuàng)建都是獨立數(shù)據(jù)庫，避免沖突。

? 3.9.7 擴展支持（高級）

你可以自定義：

• 新的嵌入式數(shù)據(jù)庫類型（實現(xiàn) EmbeddedDatabaseConfigurer）
• 新的 DataSource 工廠（如連接池）

一般開發(fā)者不需要做，但框架開發(fā)者可以貢獻(xiàn)擴展。

?? 四、總結(jié)：這些知識能用來做什么？

?? 五、學(xué)習(xí)建議

1. 先掌握 JdbcTemplate 基礎(chǔ)用法（查詢、更新）
2. 再學(xué)命名參數(shù)和 IN 子句（日常開發(fā)高頻）
3. 測試時使用嵌入式數(shù)據(jù)庫（提升測試效率）
4. 只有對接 Oracle 存儲過程時才深入 SqlTypeValue

?? 補充：現(xiàn)代 Spring 推薦替代方案

雖然這些技術(shù)仍然有效，但在現(xiàn)代 Spring Boot 項目中：

如果你告訴我你目前在做什么項目（比如：Web 后端？單元測試？還是對接 Oracle？），我可以給出更具體的建議 ??

到此這篇關(guān)于Spring JDBC實戰(zhàn)：參數(shù)處理與嵌入式數(shù)據(jù)庫的文章就介紹到這了,更多相關(guān)Spring JDBC參數(shù)處理內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論