當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

Oracle -jdbc-java 的类型映射

發布時間：2024/4/17 编程问答 24 豆豆

生活随笔收集整理的這篇文章主要介紹了 Oracle -jdbc-java 的类型映射小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

http://blog.csdn.net/a9529lty/article/details/6023331

Oracle 8i 的類型映射

下表列出了用于 Oracle 8i 數據庫的數據庫類型和 Java 類型之間的關系。

Java 數據類型	JDBC 數據類型	Oracle SQL 數據類型（8i 版）
boolean	BIT	NUMBER
byte	TINYINT	NUMBER
short	SMALLINT	NUMBER
int	INTEGER	NUMBER
long	BIGINT	NUMBER
double	FLOAT	NUMBER
float	REAL	NUMBER
double	DOUBLE	NUMBER
java.math.BigDecimal	NUMERIC	NUMBER
java.math.BigDecimal	DECIMAL	NUMBER
String	CHAR	CHAR
String	VARCHAR	VARCHAR2
String	LONGVARCHAR	LONG
java.sql.Date	DATE	DATE
java.sql.Time	TIME	DATE
java.sql.Timestamp	TIMESTAMP	DATE
byte[]	BINARY	NUMBER
byte[]	VARBINARY	RAW
byte[]	LONGVARBINARY	LONGRAW
java.sql.Blob	BLOB	BLOB
java.sql.Clob	CLOB	CLOB

====

http://qurtyy.blog.163.com/blog/static/57443681201152915147950/

Oracle 11g Datatypes

VARCHAR2(size [BYTE | CHAR])

可變長度的字符串的最大長度有大小字節或字符。最大尺寸是4000字節或字符，最低為1個字節或1個字符。您必須指定VARCHAR2大小。
字節表示該列將有字節長度語義。 CHAR列表示將字符語義。

NVARCHAR2(size)

可變長度的Unicode字符串的最大長度有大小字符。的字節數可高達兩倍的AL16UTF16編碼與UTF8編碼的三倍大小。最大尺寸是由國家字符集的定義與4000字節的上限。您必須指定NVARCHAR2大小。

NUMBER [ (p [, s]) ]

數有精度p和規模秒該精度p的范圍可以從1到38。在尺度s的范圍可以從-84到127。精度和規模都在十進位數字。一個數字值，需要從1到22字節。

FLOAT [(p)]

一個數字的數據類型具有精度第亞型float值的內部表示為NUMBER。該精度p的范圍可以從1到126個二進制數字。 float值需要從1到22字節。

LONG

可變長度達2千兆字節或231字節的字符數據-1。為了向后兼容。

DATE

有效日期范圍從1月1日，4712年，12月31日，9999 AD。默認格式是確定明確的NLS_DATE_FORMAT參數或隱式的NLS_TERRITORY參數。大小固定為7個字節。此數據類型包含日期時間字段年，月，日，小時，分和秒。它沒有小數秒或時區。

BINARY_FLOAT

32位浮點數字。這種數據類型需要5個字節，包括長度字節。

BINARY_DOUBLE

64位浮點數字。這種數據類型需要9個字節，包括長度字節。

TIMESTAMP [(fractional_seconds_precision)]

64位浮點年，月，日的日期值，以及小時，分鐘和秒鐘的時間值，其中fractional_seconds_precision是數字中的第二號日期時間字段的小數部分。對fractional_seconds_precision可接受的值是0到9。默認是6。默認格式是確定明確的NLS_DATE_FORMAT參數或隱式的NLS_TERRITORY參數。的大小不同的7至11個字節，取決于精度。此數據類型包含日期時間字段YEAR，MONTH，日，小時，分和秒。它包含小數秒，但沒有一個時區。

TIMESTAMP [(fractional_seconds)] WITH TIME ZONE

時間戳以及時區位移值，其中fractional_seconds_precision是數字在第二日期時間字段的小數部分數字的所有值。可接受的值是0到9。默認是6。默認格式是確定明確的NLS_DATE_FORMAT參數或隱式的NLS_TERRITORY參數。大小固定為13字節。此數據類型包含日期時間字段YEAR，MONTH，日，小時，分鐘，秒TIMEZONE_HOUR和TIMEZONE_MINUTE。它有一個明確的分數秒和時區。

TIMESTAMP [(fractional_seconds)] WITH LOCAL TIME ZONE

所有的TIMESTAMP WITH TIME ZONE值，但下列情況除外：
?數據標準化數據庫的時區時，存儲在數據庫中。
?當數據被檢索，用戶可以看到在會話時區中的數據。
默認格式是確定明確的NLS_DATE_FORMAT參數或隱式的NLS_TERRITORY參數。的大小不同的7至11個字節，取決于精度。

INTERVAL YEAR [(year_precision)] TO MONTH

存儲期間年數和月的時間，其中year_precision是數字的年份日期時間字段的數量。可接受的值是0到9。默認是2。大小固定為5個字節。

INTERVAL DAY [(day_precision)] TO SECOND [(fractional_seconds)]

存儲一段時間以天，小時，分鐘和秒，其中
?day_precision是數字在DAY日期時間字段的最大數量。可接受的值是0到9。默認是2。
?fractional_seconds_precision是數字中的第二個字段的小數部分的數量。可接受的值是0到9。默認是6。
大小固定為11個字節。

RAW(size)

長度字節大小的原始二進制數據。最大尺寸為2000字節。您必須指定為原始值的大小。

LONG RAW

可變長度可達2吉字節的原始二進制數據。

ROWID

基地64字符串，表示在其表行的唯一地址。該數據類型主要是由ROWID偽返回的值。

UROWID [(size)]

基地64字符串代表一個索引組織表行的邏輯地址。可選的大小是一個類型UROWID列的大小。最大尺寸和默認為4000字節。

CHAR [(size [BYTE | CHAR])]

長度大小字節或字符的固定長度的字符數據。最大尺寸為2000字節或字符。默認和最小尺寸為1字節。
BYTE和CHAR為VARCHAR2有相同的語義。

NCHAR[(size)]

長度大小字符的固定長度的字符數據。的字節數可高達兩倍的AL16UTF16編碼與UTF8編碼的三倍大小。最大尺寸是由國家字符集定義與一個2000字節的上限。默認和最小尺寸為1個字符。

CLOB

字符大對象，包含單字節或多字節字符。固定寬度和可變寬度的字符集的支持，無論是使用數據庫的字符集。最大尺寸是（4千兆字節 - 1）*（數據庫塊大小）。

NCLOB

字符大對象，包含Unicode字符。固定寬度和可變寬度的字符集的支持，同時使用數據庫國家字符集。最大尺寸是（4千兆字節 - 1）*（數據庫塊大小）。國家字符集存儲數據。

BLOB

二進制大對象。最大尺寸是（4千兆字節 - 1）*（數據庫塊大小）。

BFILE

包含一個大的二進制文件存儲在數據庫以外的定位。啟用字節流的I / O訪問駐留在數據庫服務器上的外部LOB的。最大尺寸為4千兆字節。

================

http://www.cnblogs.com/shishm/archive/2012/01/30/2332142.html

以下轉自：http://kummy.itpub.net/post/17165/172850 本文在原文基礎上有增減。

本概述是從《JDBC^TM?Database Access from Java^TM: A Tutorial and Annotated Reference》這本書中摘引來的。JavaSoft 目前正在準備這本書。這本書是一本教程，同時也是 JDBC 的重要參考手冊，它將作為 Java 系列的組成部份，在 1997 年春季由 Addison-Wesley 出版公司出版。

8.1 概述

由于 SQL 數據類型和 Java 數據類型是不同的，因此需要某種機制在使用 Java 類型的應用程序和使用 SQL 類型的數據庫之間來讀寫數據。

為此，JDBC 提供了?getXXX?和?setXXX?方法集、方法?registerOutParameter?和類?Types。

本章匯集了影響各種類和接口的數據類型的有關信息，并列出所有的對應關系表（這些表顯示了 SQL 類型和 Java 類型之間的映射關系）以便于參考。

8.2 將 SQL 數據類型映射為 Java 類型

不幸的是，不同數據庫產品所支持的 SQL 類型之間有很大的不同。即使不同的數據庫以相同的語義支持 SQL 類型，它們也可能用不同的名稱。例如，絕大多數的主流數據庫都支持一種表示大型二進制值的 SQL 類型，但 Oracle 把這種類型叫做?LONG RAW，Sybase 把它叫做?IMAGE，Informix 卻把它叫做?BYTE，而 DB2 又把它叫做?LONG VARCHAR FOR BIT DATA。

幸運的是，JDBC 程序員通常并不需要自己去關心目標數據庫所用的實際 SQL 類型的名稱。大多數時候，JDBC 程序員將根據一些現有的數據庫表來進行編程。他們無須關心用于創建這些表的確切 SQL 類型的名稱。

JDBC 在?java.sql.Types?類中定義了一系列的常規 SQL 類型標識符。這些類型可用于表示那些最為常用的 SQL 類型。在用 JDBC API 編程時，程序員通常可以使用這些 JDBC 類型來引用一般的 SQL 類型，而無須關心目標數據庫所用的確切 SQL 類型的名稱。在下一節中將對這些 JDBC 類型進行仔細說明。

程序員用到 SQL 類型名稱的主要地方是在用 SQL 的?CREATE TABLE?語句創建新的數據庫表時。這種情況下，程序員必須注意應該使用目標數據庫所支持的 SQL 類型名稱。如果需要知道各種 SQL 類型在某個特定的數據庫中的行為的確切定義，我們建議查閱一下數據庫文檔。

如果想要編寫一種可在各種數據庫上創建表的可移植 JDBC 程序，用戶主要有兩個選擇。第一個選擇是：限制自己只使用那些被廣為接受的 SQL 類型名稱（例如?INTEGER、NUMERIC?或VARCHAR）。這些類型有可能能適應所有的數據庫。第二個選擇是：用?java.sql.DatabaseMetaData.getTypeInfo?方法來找出給定的數據庫實際上支持哪些 SQL 類型，然后選擇與給定 JDBC 類型相匹配的特定于數據庫的 SQL 類型名。

JDBC 定義了一個從 JDBC 數據庫類型到 Java 類型的標準映射。例如，JDBC 的?INTEGER?類型通常映射為 Java 的?int?類型。這可支持簡單的接口，將 JDBC 值讀寫為簡單的 Java 類型。

Java 類型不必與 JDBC 類型完全形同；它們只須能夠用足夠的類型信息來代表 JDBC 類型，從而能正確地存儲和取出參數和從 SQL 語句恢復結果就可以了。例如，Java?String?對象可能并不能精確地與任何 JDBC?CHAR?類型匹配，但它卻可給出足夠的類型信息來成功地表示?CHAR、?VARCHAR?或?LONGVARCHAR?類型。

8.3 JDBC 類型

本節描述各種 JDBC 數據類型及其與標準 SQL 類型和 Java 類型的關聯方式。

8.3.1 CHAR、 VARCHAR 和 LONGVARCHAR

JDBC 類型?CHAR、VARCHAR?和?LONGVARCHAR?密切相關。CHAR?表示固定長度的小字符串，VARCHAR?表示長度可變的小字符串，而?LONGVARCHAR?表示長度可變的大字符串。

與 JDBC?CHAR?對應的是 SQL?CHAR?類型，其定義由 SQL-92 給出，且所有主要的數據庫都支持它。它接受用于指定字符串最大長度的參數，例如?CHAR(12)?即定義了一個長度為 12 個字符的字符串。所有主要的數據庫都支持長度達 254 個字符的?CHAR。

與 JDBC?VARCHAR?對應的是 SQL?VARCHAR?類型，其定義由 SQL-92 給出，且所有的主要數據庫都支持它。它接受用于指定字符串最大長度的參數，例如?VARCHAR(12)?即定義了一個最大長度為 12 個字符的字符串。所有主要數據庫都至少支持長度達 254 個字符的?VARCHAR。當把字符串的值賦給?VARCHAR?變量時，數據庫就記住該字符串的長度，使用?SELECT 時，它可以返回準確的原始字符串。

不幸的是，對于 JDBC?LONGVARCHAR?類型，目前并沒有一致的 SQL 映射。所有主要數據庫都支持某種類型的長度可變的大字符串，這種字符串支持高達十億位字節的數據，但 SQL 類型名稱卻變化多樣。

Java 程序員不必區分?CHAR、VARCHAR?和?LONGVARCHAR?這三種類型的 JDBC 字符串。它們都可表示為 Java?String，并且在不知道所需要的確切數據類型時也可正確讀寫 SQL 語句。

CHAR、VARCHAR?和?LONGVARCHAR?可映射為?String?或?char[]，但?String?更適合于一般用法。同時，?String?類能使?String?和?char[]?之間的轉換更為容易：它有一個用于將?String對象轉換為?char[]?的方法，還有一個將?char[]?轉換為?String?對象的構造函數。

必須提及的一個問題是：如何處理類型為?CHAR(n)?的固定長度的 SQL 字符串。答案是 JDBC 驅動程序（或 DBMS）將用適當的空格來進行填補。因此，當從數據庫中檢索?CHAR(n)?域時，驅動程序將把它轉換為長度為?n?的 Java?String?對象，對象末尾可能含有一些填補空格。反之，當把?String?對象送到某個?CHAR(n)?域時，驅動程序和/或數據庫將在字符串的末尾填上一些必要的空格，使字符串的長度達到?n。

方法?ResultSet.getString?用于分配和返回新的?String?對象。我們建議用它來從?CHAR、VARCHAR?和LONGVARCHAR?域中檢索數據。它適用于檢索普通的數據，但如果用 JDBC 類型LONGVARCHAR?來儲存多個兆字節的字符串時，用它進行檢索將顯得十分笨拙。為此，ResultSet?接口中有兩個方法可供程序員將?LONGVARCHAR?值作為 Java 輸入流進行檢索，之后可從該流中以任意大小的塊來讀取數據。這兩個方法是：getAsciiStream?和?getUnicodeStream，它們將把儲存在?LONGVARCHAR?列的數據作為 Ascii 或 Unicode 字符流來傳送。

8.3.2 BINARY、VARBINARY 和 LONGVARBINARY

JDBC 類型?BINARY、VARBINARY?和?LONGVARBINARY?密切相關。BINARY?表示固定長度的小二進制值，?VARBINARY?表示長度可變化的小二進制值，而?LONGVARBINARY?表示長度可變化的大二進制值。

不幸的是，這些不同?BINARY?類型的使用還未被標準化，因而在各種主要數據庫提供的支持有很大的不同。

對應于 JDBC?BINARY?類型的 SQL?BINARY?類型，是一種非標準的 SQL 擴展，只在某些數據庫上才實現。它接受用于指定二進制字節數的參數。例如，BINARY(12)?即定義了一個長度為 12 個字節的 binary 類型。通常，BINARY?值被限定在 254 個字節以內。

對應于 JDBC?VARBINARY?類型的 SQL?VARBINARY?類型，是一種非標準的 SQL 擴展，只在某些數據庫上才實現。它接受用于指定二進制字節最大數的參數。例如，VARBINARY(12)?即定義了一個長度最大可為 12 個字節的二進制類型。通常，VARBINARY?的值被限定在 254 個字節以內。當把二進制的值賦給?VARBINARY?變量時，數據庫就記住這個所賦值的長度，調用?SELECT時，它返回準確的原始值。

遺憾的是，目前還沒有一致的 SQL 類型名稱與 JDBC?LONGVARBINARY?類型相對應。所有主要數據庫都支持某種類型的長度可變的大二進制類型，它可支持高達十億個字節的數據，但 SQL 類型名稱卻變化多樣。

在 Java 中，BINARY、VARBINARY?和?LONGVARBINARY?都可用同一?byte數組來表示。由于可在不知道所需的確切?BINARY?數據類型的情況下正確地讀寫 SQL 語句，因此，Java 程序員無需區分它們。

檢索?BINARY?和?VARBINARY?值時，我們建議使用?ResultSet.getBytes。然而，如果類型為 JDBC?LONGVARBINARY?的某列儲存的是幾兆字節長度的字節數組，則建議用方法getBinaryStream?來檢索。與?LONGVARCHAR?的情形類似，該方法可以使 Java 程序員將?LONGVARBINARY?值作為 Java 輸入流檢索，然后可從該流中以更小的塊來讀取。

8.3.3 BIT

JDBC 類型?BIT?代表一個位值，可為 0 或 1。SQL-92 定義了 SQL?BIT?類型。但與 JDBC?BIT?類型不同，這種 SQL-92 BIT 類型帶參數，用于定義固定長度的二進制字符串。幸運的是，SQL-92 也允許用簡單的非參數化的?BIT?類型來代表單個的二進制數字。這種用法對應于 JDBC?BIT?類型。不幸的是，SQL-92?BIT?類型只有在 “完全” SQL-92 中才要求，且目前只有一部份主流數據庫支持它。因此，可移植的代碼也許寧愿用 JDBC?SMALLINT?類型，這種類型已得到廣泛支持。

JDBC?BIT?類型的 Java 映射的推薦類型是 Java 布爾型。

8.3.4 TINYINT

JDBC 類型?TINYINT?代表一個 8 位無符號整數，其值在 0 到 255 之間。

對應的 SQL 類型?TINYINT?目前只有一部份的數據庫支持它。因此，可移植的代碼也許寧愿用 JDBC?SMALLINT?類型，這種類型已得到廣泛支持。

JDBC?TINYINT?類型的 Java 映射的推薦類型是 Java?byte?或 Java?short。8 位的 Java?byte?類型代表一個有符號的整數，其值在 -128 到 127 之間，因此對于大的?TINYINT?值它并非總合適，而 16 位的 Java?short?類型卻總能存儲所有的?TINYINT?值。

8.3.5 SMALLINT

JDBC 類型?SMALLINT?代表一個 16 位的有符號整數，其值在 -32768 和 32767 之間。

對應的 SQL 類型?SMALLINT，其定義由 SQL- 92 給出，并為所有主流數據庫所支持。SQL-92 標準將?SMALLINT?的精度留給實現去決定。但事實上，所有的主流數據庫都至少支持 16 位。

JDBC?SMALLINT?類型的 Java 映射的推薦類型是 Java?short?類型。

8.3.6 INTEGER

JDBC 類型?INTEGER?代表一個 32 位的有符號整數，其值在 - 2147483648 和 2147483647 之間。

對應的 SQL 類型?INTEGER，其定義由 SQL- 92 給出，并為所有主流數據庫所廣為支持。SQL-92 標準將?INTEGER?的精度留給實現去決定。但事實上，所有的主流數據庫都至少支持 32 位。

INTEGER?類型 Java 映射的推薦類型是 Java?int?類型。

8.3.7 BIGINT

JDBC 類型?BIGINT?代表一個 64 位的有符號整數，其值在 -9223372036854775808 和 9223372036854775807 之間。

對應的 SQL 類型?BIGINT?是 SQL 的一個非標準擴展。事實上，目前還沒有任何數據庫實現 SQL?BIGINT?類型。我們建議在可移植的代碼中避免使用該類型。

BIGINT?類型的 Java 映射的推薦類型是 Java long 類型。

8.3.8 REAL

JDBC 類型?REAL?代表一個有 7 位尾數的“單精度”浮點數。

對應的 SQL 類型?REAL，其定義由 SQL- 92 給出。雖然未得到普遍支持，但在主流數據庫中卻已得到廣泛支持。SQL-92 標準將?REAL?的精度留給實現去決定。但事實上，所有的支持?REAL類型的主流數據庫都支持至少 7 位數的尾數精度。

REAL?類型的 Java 映射的推薦類型為 Java?float?類型。

8.3.9 DOUBLE

JDBC 類型?DOUBLE?代表一個有 15 位尾數的“雙精度”浮點數。

對應的 SQL 類型是?DOUBLE?PRECISION，其定義由 SQL- 92 給出，并為主流數據庫所廣為支持。SQL-92 標準將?DOUBLE?PRECISION?的精度留給實現去決定。但事實上，所有支持?DOUBLEPRECISION?類型的主流數據庫都支持至少 15 位數的尾數精度。

DOUBLE?類型的 Java 映射的推薦類型為 Java?double?類型。

8.3.10 FLOAT

JDBC 類型?FLOAT?基本上與 JDBC 類型?DOUBLE?相同。我們同時提供了?FLOAT?和?DOUBLE，其目的是與以前的 API 實現一致。但這卻有可能產生誤導。FLOAT?代表一個有 15 位尾數的“雙精度”浮點數。

對應的 SQL 類型?FLOAT，其定義由 SQL-92 給出。SQL-92 標準將?FLOAT?的精度留給實現去決定。但事實上，所有支持?FLOAT?類型的主流數據庫都支持至少 15 位數的尾數精度。

FLOAT?類型的 Java 映射的推薦類型為 Java?double?類型。然而，由于 SQL?FLOAT?和單精度的 Java?float類型間可能產生混淆，因此建議 JDBC 程序員通常選用 JDBC?DOUBLE?類型而不選用?FLOAT。

8.3.11 DECIMAL 和 NUMERIC

JDBC 類型?DECIMAL?和?NUMERIC?兩者非常相似。它們都表示固定精度的十進制值。

相應的 SQL 類型?DECIMAL?和?NUMERIC，其定義在 SQL-92 中給出，并得到廣泛支持。這些 SQL 類型都帶有精度和比例參數。精度是所支持的十進制數字的總位數，比例是小數點后的數字位數。比例必須永遠小于或等于精度。例如，值 "12.345" 有 5 位精度和 3 位比例，而值 ".11" 有 2 位精度和 2 位比例。JDBC 要求所有?DECIMAL?和?NUMERIC?類型都必須支持至少 15 位的精度和比例。

DECIMAL?和?NUMERIC?之間的唯一區別是 SQL-92 規范要求?NUMERIC?類型必須以確切指定的精度來表示，而對?DECIMAL?類型，它允許實現在創建該類型時所指定的精度以外再添加額外的精度。因此，創建為類型?NUMERIC(12,4)?的列將總是用 12 位數來表示，而創建為類型?DECIMAL(12,4)?的列則可用更大的位數來表示。

DECIMAL?和?NUMERIC?類型的 Java 映射的推薦類型是?java.math.BigDecimal，該 Java 類型也用絕對精度來表示定點數。java.math.BigDecimal?類型提供了一些數學操作，可對BigDecimal?類型與其它的?BigDecimal?類型、整數類型和浮點數類型進行加、減、乘、除的運算。

用于檢索?DECIMAL?和?NUMERIC?值的推薦方法是?ResultSet.getBigDecimal。JDBC 還允許將這些 SQL 類型作為簡單的?Strings?或?char?數組來訪問。因此，Java 程序員可用getString?來檢索?DECIMAL?或?NUMERIC?結果。然而，這將使常見的用?DECIMAL?或?NUMERIC?來表示的貨幣值變得極為尷尬，因為它意味著應用程序編程人員必須對字符串進行數學運算。當然，也可將這些 SQL 類型作為 Java 數值型類型來檢索。

8.3.12 DATE、TIME 和 TIMESTAMP

有三種 JDBC 類型與時間有關：

JDBC?DATE?類型表示一個由年、月、日組成的日期。對應的是 SQL?DATE?類型，其定義由 SQL-92 給出，但只有一部份主流數據庫實現它。某些數據庫提供了另外一些支持類似語義的 SQL 類型。
JDBC?TIME?類型表示一個由小時、分鐘和秒組成的時間。對應的是 SQL?TIME?類型，其定義由 SQL-92 給出，但只有一部份主流數據庫實現它。與?DATE?一樣，某些數據庫提供了另外一些支持類似語義的 SQL 類型。
JDBC?TIMESTAMP?類型表示?DATE?加上?TIME，外加一個納秒域。對應的?TIMESTAMP?類型，其定義由 SQL-92 給出，但只有少數幾個數據庫實現它。

由于標準的 Java 類?java.util.Date?并不與這三個 JDBC 日期—時間類型完全匹配（它含有?DATE?和?TIME?的信息但不含納秒信息），因此 JDBC 定義了三個?java.util.Date?的子類與 SQL 類型對應。它們是：

java.sql.Date，對應于 SQL?DATE?信息。java.util.Date?基本類中的小時、分鐘和秒都設為 0。
java.sql.Time，對應于 SQL?TIME?信息。java.util.Date?基本類中的年、月、日域設為 1970 年 1 月 1 日。這是 Java 紀元的“零”日期。
java.sql.Timestamp，對應于 SQL?TIMESTAMP?信息。該類擴展了?java.util.Date，添加了納秒域。

所有這三個與時間有關的 JDBC 類都是?java.util.Date?的子類，因此它們可用在任何可以使用?java.util.Date?的地方。例如，國際化 (internationalization) 方法將?java.util.Date?對象用作變量，因此可將這三個與時間有關的 JDBC 類中任何一個的實例作為參數傳給國際化方法。

JDBC?Timestamp?對象除了具有其父類的日期和時間成份外，還有一個獨立的納秒組件。如果將?java.sql.Timestamp?對象用于需要?java.util.Date?對象的地方，則納秒組件將丟失。但由于是以毫秒的精度來儲存 java.util.Date?對象的，因此將?java.sql.Timestamp?對象轉換為?java.util.Date?對象時可以保持這樣的精度。這可通過將納秒組件中的納秒轉換為毫秒（用納秒數除以 1,000,000）并將之添到?java.util.Date?對象中來實現。轉換中可能丟失高達 999,999 納秒，但所產生的?java.util.Date?對象將可精確到毫秒以內。

下述代碼段將?java.sql.Timestamp?對象轉換為精度達到毫秒量級的?java.util.Date?對象：

Timestamp t = new Timestamp(100, 0, 1, 15, 45, 29, 987245732);java.util.Date d;d = new java.util.Date(t.getTime() + (t.getNanos() / 1000000));

8.4 映射示例

任何情況下，當 Java 程序要從數據庫中檢索數據時，必須存在某種形式的映射和數據轉換。大多數時候， JDBC 程序員將在知道其目標數據庫機制的情況下進行編程。例如，他們將知道數據庫含有哪些表、表中每一列的數據類型。因此，他們可使用?ResultSet、?PreparedStatement和?CallableStatement?接口中那些與類型有關的存取方法。本節給出三個示例，描述各種情形中所要求的數據映射和轉換。

8.4.1 簡單的 SQL 語句

在最常見的情形中，用戶將執行簡單的 SQL 語句，然后取回含有結果的?ResultSet?對象。由數據庫返回并存放在?ResultSet?列的值，其類型為 JDBC 數據類型。調用ResultSet.getXXX?方法將把該值檢索為 Java 數據類型。例如，如果某個?ResultSet?列含有一個 JDBC?FLOAT?值，則方法?getDouble?將把它檢索為 Java?double?類型。8.6.6?節所示的表顯示了哪些?getXXX?方法可檢索哪些 JDBC 類型（如果用戶不知道某個?ResultSet?列的類型，可通過調用?ResultSet.getMetaData?方法來獲得有關信息，然后再調用ResultSetMetaData?的?getColumnType?或?getColumnTypeName?方法）。以下代碼段示范了如何獲得結果中各列的類型名稱：

String query = "select * from Table1";ResultSet rs = stmt.executeQuery(query);ResultSetMetaData rsmd = rs.getMetaData();int columnCount = rsmd.getColumnCount();for (int i = 1; i <= columnCount; i++) {String s = rsmd.getColumnTypeName(i);System.out.println ("Column " + i + " is type " + s);}

8.4.2 帶 IN 參數的 SQL 語句

在另一個可能的情況中，用戶將發送帶輸入參數的 SQL 語句。這種情況下，用戶通過調用?PreparedStatement.setXXX?方法為每個輸入參數賦值。例如，PreparedStatement.setLong(1, 2345678)?將把值?2345678?作為 Java?的 long?類型賦給第一個參數。為了將?2345678?到數據庫中，驅動程序將把它轉換為 JDBC?BIGINT。驅動程序將把哪種 JDBC 類型送到數據庫中是由 Java 類型到 JDBC 類型的標準映射所決定的

8.4.3 帶 OUT 參數的 SQL 語句

還有一個情況是，用戶要調用已存儲過程，將值賦給其 INOUT 參數，從結果中檢索值，然后從參數中檢索值。這種情形極為少見且相當復雜，但它卻不失為映射和數據轉換的好范例。

這種情況下，首先要做的是用?PreparedStatement.setXXX?方法對 INOUT 參數賦值。此外，由于這些參數同時也用于輸出，因此程序員必須為每個參數注冊 JDBC 類型，該類型是數據庫所要返回給該參數的值的 JDBC 類型。這可用?CallableStatement.registerOutParameter?方法來完成，后者接受在類?Types?中所定義的 JDBC 類型作為其變量。程序員可以用ResultSet.getXXX?方法系列來檢索返回給ResultSet?對象的結果，用?CallableStatement.getXXX?方法系列來檢索存放在輸出參數中的值。

用于?ResultSet.getXXX?方法的?XXX?類型在某些情況下非常靈活。8.6.6?節中所示的表顯示了哪些?ResultSet.getXXX?方法可用于檢索哪些 JDBC 類型。

用于?CallableStatement.getXXX?方法的?XXX?類型必須映射為那個參數所注冊的 JDBC 類型。例如，如果數據庫應返回類型為?JDBC?REAL?的輸出值，則該參數應被注冊為java.sql.Types.REAL。因此，要檢索該?JDBC?REAL?值，必須調用?CallableStatement.getFloat?方法（從 JDBC 類型到 Java 類型的映射在?8.6.1?節中的表中給出）。方法?getFloat先把儲存在輸出參數中的值從 JDBC?REAL?類型轉換為 Java?float?類型，然后將它返回。為了適應各種數據庫和使應用程序具有更高的可移植性，建議先檢索?ResultSet?對象中的值，再檢索輸出參數中的值。

下述代碼示范的是調用名為?getTestData?的已存儲過程。它有兩個參數，且都是 INOUT 參數。首先，?Connection?對象?con?將創建?CallableStatement?對象?cstmt。然后，方法setByte?把第一個參數設置為 Java?byte?類型，其值為?25。驅動程序將把?25?轉換為 JDBC?TINYINT?類型并將之送到數據庫中。方法?setBigDecimal?用輸入值?83.75?來設置第二個參數。驅動程序將把這個?java.math.BigDecimal?對象轉換為 JDBC?NUMERIC?值。接下來將這兩個參數注冊為 OUT 參數，第一個參數注冊為 JDBC?TINYINT?類型，第二個參數注冊為小數點后面帶兩位數字的 JDBC?DECIMAL?類型。執行?cstmt?后，就用?ResultSet.getXXX?方法將值從?ResultSet?對象中檢索出來。方法?getString?將第一列中的值作為 Java?String?對象獲取，getInt?將第二列中的值作為 Java?int?獲取，getInt?將第三列中的值作為 Java?int?獲取。

之后，?CallableStatement.getXXX?方法檢索存放在輸出參數中的值。方法?getByte?將?JDBC?TINYINT?檢索為 Java?byte，getBigDecimal?將?JDBC?DECIMAL?檢索為小數點后面帶有兩位數字的?java.math.BigDecimal?對象。注意，當參數既是輸入參數同時又是輸出參數時，setXXX?方法所用的 Java 類型與?getXXX?方法所用的相同（正如?setByte?和?getByte?中一樣）。registerOutParameter?方法將它注冊成由 Java 類型映射來的 JDBC 類型（Java?byte?類型映射為 JDBC?TINYINT，如?8.6.2?節中的表所示）。

CallableStatement cstmt = con.prepareCall("{call getTestData(?, ?)}");cstmt.setByte(1, 25);cstmt.setBigDecimal(2, 83.75);// 將第一個參數注冊為 JDBC TINYINT，第二個// 參數注冊為小數點后面帶有兩位數字的 JDBC DECIMAL 類型cstmt.registerOutParameter(1, java.sql.Types.TINYINT);cstmt.registerOutParameter(2, java.sql.Types.DECIMAL, 2);ResultSet rs = cstmt.executeUpdate();// 檢索并打印結果中的值。while(rs.next()) {String name = rs.getString(1);int score = rs.getInt(2);int percentile = rs.getInt(3);System.out.print("name = " + name + ", score = " + score + ", "System.out.println("percentile = " + percentile);// 檢索輸出參數中的值 byte x = cstmt.getByte(1);java.math.BigDecimal n = cstmt.getBigDecimal(2, 2);

總之，CallableStatement.getXXX?和?PreparedStatement.setXXX?方法系列中的?XXX?是 Java 類型。對于?setXXX?方法，驅動程序先把 Java 類型轉換為 JDBC 類型，再把它送到數據庫中（使用?8.6.2?節中的表所示的標準映射）。對于?getXXX?方法，驅動程序先把數據庫返回的 JDBC 類型轉換為 Java 類型（用?8.6.1?節表中所示的標準映射），再把它返回給?getXXX?方法。

registerOutParameter?方法只接受 JDBC 類型的變量，而?setObject?方法卻可接受 JDBC 類型的變量。

注意，如果在可選的第三個變量的位置上提供了 JDBC 類型，則?setObject?方法將把參數值從 Java 類型顯式地轉換為所指定的 JDBC 類型。如果沒有為?setObject?提供目標 JDBC 類型，則將把參數值轉換為 Java 類型的標準映射 JDBC 類型（如?8.6.2?節的表中所示）。在將參數送到數據庫中之前，驅動程序都要進行顯式或隱式轉換。

8.5 動態數據存取

大多數時候，用戶要存取的結果和參數其數據類型在編譯時是已知的。然而，有些應用程序（例如普通的瀏覽器或查詢工具）在編譯時對它們所要存取的數據庫的機制并不知曉。因此，JDBC 除了支持靜態數據類型存取外，還支持類型完全動態確定的數據存取。

有三種方法和一個常量可用于訪問那些在編譯時其數據類型尚屬未知的值：

ResultSet.getObject?
PreparedStatement.setObject?
CallableStatement.getObject?
java.sql.Types.OTHER?（用作?CallableStatement.registerOutParameter?的一個變量）??

例如，如果應用程序想要接受多種類型作為其?ResultSet?對象中的結果，它可以使用?ResultSet.getObject?方法。

ResultSet.getObject?和?CallableStatement.getObject?方法將值檢索為 Java?Object。由于?Object?是所有 Java 對象的基本類，因此可將任何 Java 類的實例檢索為?Object?的實例。然而，以下 Java 類型是內置的“基本”類型，因此，它們不是類?Object?的實例：?boolean、char、byte、short、int、long、?float?和?double。因此，不能用?getObject?方法來檢索它們。然而，這些基本類型每種都有相應的可用作 wrapper 的類。這些類的實例是對象，這意味著可用?ResultSet.getObject?和?CallableStatement.getObject?方法來檢索它們。第 67 頁中的表 8.6.3?顯示了從 JDBC 類型到 Java?Object?類型的映射。該表與 JDBC 類型到 Java 類型的標準映射不同：在該表中，除了 JDBC?TINYINT?和 JDBC?SMALLINT?類型映射為 Java 類Integer?之外，每一個基本的 Java 類型都被替換為它們的 wrapper 類。

方法?getObject?還可用于檢索用戶定義的 Java 類型。隨著抽象數據類型（ADT）和其它用戶定義的類型在某些數據庫系統中的出現，一些提供者可能會發現用?getObject?來檢索這些類型將更方便。

8.6 數據類型映射表

本節含有以下表，它們是 JDBC 類型和 Java 數據類型之間的映射關系表：

8.6.1 節?— 從 JDBC 類型映射到 Java 類型

8.6.2 節?— 從 Java 類型映射到 JDBC 類型

8.6.3 節?─ 從 JDBC 類型映射到 Java?Object?類型

8.6.4 節?─ 從 Java?Object?類型映射到 JDBC 類型

8.6.5 節?─ 由?setObject?所進行的轉換

8.6.6 節?— 由?ResultSet.getXXX?方法所檢索的 JDBC 類型

8.6.1 從 JDBC 類型映射到 Java 類型

JDBC 類型Java 類型

CHAR	String
VARCHAR	String
LONGVARCHAR	String
NUMERIC	java.math.BigDecimal
DECIMAL	java.math.BigDecimal
BIT	boolean
TINYINT	byte
SMALLINT	short
INTEGER	int
BIGINT	long
REAL	float
FLOAT	double
DOUBLE	double
BINARY	byte[]
VARBINARY	byte[]
LONGVARBINARY	byte[]
DATE	java.sql.Date
TIME	java.sql.Time
TIMESTAMP	java.sql.Timestamp

8.6.2 從 Java 類型映射到 JDBC 類型

該表顯示的是表?8.6.1?的反映射：Java 類型到 JDBC 類型的映射。

Java 類型JDBC 類型

String	VARCHAR 或 LONGVARCHAR
java.math.BigDecimal	NUMERIC
boolean	BIT
byte	TINYINT
short	SMALLINT
int	INTEGER
long	BIGINT
float	REAL
double	DOUBLE
byte[]	VARBINARY 或 LONGVARBINARY
java.sql.Date	DATE
java.sql.Time	TIME
java.sql.Timestamp	TIMESTAMP

?String 類型的映射通常是?VARCHAR，但如果所給的值超出了驅動程序對?VARCHAR?值所限定的極限，則將轉換為?LONGVARCHAR?類型。對?byte[]、VARBINARY?及?LONGVARBINARY?值也一樣。

8.6.3 從 JDBC 類型到 Java Object 類型的映射

由于 Java 內置類型（例如?boolean?和?int）不是?Object?的子類型，因此對于?getObject/setObject?方法，從 JDBC 類型到 Java object 類型的映射稍有不同。此種映射如下表所示：

JDBC 類型Java Object 類型

CHAR	String
VARCHAR	String
LONGVARCHAR	String
NUMERIC	java.math.BigDecimal
DECIMAL	java.math.BigDecimal
BIT	Boolean
TINYINT	Integer
SMALLINT	Integer
INTEGER	Integer
BIGINT	Long
REAL	Float
FLOAT	Double
DOUBLE	Double
BINARY	byte[]
VARBINARY	byte[]
LONGVARBINARY	byte[]
DATE	java.sql.Date
TIME	java.sql.Time
TIMESTAMP	java.sql.Timestamp

8.6.4 Java Object 類型映射到 JDBC 類型

Java Object 類型JDBC 類型

String	VARCHAR 或 LONGVARCHAR
java.math.BigDecimal	NUMERIC
Boolean	BIT
Integer	INTEGER
Long	BIGINT
Float	REAL
Double	DOUBLE
byte[]	VARBINARY 或 LONGVARBINARY
java.sql.Date	DATE
java.sql.Time	TIME
java.sql.Timestamp	TIMESTAMP

?注意，String?的映射通常為?VARCHAR，但如果所給的值超出了驅動程序對?VARCHAR?值所限定的極限值，則將轉換為?LONGVARCHAR。對?byte[]、VARBINARY?和?LONGVARBINARY?值也一樣。

8.6.5 由 setObject 所進行的轉換

setObject

　T
I
N
Y
I
N
TS
M
A
L
L
I
N
TI
N
T
E
G
E
RB
I
G
I
N
TR
E
A
LF
L
O
A
TD
O
U
B
L
ED
E
C
I
M
A
LN
U
M
E
R
I
CB
I
TC
H
A
RV
A
R
C
H
A
RL
O
N
G
V
A
R
C
H
A
RB
I
N
A
R
YV
A
R
B
I
N
A
R
YL
O
N
G
V
A
R
B
I
N
A
R
YD
A
T
ET
I
M
ET
I
M
E
S
T
A
M
P

String

java.math.BigDecimal

Boolean

Integer

Long

Float

Double

byte[]

java.sql.Date

java.sql.Time

java.sql.Time- stamp

?從 Java object 類型到 JDBC 類型的轉換。

8.6.6 由 ResultSet.getXXX 方法檢索的 JDBC 類型

"x" 表示該方法可以檢索 JDBC 類型。"X" 表示建議使用該方法來檢索該 JDBC 類型。

getByte

getShort

getInt

getLong

getFloat

getDouble

getBigDecimal

getBoolean

getString

getBytes

getDate

getTime

getTimestamp

getAsciiStream

getUnicodeStream

getBinaryStream

getObject

總結

以上是生活随笔為你收集整理的Oracle -jdbc-java 的类型映射的全部內容，希望文章能夠幫你解決所遇到的問題。

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

上一篇： ORACLE 绑定变量用法总结
下一篇： oracle有Boolean类型