About This Document
This document introduces the WebLogic J2EE Connector Architecture and describes how to configure and deploy resource adapters to WebLogic Server. The document is organized as follows:
- Overview of the WebLogic J2EE Connector Architecture, provides an overview of the WebLogic J2EE Connector Architecture.
- Security, discusses WebLogic J2EE Connector Architecture security considerations.
- Transaction Management, introduces the various types of transaction levels supported by the WebLogic J2EE Connector Architecture and explains how to specify the transaction levels in the resource adapter .rar archive.
- Connection Management, introduces you to various connection management tasks.
- Configuration, outlines the configuration tasks that you perform to deploy resource adapters to WebLogic Server.
- Writing J2EE Connector Architecture- Compliant Resource Adapters, provides requirements for writing a resource adapter (.rar).
- Resource Adapter Deployment, provides an overview of resource adapters and explains how to configure and deploy them to WebLogic Server.
- Client Considerations, discusses WebLogic J2EE Connector Architecture client considerations.
- weblogic-ra.xml Deployment Descriptor Elements, provides the weblogic-ra.xml DTD and deployment descriptor elements.
- Workarounds for Common BEA J2EE Connector Architecture Exceptions, provides troubleshooting information for two common connector exceptions.
Audience
This document is written for application developers who want to build e-commerce applications using the Java 2 Platform, Enterprise Edition (J2EE) from Sun Microsystems. It is assumed that readers know Web technologies, object-oriented programming techniques, and the Java programming language.
e-docs Web Site
BEA product documentation is available on the BEA corporate Web site. From the BEA Home page, click on Product Documentation.
How to Print the Document
You can print a copy of this document from a Web browser, one main topic at a time, by using the File—>Print option on your Web browser.
A PDF version of this document is available on the WebLogic Server documentation Home page on the e-docs Web site (and also on the documentation CD). You can open the PDF in Adobe Acrobat Reader and print the entire document (or a portion of it) in book format. To access the PDFs, open the WebLogic Server documentation Home page, click Download Documentation, and select the document you want to print.
Adobe Acrobat Reader is available at no charge from the Adobe Web site at http://www.adobe.com.
Related Information
The BEA corporate Web site provides all documentation for WebLogic Server. In particular, refer to the following:
- Javadoc for the BEA WebLogic J2EE Connector Architecture (See the product distribution CD.)
- Weblogic-specific Resource Adapter Document Type Definition (See weblogic-ra.xml Deployment Descriptor Elements.)
- BEA WebLogic Application Integration (See http://download.oracle.com/docs/cd/E13214_01/wlintegration/v2_0/applicationintegration/devel/index.htm.) This document describes how to build a resource adapter.
Also refer to the following documentation from Sun Microsystems:
- J2EE Connector Architecture—http://java.sun.com/j2ee/connector/index.html
- J2EE Connector Specification, Version 1.0, Proposed Final Draft 2—http://java.sun.com/j2ee/download.html#connectorspec
- J2EE Platform Specification, Version 1.3, Proposed Final Draft 3—http://java.sun.com/j2ee
Contact Us!
Your feedback on BEA documentation is important to us. Send us e-mail at docsupport@bea.com if you have questions or comments. Your comments will be reviewed directly by the BEA professionals who create and update the documentation.
In your e-mail message, please indicate the software name and version you are using, as well as the title and document date of your documentation. If you have any questions about this version of BEA WebLogic Server, or if you have problems installing and running BEA WebLogic Server, contact BEA Customer Support through BEA WebSupport at http://www.bea.com. You can also contact Customer Support by using the contact information provided on the Customer Support Card, which is included in the product package.
When contacting Customer Support, be prepared to provide the following information:
- Your name, e-mail address, phone number, and fax number
- Your company name and company address
- Your machine type and authorization codes
- The name and version of the product you are using
- A description of the problem and the content of pertinent error messages
Documentation Conventions
The following documentation conventions are used throughout this document.
Convention
|
Usage
|
Ctrl+Tab
|
Keys you press simultaneously.
|
italics
|
Emphasis and book titles.
|
monospace text
|
Code samples, commands and their options, Java classes, data types, directories, and file names and their extensions. Monospace text also indicates text that you enter from the keyboard.
Examples:
import java.util.Enumeration;
chmod u+w *
config/examples/applications
.java
config.xml
float
|
monospace italic text
|
Variables in code.
Example:
String CustomerName;
|
UPPERCASE TEXT
|
Device names, environment variables, and logical operators.
Examples:
LPT1
BEA_HOME
OR
|
{ }
|
A set of choices in a syntax line.
|
[ ]
|
Optional items in a syntax line. Example:
java utils.MulticastTest -n name -a address
[-p portnumber] [-t timeout] [-s send]
|
|
|
Separates mutually exclusive choices in a syntax line. Example:
java weblogic.deploy [list|deploy|undeploy|update]
password {application} {source}
|
...
|
Indicates one of the following in a command line:
- An argument can be repeated several times in the command line.
- The statement omits additional optional arguments.
- You can enter additional parameters, values, or other information
|
. . .
|
Indicates the omission of items from a code example or from a syntax line.
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.
|