Mantis - Resin
Viewing Issue Advanced Details
ID: Category: Severity: Reproducibility: Date Submitted: Last Update:
4487 minor always 04-07-11 19:47 04-27-11 11:35
Reporter: reza Platform:  
Assigned To: ferg OS:  
Priority: normal OS Version:  
Status: closed Product Version: 4.0.17  
Product Build: Resolution: fixed  
Projection: none      
ETA: none Fixed in Version: 4.0.18  
Summary: 0004487: Java EE 6 standard <data-source> XML element not supported.
Description: Java EE 6 defines a standard <data-source> XML element. It can be defined in application.xml, web.xml or ejb-jar.xml. Here is the schema definition for the element:

<xsd:complexType name="data-sourceType">
  <xsd:annotation>
    <xsd:documentation>
      Configuration of a DataSource.
    </xsd:documentation>
  </xsd:annotation>
  <xsd:sequence>
    <xsd:element name="description" type="javaee:descriptionType" minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Description of this DataSource.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="name" type="javaee:jndi-nameType">
      <xsd:annotation>
        <xsd:documentation>
          The name element specifies the JNDI name of the
          data source being defined.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="class-name" type="javaee:fully-qualified-classType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          DataSource, XADataSource or ConnectionPoolDataSource
          implementation class.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="server-name" type="javaee:string" minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Database server name.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="port-number" type="javaee:xsdIntegerType" minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Port number where a server is listening for requests.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="database-name" type="javaee:string" minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Name of a database on a server.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="url" type="javaee:jdbc-urlType" minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          <![CDATA[[
          A JDBC URL. If the <code>url</code> property is specified along with
          other standard <code>DataSource</code> properties such as
          <code>serverName</code>, <code>databaseName</code> and
          <code>portNumber</code>, the more specific properties will take
          precedence and <code>url</code> will be ignored.
          ]]>
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="user" type="javaee:string" minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          User name to use for connection authentication.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="password" type="javaee:string" minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Password to use for connection authentication.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="property" type="javaee:propertyType" minOccurs="0"
        maxOccurs="unbounded">
      <xsd:annotation>
        <xsd:documentation>
          JDBC DataSource property. This may be a vendor-specific property or a
          less commonly used DataSource property.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="login-timeout" type="javaee:xsdIntegerType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Sets the maximum time in seconds that this data source will wait
          while attempting to connect to a database.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="transactional" type="javaee:xsdBooleanType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Set to false if connections should not participate in transactions.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="isolation-level" type="javaee:isolation-levelType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Isolation level for connections.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="initial-pool-size" type="javaee:xsdIntegerType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Number of connections that should be created when a connection pool
          is initialized.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="max-pool-size" type="javaee:xsdIntegerType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Maximum number of connections that should be concurrently allocated
          for a connection pool.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="min-pool-size" type="javaee:xsdIntegerType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          Minimum number of connections that should be concurrently allocated
          for a connection pool.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="max-idle-time" type="javaee:xsdIntegerType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          The number of seconds that a physical connection should remain unused
          in the pool before the connection is closed for a connection pool.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="max-statements" type="javaee:xsdIntegerType"
        minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>
          The total number of statements that a connection pool should keep
          open.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
  </xsd:sequence>
  <xsd:attribute name="id" type="xsd:ID"/>
</xsd:complexType>

The <data-source> element can be used in application.xml like this:

<application>
  <display-name>...</display-name>
  <module>...</module>
  <data-source>
    <name>java:global/jdbc/MyDataSource</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>
</application>

The <data-source> element can be used in web.xml like this:

<web-app>
  <display-name>...</display-name>
  <servlet>...</servlet>
  <servlet-mapping>...</servlet-mapping>
  <data-source>
    <name>java:app/jdbc/MyDataSource</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>
</web-app>

The <data-source> element can be used in ejb-jar.xml like this:

<ejb-jar>
  <module-name>...</module-name>
  <enterprise-beans>...</enterprise-beans>
  <assembly-descriptor>...</assembly-descriptor>
  <data-source>
    <name>java:module/jdbc/MyDataSource</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>
</ejb-jar>

It can be also used to define a data-source at an EJB level:

<ejb-jar>
  <module-name>...</module-name>
  <enterprise-beans>
    <session>
      <display-name>...</display-name>
      <ejb-name>...</ejb-name>
      <business-local>...</business-local>
      <ejb-class>...</ejb-class>
      <data-source>
        <name>java:module/jdbc/MyDataSource</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>
    </session>
  </enterprise-beans>
</ejb-jar>

The corresponding persistence.xml will look like this:

<persistence>
  <persistence-unit name="my-persistence-unit" transaction-type="JTA">
    <jta-data-source>java:app/jdbc/MyDataSource</jta-data-source>
    <validation-mode>AUTO</validation-mode>
    <properties>
      <property name="eclipselink.ddl-generation" value="create-tables" />
      <property name="eclipselink.logging.level" value="INFO" />
    </properties>
  </persistence-unit>
</persistence>
Steps To Reproduce:
Additional Information:
Relationships
Attached Files:

Notes
(0005214)
ferg   
04-27-11 11:35   
ioc/1283