What is JBossJCA?

A clean room implementation of the J2EE Connector API part of the J2EE specification.

JCA handles the deployment of resource adapters. These include DataSources and ConnectionFactorys and

MessageListeners to and from databases, legacy systems or JMS Servers

Spec

• JBoss4 supports J2ee Connector API 1.5 (except JBoss4.0.0DR3)

• JBoss3 supports J2ee Connector API 1.0

Features

• Managed Connections

• Automatic transaction enlistment

• Security injection

• Pooling

• Local resource adapters can take part in two phase commit

• DataSource deployment using any jdbc java.sql.Driver or javax.sql.XADataSource

• JMS Resource Adapter

• Dead connection checking

• Prepared Statement pooling

• No transaction, local and XA connection managers

• Transaction inflow

• Message inflow

• Work management

• Database failover

• Lazy JCA Enlistment - a little known feature of JavaEE

Getting involved

Do you want to be a JBossJCA committer? Take a look at the [currently outstanding tasks in

JIRA|http://jira.jboss.com/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12310093]

Architecture

• Overview - a brief overview of the architecture

• Source Tree - a brief overview of the source tree

• Pooling - overview of pooling

• Lazy AutoCommit Optimization - reducing the traffic to the server

Configuration

• General - General JCA config including the resource adapter deployer

• Deploying DataSources and ConnectionFactorys - deploying -ds.xml files

• Common - Common parameters for datasources and connection factories

• DataSources - Configuring a datasource

• ConnectionFactory - Configuring connection factories (connection-definitions in 1.5)

• JCA Login Modules - Injecting security configuration into connection creation

• Encrypting DataSource Passwords How to encrypt DataSource passwords

• Inbound - Configuring a MessageListener for an inbound resource adapter (jca 1.5)

• InboundJavaMail - Configuring a MessageListener for an inbound emails (jca 1.5)

• Admin Objects - Admin Objects (jca 1.5)

• Specifying a dependency on a DataSource

• DebugConnectionProblems - an overview of what to look at

Forums

• FAQ frequently asked questions

• The user forum can be used to obtain help, but read this first

• The development forum is for the discussion of changes to the implementation.

• Bug Reports, Change Notes and RoadMap to find solved problems, known issues or report new problems

• Unoffical roadmap overview

Examples

• A simple example of message inflow

Authors

• WestonPrice project lead.

• Adrian Brock.

• Bill Burke

• Scott Stark

• Tom Elrod

• Corby Page

• PeterAntman

• BillDeCoste

Retired

• David Jencks

• Andrey Demchenko

• Igor Fedorenko

• Jason Dillon

• Norbert Lataille

• Erwin Guib

• Toby Allsopp

• And many patches gratefully received from the community with thanks.

Old Change Notes

• 3.2.4

• JBoss Changes Notes for previous releases

Related

• Changes in JCA 1.5

• JMS Resource Adapter

• Understanding JCA transaction

• Understanding JCA

• Serve It Up with J2EE 1.4 - Use JCA 1.5 and EJB 2.1 to Extend your App Server