Java Web Services Developer Pack 1.6
Supported Platforms
What's New in Java WSDP 1.6?
Redistributable Components
Nonredistributable Components
Environment Variables
Using Ant That Comes with Java WSDP on Linux
Uninstalling Java WSDP 1.6
Known IssuesThe JavaTM Web Services Developer Pack (Java WSDP) is an all-in-one download containing key technologies to simplify building of web services using the Java 2 Platform. For release notes for these technologies see:
Updated, online versions of the release notes are available here.
This release of the Java WSDP has been tested in various configurations with J2SE 1.4.2 and J2SE 5.0 on the following platforms:
- SolarisTM 9 Operating System
- Windows 2003 Server Professional Edition
- Windows XP Professional Edition
- RedHat Linux 9.0
- Fast Infoset 1.0 FCS acceleration technology built on ASN.1 standards
- Service Registry early access release for SOA web services, built on ebXML 3.0 Registry with full UDDI 3.0 support
- XML Web Services Security 2.0 early access
- Sun Java Streaming XML Parser 1.0 FCS release, a high performance implementation of JSR 173
- JAXP 1.3.1 FCS release
- XML Digital Signatures 1.0 FCS release
- Bug fixes, refreshed core components (JAX-RPC, JAXB, JAXR, and more)
Redistribution of the entire Java WSDP is subject to this license.
The following Java WSDP components are individually redistributable. Redistribution of a component entails the redistribution of all files comprising the component and any dependent components.
Redistributable Component Files JAXP jaxp-api.jar,dom.jar,sax.jar,xalan.jar,xercesImpl.jarJAXB [1] JAXB JAR files ( jaxb-api.jar,jaxb-impl.jar,jaxb-libs.jar,jaxb-xjc.jar), JAXP 1.1 or higher JAR files (jaxp-api.jar,sax.jar,dom.jar,xalan.jar), JWSDP Shared JAR files (jax-qname.jar,namespace.jar,xsdlib.jar,relaxngDataype.jar)JAX-RPC jaxrpc-api.jar,jaxrpc-impl.jar,jaxrpc-spi.jar,relaxngDatatype.jar,xsdlib.jar, JAXP, SAAJ,jcert.jar,jnet.jar,jsse.jar,FastInfoset.jar,jsr173_api.jarSAAJ saaj-api.jar,saaj-impl.jar,jaxp-api.jar,dom.jar,sax.jar,xalan.jar,xercesImpl.jar,activation.jar,mail.jar,servlet.jar,FastInfoset.jar,jsr173_api.jarJAXR jaxr-api.jar,jaxr-impl.jar,jaxb-api.jar,jaxb-impl.jar,jaxb-libs.jar,saaj-api.jar,saaj-impl.jar,jaxp-api.jar,dom.jar,sax.jar,xercesImpl.jar,activation.jar,jaas.jar,mail.jar,namespace.jar,relaxngDatatype.jar,xsdlib.jarSun Java Streaming XML Parser sjsxp.jar,jsr173_api.jarXML Digital Signature[2] xmldsig.jar,xmlsec.jarFast Infoset FastInfoset.jar,dom.jar,sax.jar,jsr173_api.jar[1] If the application will not be doing any compilation at runtime, the jaxb-xjc.jarfile does not need to be redistributed with the application.[2] If the application is to be used with J2SE 1.4.2, the dom.jar,xercesImpl.jar,xalan.jar,sax.jar, andjaxp-api.jarfiles need to be redistributed with the application.Click here to check for any changes.
The following Java WSDP components are not redistributable. These components can be used for designing, developing, and testing purposes only.
Nonredistributable Component Files Service Registry all Java XML & Web Services Security all JSTL all WS-I Sample Application all Click here to check for any changes.
In J2SE SDK 1.4, JAXP 1.2 is included in the
rt.jarfile. Unless the "java.endorsed.dirs" mechanism is used to override the JAXP APIs in thert.jarfile with thejaxp-api.jarfile from Java WSDP 1.6, the JAXP 1.2 APIs from J2SE SDK 1.4 will be used. These APIs are incompatible with the JAXP 1.3 implementation classes and, if they are used in this situation, an exception will be thrown.The "java.endorsed.dirs" property must be set to include both the
JAXP_HOME/libdirectory, which contains thejaxp-api.jarfile and theJAXP_HOME/lib/endorsed directory, which contains the implementation JAR files. Although only the JAXP API JAR file is really needed with J2SE SDK 1.4, the same "java.endorsed.dirs" property setting can be used for both J2SE 5.0, where you do need to override the JAXP 1.3 implementation classes, and J2SE SDK 1.4.
If you are using Java WSDP 1.6 with J2SE 5.0, you should be using the JAXP 1.3.1 JAR files from JWSDP 1.6, not the JAXP 1.3 JAR files from J2SE 5.0. Since the JAXP classes have been renamed to "com.sun..." in both JDK 5 and Java WSDP 1.6, we need to override the built-in classes. The APIs are the same (both are version 1.3) but version 1.3.1 implementation classes that ship with Java WSDP 1.6 include some bug fixes that are not included in the version 1.3 implementation classes that ship with J2SE 5.0.
On Linux systems, even if you set your ANT_HOME and PATH environment variables to point to the version of Ant that is installed with the Java WSDP 1.6, when you run the Java WSDP's Ant scripts, your system will look in the
/etc/ant.confconfiguration file and execute the version of Ant that is configured there. In this case, the default entry is/usr/share/ant. If you want to use the version of ANT that is shipped with Java WSDP, comment out the line that configures Ant in the/etc/ant.confconfiguration file and your ANT_HOME and PATH environment variable settings will be used.
The Service Registry software is not supported on Sun Java System Web Server 6.1. If you want to try out the Service Registry software, please use one of the other containers (Sun Java System Application Server 8.1 or Tomcat for Java WSDP).
Fast Infoset is turned off (content negotiation is set to none) by default in Java WSDP 1.6. See the Fast Infoset User's Manual for information about turning on content negotiation.
The
JAVA_HOMEenvironment variable is set to point to the version of the J2SE SDK you specify during installation. If you change your J2SE SDK installation, you will need to edit your<JWSDP_HOME>\jwsdp-shared\bin\setenv.batbatch file or<JWSDP_HOME>/jwsdp-shared/bin/setenv.shand reset theJAVA_HOMEenvironment variable.All other custom system properties can be set in the file
<JWSDP_HOME>/conf/jwsdp.propertiesas follows:http.proxyHost=webcache http.proxyPort=8080You can override any of the properties in your file
<JWSDP_HOME>/conf/jwsdp.propertiesby using the-D...argument to any of the start scripts. For example,Unix:
catalina.sh -Dhttp.proxyHost=webcache -Dhttp.proxyPort=8080Microsoft Windows:
catalina -Dhttp.proxyHost=webcache -Dhttp.proxyPort=8080
If you are running a console installation with J2SE 5.0, the installation will exit if the DISPLAY variable hasn't been set. Make sure that you set the DISPLAY variable before you start the console installation.
At some point, you may need to uninstall Java WSDP 1.6:
- On Microsoft Windows, select Start --> Programs --> Java(TM) Web Services Developer Pack 1.6 --> Uninstall.
- On Solaris and Linux, run the
<JWSDP_HOME>/uninstall.shscript.If you ran one of the integration scripts after you installed the Java WSDP, you must rerun the script using the
revert.<container>.changestarget before you uninstall the Java WSDP.
Click here to display an up-to-date list of known problems with this release of the Java Web Services Developer Pack.
Please send feedback on the Java Web Services Developer Pack to users@jwsdp.dev.java.net.
Copyright © 2005 Sun Microsystems, Inc. All rights reserved.