データソースは、name 要素で指定された名前で登録されます。これは、他のコンポーネントからのデータソースへのアクセス可能性を決定する、任意の有効な Jakarta EE 名前空間にあるように定義できます。

適切な型の JDBC ドライバー実装クラス（DataSource、ConnectionPoolDataSource、XADataSource）は、className 要素で示される必要があります。ドライバークラスの可用性は、実行時に想定されます。

DataSource プロパティは複数回指定しないでください。url アノテーション要素に、対応するアノテーション要素を使用して指定された、またはプロパティアノテーション要素で指定された DataSource プロパティが含まれている場合、優先順位は未定義で実装固有です。

   @DataSourceDefinition(name="java:global/MyApp/MyDataSource",
      className="org.apache.derby.jdbc.ClientDataSource",
      url="jdbc:derby://localhost:1527/myDB;user=bill",
      user="lance",
      password="secret",
      databaseName="testDB",
      serverName="luckydog"
   )// DO NOT DO THIS!!!
 

上記の例では、databaseName、user、serverName プロパティは、url プロパティの一部として、対応するアノテーション要素を使用して指定されています。これは避けるべきです。

properties アノテーション要素が使用され、対応するアノテーション要素を使用して指定された DataSource プロパティが含まれている場合、アノテーション要素の値が優先されます。例：

   @DataSourceDefinition(name="java:global/MyApp/MyDataSource",
      className="org.apache.derby.jdbc.ClientDataSource",
      user="lance",
      password="secret",
      databaseName="testDB",
      serverName="luckydog",
       properties= {"databaseName=myDB", "databaseProp=doThis"}
   )// DO NOT DO THIS!!!
 

これにより、DataSource の構成時に次の値が使用されます。

• serverName = luckydog
• portNumber = 1527
• databaseName = testDB
• user = lance
• password = secret
• databaseProp = doThis

ベンダーは、特定のデータソース型には通常適用されないプロパティをサポートする必要はありません。例: transactional プロパティを true に指定するが、XADataSource 以外のデータソースクラスを実装する className に値を提供することはサポートされない場合があります。

ベンダー固有のプロパティは、このアノテーションを使用して定義された標準のデータソースプロパティと組み合わせるか、オーバーライドするために使用できます。

指定された構成でサポートされていない、またはベンダー固有の構成プロパティにマップできない DataSource プロパティは無視される場合があります。

例:

   @DataSourceDefinition(name="java:global/MyApp/MyDataSource",
      className="com.foobar.MyDataSource",
      portNumber=6689,
      serverName="myserver.com",
      user="lance",
      password="secret"
   )

 

URL の使用:

  @DataSourceDefinition(name="java:global/MyApp/MyDataSource",
    className="org.apache.derby.jdbc.ClientDataSource",
    url="jdbc:derby://localhost:1527/myDB",
    user="lance",
    password="secret"
 )
 

Jakarta Enterprise Beans からの DataSource のルックアップの例:

 @Stateless
 public class MyStatelessEJB {
   @Resource(lookup="java:global/MyApp/myDataSource")
    DataSource myDB;
      ...
 }