Programming the J2EE Connector Architecture

 

 

About This Document

Audience

e-docs Web Site

How to Print the Document

Related Information

Contact Us!

Documentation Conventions

 

Overview of the WebLogic J2EE Connector Architecture

WebLogic Server 6.1 with J2EE 1.2 and J2EE 1.3 Functionality

J2EE Connector Architecture Terminology

Overview of the BEA WebLogic J2EE Connector Architecture Implementation

J2EE Connector Architecture Components

System-level Contracts

Common Client Interface (CCI)

Packaging and Deployment

Black Box Example

 

Configuration

Resource Adapter Developer Tools

ANT Tasks to Create Skeleton Deployment Descriptors

Resource Adapter Deployment Descriptor Editor

XML Editor

Configuring Resource Adapters

Overview of the Resource Adapter

Creating and Modifying Resource Adapters: Main Steps

Creating a New Resource Adapter (.rar)

Modifying an Existing Resource Adapter (.rar)

Automatic Generation of the weblogic-ra.xml File

Configuring the ra-link-ref Element

Packaging Guidelines

Packaging Resource Adapters (.rar)

Configuring the ra.xml File

Configuring the weblogic-ra.xml File

Configuring the weblogic-ra.xml File

Configurable weblogic-ra.xml Entities

Configuring the Security Principal Map

Using the Password Converter Tool

How to Execute

Security Hint

Configuring the Transaction Level Type

 

Writing J2EE Connector Architecture- Compliant Resource Adapters

Connection Management

Security Management

Transaction Management

Packaging and Deployment

Restrictions

Packaging

Deployment

 

Resource Adapter Deployment

Resource Adapter Deployment Overview

Deployment Options

Deployment Descriptor

Resource Adapter Deployment Names

Using the Administration Console

Deploying Resource Adapters Using the Administration Console

Viewing Deployed Resource Adapters Using the Administration Console

Undeploying Deployed Resource Adapters Using the Administration Console

Updating Deployed Resource Adapters Using the Administration Console

Using the Applications Directory

Using weblogic.deploy

Viewing Deployed Resource Adapters Using weblogic.deploy

Undeploying Deployed Resource Adapters Using weblogic.deploy

Updating Deployed Resource Adapters Using weblogic.deploy

Including a Resource Adapter in an Enterprise Application (.ear file)

 

Transaction Management

Supported Transaction Levels

Specifying the Transaction Levels in the .rar Configuration

Transaction Management Contract

 

Security

Container-Managed and Application-Managed Sign-on

Application-Managed Sign-on

Container-Managed Sign-on

Security Principal Map

Using Container-Managed Sign-On

Default Resource Principal

Password Converter Tool

 

Client Considerations

Common Client Interface (CCI)

ConnectionFactory and Connection

Obtaining the ConnectionFactory (Client-JNDI Interaction)

Obtaining a Connection in a Managed Application

Obtaining a Connection in a Non-Managed Application

 

weblogic-ra.xml Deployment Descriptor Elements

Manually Editing XML Deployment Files

Basic Conventions

DOCTYPE Header Information

Document Type Definitions (DTDs) for Validation

Using the Console Deployment Descriptor Editor to Edit Files

weblogic-ra.xml DTD

weblogic-ra. xml Element Hierarchy Diagram

weblogic-ra.xml Element Descriptions

 

Workarounds for Common BEA J2EE Connector Architecture Exceptions

Problem Granting Connection Request to a ManagedConnectionFactory That Does Not Exist in Connection Pool

What Causes This Exception? How Can it Be Resolved?

Cause Number One: Client-modified ManagedConnectionFactory is Not Hashed on the Server Such That It Can Be Found Again on Subsequent Lookups

Preventing the Manifestation of This Exception

Cause Number Two: A Client is Attempting to Use a Resource Adapter from a Remote JVM

Related Behavior: Client-side Mutators Do Not Work as Expected

ClassCastException

Preventing the Manifestation of This Exception

ResourceAllocationException