242

General Considerations

urn:OpcOrderTrackingService

Code Example 5.21

JAX RPC Mapping File

WSDL files, including partial WSDL files, are packaged within clients. Their

location is dependent on the type of module. Since clients using DII do not require

a WSDL file, they leave the 

wsdl file

 element portion of the 

service ref

element undefined and they must not specify the 

jaxrpc mapping file

 element.

For a web application archive (WAR) file, the WSDL file is in the 

WEB 

INF/wsdl

 directory. (See Figure 5.8.) For an EJB endpoint as well as a J2EE appli 

cation client, the WSDL file is in the directory 

MET INF/wsdl

. (See Figure 5.9.)

Both directories are relative to the root directory of the application module.

For Web tier clients, a 

service ref

 element in the 

web.xml

 file contains the

location of the JAX RPC mapping file, 

client jaxrpc mapping file.xml

. The

service endpoint interface (if provided) is either a class file in the 

WEB 

INF/classes

 directory or it is packaged in a JAR file in the 

WEB INF/lib

 directory.

Generated classes are located in the same directory.

HTML/JSP Files

WEB INF

web.xml

client jaxrpc mapping file.xml

wsdl

WSDL files

classes

Service endpoint interface class and

generated class files

lib

Prepackaged Web service library

Figure 5.8

Web Application Module Packaging