Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 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

2 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
  • Main Attributes
  • Nested Elements
    • create
    • delete
    • set
    • get
    • query
    • invoke
• Using the libclasspath Ant Task
  • libclasspath Task Definition
  • libclasspath Ant Task Reference
  • Main libclasspath Attributes
  • Nested libclasspath Elements
    • librarydir
    • library
  • Example libclasspath Ant Task

3 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

4 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

5 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

6 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

7 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

8 Understanding WebLogic Server Application Classloading

• Java Classloading
  • Java Classloader Hierarchy
  • Loading a Class
  • prefer-web-inf-classes Element
  • Changing Classes in a Running Program
  • Configuring Class Caching
• 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
    • Nesting Depth
    • Module Types
    • Duplicate Entries
    • Interfaces
    • 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 Domain /lib Directory

9 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

10 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

11 Programming Context Propagation

• Understanding Context Propagation
• Programming Context Propagation: Main Steps
• Programming Context Propagation in a Client
• Programming Context Propagation in an Application

12 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

13 Threading and Clustering Topics

• Using Threads in WebLogic Server
• Using the Work Manager API for Lower-Level Threading
• Programming Applications for WebLogic Server Clusters

A Enterprise Application Deployment Descriptor Elements

• weblogic-application.xml Deployment Descriptor Elements
  • weblogic-application
  • ejb
    • entity-cache
  • max-cache-size
  • xml
    • parser-factory
    • entity-mapping
  • jdbc-connection-pool
    • connection-factory
    • pool-params
    • driver-params
  • security
  • application-param
  • classloader-structure
  • listener
  • singleton-service
  • startup
  • shutdown
  • work-manager
  • session-descriptor
  • library-ref
  • library-context-root-override
  • fast-swap
• weblogic-application.xml Schema
• application.xml Schema

B 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