/** * Use this method to activate data tainting for this object * * Data tainting enables a check to the database every time a value is read from * this object. This can mean quite a lot of extra database activity, however it * is useful if you are concerned that there maybe a situation where a process is * might load some data from the database, and in the meantime another process might * write to it and this would potentially cause problems if the data that was already * in program memory weren't updated. * * Once an object is tainted using this method, you should put a try/catch block * around every call to a {@link read()} related method (such as set, get, fetch) * to catch a {@link TaintException} that may be thrown and deal with it. * * @access public * @see set,get,fetch,read,save,delete,TaintException */ public function taint() { $this->table->taint(); }