PhoneBookSoap Example

 

SOAP is a communication protocol used to convey messages between applications. To demonstrate it, the PhoneBook example has been split into two applications:

These two applications communicate with each other using SOAP: 

 

Note:

Installation: PhoneBookSoap example comes preconfigured with enhydra. You can also install the example manually to work with Tomcat 4 or Enhydra Multiserver.

1.      Installing and using  PhoneBookSoap with Tomcat 4

·        Preparing Tomcat:

o       Copy

EnhydraX.Y/lib/tools/Soap/webapps/soap

                                    to

                                    CATALINA_HOME/webapps

o       Copy

soap.jar, mail.jar, activation.jar, xerces.jar  and idb.jar

to

CATALINA_HOME\common/lib

·        Building PhoneBookSoap example

o       Change directory to

EnhydraX.Y/examples/phoneBookSoap

 Edit build.properties  and uncommnet out the line containing catalina.home=...

 (enter correct path to your Tomcat installation)

o       Start ant

o       Start Tomcat and deploy the new SOAP application, entering command:

deploy

·        Using PhoneBookSoap

o       Using your browser, connect to URL

 http://localhost:8080/phoneBookSoapClient

·        Using the tunneling tool:

o       Change directory to

EnhydraX.Y/examples/phoneBookSoap

o       Start tunneling, issuing the following command:

tunnel

o       Connect to

http://localhost:8080/phoneBookSoapClient

o       Change Soap Server port to 8081

2.    Installing and using PhoneBookSoap with Enhydra Multiserver

·        Preparing Enhydra:

o       Copy

EnhydraX.Y/lib/tools/Soap/webapps/soap

                                    to

                                    EnhydraX.Y/webapps

o       Copy

soap.jar, mail.jar and activation.jar

to

EnhydraX.Y/lib  

o        include copied jars into your CLASSPATH

o        include idb.jar into your CLASSPATH

o        start Enhydra Multiserver and add a new application :

 

o        add a new connection with prefix soap:

·        Building PhoneBookSoap example

o       Change directory to

EnhydraX.Y/examples/phoneBookSoap

Edit build.properties and comment the line containing catalina.home=...

o       Start ant

o      Include 

EnhydraX.Y/lib/tools/Soap/webapps/soap/WEB-INF/classes/

    into your CLASSPATH.

o       Start Multiserver and deploy the new SOAP application entering command:

deploy  

o       Using Multiserver add phoneBookSoapClient as a new enhydra application

o       Create a connection for the new application, and note its URL

·        Using PhoneBookSoap

o       Using your browser, connect to theURL of the new phoneBookSoapClient application

 

·        Using the tunneling tool:

o       Change directory to

EnhydraX.Y/examples/phoneBookSoap

o       Start tunneling, issuing the following command:

tunnel

o       Connect to the phoneBookSoapClient and 

o       Change Soap Server port to 8081