Java 教程是为 JDK 8 编写的。本页中描述的示例和实践未利用在后续版本中引入的改进。
The advanced data types introduced in this section give a relational database more flexibility in what can be used as a value for a table column. For example, a column can be used to store BLOB
(binary large object) values, which can store very large amounts of data as raw bytes. A column can also be of type CLOB
(character large object), which is capable of storing very large amounts of data in character format.
The latest version of the ANSI/ISO SQL standard is commonly referred to as SQL:2003. This standard specifies the following data types:
SQL92 built-in types, which consist of the familiar SQL column types such as CHAR
, FLOAT
, and DATE
SQL99 built-in types, which consist of types added by SQL99:
BOOLEAN
: Boolean (true or false) value
BLOB
: Binary large Bobject
CLOB
: Character large object
New built-in types added by SQL:2003:
XML
: XML object
User defined types:
Structured type: User-defined type; for example:
CREATE TYPE PLANE_POINT AS (X FLOAT, Y FLOAT) NOT FINAL
DISTINCT
type: User-defined type based on a built-in type; for example:
CREATE TYPE MONEY AS NUMERIC(10,2) FINAL
Constructed types: New types based on a given base type:
REF(structured-type)
: Pointer that persistently denotes an instance of a structured type that resides in the database
base-type ARRAY[n]
: Array of n base-type elements
Locators: Entities that are logical pointers to data that resides on the database server. A locator exists in the client computer and is a transient, logical pointer to data on the server. A locator typically refers to data that is too large to materialize on the client, such as images or audio. (Materialized views are query results that have been stored or "materialized" in advance as schema objects.) There are operators defined at the SQL level to retrieve randomly accessed pieces of the data denoted by the locator:
LOCATOR(structured-type)
: Locator to a structured instance in the server
LOCATOR(array)
: Locator to an array in the server
LOCATOR(blob)
: Locator to a binary large object in the server
LOCATOR(clob)
: Locator to a character large object in the server
Datalink
: Type for managing data external to the data source. Datalink
values are part of SQL MED (Management of External Data), a part of the SQL ANSI/ISO standard specification.
The JDBC API provides default mappings for advanced data types specified by the SQL:2003 standard. The following list gives the data types and the interfaces or classes to which they are mapped:
BLOB
: Blob
interfaceCLOB
: Clob
interfaceNCLOB
: NClob
interfaceARRAY
: Array
interfaceXML
: SQLXML
interfaceStruct
interfaceREF(structured type)
: Ref
interfaceROWID
: RowId
interfaceDISTINCT
: Type to which the base type is mapped. For example, a DISTINCT
value based on a SQL NUMERIC
type maps to a java.math.BigDecimal
type because NUMERIC
maps to BigDecimal
in the Java programming language.DATALINK
: java.net.URL
objectYou retrieve, store, and update advanced data types the same way you handle other data types. You use either ResultSet.getDataType
or CallableStatement.getDataType
methods to retrieve them, PreparedStatement.setDataType
methods to store them, and ResultSet.updateDataType
methods to update them. (The variable DataType
is the name of a Java interface or class mapped to an advanced data type.) Probably 90 percent of the operations performed on advanced data types involve using the getDataType
, setDataType
, and updateDataType
methods. The following table shows which methods to use:
Advanced Data Type | getDataType Method |
setDataType method |
updateDataType Method |
---|---|---|---|
BLOB |
getBlob |
setBlob |
updateBlob |
CLOB |
getClob |
setClob |
updateClob |
NCLOB |
getNClob |
setNClob |
updateNClob |
ARRAY |
getArray |
setArray |
updateArray |
XML |
getSQLXML |
setSQLXML |
updateSQLXML |
Structured type |
getObject |
setObject |
updateObject |
REF(structured type) |
getRef |
setRef |
updateRef |
ROWID |
getRowId |
setRowId |
updateRowId |
DISTINCT |
getBigDecimal |
setBigDecimal |
updateBigDecimal |
DATALINK |
getURL |
setURL |
updateURL |
注意:The DISTINCT
data type behaves differently from other advanced SQL data types. Being a user-defined type that is based on an already existing built-in types, it has no interface as its mapping in the Java programming language. Consequently, you use the method that corresponds to the Java type on which the DISTINCT
data type is based. See Using DISTINCT Data Type for more information.
For example, the following code fragment retrieves a SQL ARRAY
value. For this example, suppose that the column SCORES
in the table STUDENTS
contains values of type ARRAY
. The variable stmt
is a Statement
object.
ResultSet rs = stmt.executeQuery( "SELECT SCORES FROM STUDENTS " + "WHERE ID = 002238"); rs.next(); Array scores = rs.getArray("SCORES");
The variable scores
is a logical pointer to the SQL ARRAY
object stored in the table STUDENTS
in the row for student 002238
.
If you want to store a value in the database, you use the appropriate set
method. For example, the following code fragment, in which rs
is a ResultSet
object, stores a Clob
object:
Clob notes = rs.getClob("NOTES"); PreparedStatement pstmt = con.prepareStatement( "UPDATE MARKETS SET COMMENTS = ? " + "WHERE SALES < 1000000"); pstmt.setClob(1, notes); pstmt.executeUpdate();
This code sets notes
as the first parameter in the update statement being sent to the database. The Clob
value designated by notes
will be stored in the table MARKETS
in column COMMENTS
in every row where the value in the column SALES
is less than one million.