在JavaEE应用程序中，数据源对象（DataSource objects）是通过JDBC API访问关系数据库的途径。每个DataSource对象都有一系列用来描述现实世界中数据源的属性，通过这些属性可以描述数据库服务器所在的地址、数据库名称、网络协议等信息。另外数据源对象还可以与JNDI配合使用，如果将一个数据源与一个注册好的JNDI服务绑定后，在应用程序中就可以通过访问JNDI API得到这个数据源对象，进而取得和数据库的链接以及进行数据库操作。

　　在JavaEE 6以前，数据源的定义和使用与Java应用服务器厂家有很强的相关性，JavaEE 6则提供了更为灵活的数据源定义方式，可以定义在多个应用服务器之间兼容的数据源。另外同时支持注释、声明、部署表述等多个定义方式。在本文中，将说明如何使用注释和或部署描述来定义数据源。

　　使用注释定义数据源

　　在JavaEE 6中提供了两个用来定义数据源的注释标记：@DataSourceDefinition 和@DataSourceDefinitions，这两个标记都位于javax.annotation.sql包中。通过@DataSourceDefinition可以定义单个数据源，通过@DataSourceDefinitions可以定义多个数据源。

　　@DataSourceDefinition注释

　　@DataSourceDefinition注释标记可以应用客户端、Servlet、EJB等元件当中定义数据源，通过该注释标记，可以定义数据源对象，并与JNDK绑定。该标记的使用方式与设置数据源对象的属性没有什么区别，也可以设置附加信息以及特定信息。

　　例如，下面的注释标记创建了一个访问Derby数据库的数据源。

以下是引用片段： @DataSourceDefinition(name = “java:app/env/Servlet_DataSource”,       minPoolSize = 0,       initialPoolSize = 0,       className = “org.apache.derby.jdbc.ClientXADataSource”,       user = “APP”,       password = “APP”,       databaseName = “testdb”,       properties = {“connectionAttributes=;create=true”}  )

　　数据源的name属性值就是要绑定的的JNDI名称，根据JNDI的特点，该值应该是唯一的。从上面的例子中可以注意到，属性值的第一部分，也就是java:app是一个命名空间说明。在JavaEE 6中引入了应用元件命名空间，目前可以使用的命名空间如下：

　　java:comp，同一应用同一容器中的元件可以访问。

　　java:module，与元件相同的一个模块中可以访问，比如定义在同一个ejb-jar.xml中的EJB元件。

　　java:app，可以在同一应用中的所有元件和模块中访问，例如位于统一ear文件中的客户端元件、WEB元件、EJB元件。

　　java:global，可以在服务器中所有的应用程序之间共享。

　　name属性所引用的命名空间范围，也决定了数据源对象的访问范围，也就是模块、应用或者同一服务中的所有用用。以下的定义方式分别表示：

　　java:comp/env/, 与数据源定义元件处于同一容器中的其他元件、如客户端元件、WEB元件、EJB元件都可以访问这个数据源。

　　java:module/env/, 位于同一个ejb-jar.xml中的元件都可以访问这个数据源。

　　java:app/env/, 同一个应用中的所有元件，如EJB, servlet以及客户端元件都可以访问这个数据源。

　　@DataSourceDefinitions注释

　　通过@DataSourceDefinitions可以在一个元件类中创建多个数据源，就如同定义一个数组一样，每个数据源是数组的一个元素。下面是一个为EJB定义多个数据源的例子。
 

以下是引用片段： @DataSourceDefinitions(       value = {           @DataSourceDefinition(name = “java:app/env/HelloStatefulEJB_DataSource”,               minPoolSize = 0,               initialPoolSize = 0,               className = “org.apache.derby.jdbc.ClientXADataSource”,               portNumber = 1527,               serverName = “localhost”,               user = “APP”,               password = “APP”,               databaseName = “testdb”,               properties = {“connectionAttributes=;create=true”}           ),           @DataSourceDefinition(name = “java:comp/env/HelloStatefulEJB_DataSource”,               minPoolSize = 0,               initialPoolSize = 0,               className = “org.apache.derby.jdbc.ClientXADataSource”,               portNumber = 1527,               serverName = “localhost”,               user = “APP”,               password = “APP”,               databaseName = “testdb”,               properties = {“connectionAttributes=;create=true”}           )       }  )   @Stateful public class HelloStatefulEJB implements HelloStateful {       …      …  }

　　采用部署表述定义数据源

　　除了前面的方式以外，JavaEE 6还继续支持使用部署描述的方式定义数据源，部署描述信息可以写在application.xml、application-client.xml、web.xml以及ejb-jar.xml当中。下面的例子中定义的数据源与前面使用@DataSourceDefinition数据源含义相同。

以下是引用片段： <data-source>      <name>java:app/env/Application_Level_DataSource</name>      <class-name>org.apache.derby.jdbc.ClientXADataSource</class-name>      <server-name>localhost</server-name>      <port-number>1527</port-number>      <database-name>testdb</database-name>      <user>APP</user>      <password>APP</password>      <property>          <name>connectionAttributes</name>          <value>;create=true</value>      </property>  </data-source>

　　如果在同一个应用程序中，分别通过@DataSourceDefinition和部署描述信息定义了两个数据源，但这这两个数据源具有相同的name属性。如果发证这样的情况，采用部署描述定义的数据源优先权高于采用注释声明定义的数据源。