Service:
-------
To install this service on an Apache-SOAP listener, you need to make
the samples.propertybag package available on the Apache-SOAP listener's
classpath. Then deploy this service by filling in the deployment
template using the info in the deployment descriptor in this
directory or by using the service manager client:
  java org.apache.soap.server.ServiceManagerClient routerURL deploy dd.xml
where routerURL is the URL of the SOAP RPC router and dd.xml is the
name of the deployment descriptor file.  For example:
  java org.apache.soap.server.ServiceManagerClient  \
    http://localhost:8080/soap/servlet/rpcrouter deploy DeploymentDescriptor.xml


Client:
------

There is one HTTP client that sends a "book bean" property bag to the service.  
The service method "analyzes" this, returning the list of keys and list of values.

Additional Client Classpath Requirements:
----------------------------------------

  ../..


Explanation:
-----------

This demonstrates and tests the PropertyBagSerializer class.  A property bag is
meant to be used as an alternative to a Java bean with no behavior.  It is
especially useful to receive complex types received in SOAP messages without
having to create a bean for each type.


Sample Usage:
------------

java samples.gzip.PropertyBagClient \
  http://localhost:8080/soap/servlet/rpcrouter


Wire Dump:
---------
*** REQUEST ***
POST /soap/servlet/rpcrouter HTTP/1.0
Host: localhost:81
Content-Type: text/xml; charset=utf-8
Content-Length: 892
SOAPAction: ""
Accept-Encoding: x-gzip

<?xml version='1.0' encoding='UTF-8'?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<ns1:analyze xmlns:ns1="urn:property-bag-sample" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<bag xsi:type="ns1:PropertyBag">
<Publisher xsi:type="xsd:string">Random House</Publisher>
<AuthorFirstName xsi:type="xsd:string">Michael</AuthorFirstName>
<CopyrightYear xsi:type="xsd:int">2000</CopyrightYear>
<AuthorLastName xsi:type="xsd:string">Chabon</AuthorLastName>
<DateAdded xsi:type="xsd:dateTime">2002-09-16T15:16:33.832Z</DateAdded>
<Title xsi:type="xsd:string">The Amazing Adventures of Kavalier &amp; Clay</Title>
<Pages xsi:type="xsd:int">639</Pages>
</bag>
</ns1:analyze>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

*** RESPONSE ***
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: 890
Date: Mon, 16 Sep 2002 15:16:34 GMT
Accept-Encoding: x-gzip
Server: Apache Tomcat/4.0.1 (HTTP/1.1 Connector)

<?xml version='1.0' encoding='UTF-8'?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<ns1:analyzeResponse xmlns:ns1="urn:property-bag-sample" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<return xmlns:ns2="http://xml.apache.org/xml-soap" xsi:type="ns2:Map">
<item>
<key xsi:type="xsd:string">keys</key>
<value xsi:type="xsd:string">AuthorLastName~AuthorFirstName~DateAdded~CopyrightYear~Title~Pages~Publisher</value>
</item>
<item>
<key xsi:type="xsd:string">values</key>
<value xsi:type="xsd:string">Chabon~Michael~Mon Sep 16 11:16:33 EDT 2002~2000~The Amazing Adventures of Kavalier &amp; Clay~639~Random House</value>
</item>
</return>
</ns1:analyzeResponse>

</SOAP-ENV:Body>
</SOAP-ENV:Envelope>