アノテーションインターフェース DataSourceDefinition
DataSource を定義するために使用されるアノテーション。DataSource は、一般的に使用される DataSource プロパティのアノテーション要素を設定することで構成できます。properties 要素を使用して、追加の標準およびベンダー固有のプロパティを指定できます。 データソースは、name 要素で指定された名前で登録されます。これは、他のコンポーネントからのデータソースへのアクセス可能性を決定する、任意の有効な Jakarta EE 名前空間にあるように定義できます。
適切な型の JDBC ドライバー実装クラス(DataSource、ConnectionPoolDataSource、XADataSource)は、className 要素で示される必要があります。ドライバークラスの可用性は、実行時に想定されます。
DataSource プロパティは複数回指定しないでください。url アノテーション要素に、対応するアノテーション要素を使用して指定された、またはプロパティアノテーション要素で指定された DataSource プロパティが含まれている場合、優先順位は未定義で実装固有です。
上記の例では、databaseName、user、serverName プロパティは、url プロパティの一部として、対応するアノテーション要素を使用して指定されています。これは避けるべきです。
properties アノテーション要素が使用され、対応するアノテーション要素を使用して指定された DataSource プロパティが含まれている場合、アノテーション要素の値が優先されます。例:
これにより、DataSource の構成時に次の値が使用されます。
- serverName = luckydog
- portNumber = 1527
- databaseName = testDB
- user = lance
- password = secret
- databaseProp = doThis
ベンダーは、特定のデータソース型には通常適用されないプロパティをサポートする必要はありません。例: transactional プロパティを true に指定するが、XADataSource 以外のデータソースクラスを実装する className に値を提供することはサポートされない場合があります。
ベンダー固有のプロパティは、このアノテーションを使用して定義された標準のデータソースプロパティと組み合わせるか、オーバーライドするために使用できます。
指定された構成でサポートされていない、またはベンダー固有の構成プロパティにマップできない DataSource プロパティは無視される場合があります。
例:
URL の使用:
Jakarta Enterprise Beans からの DataSource のルックアップの例:
- 導入:
- 共通のアノテーション 1.1
- 関連事項:
必須定数のサマリー
必須要素オプション要素の概要
オプション要素修飾子と型オプションの要素説明サーバー上のデータベースの名前。このデータソースの説明int接続プールの初期化時に作成する必要がある接続の数。int接続の分離レベル。intデータベースへの接続試行中にこのデータソースが待機する最大時間を秒単位で設定します。int接続が接続プールに対して閉じられるまでに、物理接続がプール内で未使用のままでいる必要がある秒数。int接続プールに同時に割り当てられる接続の最大数。int接続プールを開いたままにしておくべきステートメントの総数。int接続プールに割り当てる必要がある接続の最小数。接続認証に使用するパスワード。intサーバーがリクエストをリスニングするポート番号。StringSE[]ベンダー固有のプロパティと、あまり一般的に使用されないDataSourceプロパティ (dataSourceName networkProtocol、propertyCycle roleName など) を指定するために使用されます。プロパティは、propertyName=propertyValue の形式で指定され、配列要素ごとに 1 つのプロパティが含まれます。データベースサーバー名。boolean接続がトランザクションに参加しない場合は、falseに設定します。JDBC URL。接続認証に使用するユーザー名。
要素の詳細
description
StringSE descriptionこのデータソースの説明- 導入:
- 1.1
- デフォルト:
- ""
url
StringSE urlJDBCURL。urlアノテーション要素に対応するアノテーション要素を使用して指定された DataSource プロパティが含まれている場合、優先順位は定義されておらず、実装固有です。- 導入:
- 1.1
- デフォルト:
- ""
user
StringSE user接続認証に使用するユーザー名。- 導入:
- 1.1
- デフォルト:
- ""
password
StringSE password接続認証に使用するパスワード。- 導入:
- 1.1
- デフォルト:
- ""
databaseName
StringSE databaseNameサーバー上のデータベースの名前。- 導入:
- 1.1
- デフォルト:
- ""
portNumber
int portNumberサーバーがリクエストをリスニングするポート番号。- 導入:
- 1.1
- デフォルト:
- -1
serverName
StringSE serverNameデータベースサーバー名。- 導入:
- 1.1
- デフォルト:
- "localhost"
isolationLevel
int isolationLevel接続の分離レベル。分離レベルは、次のいずれかである必要があります。- Connection.TRANSACTION_NONE
- Connection.TRANSACTION_READ_ UNCOMMITTED
- Connection.TRANSACTION_READ_COMMITTED
- Connection.TRANSACTION_REPEATABLE_READ
- Connection.TRANSACTION_SERIALIZABLE
- 導入:
- 1.1
- デフォルト:
- -1
transactional
boolean transactional接続がトランザクションに参加しない場合は、falseに設定します。デフォルトでは、トランザクションがアクティブまたはアクティブになったときにトランザクションに参加します。
- 導入:
- 1.1
- デフォルト:
- true
initialPoolSize
int initialPoolSize接続プールの初期化時に作成する必要がある接続の数。デフォルトはベンダー固有です
- 導入:
- 1.1
- デフォルト:
- -1
maxPoolSize
int maxPoolSize接続プールに同時に割り当てられる接続の最大数。デフォルトはベンダー固有です。
- 導入:
- 1.1
- デフォルト:
- -1
minPoolSize
int minPoolSize接続プールに割り当てる必要がある接続の最小数。デフォルトはベンダー固有です。
- 導入:
- 1.1
- デフォルト:
- -1
maxIdleTime
int maxIdleTime接続が接続プールに対して閉じられるまでに、物理接続がプール内で未使用のままでいる必要がある秒数。デフォルトはベンダー固有です
- 導入:
- 1.1
- デフォルト:
- -1
maxStatements
int maxStatements接続プールが開いたままにしておく必要のあるステートメントの総数。値 0 は、接続プールに対してステートメントのキャッシュが無効になっていることを示します。デフォルトはベンダー固有です
- 導入:
- 1.1
- デフォルト:
- -1
properties
StringSE[] propertiesベンダー固有のプロパティを指定するために使用され、以下のようなあまり使用されないDataSourceプロパティ:- dataSourceName
- networkProtocol
- propertyCycle
- roleName
DataSource プロパティが
properties要素で指定され、プロパティのアノテーション要素も指定されている場合、アノテーション要素の値が優先されます。- 導入:
- 1.1
- デフォルト:
- {}
loginTimeout
int loginTimeoutこのデータソースがデータベースへの接続を試行しているときに待機する最大時間を秒単位で設定します。ゼロの値は、タイムアウトが存在する場合、タイムアウトがデフォルトのシステムタイムアウトであることを指定します。それ以外の場合は、タイムアウトがないことを指定します。デフォルトはベンダー固有です。
- 導入:
- 1.1
- デフォルト:
- 0