Novell exteNd Web Services SDK 5.0

README

Contents

Introduction

The Novell exteNd Web Services SDK (formerly jBroker Web) is a toolkit for developing Web Service client and server applications. The SDK contains compilers and tools for building Web Services, and a runtime for executing and testing Web Services. The Novell exteNd WSSDK is a 100% pure Java implementation, which supports standards such as SOAP, WSDL, JAX-RPC, SAAJ and WS-I Basic Profile 1.0. The Novell exteNd WSSDK brings the familiar programming model of Java RMI to the Web Services world.

The Novell exteNd WSSDK compilers provide support for both application programmers who are developing client programs that need to access existing Web Services, as well as application programmers who are developing server programs that implement those Web Services. The compilers generate stubs and skeletons as an abstraction over the underlying protocols, which means that developers are not exposed to the mechanisms of the transport layer.

In addition to standards-based mapping between basic Java and XML data types, the Novell exteNd WSSDK also supports an XML schema compiler, which generates Java classes for commonly encountered schema types. Data binding not only provides a familiar programming model, it also shields application developers from the details of how Java types are represented as XML on the wire.

The Novell exteNd WSSDK currently supports SOAP header parameters that are in either the input or output message of the operation (in the WSDL description of the Web Service), and the following styles of Web Services:

The Novell exteNd WSSDK is based on a flexible and dynamic architecture, which allows multiple transports, implementation styles and security mechanisms to be supported. In particular, both SOAP over HTTP(S) and JMS transports are supported. Also, Web Services can either be realized as Servlets or Message Driven Beans. Finally, security features such as Basic, Digest and NTLM authentication as well as SSL and XML Signature support are fully supported.

The Novell exteNd Web Services SDK tools include a light-weight Web Server for deploying standard WAR files that contain Web Services, and a TCP tunnel for debugging the SOAP messages exchanged between client and server applications. A tool for converting a regular Java class to RMI is also provided. For more information about the Novell exteNd WSSDK, please refer to the documentation section, or the Novell exteNd WSSDK datasheet.

What's New

What's New in Version 5.0

Version 5.0 is a major new release, which includes all the features of vrsion 2.1 and the following changes

What's New in Version 2.1

Version  2.1 is a maintenance release, which includes several new features.

System Requirements

Novell exteNd Web Services SDK requires Java 2, an XML parser such as Xerces, and the following components: Also, clients may optionally require JNDI if they prefer to look up references to (remote) Web Services via JNDI. Although Novell exteNd Web Services SDK comes with a simple Web Server, server side development and deployment typically requires a servlet container, such as Novell eXtend Application Server or Tomcat.

This release has been tested on Windows NT/2000/XP, Solaris Sparc/Intel 2.6+, HP-UX 11, AIX 4.3, Linux Red Hat 7 and Netware 6. The following JDKs are supported:

Java 2 Standard Edition

Installation

Novell exteNd Web Services SDK is installed as follows:
  1. On Windows platforms, simply launch the WSSDK.exe executable. On other platforms, run the Novell exteNd Web Services SDK installer where WSSDK.jar is located:
    2.    java -jar WSSDK.jar
    The Setup Welcome screen appears. Click "Next" to view the README information.

  2. The README contains important information. Please take the time to read these notes carefully before continuing. When you have finished reading the notes, continue the installation by clicking the "Next" button.

  3. The Installation program displays the Novell license agreement. To install Novell exteNd Web Services SDK, you must accept all terms of this agreement. Check the "Accept all terms of the license" checkbox and click "Next" to continue.

  4. Choose or specify a destination directory (or accept the default) and select "Next" to continue.

  5. Review the installation summary. Client "Next" when you're ready to install. The installation program notifies you when the installation is complete.

  6. Choose "Finish" to exit the Installation program.
Once installation is complete, please make sure that you satisfy the above System Requirements, and that the following resources are available to the Java 2 runtime: Put wssdk.jar, xercesImpl.jar, xmlParserAPIs.jar, activation.jar, and servlet.jar in your CLASSPATH, and bin\win32, bin/solaris, or bin/linux-x86 on your PATH. When compiling or running applications that use HTTPS also include wssdk-ssl.jar in your CLASSPATH. unless you're using the SSL support in JDK 1.4. If you're running on JDK 1.2, also include jndi.jar in your CLASSPATH. You can use the env.bat, env.sh, or env.csh script in the examples directory for setting up your environment.

Documentation

The following documentation is included with this release of Novell exteNd WSSDK:

Sample Programs

Novell exteNd Web Services SDK comes with a number of pre-built examples. These examples show how to use most of the features of the Novell exteNd WSSDK product. The Novell exteNd WSSDK tutorial contains a description of each example. The Java source for the examples can be found in the examples directory.

Limitations in this Release

The following features are not implemented in this release of Novell exteNd WSSDK:

Bug Reports and Feedback

Please use extendsupport@novell.com for feedback, comments, and any bug reports.

Resources on the Internet

There are many Web Services resources available on the Internet: Back to top.
Copyright © 2001-2003, Novell, Inc. All rights reserved.