Developing Applications with WebLogic Server

Overview of WebLogic Server Application Development

Document Scope and Audience

WebLogic Server and the Java EE Platform

Overview of Java EE 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

Java EE Programming Model

Packaging and Deployment Overview

WebLogic Web Services

JMS and JDBC Modules

WebLogic Diagnostic Framework Modules

Using an External Diagnostics Descriptor

Defining an External Diagnostics Descriptor

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

Using A Third-Party Version of Ant

Changing the Ant Heap Size

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

wlconfig Ant Task Reference

Using the libclasspath Ant Task

libclasspath Task Definition

libclasspath Ant Task Reference

Main libclasspath Attributes

Nested libclasspath Elements

librarydir

library

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 Java EE 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

weblogic.BuildXMLGen Syntax

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

Developing Applications for Production Redeployment

What is Production Redeployment?

Supported and Unsupported Application Types

Additional Application Support

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

Using Java EE Annotations and Dependency Injection

Annotation Processing

Annotation Parsing

Deployment View of Annotation Configuration

Compiling Annotated Classes

Dynamic Annotation Updates

Dependency Injection of Resources

Application Life-Cycle Annotation Methods

Standard JDK Annotations

javax.annotation.PostConstruct

javax.annotation.PreDestroy

javax.annotation.Resource

javax.annotation.Resources

Standard Security-Related JDK Annotations

javax.annotation.security.DeclareRoles

javax.annotation.security.DenyAll

javax.annotation.security.PermitAll

javax.annotation.security.RolesAllowed

javax.annotation.security.RunAs

Understanding WebLogic Server Application Classloading

Java Classloading

Java Classloader Hierarchy

Loading a Class

prefer-web-inf-classes Element

Changing Classes in a Running Program

WebLogic Server Application Classloading

Overview of WebLogic Server Application Classloading

Application Classloader Hierarchy

Custom Module Classloader Hierarchies

Declaring the Classloader Hierarchy

User-Defined Classloader Restrictions

Servlet Reloading Disabled

Call-by-Value Semantics

In-Flight Work

Development Use Only

Individual EJB Classloader for Implementation Classes

Application Classloading and Pass-by-Value or Reference

Using a Filtering Classloader

What is a Filtering ClassLoader

Configuring a FilteringClassLoader

Resource Loading Order

Resolving Class References Between Modules and Applications

About Resource Adapter Classes

Packaging Shared Utility Classes

Manifest Class-Path

Sharing Applications and Modules By Using Java EE Libraries

Adding JARs to the System Classpath

Creating Shared Java EE Libraries and Optional Packages

Overview of Shared Java EE Libraries and Optional Packages

Optional Packages

Library Directories

Versioning Support for Libraries

Shared Java EE Libraries and Optional Packages Compared

Additional Information

Creating Shared Java EE Libraries

Assembling Shared Java EE Library Files

Assembling Optional Package Class Files

Editing Manifest Attributes for Shared Java EE Libraries

Packaging Shared Java EE Libraries for Distribution and Deployment

Referencing Shared Java EE Libraries in an Enterprise Application

Overriding context-roots Within a Referenced Enterprise Library

URIs for Shared Java EE Libraries Deployed As a Standalone Module

Referencing Optional Packages from a Java EE Application or Module

Using weblogic.appmerge to Merge Libraries

Using weblogic.appmerge from the CLI

Using weblogic.appmerge as an Ant Task

Integrating Shared Java EE Libraries with the Split Development Directory Environment

Deploying Shared Java EE Libraries and Dependent Applications

Web Application Shared Java EE Library Information

Using WebApp Libraries With Web Applications

Accessing Registered Shared Java EE Library Information with LibraryRuntimeMBean

Order of Precedence of Modules When Referencing Shared Java EE Libraries

Best Practices for Using Shared Java EE Libraries

Programming Application Life Cycle Events

Understanding Application Life Cycle Events

Registering Events in weblogic-application.xml

Programming Basic Life Cycle Listener Functionality

Configuring a Role-Based Application Life Cycle Listener

Examples of Configuring Life Cycle Events with and without the URI Parameter

Understanding Application Life Cycle Event Behavior During Re-deployment

Programming Application Version Life Cycle Events

Understanding Application Version Life Cycle Event Behavior

Types of Application Version Life Cycle Events

Example of Production Deployment Sequence When Using Application Version Life Cycle Events

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

classloader-structure

library-context-root-override

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

Support for Spring on WebLogic Server

Demonstrating 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

Configure Spring JDBC to Communicate With the Connection Pool

Use the Spring Transaction Abstraction Layer for Transaction Management

Make Use of WebLogic Server Clustering

Clustered Spring Remoting