4.1.1 WSDL Option

JSMDirect has the ability to return the contents of the file specified in the WSDL file location column of DC@W29 or dc_w29.txt configuration file.

By including an additional '+wsdl' parameter on the web service URL, JSMDirect will return the contents of the file instead of executing the web service.

Example

 

http://mycompany.com/cgi-bin/jsmdirect?mywebservice+wsdl

 

 

The file content is treated as binary and text must be UTF-8 encoded.

The IBM i Apache HTTP Server must be configured to run in BINARY mode.

By returning HTML content you can offer more selection choices to the end user, instead of just WSDL content.

JSMDirect recognizes the following file extensions and uses an appropriate content type. If the file extension is not supported then the content type of unknown/unknown is used.

htm

text/html; charset=utf-8

html

text/html; charset=utf-8

xhtml

application/xhtml+xml; charset=utf-8

wsdl

application/xml; charset=utf-8

 

unknown/unknown

 

 

 

WSDL and unknown content will also include a Content-Disposition header using the name of the file, this allows the HTTP browser to prompt the user with a save file dialog.

Example

 

Content-Disposition: attachment; filename=xxxx

 

 

Example: HTML

 

<html>

 

<head>

<title>MyWebService</title>

</head>

 

<body>

 

This is MyWebService in HTML format

 

Use the following link to download the PDF documentation<br/>

 

Use the following link to download the WSDL file<br/>

 

</body>

</html>

 

 

Example: XHTML

 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

 

<html xmlns="http://www.w3.org/1999/xhtml">

 

<head>

<title>MyWebService</title>

</head>

 

<body>

 

This is MyWebService in XHTML format<br/>

 

Use the following link to download the PDF documentation<br/>

 

Use the following link to download the WSDL file<br/>

 

</body>

</html>