Configuring Generic JCA Adaptors


XSLSubDeployer also supports the deployment of arbitrary non-JDBC JCA resource adaptors. Figure 7.10 shows the schema for the top-level connection factory elements of the *-ds.xml configuration deployment file.

Figure 7.10. The simplified JCA adaptor connection factory configuration descriptor top-level schema elements.


You can specify multiple connection factory configurations in a configuration deployment file. These are the child elements of the connection-factories root element:

  • mbean You can specify any number of mbean elements to define MBean services that should be included in the jboss-service.xml descriptor that results from the transformation. You can use this element to configure additional services used by the adaptor.

  • no-tx-connection-factory You use this element to specify the (org.jboss.resource.connectionmanager)NoTxConnectionManager service configuration. NoTxConnectionManager is a JCA connection manager with no transaction support. The no-tx-connection-factory child element schema is shown in Figure 7.11.

    Figure 7.11. The no-tx-connection-factory element schema.


  • tx-connection-factory You use this element to specify the (org.jboss.resource.connectionmanager)TxConnectionManager service configuration. The tx-connection-factory child element schema is shown in Figure 7.12.

    Figure 7.12. The tx-connection-factory element schema.


The majority of the elements here are the same as those of the datasource configuration. The elements that are unique to the connection factory configuration include the following:

  • adaptor-display-name This is a human-readable display name to assign to the connection manager MBean.

  • local-transaction This element specifies that the tx-connection-factory supports local transactions.

  • xa-transaction This element specifies that the tx-connection-factory supports XA transactions.

  • track-connection-by-tx This element specifies that a connection should be used only on a single transaction and that a transaction should be associated with only one connection.

  • rar-name This is the name of the RAR file that contains the definition for the resource you want to provide. For nested RAR files, the name would look like myapplication.ear#my.rar.

  • connection-definition This is the connection factory interface class. It should match the connectionfactory-interface in the ra.xml file.

  • config-property You can specify any number of properties to supply to the ManagedConnectionFactory MBean service configuration. Each config-property element specifies the value of a ManagedConnectionFactory property. The config-property element has two required attributes:

    • name The name of the property.

    • type The fully qualified type of the property.

The content of the config-property element provides the string representation of the property value. This is converted to the true property type by using the associated type PropertyEditor.



JBoss 4. 0(c) The Official Guide
JBoss 4.0 - The Official Guide
ISBN: B003D7JU58
EAN: N/A
Year: 2006
Pages: 137

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net