To check if any of the information in this file has been updated, see the online version.
Redistribution of the entire Java XML Pack is subject to this license.
The following Java XML Pack components are individually redistributable. Redistribution of a component entails the redistribution of
all files comprising the component and any dependent components.
Redistributable Components
Component | Files |
---|---|
JAXP | jaxp-api.jar, dom.jar, sax.jar, xalan.jar, xercesImpl.jar, xsltc.jar |
SAAJ | saaj-api.jar, saaj-ri.jar, activation.jar, commons-logging.jar, dom4j.jar, mail.jar, JAXP |
JAXM | jaxm-api.jar, jaxm-provider, jaxm-provideradmin, jaxm-runtime.jar, SAAJ, JAXP |
JAXR | jaxr-api.jar, jaxr-ri.jar, soap.jar, castor-0.9.3.9-xml.jar, fscontext.jar, jaas.jar, jcert.jar, jnet.jar, jsse.jar, providerutil.jar, SAAJ, JAXP |
JAX-RPC | jaxrpc-api.jar, jaxrpc-ri.jar, SAAJ, JAXP |
To use the Java XML Pack technologies, you need to set the home directory for each technology as follows:
JAVA_XML_PACK_HOME
to the directory where the java xml
pack has been installed.
JAXM_HOME
to <JAVA_XML_PACK_INSTALL>/java_xml_pack-summer-02_01/jaxm-1.1_01
JAXP_HOME
to <JAVA_XML_PACK_INSTALL>/java_xml_pack-summer-02_01/jaxp-1.2_01
JAXR_HOME
to <JAVA_XML_PACK_INSTALL>/java_xml_pack-ummer-02_01/jaxr-1.0_02
JAXRPC_HOME
to <JAVA_XML_PACK_INSTALL>/java_xml_pack-ummer-02_01/jaxrpc-1.0_01
<JAVA_XML_PACK_INSTALL>
is the directory where the Java XML Pack bundle was unpacked.
To build and run the examples, you will also need to set environment variables described in the next section.
To use the Java XML Pack technologies, you need a version of the Java 2 Platform, Standard Edition (J2SETM). To download J2SE:
To build some of the examples, you need the
This will create the directory To run some of the examples, you need the Tomcat 4.0.3 servlet engine. To install Tomcat 4.0.3:
This will create the directory At this release, the components of the Java XML Pack support the Jakarta
Commons Logging API. The following levels are available, in ascending order of
granularity:
You can change the default level of logging for Tomcat. For example, to
change the default level to Unix: Microsoft Windows: On UNIX systems, logging output appears in the file On Microsoft Windows systems, logging output appears in the Tomcat window.
The default logger, For more information about configuring logging, see the Jakarta Commons Logging API
documentation. In particular, refer to the
Package Description.
Building and Running the Examples
JAVA_HOME
to the location of your J2SE installation.
ant 1.4.1
build tool. To install ant 1.4.1
:
http://jakarta.apache.org/builds/jakarta-ant/release/v1.4.1/bin
jakarta-ant-1.4.1-bin.zip
and use the window that appears to indicate where you want the download to go.
jakarta-ant-1.4.1-bin.zip
. At the command line, type the following:
unzip jakarta-ant-1.4.1-bin.zip
jakarta-ant-1.4.1
containing all the unzipped files. You can delete the zip file once you have unzipped it.
ANT_HOME
to the location of your ant installation.
Note: When you run the examples on Tomcat you must copy
all the JAR files from the Java XML Pack to http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.0.3/bin
jakarta-tomcat-4.0.3.zip
and use the window that appears to indicate where you want the download to go.
jakarta-tomcat-4.0.3.zip
. At the command line, type the following:
unzip jakarta-tomcat-4.0.3.zip
jakarta-tomcat-4.0.3
containing all the unzipped files. You can delete the zip file once you have unzipped it.
CATALINA_HOME
to the location of your Tomcat installation.CATALINA_HOME/common/lib
.
Some of these files already exist in Tomcat distribution and should be
overwritten by the Java XML Pack JARs. The xerces.jar that comes with the
tomcat installation should also be removed from
CATALINA_HOME/common/lib
.
Modifying the Default Logging Level
fatal
error
warn
info
debug
trace
debug
, specify the following options
(all on one line) in the CATALINA_OPTS
environment variable
definition. On Unix, you can use the "\" line continuation character in shell
scripts to spread this over more than one physical line.
export CATALINA_OPTS="-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
-Dorg.apache.commons.logging.simplelog.defaultlog=debug"
set CATALINA_OPTS=-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
-Dorg.apache.commons.logging.simplelog.defaultlog=debug
TOMCAT_HOME/logs/catalina.out
.
SimpleLog
, assumes that logger names are hierarchical.
To set a default log level for all the technologies with package names beginning with com.sun.xml, you can say:
-Dorg.apache.commons.logging.log.com.sun.xml=info