/**
* This function performs the validation work for complex object models.
*
* In addition to checking the current object, all related objects will
* also be validated. If all pass then <code>true</code> is returned; otherwise
* an aggregated array of ValidationFailed objects will be returned.
*
* @param array $columns Array of column names to validate.
* @return mixed <code>true</code> if all validations pass; array of <code>ValidationFailed</code> objects otherwise.
*/
protected function doValidate($columns = null)
{
if (!$this->alreadyInValidation) {
$this->alreadyInValidation = true;
$retval = null;
$failureMap = array();
// We call the validate method on the following object(s) if they
// were passed to this object by their corresponding set
// method. This object relates to these object(s) by a
// foreign key reference.
if ($this->aUserRelatedByCreatedBy !== null) {
if (!$this->aUserRelatedByCreatedBy->validate($columns)) {
$failureMap = array_merge($failureMap, $this->aUserRelatedByCreatedBy->getValidationFailures());
}
}
if ($this->aUserRelatedByUpdatedBy !== null) {
if (!$this->aUserRelatedByUpdatedBy->validate($columns)) {
$failureMap = array_merge($failureMap, $this->aUserRelatedByUpdatedBy->getValidationFailures());
}
}
if (($retval = DocumentCategoryPeer::doValidate($this, $columns)) !== true) {
$failureMap = array_merge($failureMap, $retval);
}
if ($this->collDocuments !== null) {
foreach ($this->collDocuments as $referrerFK) {
if (!$referrerFK->validate($columns)) {
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
}
}
}
$this->alreadyInValidation = false;
}
return !empty($failureMap) ? $failureMap : true;
}