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/beanutils/optional/bean-collections/xdocs index.xml
Date Thu, 03 Jun 2004 20:27:52 GMT
rdonkin     2004/06/03 13:27:52

  Modified:    beanutils/optional/bean-collections/xdocs index.xml
  Log:
  Added some meat to the bean collections description
  
  Revision  Changes    Path
  1.2       +26 -1     jakarta-commons/beanutils/optional/bean-collections/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/beanutils/optional/bean-collections/xdocs/index.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.xml	10 May 2004 19:56:06 -0000	1.1
  +++ index.xml	3 Jun 2004 20:27:52 -0000	1.2
  @@ -46,7 +46,32 @@
   these classes to speed development and then substitute faster implementations only
   where the profiler indicates there is a problem :) 
   </p>
  -
  +    <subsection name='Quick-Quick Guide To Functors'>
  +        <p>
  +Many of the classes in <code>bean-collections</code> are functor implementations
  +specialized for bean properties. This is a very quick guide (aimed to let java developer
  +know why functors make for elegant code).
  +        </p>
  +        <p>
  +The word <code>functor</code> is mathematical in origin but comes into object
oriented
  +development from functional and logic coding. In Java terms, a functor 
  +is a function that is encapsulated as an object (and so can be manipulated as an object).
  +This allows elegant, concise and powerful techniques to be used. For example, 
  +<a href='http://jakarta.apache.org/commons/collections'>Commons Collections</a>
  +contains utilities that allow functions (as functors) to be easily applied to 
  +Collections.
  +        </p>
  +        <p>
  +This is actually pretty useful when it comes to collections of beans. It's a common 
  +problem to want to extract information from a collection of beans or to change all properties
  +to a particular value. Functors can be a particularly elegant way to do this. So try them!
  +You might just like them!
  +        </p>
  +        <p>
  +For more information about functors, please read the introduction to the
  +<a href='http://jakarta.apache.org/commons/sandbox/functor/'>Commons Functor component</a>.
  +        </p>
  +    </subsection>
   </section>
   
   </body>
  
  
  

---------------------------------------------------------------------
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