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/guide start.xml
Date Wed, 21 Jan 2004 21:25:20 GMT
rdonkin     2004/01/21 13:25:20

  Modified:    betwixt/xdocs Tag: REFACTORING-BRANCH_2004-01-13 faq.xml
                        tasks.xml
               betwixt/xdocs/guide Tag: REFACTORING-BRANCH_2004-01-13
                        start.xml
  Log:
  Documentation for the new addDefault properties.
  
  Revision  Changes    Path
  No                   revision
  No                   revision
  1.7.2.1   +24 -1     jakarta-commons/betwixt/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/faq.xml,v
  retrieving revision 1.7
  retrieving revision 1.7.2.1
  diff -u -r1.7 -r1.7.2.1
  --- faq.xml	14 Aug 2003 21:24:41 -0000	1.7
  +++ faq.xml	21 Jan 2004 21:25:20 -0000	1.7.2.1
  @@ -70,6 +70,17 @@
             How can I make my extra digestion <em>Rule</em>s work with Betwixt?
           </a>
         </li>
  +      <li>
  +        <a href="#bean-read-failure">
  +          Why does reading my xml return null?
  +        </a>
  +      </li>
  +      <li>
  +      	<a href="#betwixt-matching-adders">
  +How can I make Betwixt match adders to collective properties when using
  +a <code>.betwixt</code> file <em>without</em> also adding default
propertes?
  +      	</a>
  +      </li>
       </ol>
       <p><strong>Building Betwixt</strong></p>
       <ol>
  @@ -228,7 +239,7 @@
               upgrade.
           </dd>
           <dt>
  -          <a name="Why Can't A Read My Bean?">
  +          <a name="bean-read-failure">
               Why does reading my xml return null?
             </a>
           </dt>
  @@ -243,7 +254,19 @@
               to register the class at a particular path.</li>
               </ul>
           </dd>
  +         <dt>
  +          <a name="betwixt-matching-adders">
  +How can I make Betwixt match adders to collective properties when using
  +a <code>.betwixt</code> file <em>without</em> also adding default
propertes?
  +          </a>
  +        </dt>
  +        <dd>
  +Add the <code>&lt;addDefaults&gt;</code> and to it add an attribute

  +<code>add-properties=&quot;false&quot;</code>.
  +        </dd>       
  +        
         </dl>
  +      
       </subsection>
       <subsection name="Building Betwixt">
         <dl>
  
  
  
  1.25.2.4  +10 -5     jakarta-commons/betwixt/xdocs/tasks.xml
  
  Index: tasks.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/tasks.xml,v
  retrieving revision 1.25.2.3
  retrieving revision 1.25.2.4
  diff -u -r1.25.2.3 -r1.25.2.4
  --- tasks.xml	18 Jan 2004 22:25:23 -0000	1.25.2.3
  +++ tasks.xml	21 Jan 2004 21:25:20 -0000	1.25.2.4
  @@ -264,6 +264,11 @@
               <li>
   <strong>Added Support For Replacement Of Bad Characters</strong> to default
mapping of element names.
               </li>
  +            <li>
  +<strong>Extended betwixt file</strong> by adding two new properties 
  +to &lt;addDefaults&gt; that allow matching properties or adders to be
  +supressed.
  +            </li>
           </ul>
       </subsection>
   </section>
  @@ -339,17 +344,17 @@
               				<li><code>PrimitiveType</code> property removed</li>
           				
               			</ul>
               		</li>
  -            		<li><strong>XMLIntrospectorHelper</strong> this will be
deprecated.
  +            		<li><strong>XMLIntrospectorHelper</strong> this will be
deprecated.</li>
               	</ul>
               </li>
               <li><strong>Refactored introspection configuration into separate
class</strong>
               	<ul>
  -            		<li><strong>XMLIntrospector</strong></li>
  +            		<li><strong>XMLIntrospector</strong>
               			<ul>
               				<li>useBeanInfoSearchPath property</li>
               				<li>AttributeNameMapper property</li>
               				<li>ElementNameMapper property</li>
  -            				<li>PluralStemmer< property/li>
  +            				<li>PluralStemmer property</li>
               				<li>WrapCollectionsInElement property</li>
               				<li>AttributesForPrimitives property</li>
               				<li>ClassNormalizer property</li>
  @@ -413,7 +418,7 @@
                   <a href='guide/binding.html#Converting Dates (And Other Objects)'>the
guide</a>.
               </li>
               <li>
  -            	<strong>Introspection & ELementDescriptor</strong> changes
in introspection and 
  +            	<strong>Introspection and ElementDescriptor</strong> changes in
introspection and 
               	ElementDescriptor to make them more declarative so that the logic required
to
               	read and write beans can be reduced. An explicit flag has been added to indicate
               	which ElementDescriptors are hollow. The descriptors describing collective
mappings
  @@ -426,7 +431,7 @@
               	<strong>ID assignment</strong> IDs are now not assigned to any
element
               	which are simple (do not have any children and no attributes) rather than
just primitives.
               	The concept of primitives is being phased out in favour of the more general
  -            	concept of atomic mappings (object <-> string) and elements of simple
type.
  +            	concept of atomic mappings (object &lt;-&gt; string) and elements
of simple type.
               	ID generation is likely to be refactored soon so that it's performed within

               	the structure of the attribute references rather than as part of the writing
               	algorithm.
  
  
  
  No                   revision
  No                   revision
  1.1.2.1   +17 -0     jakarta-commons/betwixt/xdocs/guide/start.xml
  
  Index: start.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/guide/start.xml,v
  retrieving revision 1.1
  retrieving revision 1.1.2.1
  diff -u -r1.1 -r1.1.2.1
  --- start.xml	14 Aug 2003 21:26:16 -0000	1.1
  +++ start.xml	21 Jan 2004 21:25:20 -0000	1.1.2.1
  @@ -136,6 +136,23 @@
   </info>
   ]]></source>
   
  +	<p>The plain <code>&lt;addDefaults&gt;</code> tag adds default
properties
  +	and the adders (it can find) for all the properties (both explicitly 
  +	described in the <code>.betwixt</code> file and the default ones discovered).
  +	Usually, this is really pretty useful but sometimes it is more finely graine
  +	control is needed. In this case, there are two properties that can be set
  +	to given this extra control:</p>
  +	
  +	<ul>
  +		<li><strong><code>add-properties</code></strong> If this
property is set to any value
  +		other than <code>true</code> the discovery of default properties will
  +		be suppressed.</li>
  +		<li><strong><code>add-adders</code></strong> if this property
is set to
  +		any value other than <code>true</code> the matching of adders will be supressed.</li>
  +	</ul>
  +	
  +	<p>Using <code>&lt;addDefaults add-properties='false' add-adders='false'/&gt;</code>
  +	doesn't really make any sense but no error will be thrown.</p>
   </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