Developing Applications with WebLogic Server

Overview of WebLogic Server Application Development

Document Scope and Audience

WebLogic Server and the J2EE Platform

Overview of J2EE Applications and Modules

Web Application Modules

Servlets

JavaServer Pages

More Information on Web Application Modules

Enterprise JavaBean Modules

EJB Overview

EJBs and WebLogic Server

Connector Modules

Enterprise Applications

WebLogic Web Services

JMS and JDBC Modules

WebLogic Diagnostic Framework Modules

XML Deployment Descriptors

Automatically Generating Deployment Descriptors

EJBGen

Java-based Command-line Utilities

Upgrading Deployment Descriptors From Previous Releases of J2EE and WebLogic Server

Deployment Plans

Development Software

Apache Ant

Source Code Editor or IDE

Database System and JDBC Driver

Web Browser

Third-Party Software

Using Ant Tasks to Configure and Use a WebLogic Server Domain

Overview of Configuring and Starting Domains Using Ant Tasks

Starting Servers and Creating Domains Using the wlserver Ant Task

Basic Steps for Using wlserver

Sample build.xml Files for wlserver

wlserver Ant Task Reference

Configuring a WebLogic Server Domain Using the wlconfig Ant Task

What the wlconfig Ant Task Does

Basic Steps for Using wlconfig

Sample build.xml Files for wlconfig

Complete Example

Query and Delete Example

Example of Setting Multiple Attribute Values

wlconfig Ant Task Reference

Main Attributes

Nested Elements

Using the libclasspath Ant Task

libclasspath Task Definition

libclasspath Ant Task Reference

Main libclasspath Attributes

Nested libclasspath Elements

Example libclasspath Ant Task

Creating a Split Development Directory Environment

Overview of the Split Development Directory Environment

Source and Build Directories

Deploying from a Split Development Directory

Split Development Directory Ant Tasks

Using the Split Development Directory Structure: Main Steps

Organizing J2EE Components in a Split Development Directory

Source Directory Overview

Enterprise Application Configuration

Web Applications

EJBs

Important Notes Regarding EJB Descriptors

Organizing Shared Classes in a Split Development Directory

Shared Utility Classes

Third-Party Libraries

Class Loading for Shared Classes

Generating a Basic build.xml File Using weblogic.BuildXMLGen

Developing Multiple-EAR Projects Using the Split Development Directory

Organizing Libraries and Classes Shared by Multiple EARs

Linking Multiple build.xml Files

Best Practices for Developing WebLogic Server Applications

Building Applications in a Split Development Directory

Compiling Applications Using wlcompile

Using includes and excludes Properties

wlcompile Ant Task Attributes

Nested javac Options

Setting the Classpath for Compiling Code

Library Element for wlcompile and wlappc

Building Modules and Applications Using wlappc

wlappc Ant Task Attributes

wlappc Ant Task Syntax

Syntax Differences between appc and wlappc

weblogic.appc Reference

weblogic.appc Syntax

weblogic.appc Options

Deploying and Packaging from a Split Development Directory

Deploying Applications Using wldeploy

Packaging Applications Using wlpackage

Archive versus Exploded Archive Directory

wlpackage Ant Task Example

wlpackage Ant Task Attribute Reference

Understanding WebLogic Server Application Classloading

Java Classloader Overview

Java Classloader Hierarchy

Loading a Class

prefer-web-inf-classes Element

Changing Classes in a Running Program

WebLogic Server Application Classloader Overview

Application Classloading

Application Classloader Hierarchy

Custom Module Classloader Hierarchies

Declaring the Classloader Hierarchy

User-Defined Classloader Restrictions

Individual EJB Classloader for Implementation Classes

Application Classloading and Pass-by-Value or Reference

Resolving Class References Between Modules and Applications

About Resource Adapter Classes

Packaging Shared Utility Classes

Manifest Class-Path

Sharing Applications and Modules By Using J2EE Libraries

Adding JARs to the System Classpath

Developing Applications for Production Redeployment

What is Production Redeployment?

Supported and Unsupported Application Types

Programming Requirements and Conventions

Applications Should Be Self-Contained

Versioned Applications Access the Current Version JNDI Tree by Default

Security Providers Must Be Compatible

Applications Must Specify a Version Identifier

Applications Can Access Name and Identifier

Client Applications Use Same Version when Possible

Assigning an Application Version

Application Version Conventions

Upgrading Applications to Use Production Redeployment

Accessing Version Information

Creating Shared J2EE Libraries and Optional Packages

Overview of Shared J2EE Libraries and Optional Packages

Optional Packages

Versioning Support for Libraries

Shared J2EE Libraries and Optional Packages Compared

Additional Information

Creating Shared J2EE Libraries

Assembling Shared J2EE Library Files

Assembling Optional Package Class Files

Editing Manifest Attributes for Shared J2EE Libraries

Packaging Shared J2EE Libraries for Distribution and Deployment

Referencing Shared J2EE Libraries in an Enterprise Application

URIs for Shared J2EE Libraries Deployed As a Standalone Module

Referencing Optional Packages from a J2EE Application or Module

Using weblogic.appmerge to Merge Libraries

Using weblogic.appmerge from the CLI

Using weblogic.appmerge as an Ant Task

Integrating Shared J2EE Libraries with the Split Development Directory Environment

Deploying Shared J2EE Libraries and Dependent Applications

Web Application Shared J2EE Library Information

Accessing Registered Shared J2EE Library Information with LibraryRuntimeMBean

Order of Precedence of Modules When Referencing Shared J2EE Libraries

Best Practices for Using Shared J2EE Libraries

Programming Application Lifecycle Events

Understanding Application Lifecycle Events

Registering Events in weblogic-application.xml

Programming Basic Lifecycle Listener Functionality

Examples of Configuring Lifecycle Events with and without the URI Parameter

Understanding Application Lifecycle Event Behavior During Re-deployment

Programming Context Propagation

Understanding Context Propagation

Programming Context Propagation: Main Steps

Programming Context Propagation in a Client

Programming Context Propagation in an Application

Programming JavaMail with WebLogic Server

Overview of Using JavaMail with WebLogic Server Applications

Understanding JavaMail Configuration Files

Configuring JavaMail for WebLogic Server

Sending Messages with JavaMail

Reading Messages with JavaMail

Threading and Clustering Topics

Using Threads in WebLogic Server

Using the Work Manager API for Lower-Level Threading

Programming Applications for WebLogic Server Clusters

Enterprise Application Deployment Descriptor Elements

weblogic-application.xml Deployment Descriptor Elements

weblogic-application

ejb

max-cache-size

xml

jdbc-connection-pool

security

application-param

classloader-structure

listener

startup

shutdown

work-manager

session-descriptor

library

weblogic-application.xml Schema

application.xml Schema

wldeploy Ant Task Reference

Overview of the wldeploy Ant Task

Basic Steps for Using wldeploy

Sample build.xml Files for wldeploy

wldeploy Ant Task Attribute Reference

Main Attributes

Nested <files> Child Element

Spring Applications Reference

About Spring on WebLogic Server

Redesigning a J2EE-Based Application to a Spring-Based Application

Configure Spring Inversion of Control

Enable the Spring Web Services Client Service

Make JMS Services Available to the Application at Runtime

Configure JMX: Expose the WebLogic Server Runtime MBean Server Connection to Spring