Project Home • Forums • Wiki • Known Issues • Contact Project
BeanUtils isn't a library for mass use: it's intended for framework and tooling authors.
It's designed for folks building frameworks that manipulate "bean"-style CFCs, and focuses on enumerating and manipulating properties (defined by either <cfproperty> or getter functions).
While it has lower level CFCs to inspect and manipulate beans, they're all facaded by BeanUtils.cfc. You may compose it with alternate implementations of the lower-level inspector and converter CFCs to modify your use of BeanUtils.
BeanUtils.cfc provides methods such as:
inspect(): returning all explicit (<cfproperty>) and implicit properties (getNNN) of a CFC instance
inspectAsXML: inspect()'s result as XML)
methods to allow type-based caching of property information (getHash(), propertiesAreDirty()).
extract(): extracts a bean's data to a structure. It follows collections, and elegantly handles cyclic graphs (returning a cyclic struct, so don't <cfdump> it).
inject(): a struct of data into a CFC, but doesn't yet handle injecting collections of CFCs.
setProperty(bean, propname, value): sets a property's value regardless of setter style (<cfproperty>/THIS scope or setNNN)
getProperty(bean, propname): gets a property's value regardless of getter style (<cfproperty>/THIS scope or getNNN)
All included components are unit tested at a high level of coverage. Unit tests are included to help in development of your own extensions/customizations.
Note: on anything less than ColdFusion 8, a few tests fail (references the "component" type).
There are no issues for this project.
To enter issues for this (or any other) project, you must be logged in.
You may access this project's Subversion repository with your client here: http://svn.riaforge.org/beanutils.
To view files and changelists associated with this repository, go here: http://beanutils.riaforge.org/index.cfm?event=page.svnbrowse.
Anonymous users have read access to the repository while the administrator has write access.
This project is sharing its code via Subversion. Subversion is an open source source control method. You may find more information about Subversion here: http://subversion.tigris.org/
Adobe and the Adobe product names are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.