Usage is fairly simple:
Where you need your objects (for example in one of your models getter) use the get/getOne/getByPath/getOneByPath functions (please see the PHDoc for the options/parameters at this time).
The function calls are cached per call of the page, meaning as long as you enter the same parameters, the functions will only call the db the first time.
Should memory be an issue, you can clear the "cache" (static field in the utility class) with the function Tx_ExtbaseDam_Utility_Dam::flushCache().
/**
* Getter for picture
*
* @return Tx_ExtbaseDam_Domain_Model_Dam Location picture
*/
public function getPicture() {
return Tx_ExtbaseDam_Utility_Dam::getOne('tx_yourextension_domain_model_yourtable', $this->uid, 'picture');
}Note that the 3rd argument must be the ident, so the ident you used in the TCA.