4. Mapping

NEXT | PREVIOUS | CONTENT

Mapping zwischen SQL-Typen und Java-Klassen:

nötig, da teilweise signifikante Unterschiede, auch zwischen den verschiedenen DBMSs
durch JDBC Menge von generischen SQL-Typen definiert (in der Klasse java.sql.Types), Umsetzung vom Treiber erledigt
in getXXX(), setXXX() und registerOutParameter() vorgenommen
Ausnahme: CREATE TABLE -> SQL-Typen benötigt -> mit DatabaseMetaData.getTypeInfo() Infos holen

CHAR, VARCHAR und LONGVARCHAR:

repräsentieren einen String mit fester bzw. variabler Länge
Deklaration mit CHAR(n), VARCHAR(n) (n bis mindestens 254 unterstützt)
LONGVARCHAR nicht standardisiert, oft unterschiedliche Namen -> Anpassungen von JDBC vorgenommen
entsprechende Java-Klasse ist String
bei fester Länge (CHAR(n)) Lägendifferenz durch Leerzeichen ausgeglichen

BINARY, VARBINARY und LONGVARBINARY:

repräsentieren einen Binärwert fester bzw. variabler Länge
Deklaration mit Parameter (n)
nicht standardisierte SQL-Erweiterung -> nicht von allen DBMSs unterstützt
entsprechende Java-Klasse ist byte[]

BIT, TINYINT, SMALLINT, INTEGER und BIGINT:

BIT -> boolean
TINYINT ist ein unsigned 8-Bit-Wert (nicht immer unterstützt) -> byte (signed!) oder short (16 Bit)
SMALLINT ist ein signed 16-Bit-Wert -> short (vorzuziehen)
INTEGER ist ein signed 32-Bit-Wert -> int
BIGINT ist ein signed 64-Bit-Wert (nicht standardisiert) -> long

REAL, DOUBLE und FLOAT:

REAL ist ein Gleitkommawert mit 7-Bit-Mantisse -> float
DOUBLE und FLOAT beides Gleitkommawerte mit 15-Bit-Mantisse -> double (DOUBLE ist vorzuziehen)

DECIMAL und NUMERIC:

beides dezimale Festkommazahlen, die Genauigkeit von DECIMAL kann nachträglich noch angepasst werden
Deklaration mit DECIMAL/NUMERIC(n, m), wobei n die Gesamtanzahl von Dezimalstellen und m die Anzahl nach dem Komma ist (mindestens 15 unterstützt)
entsprechende Java-Klasse ist java.math.BigDecimal

DATE, TIME und TIMESTAMP:

DATE enthält ein Datum -> java.sql.Date (Zeit auf 0:00:00.0 gesetzt)
TIME enthält eine Zeit -> java.sql.Time (Datum auf 1.1.1970 gesetzt)
TIMESTAMP enthält beides plus einen Nanosekunden-Wert -> java.sql.Timestamp
alles Subklassen von java.util.Date -> können überall dort verwendet werden, wo java.util.Date erwartet wird

trotzdem Konvertierung von Timestamp in java.util.Date, um zumindest die Millisekunden zu erhalten:

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

ab JDBC 2.0 auch Unterstützung von Zeitzonen über Calendar

Neue Typen in JDBC 2.0:

u.a. Array's, Struct's, Ref'erences und Locator's
BLOB - Binary Large OBject und CLOB - Character Large OBject
strukturierte Typen, z.B. CREATE TYPE PLANE_POINT (X FLOAT, Y FLOAT)
Mapping von strukturierten SQL-Typen in Java-Klassen über das Interface SQLData

Tabellen für Datentyp-Mapping:

(aus dem JDBC Guide)

JDBC-Typen -> Java-Typen:

JDBC type	Java type
`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`

Java-Typen -> JDBC-Typen:

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

JDBC-Typen -> Java-Objects:

JDBC Type	Java Object Type
`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`

Java-Objects -> JDBC-Typen:

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

Konvertierungen von setObject():

	T I N Y I N T	S M A L L I N T	I N T E G E R	B I G I N T	R E A L	F L O A T	D O U B L E	D E C I M A L	N U M E R I C	B I T	C H A R	V A R C H A R	L O N G V A R C H A R	B I N A R Y	V A R B I N A R Y	L O N G V A R B I N A R Y	D A T E	T I M E	T I M E S T A M P
String	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x
java.math.BigDecimal	x	x	x	x	x	x	x	x	x	x	x	x	x
Boolean	x	x	x	x	x	x	x	x	x	x	x	x	x
Integer	x	x	x	x	x	x	x	x	x	x	x	x	x
Long	x	x	x	x	x	x	x	x	x	x	x	x	x
Float	x	x	x	x	x	x	x	x	x	x	x	x	x
Double	x	x	x	x	x	x	x	x	x	x	x	x	x
byte[]														x	x	x
java.sql.Date											x	x	x				x		x
java.sql.Time											x	x	x					x
java.sql.Time-stamp											x	x	x				x	x	x

JDBC-Typen, die ResultSet.getXXX() liefert:

"x" - diese Methode kann diese Typen liefern
"X" - diese Methode sollte aber dafür verwendet werden

T
I
N
Y
I
N
T S
M
A
L
L
I
N
T I
N
T
E
G
E
R B
I
G
I
N
T R
E
A
L F
L
O
A
T D
O
U
B
L
E D
E
C
I
M
A
L N
U
M
E
R
I
C B
I
T C
H
A
R V
A
R
C
H
A
R L
O
N
G
V
A
R
C
H
A
R B
I
N
A
R
Y V
A
R
B
I
N
A
R
Y L
O
N
G
V
A
R
B
I
N
A
R
Y D
A
T
E T
I
M
E T
I
M
E
S
T
A
M
P
getByte X x x x x x x x x x x x x
getShort x X x x x x x x x x x x x
getInt x x X x x x x x x x x x x
getLong x x x X x x x x x x x x x
getFloat x x x x X x x x x x x x x
getDouble x x x x x X X x x x x x x
getBigDecimal x x x x x x x X X x x x x
getBoolean x x x x x x x x x X x x x
getString x x x x x x x x x x X X x x x x x x x
getBytes X X x
getDate x x x X x
getTime x x x X x
getTimestamp x x x x X
getAsciiStream x x X x x x
getUnicodeStream x x X x x x
getBinaryStream x x X
getObject x x x x x x x x x x x x x x x x x x x

	T I N Y I N T	S M A L L I N T	I N T E G E R	B I G I N T	R E A L	F L O A T	D O U B L E	D E C I M A L	N U M E R I C	B I T	C H A R	V A R C H A R	L O N G V A R C H A R	B I N A R Y	V A R B I N A R Y	L O N G V A R B I N A R Y	D A T E	T I M E	T I M E S T A M P
getByte	X	x	x	x	x	x	x	x	x	x	x	x	x
getShort	x	X	x	x	x	x	x	x	x	x	x	x	x
getInt	x	x	X	x	x	x	x	x	x	x	x	x	x
getLong	x	x	x	X	x	x	x	x	x	x	x	x	x
getFloat	x	x	x	x	X	x	x	x	x	x	x	x	x
getDouble	x	x	x	x	x	X	X	x	x	x	x	x	x
getBigDecimal	x	x	x	x	x	x	x	X	X	x	x	x	x
getBoolean	x	x	x	x	x	x	x	x	x	X	x	x	x
getString	x	x	x	x	x	x	x	x	x	x	X	X	x	x	x	x	x	x	x
getBytes														X	X	x
getDate											x	x	x				X		x
getTime											x	x	x					X	x
getTimestamp											x	x	x				x		X
getAsciiStream											x	x	X	x	x	x
getUnicodeStream											x	x	X	x	x	x
getBinaryStream														x	x	X
getObject	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x