Java Web Services Developer Pack 1.5

JavaTM Web Services Developer Pack 1.5 Release Notes

Contents

Supported Platforms
What's New in Java WSDP 1.5?
Redistributable Components
Nonredistributable Components
Environment Variables
Using Ant That Comes with Java WSDP on Linux
Uninstalling Java WSDP 1.5
Known Issues

The 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:

Supported Platforms and Containers

This release of the Java WSDP has been tested in various configurations with J2SE 1.4.2 SDK and J2SE 5.0 JDK on the following platforms:

Java WSDP v1.5 supports the following containers:

Download the above containers from here.

What's New in Java WSDP 1.5?

Redistributable Components

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.jar
JAXB * 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, jax-qname.jar, xsdlib.jar, relaxngDatatype.jar, JAXP, SAAJ
SAAJ saaj-api.jar, saaj-impl.jar, jaxp-api.jar, dom.jar, sax.jar, xalan.jar, xercesImpl.jar, activation.jar, mail.jar
JAXR 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.jar
Java XML & Web Services Security all
*  If the application will not be doing any compilation at runtime, the jaxb-xjc.jar file does not need to be redistributed with the application.

Nonredistributable Components

The following Java WSDP components are not redistributable. These components can be used for designing, developing, and testing purposes only.

Nonredistributable Component Files
Registry Server registry-server.war, xindice.jar
Sun Java Streaming XML Parser all
XML Digital Signature all
JSTL all
WS-I Sample Application all

Using Ant That Comes with Java WSDP on Linux

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.5, when you run the Java WSDP's Ant scripts, your system will look in the /etc/ant.conf configuration 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.conf configuration file and your ANT_HOME and PATH environment variable settings will be used.

Environment Variables

The JAVA_HOME environment 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.bat batch file or <JWSDP_HOME>/jwsdp-shared/bin/setenv.sh and reset the JAVA_HOME environment variable.

All other custom system properties can be set in the file <JWSDP_HOME>/conf/jwsdp.properties as follows:

http.proxyHost=webcache 
http.proxyPort=8080

If you are using Tomcat 5.0 for Java WSDP, you can override any of the properties in your file <JWSDP_HOME>/conf/jwsdp.properties by using the -D... argument to any of the start scripts. For example,

Unix: catalina.sh -Dhttp.proxyHost=webcache -Dhttp.proxyPort=8080

Microsoft Windows: catalina -Dhttp.proxyHost=webcache -Dhttp.proxyPort=8080

You can make these modifications to <JWSDP_HOME>/conf/sjsas.properties if you are using the Application Server or <JWSDP_HOME>/conf/sjsws.properties if you are using the Web Server.

J2SE Version Determines Which Version of JAXP Is Used

J2SE 5.0 JDK includes JAXP v1.3. Java WSDP v1.5 includes JAXP v1.2.6_01. If you are running J2SE 5.0 JDK, JAXP 1.3 will be used. Java WSDP 1.5 will not replace that version of the JAXP technology with an older version. If you are running J2SE 1.4.2 SDK, JAXP version 1.2.6_01 will be used.

Uninstalling Java WSDP 1.5

At some point, you may need to uninstall Java WSDP 1.5:

If you ran one of the integration scripts after you installed the Java WSDP, you must rerun the script using the revert.<container>.changes target before you uninstall the Java WSDP.

Known Issues

Dynamic Proxy Support from XML and Web Services Security

XML and Web Services Security v1.0 does not support JAX-RPC dynamic proxies. Static stubs, however, are supported.

Sun Java System Application Server Version Support

Java WSDP 1.5 has been tested with and works with Sun Java System Application Server Platform Edition 8.0 Update 1 (also known as version 8.0.0_01). It must not be used with Sun Java System Application Server Platform Edition 8.1 Q42004. The version of XML and Web Services Security that is included in Java WSDP v1.5 does not work with the 8.1 Q42004 version of the Application Server.

Web Server Throws Exception During Deployment/Undeployment

The Sun Java System Web Server 6.1 may throw an exception when a Web application is being deployed or undeployed. These exceptions, noted in BugID 5042463, can be ignored.

Naming Exception After Installing Java WSDP onto the Web Server

The Sun Java System Web Server 6.1 may throw a naming exception, noted in BugID 5045245. This exception can also be ignored.

 


Please send feedback on the Java Web Services Developer Pack to users@jwsdp.dev.java.net.

Copyright 2004 Sun Microsystems, Inc. All rights reserved.