Sample for MTOM
===============

Overview:
---------

This sample demonstrates the capabilities and power of MTOM & SwA support of 
AXIS2. In this sample the user can send multiple files to the MTOM sample 
service, which will save them on the server or echo them depending on the 
selected operation (i.e. send or send & receive). Echoing would result the files
to be saved on the client side.

The option of client side file caching can be used when echoing a larger amount 
of data which could result in memory overflows. 



Running the Sample:
-------------------
1. Use <ant service> command in the AXIS2_DIST/sample/mtomsample/ to build the service.
2. Drop the mtomSample.aar service to the AXIS2_DIST/repository/services.
3. run the AXIS2_DIST/bin/axis2server.{sh.bat} to start the standalone axis2 server. 
(Alternatively you can drop the sample to the services directory of a Axis2 server
running in a servlet container)
4. Use <ant client> to build and run the client.


UI Configuration:
-----------------
1.  First browse a file or type the absolute path of a file that you want to 
transmit. Then click "Add".  Add any number of files as you like.

2.  Give the desired location that you want the files to be saved, for example 
[/usr/temp/]. In the upload scenario(send) it must be a directory in the machine 
which runs the Axis2 server. In echo scenario(send receive) it must be a 
directory in the client machine.

3. The default end point reference is given, assuming you are deploying the 
mtomSample service in the same machine. You can change it according to your host.

3.  Select the transfer method either as MTOM or as SOAP with attachments. 
Select the operation as either to send or send & receive.

4.  Client side File caching is enabled only in the send & receive operation. 
Enter a threshold value in bytes so that files larger than this will be cached. 
Files will be cached in the path given in the cache folder text box. This is 
a must if you are planning to echo large attachments. 

5.  Pressing "Execute" will perform the intended operation under given 
configurations. On success a message box will appear informing the number of 
files saved.


Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble 
running the sample.