Oracle® XML Developer's Kit Programmer's Guide 10g Release 1 (10.1) Part No. B10794-01 December 2003 Oracle XML Developer's Kit Programmer's Guide, 10g Release 1 (10.1) Part No. B10794-01 Copyright © 2001, 2003 Oracle Corporation. All rights reserved. Primary Author: Jack Melnick Contributing Authors: Mark Bauer, Shelley Higgins, Steve Muench, Mark Scardina, Jinyu Wang Contributors: Sandeepan Banerjee, Sivasankaran Chandrasekar, Dan Chiba, Steve Ding, Stanley Guan, Bill Han, K. Karun, Murali Krishnaprasad, Dmitry Lenkov, Roza Leyderman, Bruce Lowenthal, Ian Macky, Anjana Manian, Meghna Mehta, Valarie Moore, Ravi Murthy, Anguel Novoselsky, Tomas Saulys, Helen Slattery, Asha Tarachandani, Tim Yu, Jim Warner, Simon Wong, Kongyi Zhou The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent and other intellectual and industrial property laws. Reverse engineering, disassembly or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable: Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the Programs. Oracle is a registered trademark, and Express, Oracle Discoverer, Oracle Store, Oracle8, Oracle8i, Oracle9i, PL/SQL, Pro*C/C++, and SQL*Plus are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners. Contents Send Us Your Comments .............................................................................................................. xxiii Preface......................................................................................................................................................... xxv Audience .............................................................................................................................................. xxv Organization....................................................................................................................................... xxvi Related Documentation .................................................................................................................. xxviii Conventions........................................................................................................................................ xxix Documentation Accessibility ......................................................................................................... xxxiv What's New in XDK? ....................................................................................................................... xxxvii Features Introduced in Oracle XML Developer's Kit 10g Release 1 (10.1) ............................. xxxvii 1 Overview of XML Developer's Kit Components Introducing Oracle XML Developer's Kit...................................................................................... 1-1 Overview of Oracle XDK Components ..................................................................................... 1-3 XDK Functionality Applied to XML Documents ......................................................................... 1-4 XML Parsers .................................................................................................................................. 1-5 XSL Transformation (XSLT) Processors .................................................................................... 1-6 JAXB and C++ Class Generators ................................................................................................ 1-6 XML Schema Processor................................................................................................................ 1-7 XDK JavaBeans ............................................................................................................................. 1-7 DOMBuilder........................................................................................................................... 1-7 XSLTransformer..................................................................................................................... 1-7 DBAccess ................................................................................................................................ 1-8 iii XMLDiff .................................................................................................................................. 1-8 XMLCompress ....................................................................................................................... 1-8 XMLDBAccess........................................................................................................................ 1-8 XSDValidator.......................................................................................................................... 1-8 Oracle XML SQL Utility (XSU) for Java .................................................................................... 1-8 XSQL Pages Publishing Framework.......................................................................................... 1-9 TransX Utility ................................................................................................................................ 1-9 Soap Services ................................................................................................................................. 1-9 Using XDK-supported Languages to Generate XML Documents........................................... 1-10 Using XSU for Java to Generate XML Documents................................................................. 1-10 Generating XML from Query Results............................................................................... 1-10 XML Document Structure: Columns Are Mapped to Elements................................... 1-10 XSU Generates the XML Document as a String or DOM Element Tree...................... 1-11 XSU Generates a DTD Based on Queried Table's Schema ............................................ 1-11 Using Oracle XDK Java Components to Generate XML Documents.................................. 1-12 Using Oracle XDK C Components to Generate XML Documents ...................................... 1-14 Using Oracle XDK C++ Components to Generate XML Documents ................................. 1-16 XDK and Application Development Tools .................................................................................. 1-18 Browsers That Support XML..................................................................................................... 1-20 Oracle XML Gateway................................................................................................................. 1-20 Oracle Data Provider for .NET ................................................................................................. 1-20 JDeveloper.................................................................................................................................... 1-21 Business Components for Java (BC4J) ..................................................................................... 1-23 User Interface XML (UIX).......................................................................................................... 1-23 Oracle Reports............................................................................................................................. 1-24 Recommended Books and Web Sites About XML................................................................. 1-24 Using Oracle XML-Enabled Technology...................................................................................... 1-25 Information for Using the XDK ................................................................................................ 1-25 Using Apache Web Server Instead