Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction and Roadmap

• Document Scope and Audience
• Guide to This Document
• Related Documentation
• Examples for the Resource Adapter Developer
• New and Changed Features in This Release

2 Understanding Resource Adapters

• Overview of Resource Adapters
  • Comparing WebLogic Server and WebLogic Integration Resource Adapters
  • Inbound, Outbound, and Bidirectional Resource Adapters
  • Comparing 1.0 and 1.5 Resource Adapters
• Java EE Connector Architecture
  • Java EE Architecture Diagram and Components
  • System-Level Contracts
• Resource Adapter Deployment Descriptors

3 Creating and Configuring Resource Adapters

• Creating and Configuring Resource Adapters: Main Steps
• Modifying an Existing Resource Adapter
• Configuring the ra.xml File
• Configuring the weblogic-ra.xml File
  • Editing Resource Adapter Deployment Descriptors
    • Editing Considerations
    • Schema Header Information
    • Conforming Deployment Descriptor Files to Schema
  • Dynamic Descriptor Updates: Console Configuration Tabs
    • Dynamic Configuration Parameters
    • Dynamic Pool Parameters
    • Dynamic Logging Parameters
  • Automatic Generation of the weblogic-ra.xml File
  • (Deprecated) Configuring the Link-Ref Mechanism

4 Programming Tasks

• Required Classes for Resource Adapters
• Programming a Resource Adapter to Perform as a Startup Class
• Suspending and Resuming Resource Adapter Activity
• Extended BootstrapContext
  • Diagnostic Context ID
  • Dye Bits
  • Callback Capabilities

5 Connection Management

• Connection Management Contract
  • Connection Factory and Connection
  • Resource Adapters Bound in JNDI Tree
  • Obtaining the ConnectionFactory (Client-JNDI Interaction)
  • Specifying an Unshareable ManagedConnectionFactory
• Configuring Outbound Connections
  • Connection Pool Configuration Levels
  • Multiple Outbound Connections Example
• Configuring Inbound Connections
• Configuring Connection Pool Parameters
  • initial-capacity: Setting the Initial Number of ManagedConnections
  • max-capacity: Setting the Maximum Number of ManagedConnections
  • capacity-increment: Controlling the Number of ManagedConnections
  • shrinking-enabled: Controlling System Resource Usage
  • shrink-frequency-seconds: Setting the Wait Time Between Attempts to Reclaim Unused ManagedConnections
  • highest-num-waiters: Controlling the Number of Clients Waiting for a Connection
  • highest-num-unavailable: Controlling the Number of Unavailable Connections
  • connection-creation-retry-frequency-seconds: Recreating Connections
  • match-connections-supported: Matching Connections
  • test-frequency-seconds: Testing the Viability of Connections
  • test-connections-on-create: Testing Connections upon Creation
  • test-connections-on-release: Testing Connections upon Release to Connection Pool
  • test-connections-on-reserve: Testing Connections upon Reservation
• Connection Proxy Wrapper - 1.0 Resource Adapters
  • Possible ClassCastException
  • Turning Proxy Generation On and Off
• Reset a Connection Pool
• Testing Connections
  • Configuring Connection Testing
  • Testing Connections in the Administration Console

6 Transaction Management

• Supported Transaction Levels
  • XA Transaction Support
  • Local Transaction Support
  • No Transaction Support
• Configuring Transaction Levels
  • Configure XA Transaction Recovery Credential Mapping

7 Message and Transactional Inflow

• Overview of Message and Transactional Inflow
  • Architecture Components
  • Inbound Communication Scenario
• How Message Inflow Works
  • Handling Inbound Messages
  • Proprietary Communications Channel and Protocol
• Message Inflow to Message Endpoints (Message-driven Beans)
  • Deployment-Time Binding Between an MDB and a Resource Adapter
    • Binding an MDB and a Resource Adapter
  • Dispatching a Message
  • Activation Specifications
  • Administered Objects
• Transactional Inflow
  • Using the Transactional Inflow Model for Locally Managed Transactions
• @LongRunning

8 Security

• Container-Managed and Application-Managed Sign-on
  • Application-Managed Sign-on
  • Container-Managed Sign-on
• Password Credential Mapping
  • Authentication Mechanisms
  • Credential Mappings
    • Non-initial Connection: Requires ManagedConnection from Adapter Upon Application's Request
    • Initial Connection: Requires a ManagedConnection from Adapter Without Application's Request
    • Special Users
  • Creating Credential Mappings Using the Console
• Security Policy Processing
• Configuring Security Identities for Resource Adapters
  • default-principal-name: Default Identity
  • manage-as-principal-name: Identity for Running Management Tasks
  • run-as-principal-name: Identity Used for Connection Calls from the Connector Container into the Resource Adapter
  • run-work-as-principal-name: Identity Used for Performing Resource Adapter Management Tasks
• Configuring Connection Factory-Specific Authentication and Re-authentication Mechanisms

9 Packaging and Deploying Resource Adapters

• Packaging Resource Adapters
  • Packaging Directory Structure
  • Packaging Considerations
  • Packaging Limitation
  • Packaging Resource Adapter Archives (RARs)
• Deploying Resource Adapters
  • Deployment Options
  • Resource Adapter Deployment Names
  • Production Redeployment
    • Suspendable Interface and Production Redeployment
    • Production Redeployment Requirements
    • Production Redeployment Process

A weblogic-ra.xml Schema

• weblogic-connector
• work-manager
• security
  • default-principal-name
  • manage-as-principal-name
  • run-as-principal-name
  • run-work-as-principal-name
• properties
• admin-objects
  • admin-object-group
    • admin-object-instance
• outbound-resource-adapter
  • default-connection-properties
    • pool-params
    • logging
  • connection-definition-group
    • connection-instance

B Resource Adapter Best Practices

• Classloading Optimizations for Resource Adapters
• Connection Optimizations
• Thread Management
• InteractionSpec Interface