| ||||
Chapter 4Setup and ConfigurationThis chapter describes how to set up the SAAJ TCK and JavaTest harness software. Before proceeding with the instructions in this chapter, be sure to install all required software, as described in Chapter 3. After completing the instructions in this chapter, proceed to Chapter 5 for instructions on running the SAAJ TCK. This chapter includes the following topics: 4.1 Configuring Your Environment to Run the SAAJ TCKThis section describes how to configure the SAAJ TCK for your environment. After configuring your environment, continue with the instructions in Using the JavaTest Harness Software. Note - In these instructions, variables in angle brackets need to be expanded for each platform. For example, <TS_HOME> becomes $TS_HOME on Solaris/Linux and %TS_HOME% on Windows 2000/XP. In addition, the forward slashes (/) used in all of the examples need to be replaced with backslashes (\) for Windows 2000/XP. Finally, be sure to use the appropriate separator for your operating system when specifying multiple path entries (; on Windows, : on UNIX/Linux).
|
local.classes=${env.SAAJ_HOME}/lib/saaj-api.jar: ${env.SAAJ_HOME}/lib/saaj-impl.jar: ${env.SAAJ_HOME}/lib/activation.jar: ${env.CATALINA_HOME}/common/lib/servlet-api.jar |
Set the webserver.container property to the supported web container type used for testing.
The supported web container type for standalone web applications is Tomcat via tomcat.xml. By default this is set to tomcat.xml.
Set the webcontainer.home property to the location in which the Web container under test is installed.
The supported web container type for standalone Web applications is Tomcat, so this property should be set to where your Tomcat is installed.
Set the porting.ts.url.class.1 property to your porting implementation class that is used for obtaining URLs.
The default setting for the Sun RI porting implementation is:
com.sun.ts.lib.implementation.sun.common.SunRIURL |
Provide your own implementations of the porting package interfaces provided with the SAAJ TCK.
The porting interfaces are:
TSURLInterface.java -- Obtains URL strings for web resources in an implementation-specific manner
API documentation for the TSURLInterface.java porting package interface is available in the <TS_HOME>/docs/api directory.
Change to the <TS_HOME>/dist directory.
Copy the SAAJ TCK WAR files to the appropriate container.
For example, for the Apache Tomcat 5.5.x Web container, use the following command:
cp *war <CATALINA_HOME>/webapps |
Complete the following two procedures to configure your Web server environment for Java Web Services Developers Pack.
Set the following environment variables in your shell environment:
JAVA_HOME to the directory in which Java SE 5 is installed
TS_HOME to the directory in which the SAAJ TCK 1.3 software is installed
SAAJ_HOME to the directory in which the SAAJ RI software is installed
CATALINA_HOME to the directory in which the Apache Tomcat 5.5.x Web Container is installed
Copy the required jar files to the Web server shared library directory:
For the Apache Tomcat 5.5.x Web Container, use the following commands:
cp <TS_HOME>/lib/tsharness.jar <TS_HOME>/lib/saajtck.jar <CATALINA_HOME>/shared/lib cp <SAAJ_HOME>/lib/*.jar <CATALINA_HOME>/shared/lib |
![]() ![]() |