Programming WebLogic Resource Adapters
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
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
J2EE Connector Architecture
J2EE Architecture Diagram and Components
System-Level Contracts
Resource Adapter Deployment Descriptors
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
Conforming Deployment Descriptor Files to Schema
Dynamic Descriptor Updates: Console Configuration Tabs
Automatic Generation of the weblogic-ra.xml File
(Deprecated) Configuring the Link-Ref Mechanism
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
Connection Management
Connection Management Contract
Connection Factory and Connection
Resource Adapters Bound in JNDI Tree
Obtaining the ConnectionFactory (Client-JNDI Interaction)
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
Testing Connections
Configuring Connection Testing
Testing Connections in the Administration Console
Transaction Management
Supported Transaction Levels
XA Transaction Support
Local Transaction Support
No Transaction Support
Configuring Transaction Levels
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
Security
Container-Managed and Application-Managed Sign-on
Application-Managed Sign-on
Container-Managed Sign-on
Password credential mapping
Authentication Mechanisms
credential mappings
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
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
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
outbound-resource-adapter
default-connection-properties
connection-definition-group
Resource Adapter Best Practices
Classloading Optimizations for Resource Adapters
Connection Optimizations
Thread Management
InteractionSpec Interface
|