Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction and Roadmap

• Document Scope and Audience
• Guide to This Document
• Related Documentation
• Samples for the XML Developer
  • XML Examples in the WebLogic Server Distribution
• New and Changed XML Features in This Release
• Summary of WebLogic Server XML Features
  • XML Document Parsers
    • Difference In Default Parsers Between Versions 8.1 and 9.1 of WebLogic Server
  • XML Document Transformer
  • Streaming API for XML (StAX) Implementation
  • WebLogic XPath API
  • JAXP Pluggability Layer Implementation
  • Java API for XML Registries Implementation
  • WebLogic Servlet Attributes
  • WebLogic XSLT JSP Tag Library
  • XML Registry For Configuring Parsers and Transformers
  • XML Registry for Configuring External Entity Resolution
• Endorsed Standards Override Mechanism for DOM/SAX: Not Supported
• Learning More About XML

2 XML Overview

• What Is XML?
• How Do You Describe an XML Document?
• Why Use XML?
• What Are XSL and XSLT?
• What Are DOM and SAX?
  • SAX
  • DOM
• What Is the Streaming API for XML (StAX)?
• What Is JAXP?
  • JAXP Packages
  • New Feature of JAXP 1.2
• Common Uses of XML and XSLT
  • Using XML and XSLT to Separate Content from Presentation
  • XML as a Message Format for Business-to-Business Communication

3 Developing XML Applications with WebLogic Server

• Developing XML Applications: Main Steps
• Parsing XML Documents
  • Parsing XML Documents Using JAXP in SAX Mode
  • Parsing XML Documents Using JAXP in DOM Mode
  • Parsing XML Documents in a Servlet
  • Using the org.xml.sax.DefaultHandler Attribute to Parse a Document
  • Using the org.w3c.dom.Document Attribute to Parse a Document
  • Validating and Non-Validating Parsers
  • Handling Entity Resolution While Parsing an XML Document
  • General Information About External Entities
  • Using the WebLogic Server Entity Resolution Features
  • Using Parsers Other Than the Default
• Generating New XML Documents
  • Generating XML from a DOM Document Tree
  • Generating XML Documents in a JSP
• Transforming XML Documents
  • Using JAXP to Transform XML Data
  • Example of Transforming an XML Document Using JAXP
  • Using the JSP Tag to Transform XML Data
  • XSLT JSP Tag Syntax
  • XSLT JSP Tag Usage
  • Transforming XML Documents Using an XSLT JSP Tag
  • Example of Using the XSLT JSP Tag in a JSP
  • Using Transformers Other Than the Default Transformer

4 Using the Streaming API for XML (StAX)

• Overview of the Streaming API for XML
  • Description of the Cursor API
  • The XMLStreamReader Interface
  • The XMLStreamWriter Interface
  • Description of the Event Iterator API
  • Main Interfaces and Classes of StAX
• Parsing XML With the XMLStreamReader Interface: Typical Steps
  • Example of Parsing XML Using StAX
  • Getting the XMLStreamReader Object
  • Determining the Specific XML Event Type
  • Getting the Full Name of an Element
  • Getting the Attributes of an Element
  • Getting the Namespaces of an Element
  • Getting Text Data
  • Getting Location Information
  • Closing the Input Stream
• Generating XML Using the XMLStreamWriter Interface: Typical Steps
  • Example of Generating XML Using StAX
  • Getting the XMLStreamWriter Object
  • Adding the XML Declaration to the Output Stream
  • Adding Standard XML Events to the Output Stream
  • Adding Attributes and Namespace Declarations to a Start Element
  • Closing the Output Stream
• Properties Defined for the XMLInputFactory Interface
• Properties Defined for the XMLOutputFactory Interface

5 Using Advanced XML APIs

• Using the Java API for XML Registries (JAXR) API
• Using the WebLogic XPath API
  • Using the DOMXPath Class
  • Example of Using the DOMXPath Class
  • Main Steps When Using the DOMXPath Class
  • Using the StreamXPath Class
  • Example of Using the StreamXPath Class
  • Main Steps When Using the StreamXPath Class

6 XML Programming Best Practices

• When to Use the DOM, SAX, and StAX APIs
• Increasing Performance of XML Validation
• When to Use XML Schemas or DTDs
• Configuring External Entity Resolution for Maximum Performance
• Using SAX InputSources
• Improving Performance of Transformations

7 XML Programming Techniques

• Transmitting XML Data Between A Java Client and WebLogic Server
• Handling XML Documents in a JMS Application
• Accessing External Entities That Do Not Have an HTTP Interface

8 XML Application Scoping

• Overview of Application Scoping
• The weblogic-application.xml File
  • xml
  • parser-factory
  • saxparser-factory
  • document-builder-factory
  • transformer-factory
  • entity-mapping
  • entity-mapping-name
  • public-id
  • system-id
  • entity-uri
  • when-to-cache
  • cache-timeout-interval
• Configuring a Parser or Transformer for an Enterprise Application
• Configuring an External Entity for an Enterprise Application
• Configuring the External Entity Cache for an Enterprise Application

9 Administering WebLogic Server XML

• Overview of Administering WebLogic Server XML
  • XML Administration Tasks
  • How the XML Registry Works
  • Parser Selection Within the XML Registry
• XML Parser and Transformer Configuration Tasks
  • Configuring a Parser or Transformer Other Than the Default
  • Configuring a Parser for a Particular Document Type
• External Entity Configuration Tasks
  • Configuring External Entity Resolution
  • Configuring the External Entity Cache

A XML Reference

• XML APIs
• Code Examples
• Related WebLogic Server Documentation
• Tutorials and Online Courses
• Other XML Specifications and Information

B Using the WebLogic XML Streaming API (Deprecated)

• Overview of the WebLogic XML Streaming API
• Javadocs for the WebLogic XML Streaming API
• Parsing an XML Document: Typical Steps
  • Example of Parsing an XML Document
  • Getting an XML Input Stream
  • Getting a Buffered XML Input Stream
  • Filtering the XML Stream
  • Creating a Custom Filter
  • Iterating Over the Stream
  • Determining the Specific XMLEvent Type
  • Getting the Attributes of an Element
  • Positioning the Stream
  • Getting a Substream
  • Marking and Resetting a Buffered XML Input Stream
  • Closing the Input Stream
• Generating a New XML Document: Typical Steps
  • Example of Generating an XML Document
  • Creating an XML Output Stream
  • Adding Elements to the Output Stream
  • Adding Attributes to an Element on the Output Stream
  • Adding an Input Stream to an Output Stream
  • Printing an Output Stream
  • Closing the Output Stream