The demo shows how to write web services to work with very large amounts of data. This demo uses either MIME multipart/related encoding or DIME which can handle large amounts of data efficiently.

Applications that have to process very large amounts of data tend to suffer from performance problems. You can partially avoid this by using concurrent reading and writing of input and output. In SESJ, you can do this using the org.idoox.wasp.types.MessageAttachment class. This class is supported directly by SESJ.

This demo is a simple service which receives and sends a large amount of data and compresses/decompresses it using a zip algorithm. For this purpose a new thread is created and connected to PipedInputStream and PipedOutputStream. While concurrent threads manage the data processing, the main service thread exits from the service method and returns control to SESJ.

There are three service endpoints created, they are using different attachment encapsulation. The "demo/advanced/AttachmentService" endpoint uses the default attachment encapsulation (MIME or DIME) chosen during SESJ installation. The "demo/advanced/MIMEService" and "demo/advanced/DIMEService" endpoints use explicitly chosen MIME/DIME encapsulation.

To start, the client creates a chunk of data approx. 10MB in size and then sends it to the server where is it compressed. When data is returned, it is then decompressed in the same manner. The results are saved in the following files:

demoDataDefault.pack
demoDataMIME.pack
demoDataDIME.pack      - compressed data sent to server
demoDataDefault.unpack
demoDataMIME.unpack
demoDataDIME.unpack    - decompressed data received from server

	Note
	This demo might not work correctly on some application servers due to their inability to communicate using chunked HTTP messages (sending the message by parts). If you want to run this demo over JMS transport, increase the memory limits for JVM on both the server and the client side to at least 256MB (-Xmx256m)

In addition to the files described in Files and Directories, this demo contains:

You can run the demo using the "run.sh" (for UNIX) or "run.bat" (for Windows) scripts. Running the script without arguments prints out a help screen.

The demo can be run in two different ways: