/**
* Adds an object to the instance pool.
*
* Propel keeps cached copies of objects in an instance pool when they are retrieved
* from the database. In some cases -- especially when you override doSelect*()
* methods in your stub classes -- you may need to explicitly add objects
* to the cache in order to ensure that the same objects are always returned by doSelect*()
* and retrieveByPK*() calls.
*
* @param DocumentData $obj A DocumentData object.
* @param string $key (optional) key to use for instance map (for performance boost if key was already calculated externally).
*/
public static function addInstanceToPool($obj, $key = null)
{
if (Propel::isInstancePoolingEnabled()) {
if ($key === null) {
$key = (string) $obj->getHash();
}
// if key === null
DocumentDataPeer::$instances[$key] = $obj;
}
}
/**
* Declares an association between this object and a DocumentData object.
*
* @param DocumentData $v
* @return Document The current object (for fluent API support)
* @throws PropelException
*/
public function setDocumentData(DocumentData $v = null)
{
if ($v === null) {
$this->setHash(NULL);
} else {
$this->setHash($v->getHash());
}
$this->aDocumentData = $v;
// Add binding for other direction of this n:n relationship.
// If this object has already been added to the DocumentData object, it will not be re-added.
if ($v !== null) {
$v->addDocument($this);
}
return $this;
}
/**
* Filter the query by a related DocumentData object
*
* @param DocumentData|PropelObjectCollection $documentData The related object(s) to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return DocumentQuery The current query, for fluid interface
* @throws PropelException - if the provided filter is invalid.
*/
public function filterByDocumentData($documentData, $comparison = null)
{
if ($documentData instanceof DocumentData) {
return $this->addUsingAlias(DocumentPeer::HASH, $documentData->getHash(), $comparison);
} elseif ($documentData instanceof PropelObjectCollection) {
if (null === $comparison) {
$comparison = Criteria::IN;
}
return $this->addUsingAlias(DocumentPeer::HASH, $documentData->toKeyValue('PrimaryKey', 'Hash'), $comparison);
} else {
throw new PropelException('filterByDocumentData() only accepts arguments of type DocumentData or PropelCollection');
}
}
/**
* Exclude object from result
*
* @param DocumentData $documentData Object to remove from the list of results
*
* @return DocumentDataQuery The current query, for fluid interface
*/
public function prune($documentData = null)
{
if ($documentData) {
$this->addUsingAlias(DocumentDataPeer::HASH, $documentData->getHash(), Criteria::NOT_EQUAL);
}
return $this;
}
