rdonkin 2003/07/27 10:50:20 Modified: betwixt/xdocs overview.xml tasks.xml Log: Added documentation for reading dynabeans Revision Changes Path 1.18 +16 -0 jakarta-commons/betwixt/xdocs/overview.xml Index: overview.xml =================================================================== RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/overview.xml,v retrieving revision 1.17 retrieving revision 1.18 diff -u -r1.17 -r1.18 --- overview.xml 13 Jul 2003 21:26:28 -0000 1.17 +++ overview.xml 27 Jul 2003 17:50:20 -0000 1.18 @@ -473,6 +473,22 @@ </section> +<section name='Writing Beans (Advanced)'> + <subsection name='Writing DynaBeans'> + <p> +A <strong>DynaBean</strong> is a pseudo-bean whose properties may differ between instances of the same Class. +Pseudo-introspection of the available properties uses a pseudo-class of type DynaClass. +For more details see <a href='http://jakarta.apache.org/commons/beanutils.html'>BeanUtils</a>. + </p> + <p> +Betwixt now supports the (correct) writing of objects implementating DynaBean. Rather than using standard +introspection for these objects, <code>Betwixt</code> now interrogates the DynaClass. Using .betwixt files +with DynaBeans is not yet supported and special behaviour of DynaBeans can be overridden by specifying a +.betwixt file. + </p> + </subsection> +</section> + <section name='Reading Beans (Advanced)'> <subsection name='Adding Custom Digestion Rules'> <p> 1.18 +18 -1 jakarta-commons/betwixt/xdocs/tasks.xml Index: tasks.xml =================================================================== RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/tasks.xml,v retrieving revision 1.17 retrieving revision 1.18 diff -u -r1.17 -r1.18 --- tasks.xml 13 Jul 2003 21:26:28 -0000 1.17 +++ tasks.xml 27 Jul 2003 17:50:20 -0000 1.18 @@ -65,7 +65,7 @@ Dynabeans are a feature of <code>commons-beanutils</code> that allows data in non-beans to be wrapped into pseudo-beans. If betwixt supported dynabeans then you could do cool stuff like SQL -> DynaBeans -> XML. Probably a good way to do this would be to ensure that all property - intrspection is done by dyanbeans-aware methods of beanutils. + introspection is done by dyanbeans-aware methods of beanutils. </li> <li> <strong>Update RSS example application.</strong> @@ -227,6 +227,11 @@ <strong>Basic Support For Reading Mixed Content</strong> This is the basic case where all of the content is read into a single property. </li> + <li> + <strong>Basic Support For Writing DynaBeans</strong> + Basic support for writing DynaBeans has been added. This was implemented by using an additional + layer of abstraction in the introspector. + </li> </ul> </subsection> </section> @@ -325,6 +330,18 @@ The AbstractBeanWriter refactoring means that SAXBeanWriter now has a much cleaner internal API. If anyone out there has been doing funky stuff by extending SAXBeanWriter then i'm afraid that you'll need to rewrite. + </li> + <li> + <strong>Refactored Introspection</strong> + XMLIntrospector has been refactored to add an extra level of introspection indirection. + The results of introspection are now given in a BeanProperty. This allows support for + introspection alternatives to be added. + </li> + <li> + <strong>DynaBean Implementations</strong> + DynaBean's are now mapped using the properties found via the pseudo-introspection process + defined in BeanUtils. If you don't wish for DynaBeans implementations to be introspected + in this way then provide a <code>.betwixt</code> file to specify the mapping. </li> </ul> </subsection>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]