Interstage Application Server J2EE ユーザーズガイド

12.11.1 標準データ型

■ 使用できる標準データ型

　以下に、使用できる標準データ型を示します。

• boolean
• java.lang.Boolean (注)
• byte
• java.lang.Byte (注)
• byte[]
• char
• java.lang.Character (注)
• double
• java.lang.Double (注)
• float
• java.lang.Float (注)
• int
• java.lang.Integer (注)
• long
• java.lang.Long (注)
• short
• java.lang.Short (注)
• java.lang.String
• java.math.BigDecimal
• java.sql.Date
• java.sql.Time
• java.sql.Timestamp

(注)
　コンテナが、対応するJavaのプリミティブデータ型に変換してからデータベースに設定します。

■ nullが使用可能なCMFのデータ型

　以下に、nullが使用できるデータ型を示します。

• java.lang.Boolean
• java.lang.Byte
• byte[]
• java.lang.Character
• java.lang.Double
• java.lang.Float
• java.lang.Integer
• java.lang.Long
• java.lang.Short
• java.lang.String
• java.math.BigDecimal
• java.sql.Date
• java.sql.Time
• java.sql.Timestamp

■ 推奨パターン

　以下に、Javaのデータ型とDBMSのSQLデータ型の組合せ（推奨パターン）を示します。

　Javaのデータ型を、以下の表に示す以外のDBMSのSQLデータ型と組み合わせたい場合は、JDBCドライバの変換規則にしたがってください。
　ただし、“使用できる標準データ型”で、(注)となっているデータ型については、コンテナが変換した後のJavaのプリミティブデータ型でJDBCの変換規則にしたがってください。

　なお、Interstage EJBではJDBC2.0の範囲でサポートしています。

　DBMSのSQLデータ型でCHAR型のような固定長文字列型を使用した場合、JDBCドライバの仕様により、返却される文字列データ値について後方空白削除、または空白パディングを行うためデータ値の不整合が起こる場合があります。
　特にプライマリキーフィールドにCHAR型のカラムをマッピングする場合に注意してください。

　このような場合、CHAR型のような固定長文字列型ではなく、VARCHAR型やVARCHAR2型といった可変長文字列型を使用することでこの問題は解決されます。

Javaのデータ型	DBMSのSQLデータ型
	Symfoware	Oracle	SQL Server	PostgreSQL
boolean/java.lang.Boolean	−	NUMBER	bit	BOOLEAN
byte/java.lang.Byte	−	NUMBER	tinyint	SMALLINT
char/java.lang.Character	−	−	−	−
double/java.lang.Double	FLOAT DOUBLE	NUMBER	float	DOUBLE PRECISION (注6)
float/java.lang.Float	REAL	NUMBER	real	REAL (注6)
int/java.lang.Integer	INT	NUMBER	int	INTEGER SERIAL
long/java.lang.Long	−	NUMBER	bigint	BIGINT BIGSERIAL
short/java.lang.Short	SMALLINT	NUMBER	smallint	SMALLINT
java.lang.String	CHAR NCHAR VARCHAR NVARCHAR	CHAR (注2) VARCHAR2 (注2) LONG (注2)	char varchar text nchar nvarchar sql_variant sysname uniqueidentifier ntext	CHARACTER CHARACTER VARYING TEXT
java.math.BigDecimal	NUMERIC DECIMAL	NUMBER	decimal numeric money smallmoney	NUMERIC DECIMAL
byte[]	BLOB (注1)	NUMBER RAW LONGRAW (注2)(注3)	binary varbinary image timestamp	BYTEA
java.sql.Date	DATE	DATE	−	DATE
java.sql.Time	TIME	DATE	−	TIME
java.sql.Timestamp	TIMESTAMP	DATE	datetime (注4)(注5) smalldatetime (注4)	TIMESTAMP TIMESTAMP WITH TIMEZONE

− ： 推奨するデータ型は特にありません。

（注1）
　以下の場合、32KB以上のBLOB型の列に対して取り出し/設定はできません。

• バージョンレベルがV5.0L10より前のSymfowareを使用する場合
• バージョンレベルがV5.0L10以降のSymfowareでRDA-SV連携を使用する場合

(注2)
　Oracleを利用する場合、以下のデータ型については、取り扱い可能なデータ長に制限がある場合があります。

• CHAR：4000Byte
• VARCHAR2：4000Byte
• LONG：4000Byte
• LONGRAW：2000Byte

　上記制限値より大きいデータ量を取り扱う場合は、BMPのEntity Beanを使用してください

(注3)
　OracleのLONGRAWデータ型を使用する場合、CMPのEntity Beanのトランザクション属性にMandatoryを指定して動作させるとOracleのJDBCドライバより以下のメッセージが出力される場合があります。
　「ORA-17027：ストリームはすでにクローズ済みです」
　トランザクション属性にRequiredを指定することで上記問題は回避できますが、処理性能が劣化する場合があります。

（注4)
　datetime型とsmalldatetime型のデータを更新する場合は、以下の形式でデータを指定してください。

• 記述形式

  　YYYY-MM-DD hh:mm:ss　

　　　YYYY：年、MM：月、DD：日、hh：時、mm：分、ss：秒
（ミリ秒は未サポートです。）

• 例

2001-09-22 14:23:40

（注5)
　datetime型に対して、以下のAPIを使用する場合、smalldatetime型の範囲内の値だけ有効となります。

• PreparedStatement.setTimestamp(int parameterIndex, Timestamp x)

（注6）
　PostgreSQLのREALデータ型とDOUBLE PRECISIONデータ型は不正確な精度が変動する数値データ型です。したがって、正確な値ではなく、正確な値に近い値として保存されることがあるため、保存しようとする値と保存された値に多少の誤差がある可能性があります。
　なお、ゼロに限りなく近い値で、ゼロとは区別されていない数値は、アンダーフローエラーを引き起こします。正確な記録や計算が必要な場合は、NUMERICデータ型を使用してください。