
Contact me
--------------------------------------------------------------------------------
Email: aleph_one@home.se


Purpose
--------------------------------------------------------------------------------
The purpose of the virtual provider is to act as a multithreaded HTTP/HTTPS 
server receiving SOAP messages. 
It is possible to send responses manually as well as automatically.
The server is not built for stress testing.


System Requirements
--------------------------------------------------------------------------------
Developed mainly for Solaris, Linux and Windows using J2SE 1.4.2


Usage
--------------------------------------------------------------------------------
A normal scenario
  1. A new message arrives and shows up in the "Requests" queue

  2. Click on the message to see the received SOAP message.

  3. Then if you have specified a message directory its possible to select 
     a response message from the combo-box. Of course it is also possible 
     to just paste some text directly. Another way to respond is to use 
     autorespond settings.

  4. Click "Send" and the response message is away.


If you receive several messages within a short period of time you can select 
which message to respond to first, you don't have to answer the messages in a 
certain order.


Auto Respond (Settings->Auto Respond)
--------------------------------------------------------------------------------
Autoresponse checks for a specific operation in the incoming soap message, and 
if there is a math in the config file, an autoresponce is sent back otherwise 
you have to send it manually back.

To use auto response it is necessary to specify which operations to 
auto respond to and what to respond with.

"filepath" points to a file that contains a soap message to send in response.
"operation" is the operation to look for in requests (incoming soap messages).

A normal auto response file can look like this:

<?xml version="1.0" encoding="UTF-8" ?>
<autoresponse>
   <message filepath="/path/to/LoginResponse.xml" operation="Login" />
   <message filepath="/path/to/LogoutResponse.xml" operation="Logout" />
</autoresponse>

Example configuration is located in the "conf" directory.


Protocols (Settings->Protocol)
--------------------------------------------------------------------------------
Specify ports to use for HTTP and HTTPS and their settings.
Default is port 80 for HTTP and port 443 for HTTPS.
To start/stop listening for incoming HTTP and HTTPS connections click on the 
buttons at the top to the right.
Check the log window to make sure that it starts listening.


SOAP Messages (Settings->Specify Message Directory)
--------------------------------------------------------------------------------
Specify a directory that contains SOAP messages that can be used to manually 
respond to requests. The message can be accessed from the combo box.
The same message can be used for sending with autorespond and be specified 
in the autorespond config file.

A simple soap message can look like this:

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope 
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
	xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	
	<soapenv:Header>
	</soapenv:Header>
	<soapenv:Body>
		<LoginResponse xmlns="http://schemas.testdomain.com/wohaa/">
		</LoginResponse>
	</soapenv:Body>
</soapenv:Envelope>

Some examples are located in the "soap" directory.
