Java DB是基于Java編程語言和SQL的關系數據庫管理系統。 這是Apache軟件基金會的開源Derby項目的Oracle版本。 Java SE 7 SDK中包含Java DB。

用戶定義類型（UDT）是Java類，其實例（對象）存儲在數據庫表列中。 UDT定義為列數據類型，UDT實例存儲為列值。 可以在Java DB數據庫中創建和使用UDT。

以下是該帖子的內容：

用戶定義類型（UDT）

創建和使用UDT

設計UDT –考慮更新UDT對現有數據的影響

范例程式碼

注釋與參考

1.用戶定義類型（UDT）

UDT在數據庫中定義數據類型。 UDT是具有公共訪問修飾符的Java類。 此類實現java.io.Serializable接口。 該類必須在引用該類的數據庫應用程序（或工具）的類路徑上可見。

UDT類用于定義表或視圖列的數據類型-用戶定義的數據類型。 UDT數據是UDT類的實例（Java對象）。 并存儲為列數據。 UDT也可以在存儲過程和函數（在Java DB中，它們是基于Java的）中稱為數據類型。

• UDT可以具有子類型。 并且可以將子類型數據填充為主類型，即，可以將UDT類的子類實例填充為UDT值。 例如：（a）Java類Type1和在數據庫中定義為dbtype1的UDT，以及（b）Java類Subtype1是Type1的子類，并且（c） dbtype1表列也可以用的實例填充Subtype1 （除了Type1的實例之外）。
• 無法對UDT進行索引，排序或比較； 并且不能與在SQL表達式中分組或聚合的運算符一起使用（例如=，LIKE，DISTINCT，GROUP…）。

2.創建和使用UDT

• 2.1。 創建UDT
• 2.2。使用UDT

2.1。創建一個UDT

創建一個Java類并在數據庫中定義UDT。創建一個Java類，例如TestType1.java （請參見代碼： 4.1 TestType1.java ），以用作數據庫中的UDT。 編譯源代碼。

SQL CREATE TYPE語句在數據庫中創建UDT。 語法為：

CREATE TYPE udtTypeName EXTERNAL NAME javaClassName LANGUAGE JAVA

該命令以默認或指定的架構創建UDT，其中：

• udtTypeName是數據庫中UDT的名稱標識符。
• javaClassName是Java類的標準名稱。

例如，使用ij工具在Java DB數據庫中創建UDT（ ij是Java DB附帶的命令行工具。ij是用于在Java DB數據庫上運行交互式查詢的JDBC工具。）：

ij> CONNECT 'jdbc:derby:testDB'; ij> CREATE TYPE type1 EXTERNAL NAME 'TestType1' LANGUAGE JAVA;

在上面的示例中， testDB是現有數據庫。 在testDB數據庫中創建了名稱為type1的UDT。

注意

Java類文件必須位于要從ij工具引用的類路徑中。

2.1.1。驗證，刪除和更新UDT

可以使用以下SQL命令驗證創建的UDT：

ij> SELECT alias, javaclassname FROM SYS.SYSALIASES WHERE aliastype='A';

要從數據庫中刪除UDT，請使用DROP TYPE SQL命令。 以下是一個示例：

ij> DROP TYPE udtTypeName RESTRICT;

在上面的示例中， udtTypeName是數據庫中定義的UDT名稱。

如果數據庫對象正在使用（或引用）UDT，則不能刪除UDT。 例如，（a）如果表列的類型為UDT，除非刪除相應的表列，否則不能刪除該UDT，或者（b）如果數據庫函數引用的是UDT的類（實例），則不能刪除UDT。除非已修改函數，否則不要引用該UDT類。

要使用更新后的Java代碼更新UDT，請（重新）編譯UDT類。 這會影響UDT類型的對象。 這也可能會影響存儲在UDT對象中的數據，具體取決于在應用程序中定義和使用UDT的方式。 請參閱主題： 3.設計UDT –考慮更新UDT對現有數據的影響 。

2.2。使用UDT

使用UDT創建數據庫對象并處理UDT數據（插入，更新，刪除和查詢）。 UDT數據可以與SQL交互使用，也可以與Java程序中的JDBC API一起在數據庫中使用。

2.2.1。 互動式SQL

下面介紹創建UDT類型的數據庫表列，插入數據和查詢插入的數據。

• （i）以UDT作為列類型創建數據庫表。

  例如：

  CREATE TABLE test_table1 (id INT,type1col type1, // column with UDT )
• （ii）將數據插入表中。

  使用定制的數據庫函數將數據插入到用UDT定義的表列中。有關創建定制函數以將UDT數據插入到表列中的詳細信息，請參見4.2。 Example_Fn1 –函數 。

  示例函數Example_Fn1具有簽名Example_Fn1（字符串輸入），并返回TestType1的實例（其中TestType1是表示UDT的Java類）。

  ij> INSERT INTO test_table1(id, type1col) VALUES(1, Example_Fn1("udt value 1"));

  上面的SQL命令在表中插入一行，其中帶有TestType1 Java對象的UDT列值。 函數Example_Fn1調用帶有String輸入參數的TestType1類的構造函數來構建對象。 并且該對象存儲在表列中。

• （iii）查詢插入的數據。

  可以使用自定義函數從UDT列獲取數據。 在以下示例中，UDT類TestType1的重寫的Object類的toString（）方法返回存儲實例的字符串值。

  ij> SELECT * FROM test_table1; ID | TYPE1COL ------------------------- 1 | udt value 1

2.2.2。 使用JDBC API

在java.sql包中定義的PreparedStatement和ResultSet接口分別用于插入和獲取數據庫UDT數據。

• PreparedStatement的setObject（）方法用于將UDT數據作為對象存儲在UDT表列中。 方法setObject（int parameterIndex，Object obj）使用給定的對象設置指定參數的值。
• ResultSet的getObject（）方法用于從UDT表列中檢索存儲的UDT數據。 方法getObject（int columnIndex）獲取此ResultSet對象的當前行中指定列的值。 返回的數據是一個對象。

以下Java代碼段顯示了用法：

// insert data into a table int idValue = 2; TestType1 obj = new TestType1("udt value 2"); PreparedStatement ps = conn.prepareStatement("INSERT INTO test_table1 VALUES (?, ?)"; ps.setInt(1, idValue); // where 1 is the parameter index ps.setObject(2, obj); // UDT data ps.executeUpdate(); ... // retrieve data from a table PreparedStatement ps = conn.prepareStatement("SELECT * FROM test_table1"); ResultSet rs = ps.executeQuery(); while (rs.next()) { int idValue = rs.getInt(1);TestType1 testType1 = (TestType1) rs.getObject(2); // where 2 is the column index in ResultSet object... }

注意

在上面的代碼中， conn是數據庫Connection對象。

UDT Java類文件必須位于類路徑中，才能從JDBC代碼進行引用。

設計UDT –考慮更新UDT對現有數據的影響

UDT用于存儲數據。 該UDT（和數據）可能會在應用程序的整個生命周期中發生變化（即演變）。 設計UDT時必須考慮到這一點。

另外，請注意，UDT類始終實現Serializable接口。 必須考慮數據序列化和UDT數據對象的各種版本的影響。 在簡單的情況下，僅編譯更改的UDT類代碼就足夠了。

有兩種設計和使用UDT的方法。

• UDT類實現了可序列化，并且隨著UDT數據的發展，應用程序（帶有UDT）使用數據轉換應用程序。
• UDT類實現Externalizable （而不是Serializable ），并在UDT類中使用數據轉換功能。 一個帶有UDT類代碼的示例如下所示。

關于可外部化

UDT類必須實現Serializable接口。 和java.io.Externalizable擴展Serializable 。

實現此接口后，只有可外部化實例的類的身份（而不是狀態）才寫入序列化流中。 該類負責保存和恢復其實例的內容（狀態）。

必須實現兩種方法：

• readExternal（ObjectInput in）：對象實現readExternal（）方法以還原其內容。
• writeExternal（ObjectOutput out）：對象實現writeExternal（）方法以保存其內容。

3.1 UDT類實現Serializable

UDT類實現了Serializable，并且隨著UDT數據的發展，應用程序（使用UDT）使用數據轉換應用程序-以下是概述步驟：

• UDT實現Serializable 。
• 創建并使用帶有初始版本的UDT。
• 在使用下一個版本更新UDT之前，請保存（存儲）先前版本的數據。
• 創建下一個版本的UDT（更新較早的版本）。
• 將初始版本數據轉換為當前更新的版本數據。

請注意，在這種情況下，所有以前的版本數據一次都轉換為當前（新）版本。

3.2 UDT類實現可外部化

UDT類實現Externalizable （而不是Serializable ）并在其中使用數據轉換功能-以下是概述步驟：

• UDT實現Externalizable 。
• 創建并使用帶有初始版本的UDT。
• 在使用下一版本更新UDT之前，無需執行任何操作。
• 使用內置的數據轉換功能，創建下一個版本的UDT（更新較早的版本）。

在這種情況下，每當查詢或更新數據時，以前的版本數據就會轉換為當前（新）版本。 版本信息包含在UDT類中。

以下是有關UDT類的詳細信息和代碼的示例。

創建具有版本1的UDT類： Testtype2.java （請參見代碼： 4.3Testtype2.java（版本1） ）

編譯

在數據庫中創建UDT： type2

創建帶有UDT列的表： test_table3

將數據插入UDT列

查詢UDT數據

使用版本2更新UDT類： Testtype2.java （請參見代碼： 4.3 Testtype2.java（版本2） ）

編譯

將數據（版本2）插入UDT列

查詢UDT數據–版本1和版本2數據

注意

本主題中的示例未顯示用于插入和查詢UDT數據的SQL命令和函數的詳細信息或代碼。 這些可能類似于本文前面顯示的示例。

4.示例代碼

• 4.1。 TestType1.java
• 4.2。 Example_Fn1 –函數
• 4.3.Testtype2.java（版本1）
• 4.4.Testtype2.java（版本2）

4.1.TestType1.java

public class TestType1implements java.io.Serializable {private String value = "DEFAULT";public TestType1() {}public TestType1(String s) {value = s;}@Overridepublic String toString() {return value;} } // class

4.2.Example_Fn1 –功能

此功能是將數據插入UDT列的功能，請參見2.2中的示例。 使用UDT 。

• （i）使用具有該功能功能的公共靜態方法創建一個Java類。
• （ii）使用CREATE FUNCTION命令在數據庫中創建函數。

以下是該函數和CREATE FUNCTION命令的Java類。 使用ij工具以交互方式編譯Java類并運行CREATE FUNCTION命令。

public class FunctionClass {public static TestType1 FnMethod1(String s) {return new TestType1(s);} }CREATE FUNCTION Example_Fn1(VARCHAR(25)) RETURNS type1 LANGUAGE JAVA PARAMETER STYLE JAVA NO SQL EXTERNAL NAME 'FunctionClass.FnMethod1';

注意

ij使用SQL命令SHOW FUNCTIONS和DROP FUNCTION來驗證創建的函數并將其從數據庫中刪除。

4.3.Testtype2.java（版本1）

import java.io.*; public class Testtype2implements Externalizable {private static final long serialVersionUID = 1L;private static final int FIRST_VERSION = 1; // initial version idprivate String value = "DEFAULT";public Testtype2() {}public Testtype2(String s) {value = s;}@Overridepublic void writeExternal(ObjectOutput out)throws IOException {// first write the version id out.writeInt(FIRST_VERSION);// next write the state out.writeObject(value);}@Overridepublic void readExternal(ObjectInput in)throws IOException, ClassNotFoundException {// read the version id int version = in.readInt();if (version < FIRST_VERSION) { throw new IOException("Corrupt data stream (no such version).");}if (version > FIRST_VERSION) {throw new IOException("Can't deserialize from the future versions.");}// read object (state)value = (String) in.readObject() + "_V" + version;} // readExternal()@Overridepublic String toString() {return value;} } // version 1 class

4.4.Testtype2.java（版本2）

import java.io.*; public class Testtype2implements Externalizable {private static final long serialVersionUID = 1L;private static final int FIRST_VERSION = 1; // initial version idprivate static final int NEW_VERSION = 2;private String value = "DEFAULT";private double newData;public Testtype2() {}public Testtype2(String s, double i) {value = s; newData = i;}@Overridepublic void writeExternal(ObjectOutput out)throws IOException {// first write the version id out.writeInt(NEW_VERSION);// next write the state out.writeObject(value); out.writeDouble(newData);}@Overridepublic void readExternal(ObjectInput in)throws IOException, ClassNotFoundException {if (version < FIRST_VERSION) { throw new IOException("Corrupt data stream (no such version).");}if (version > NEW_VERSION) {throw new IOException("Can't deserialize from the future versions.");}// read objectvalue = (String) in.readObject() + "_V" + version;// read new version's data if (version == NEW_VERSION) { newData = in.readDouble();}else { // if FIRST_VERSION// newData is its default value, 0}} // readExternal()@Overridepublic String toString() {return value + ":" + newData;} } // version 2 class

注意

externalizable的readExternal（）方法必須按與writeExternal（）方法寫入的相同順序和相同類型讀取值。

在上面的示例代碼中， serialVersionUID變量是可選的。

5.注釋和參考

• Java Swing文本編輯器應用程序中的示例用法：GUI文本編輯器創建一個文本文檔作為java.swing.text.PlainDocument類的實例。 使用內容創建的UDT Java類–例如PlainDocument實例，文檔名稱，創建日期等，并在應用程序中用于存儲數據。
• Oracle 10g數據庫支持創建和使用基于Java的UDT。 這些被稱為SQLJ類型。 表示UDT的Java類實現java.sql.SQLData或oracle.sql.ORAData接口，而不是java.io.Serializable 。 這些UDT是使用CREATE TYPE SQL語句創建的，并存儲到服務器，并且可以通過SQL訪問。
• 鏈接到Apache Derby>文檔（10.8手冊）： http : //db.apache.org/derby/manuals/index.html

翻譯自: https://www.javacodegeeks.com/2013/10/java-user-defined-types-udt-in-java-db.html

總結

以上是生活随笔為你收集整理的Java DB中的Java用户定义类型（UDT）的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。