[cl-soap-cvs] CVS update: public_html/index.html

[Sven Van Caekenberghe]

Update of /project/cl-soap/cvsroot/public_html
In directory common-lisp.net:/tmp/cvs-serv15756

Modified Files:
	index.html 
Log Message:
updated with installation instructions, status and some example code

Date: Thu Sep 15 13:35:55 2005
Author: scaekenberghe

Index: public_html/index.html
diff -u public_html/index.html:1.3 public_html/index.html:1.4
--- public_html/index.html:1.3	Fri Sep  9 21:30:14 2005
+++ public_html/index.html	Thu Sep 15 13:35:55 2005
@@ -52,6 +52,61 @@
 <li>Good debugging support as well as initial unit and functional tests will be added.</li>
 </ul>
 </p>
+<h3>Installation Instructions</h3>
+<p>
+<ul>
+<li>Get the source code for CL-SOAP through CVS as described above.</li>
+<li>Get the source code for <a href="http://common-lisp.net/project/s-xml">S-XML</a> 
+  through CVS (<em>do not use a released version</em>).</li>
+<li>Get a recent version of the <a href="http://puri.b9.com/">PURI</a> package.</li>
+<li>Make sure ASDF works for you, add the *.asd files of the packages you just downloaded
+(see the <a href="http://constantly.at/lisp/asdf"/>asdf manual</a>).</li>
+<li>With all of the above done:
+  <pre>(asd:oos 'asdf:load-op :cl-soap)</pre>
+  should load all code into your lisp image (and compile it if necessary).
+</li>
+<li>Check out the example/test code in the <tt>test</tt> directory.</li>
+<li>May the source be with you, always.</li>
+</ul>
+</p>
+<h3>Status</h3>
+<p>
+<ul>
+  <li>S-XML was extended to support XML Namespaces</li>
+  <li>Basic, manual SOAP calls are now possible, for example:
+    <pre>(defun xmethods-get-quote (symbol)
+  "Calling http://services.xmethods.net/soap/urn:xmethods-delayed-quotes.wsdl"
+  (let ((ns "urn:xmethods-delayed-quotes"))
+    (s-xml:register-namespace ns "ns1" :ns1)
+    (let* ((xmethods (make-soap-end-point "http://64.124.140.30:9090/soap"))
+           (result (soap-call xmethods 
+                              '() 
+                              `((ns1::|getQuote| 
+                                 soapenv:|encodingStyle| ,+soap-enc-ns-uri+
+                                 :|xmlns:ns1| ,ns) 
+                                ((:|symbol| xsi::|type| "xsd:string") 
+                                 ,symbol)) 
+                              :soap-action "urn:xmethods-delayed-quotes#getQuote")))
+      (if (eql (lxml-get-tag result) 'ns1::|getQuoteResponse|)
+          (let ((contents (lxml-find-tag :|Result| (rest result))))
+            (if contents
+                (coerce (read-from-string (second contents)) 'float)
+              (error "Expected a <Result> element")))
+        (error "Expected a <getQuoteResponse> element")))))</pre>
+    Check out the test/test-basic.lisp file for more examples.
+  </li>
+  <li>WSDL with SOAP bindings in url/file/stream form can now be parsed into a Common Lisp representation. Use parse-wsdl, parse-wsdl-file and parse-wsdl-url.</li>
+  <li>The WSDL SOAP CL representation can be inspected and printed using describe-wsdl-soap.</li>
+  <li>There is a partial implementation for making SOAP calls with structured WSDL support, for example:
+    <pre>(defun xmethods-get-rate (country1 country2)
+  (wsdl-soap-call "http://www.xmethods.net/sd/2001/CurrencyExchangeService.wsdl"
+                  "getRate"
+                  :input `("country1" ,country1 "country2" ,country2)))</pre>
+  </li>
+  <li>Some partial support for XML Schema Defintion types definition in WSDL is being implemented.</li>
+  <li>Lot's of work remains to be done! All help is welcome.</li>
+</ul>
+</p>
 <h3>Next Phase(s) (Future)</h3>
 <p>
 <ul>
@@ -89,6 +144,6 @@
 Initial developers and contributors will include Sven Van Caekenberghe (Beta Nine),
 Alain Picard (Memetrics), Ivan Melotte (Beta Nine) and Nicky Peeters (Beta Nine).
 <p>
-<p>$Id: index.html,v 1.3 2005/09/09 19:30:14 scaekenberghe Exp $</p>
+<p>$Id: index.html,v 1.4 2005/09/15 11:35:55 scaekenberghe Exp $</p>
 </body>
 </html>