Database Class Enhancements
In the SourcePro DB environment, two main classes are involved in the interaction between a client and a server: RWDBDatabase and RWDBConnection. The DB XA Module extends these classes to make them XA-enabled. The changes in RWDBConnection provide a bridge between the resource manager and the application programmer. Changes to RWDBDatabase allow it to produce and manage XA-compliant RWDBConnection objects.
The DB XA Module also enhances the functionality of class RWDBManager to produce XA-appropriate RWDBDatabase instances when the propertyString passed has an XA key.
The following criteria influenced the design of the new class and the extensions:
*The DB XA Module is an add-on to the existing DB Interface Module class library. The new classes must be transparent to any existing DB Interface Module code. Therefore, none of your existing classes or any portions of your existing code will refer to the DB XA Module implementation.
*Like the DB Interface Module, the DB XA Module follows both the producer/product paradigm and the interface/implementation design pattern.
Additional information about these classes appears in Chapter 4 and in the Reference Guide.