commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rdon...@apache.org
Subject cvs commit: jakarta-commons/betwixt/xdocs overview.xml tasks.xml
Date Fri, 11 Apr 2003 21:28:28 GMT
rdonkin     2003/04/11 14:28:28

  Modified:    betwixt/xdocs overview.xml tasks.xml
  Log:
  Added documentation for map reading and writing using betwixt
  
  Revision  Changes    Path
  1.16      +30 -0     jakarta-commons/betwixt/xdocs/overview.xml
  
  Index: overview.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/overview.xml,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- overview.xml	8 Apr 2003 13:42:32 -0000	1.15
  +++ overview.xml	11 Apr 2003 21:28:28 -0000	1.16
  @@ -311,6 +311,36 @@
       </p>
   </subsection>
   
  +<subsection name="Reading And Writing Map Properties">
  +    <p>
  +Maps are a special kind of composite property. Each entry in a map has a key and a value.

  +Betwixt handles maps by adding extra elements which wrap each entry. Each entry is wrapped
in
  +a <code>&lt;entry&gt;</code> element. That element contains the key
wrapped in a <code>&lt;key&gt;</code>
  +element and the entry value wrapped in a <code>&lt;value&gt;</code>
element.
  +        </p>
  +    <p>
  +The structure is something like:
  +<source><![CDATA[
  +    ...
  +    <entry>
  +        <key>...</key>
  +        <value>...</value>
  +    <entry>
  +    <entry>
  +        <key>...</key>
  +        <value>...</value>
  +    <entry>
  +    ...
  +]]></source>
  +The key and the value content are standard betwixt mappings of the objects.
  +        </p>
  +    <p>
  +Reading map properties is an extension of the ways that Betwixt handles collections. Rather
than 
  +searching for an <code>add*</code> method that takes a single parameter, now
Betwixt looks 
  +(in a similar fashion) for such a method that takes two parameters.
  +        </p> 
  +</subsection>
  +
   </section>
   
   <section name="Customizing the mapping of a bean to XML (advanced)">
  
  
  
  1.13      +9 -4      jakarta-commons/betwixt/xdocs/tasks.xml
  
  Index: tasks.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/tasks.xml,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- tasks.xml	8 Apr 2003 13:42:32 -0000	1.12
  +++ tasks.xml	11 Apr 2003 21:28:28 -0000	1.13
  @@ -199,10 +199,15 @@
                   body text between child elements through the .betwixt file. This text can
be
                   static or set from a property.
               </li>
  -        <li>
  -            <strong>Allow customization for update from .betwixt file</strong>
  -            Add updater attribute that allows the updater to be specified for an elements.
  -        </li>
  +            <li>
  +                <strong>Allow customization for update from .betwixt file</strong>
  +                Add updater attribute that allows the updater to be specified for an elements.
  +            </li>
  +            <li>
  +                <strong>Added Reading for Composite Map Properties</strong>
  +                Added code that reads entries for composite map properties and adds then
correctly.
  +                This code relies on the Betwixt map element mapping format.
  +            </li>
           </ul>
       </subsection>
   </section>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message