JavaEE 6中新的定义数据源方法

JavaEE 6中新的定义数据源方法

在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属性。如果发证这样的情况，采用部署描述定义的数据源优先权高于采用注释声明定义的数据源。