Return-Path: Delivered-To: apmail-ws-axis-dev-archive@www.apache.org Received: (qmail 54061 invoked from network); 9 Jul 2007 11:16:45 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 9 Jul 2007 11:16:44 -0000 Received: (qmail 90438 invoked by uid 500); 9 Jul 2007 11:16:45 -0000 Delivered-To: apmail-ws-axis-dev-archive@ws.apache.org Received: (qmail 90328 invoked by uid 500); 9 Jul 2007 11:16:45 -0000 Mailing-List: contact axis-cvs-help@ws.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list axis-cvs@ws.apache.org Received: (qmail 90316 invoked by uid 500); 9 Jul 2007 11:16:45 -0000 Delivered-To: apmail-ws-axis2-cvs@ws.apache.org Received: (qmail 90313 invoked by uid 99); 9 Jul 2007 11:16:45 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 09 Jul 2007 04:16:45 -0700 X-ASF-Spam-Status: No, hits=-99.5 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 09 Jul 2007 04:16:40 -0700 Received: by eris.apache.org (Postfix, from userid 65534) id 32A9C1A981A; Mon, 9 Jul 2007 04:16:20 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r554602 - in /webservices/axis2/trunk/java/modules/samples/userguide: README.txt build.xml Date: Mon, 09 Jul 2007 11:16:20 -0000 To: axis2-cvs@ws.apache.org From: deepal@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20070709111620.32A9C1A981A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: deepal Date: Mon Jul 9 04:16:19 2007 New Revision: 554602 URL: http://svn.apache.org/viewvc?view=rev&rev=554602 Log: applying the patch in 1700 - thx Suran for the patch Modified: webservices/axis2/trunk/java/modules/samples/userguide/README.txt webservices/axis2/trunk/java/modules/samples/userguide/build.xml Modified: webservices/axis2/trunk/java/modules/samples/userguide/README.txt URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/modules/samples/userguide/README.txt?view=diff&rev=554602&r1=554601&r2=554602 ============================================================================== --- webservices/axis2/trunk/java/modules/samples/userguide/README.txt (original) +++ webservices/axis2/trunk/java/modules/samples/userguide/README.txt Mon Jul 9 04:16:19 2007 @@ -1,80 +1,88 @@ -Axis2 User's Guide Sample -========================= - -This sample contains the source code relevant to xdocs/1_1/adv-userguide.html, -more specifically to xdocs/1_1/dii.html and xmlbased-server.html which are sections -of the Axis2 Advanced User's Guide found in the Documents Distribution. - -The sample explains how to write a Web service and Web service client with -Apache Axis2 using XML based client APIs (Axis2's Primary APIs). - -Introduction -============ - -The following sample clients are located at -Axis2_home/samples/userguide/samples/userguide/src/userguide/clients directory. - -EchoBlockingClient.java -- Demonstrates the request-response, blocking client which -is written using Axis2's primary APIs. - -EchoBlockingDualClient.java -- Demonstrates the request-response, blocking client which -uses two transport connections and written using Axis2's primary APIs. - -EchoNonBlockingClient.java -- Demonstrates the request-response, non-blocking invocation -which is written using Axis2's primary APIs. - -EchoNonBlockingDualClient.java -- Demonstrates the request-response, non-blocking invocation -using two transport connections and is written using Axis2's primary APIs. - -MailClient.java -- Represents a client for invoking - -PingClient.java -- Represents a simple one-way client which is written using Axis2's primary APIs. - -RESTClient.java -- Represents a client for invoking a REST Web service - -TCPClient.java -- Demonstrates a client for invoking a Web service using TCP - -example1, example2 and example3 directories inside Axis2_home/samples/userguide/src/userguide -contain the Web services which are invoked by the above clients. - - -Pre-Requisites -============== - -Apache Ant 1.6.2 or later - -Building the Service -==================== - -* Type "ant generate.service" or just "ant" from Axis2_HOME/samples/userguide -* Then go to Axis2_HOME/bin directory and run either axis2server.bat or axis2server.sh depending on your platform. - -Alternatively you can copy the the generated service archives in to a servlet container. - -If you go to http://localhost:8080/axis2/, you should see MyService, MyServiceWithModule are deployed. - - -Running the Clients -=================== - -Type the following ant commands from Axis2_HOME/samples/userguide to run the clients one by one. - - * "ant run.client.blocking" - This invokes MyService through a request-response, blocking client. - * "ant run.client.blockingdual" - This invokes MyService through a request-response, blocking client via dual transport channels. - * "ant run.client.nonblocking" - This invokes MyService through a request-response, non-blocking client. - * "ant run.client.nonblockingdual" - This invokes MyService through a request-response, non-blocking client via dual transport channels. - * "ant run.client.ping" - This invokes MyService through a one-way client - - -You can find more information on the above clients in Axis2 users guide, RESTFul Web services support, -TCP Transport documents found in the Documents Distribution's xdocs directory. Also, you may find it -useful to try out the above services and clients while going through these documents. - -Help -==== -Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample. +Axis2 User's Guide Sample +========================= + +This sample contains the source code relevant to xdocs/1_1/adv-userguide.html, +more specifically to xdocs/1_1/dii.html and xmlbased-server.html which are sections +of the Axis2 Advanced User's Guide found in the Documents Distribution. + +The sample explains how to write a Web service and Web service client with +Apache Axis2 using XML based client APIs (Axis2's Primary APIs). + +Introduction +============ + +The following sample clients are located at +AXIS2_HOME/samples/userguide/samples/userguide/src/userguide/clients directory. + +EchoBlockingClient.java -- Demonstrates the request-response, blocking client which +is written using Axis2's primary APIs. + +EchoBlockingDualClient.java -- Demonstrates the request-response, blocking client which +uses two transport connections and written using Axis2's primary APIs. + +EchoNonBlockingClient.java -- Demonstrates the request-response, non-blocking invocation +which is written using Axis2's primary APIs. + +EchoNonBlockingDualClient.java -- Demonstrates the request-response, non-blocking invocation +using two transport connections and is written using Axis2's primary APIs. + +MailClient.java -- Represents a client for invoking + +PingClient.java -- Represents a simple one-way client which is written using Axis2's primary APIs. + +RESTClient.java -- Represents a client for invoking a REST Web service + +TCPClient.java -- Demonstrates a client for invoking a Web service using TCP + +example1, example2 and example3 directories inside Axis2_home/samples/userguide/src/userguide +contain the Web services which are invoked by the above clients. + + +Pre-Requisites +============== + +Apache Ant 1.6.2 or later + +Building the Service +==================== +* Type "ant generate.module" from Axis2_HOME/samples/userguide to generate the logging module. +* Add the logging phase to the ../../conf/axis2.xml. For more details please refer to the + http://ws.apache.org/axis2/1_2/modules.html +* Type "ant generate.service" or just "ant" from Axis2_HOME/samples/userguide +* Then go to AXIS2_HOME/bin directory and run either axis2server.bat or axis2server.sh depending on your platform. + +Alternatively you can copy the the generated service archives in to a servlet container. + +If you go to http://localhost:8080/axis2/, you should see MyService, MyServiceWithModule are deployed. + + +Running the Clients +=================== + +Type the following ant commands from Axis2_HOME/samples/userguide to run the clients one by one. + + * "ant run.client.blocking" + This invokes MyService through a request-response, blocking client. + * "ant run.client.blockingdual" + This invokes MyService through a request-response, blocking client via dual transport channels. + * "ant run.client.nonblocking" + This invokes MyService through a request-response, non-blocking client. + * "ant run.client.nonblockingdual" + This invokes MyService through a request-response, non-blocking client via dual transport channels. + * "ant run.client.ping" + This invokes MyService through a one-way client + + +You can find more information on the above clients in Axis2 users guide, RESTFul Web services support, +TCP Transport documents found in the Documents Distribution's xdocs directory. Also, you may find it +useful to try out the above services and clients while going through these documents. + +Note +============== +Sometimes, if you're having trouble running the client successfully, +It may be necessary to clean the services repository before you generate the service, deploy it +and run the client. (i.e. delete services created from previous samples.) + +Help +==== +Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample. Modified: webservices/axis2/trunk/java/modules/samples/userguide/build.xml URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/modules/samples/userguide/build.xml?view=diff&rev=554602&r1=554601&r2=554602 ============================================================================== --- webservices/axis2/trunk/java/modules/samples/userguide/build.xml (original) +++ webservices/axis2/trunk/java/modules/samples/userguide/build.xml Mon Jul 9 04:16:19 2007 @@ -82,7 +82,7 @@ - + --------------------------------------------------------------------- To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org For additional commands, e-mail: axis-cvs-help@ws.apache.org