Share via

使用 SQLXML 進行程式設計

  • 發行項

下載 JDBC 驅動程式

本節描述如何使用 Microsoft JDBC Driver for SQL Server 的 API 方法，將 XML 文件儲存到包含 SQLXML 物件的關聯式資料庫中，以及從中擷取 XML 文件。

本節同時包含有關 SQLXML 物件類型的資訊，並提供使用 SQLXML 物件時重要指導方針和限制的清單。

讀取和寫入具有 SQLXML 物件的 XML 資料

下列清單描述如何使用 Microsoft JDBC Driver for SQL Server 的 API 方法讀寫具有 SQLXML 物件的 XML 資料：

  • 若要建立 SQLXML 物件，請使用 SQLServerConnection 類別的 createSQLXML 方法。 請注意，這種方法會建立不含任何資料的 SQLXML 物件。 若要將 xml 資料加入至 SQLXML 物件，請呼叫 SQLXML 介面中指定的下列其中一種方法：setResult、setCharacterStream、setBinaryStream 或 setString。

  • 若要擷取 SQLXML 物件本身，請使用 SQLServerResultSet 類別或 SQLServerCallableStatement 類別的 getSQLXML 方法。

  • 若要從 SQLXML 物件擷取 xml 資料，請使用 SQLXML 介面中指定的下列其中一種方法：getSource、getCharacterStream、getBinaryStream 或 getString。

  • 若要更新 SQLXML 物件中的 xml 資料，請使用 SQLServerResultSet 類別的 updateSQLXML 方法。

  • 若要在 xml 類型的資料庫資料表資料行中儲存 SQLXML 物件，請使用 SQLServerPreparedStatement 類別或 SQLServerCallableStatement 類別的 setSQLXML 方法。

SQLXML 資料類型範例中的範例程式碼將示範如何執行這些常見 API 工作。

可讀取和可寫入的 SQLXML 物件

下表將列出 JDBC API 提供之 setter、getter 和 updater 方法所支援的 SQLXML 物件類型。 此表格中的欄位代表下列項目：

方法名稱 Getter SQLXML 物件

(可讀取)		 Setter SQLXML 物件

(可寫入)
CallableStatement.setSQLXML() 不支援 支援
CallableStatement.setObject() 不支援 支援
PreparedStatement.setSQLXML() 不支援 支援
PreparedStatement.setObject() 不支援 支援
ResultSet.updateSQLXML() 不支援 支援
ResultSet.updateObject() 不支援 支援
ResultSet.getSQLXML() 支援 不支援
CallableStatement.getSQLXML() 支援 不支援

如上表所示，setter SQLXML 方法無法使用可讀取的 SQLXML 物件。同樣地，getter 方法無法使用可寫入的 SQLXML 物件。

如果應用程式透過指定具有 SQLXML 物件的小數位數或長度參數叫用 setObject 方法，系統就會忽略此小數位數或長度參數。

使用 SQLXML 物件時的指導方針和限制

應用程式可以使用 SQLXML 物件，在資料庫中讀取和寫入 XML 資料。 下列清單將提供有關使用 SQLXML 物件時特定限制和指引的資訊：

  • SQLXML 物件只有在建立此物件的交易持續期間有效。

  • 從 getter 方法擷取的 SQLXML 物件只能用來讀取資料。

  • 連接物件所建立的 SQLXML 物件只能用來寫入資料。

  • 應用程式只能針對可讀取的 SQLXML 物件叫用單一 getter 方法來讀取資料。 叫用 getter 方法之後，相同 SQLXML 物件上的所有其他 getter 或 setter 方法都會失敗。

  • 應用程式只能在讀取或寫入 SQLXML 物件之後，針對此物件叫用 free 方法。 不過，只要基礎資料行或參數使用中，它仍然能夠處理傳回的資料流或來源。 如果基礎資料行或參數變成非使用中，與 SQLXML 物件相關聯的資料流或來源將會關閉。 如果基礎資料行或參數不再有效，基礎資料將不適用於 Stream、Simple API for XML (SAX) 和 Streaming API for XML (StAX) getter。

  • 應用程式只能針對可寫入的 SQLXML 物件叫用單一 setter 方法。 叫用 setter 方法之後，相同 SQLXML 物件上的所有其他 setter 或 getter 方法都會失敗。

  • 若要設定 SQLXML 物件的資料，應用程式必須在傳回的物件中使用適當的 setter 方法與函數。

  • 如果基礎資料行為 null，SQLServerCallableStatement 類別和 SQLServerResultSet 類別的 getSQLXML 方法就會傳回 null 資料。

  • setter 物件可以透過在其中建立這些物件的連接生效。

  • 應用程式無法使用 SQLXML 介面所提供的 setter 方法來設定 null 值。 應用程式可以使用 SQLXML 介面中提供的 setter 方法來設定空字串 ("")。 若要設定 null 值，應用程式應該呼叫下列其中一種方法：

  • 基於效能考量，使用 XML 文件時，我們建議您使用 Simple API for XML (SAX) 和 Streaming API for XML (StAX) 剖析器，而非文件物件模型 (DOM) 剖析器。

XML 剖析器無法處理空值。 不過，SQL Server 允許應用程式在 XML 資料類型的資料庫資料行中擷取和儲存空值。 這表示，剖析 XML 資料時，如果基礎值是空的，剖析器就會擲回例外狀況。 若為 DOM 輸出，JDBC Driver 會捕捉例外狀況並擲回錯誤。 若為 SAX 和 Stax 輸出，錯誤則直接來自剖析器。

自適性緩衝和 SQLXML 支援

SQLXML 物件所傳回的二進位和字元資料流會遵循適應性或完整緩衝模式。 反之，如果 XML 剖析器不是資料流，它們就不會遵循適應性或完整設定。 如需有關自適性緩衝的詳細資訊，請參閱使用自適性緩衝。

另請參閱

支援 XML 資料