2 Getting Started with XDK Java Components

XDK Java Components Specifications

XDK Java components, release 10.1, are built on these specifications:

• XML 1.0 (Second Edition)

• DOM Level 2.0 Specifications

  • DOM Level 2.0 Core

  • DOM Level 2.0 Traversal and Range

  • DOM Level 2.0 Events

• DOM Level 3.0 Specifications

  • DOM Level 3.0 Load and Save (internal draft version 10 October 2003)

  • DOM Level 3.0 Validation (Candidate Recommendation 30 July 2003)

• SAX 2.0 and SAX Extensions

• XSLT/XPath 2.0 Specifications

  • XSL Transformations (XSLT) 2.0 (working draft dated 02 May 2003)

  • XML Path Language (XPath) 2.0 (working draft dated 22 August 2003)

  • XPath 2.0 Data Model (working draft dated 11th November 2002)

• XML Schema Specifications

  • XML Schema Part 0: Primer

  • XML Schema Part 1: Structures

  • XML Schema Part 2: Datatypes

• XML Pipeline Definition Language 1.0

• Java API for XML Processing 1.1 and 1.2 (JAXP)

• Java Architecture for XML Binding 1.0 (JAXB)

Installing XDK Java Components

XDK Java components are included with the Oracle database and with the Oracle application server. You can download the latest beta or production version of XDK Java components from OTN as part of the XDK. The XDK Java components and JavaBeans are now bundled together.

If you installed XDK with the Oracle database or the Oracle application server, you can use this chapter as a reference.

If you download the XDK from OTN, follow these steps:

• Go to the URL:

  http://www.oracle.com/technology/tech/xml/xdk/content.html
  
  

• Click the Software link on the right-side of the page.

• Logon with your OTN username and password (registration is free if you do not already have an account).

• Select the Windows or UNIX download.

• Select the appropriate download for your operating system.

• Accept all terms of the licensing agreement and then download the software by clicking the appropriate distribution.

• Extract the files in the distribution:

  • Choose a directory under which you want the ./xdk directory and subdirectories to go.

  • Change to that directory and then extract the XDK Java components download archive file. For UNIX:

    tar xvfz xdk_XXXX.tar.gz       # UNIX. XXXX is the release name
    Use WinZip visual archive extraction tool in Windows
    

XDK Java Components Directory Structure

After installing the XDK, the directory structure is:

-$XDK_HOME
    | - bin: executable files and setup script or batch files.
    | - lib: library files.
    | - xdk:
         | - admin: (Administration): SQL script and XSL Servlet Configuration
                     file (XSQLConfig.xml).
         | - demo/java: demonstration code 
         | - doc/java: documents including release notes and Javadoc HTML.

All the XDK Java components are certified and supported with JDK 1.2, JDK 1.3, and JDK 1.4. Make sure that your CLASSPATH includes all the necessary libraries:

In addition, XML SQL Utility, XSQL Servlet, and TransX Utility all depend on JDBC and globalization support libraries, which are listed in Table 2-2:

XDK Java Components Environment Settings

The UNIX and Windows environment settings are listed:

XDK Java Components Globalization Support

Here is a summary on the settings that relate to Globalization Support:

• Using xmlmesg.jar: If you are using a language other than English you need to set the xmlmesg.jar into your CLASSPATH to let the parser get correct messages in your language.

• Using orai18n.jar: If you are using a multibyte character set other than one of the following,

  • UTF-8

  • ISO8859-1

  • JA16SJIS

  then you must set this JAR file into your Java CLASSPATH so that JDBC can convert the character set of the input file to the database character set during the loading of XML files using either XSU, TransX or XSQL Servlet.

XDK Java Components Dependencies

Figure 2-1 shows the dependencies of XDK Java Components when using JDK 1.2 and higher:

Figure 2-1 XDK Java Components Dependencies Using JDK 1.2.x and Higher

Description of the illustration adxdk110.gif

After you correctly setup the environment, include all the necessary JAR files in your CLASSPATH. You can then start writing your Java programs and compiling them with the javac command:

javac your_program.java

If the compilation finishes without errors, then you can just test your program using the command line or the Web Server.

Verifying the XDK Java Components Version

To obtain the version of XDK you are working with, compile and run the following Java code (XDKVersion.java):

import java.net.URL;
import oracle.xml.parser.v2.XMLParser;
public class XDKVersion
{
   static public void main(String[] argv)
   {
      System.out.println("You are using version: ");
      System.out.println(XMLParser.getReleaseVersion());
   }

}