2008-08-06 05:28:25 +02:00
|
|
|
<?php
|
|
|
|
/**
|
2012-04-12 08:02:46 +02:00
|
|
|
* @package framework
|
2008-08-09 08:40:50 +02:00
|
|
|
* @subpackage search
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Selects textual content with an exact match between columnname and keyword.
|
2008-08-06 05:28:25 +02:00
|
|
|
*
|
|
|
|
* @todo case sensitivity switch
|
|
|
|
* @todo documentation
|
2014-08-15 08:53:05 +02:00
|
|
|
*
|
2012-04-12 08:02:46 +02:00
|
|
|
* @package framework
|
2008-08-06 05:28:25 +02:00
|
|
|
* @subpackage search
|
|
|
|
*/
|
2008-08-09 05:54:55 +02:00
|
|
|
class ExactMatchFilter extends SearchFilter {
|
2012-12-10 23:35:04 +01:00
|
|
|
|
|
|
|
public function setModifiers(array $modifiers) {
|
2012-09-20 09:26:05 +02:00
|
|
|
if(($extras = array_diff($modifiers, array('not', 'nocase', 'case'))) != array()) {
|
|
|
|
throw new InvalidArgumentException(
|
|
|
|
get_class($this) . ' does not accept ' . implode(', ', $extras) . ' as modifiers');
|
|
|
|
}
|
2012-12-10 23:35:04 +01:00
|
|
|
|
|
|
|
parent::setModifiers($modifiers);
|
2012-09-20 09:26:05 +02:00
|
|
|
}
|
|
|
|
|
2008-08-09 06:06:52 +02:00
|
|
|
/**
|
|
|
|
* Applies an exact match (equals) on a field value.
|
|
|
|
*
|
2012-09-06 09:54:44 +02:00
|
|
|
* @return DataQuery
|
2008-08-09 06:06:52 +02:00
|
|
|
*/
|
2012-09-06 09:54:44 +02:00
|
|
|
protected function applyOne(DataQuery $query) {
|
2011-03-21 09:37:55 +01:00
|
|
|
$this->model = $query->applyRelation($this->relation);
|
2013-06-21 00:32:08 +02:00
|
|
|
$where = DB::get_conn()->comparisonClause(
|
2008-10-05 21:20:35 +02:00
|
|
|
$this->getDbName(),
|
2013-06-21 00:32:08 +02:00
|
|
|
null,
|
2012-12-10 23:35:04 +01:00
|
|
|
true, // exact?
|
|
|
|
false, // negate?
|
2013-06-21 00:32:08 +02:00
|
|
|
$this->getCaseSensitive(),
|
|
|
|
true
|
2012-12-10 23:35:04 +01:00
|
|
|
);
|
2013-06-21 00:32:08 +02:00
|
|
|
return $query->where(array($where => $this->getValue()));
|
2008-08-09 06:06:52 +02:00
|
|
|
}
|
2012-09-06 09:54:44 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Applies an exact match (equals) on a field value against multiple
|
|
|
|
* possible values.
|
|
|
|
*
|
|
|
|
* @return DataQuery
|
|
|
|
*/
|
|
|
|
protected function applyMany(DataQuery $query) {
|
|
|
|
$this->model = $query->applyRelation($this->relation);
|
2013-06-21 00:32:08 +02:00
|
|
|
$caseSensitive = $this->getCaseSensitive();
|
|
|
|
$values = $this->getValue();
|
|
|
|
if($caseSensitive === null) {
|
|
|
|
// For queries using the default collation (no explicit case) we can use the WHERE .. IN .. syntax,
|
|
|
|
// providing simpler SQL than many WHERE .. OR .. fragments.
|
|
|
|
$column = $this->getDbName();
|
|
|
|
$placeholders = DB::placeholders($values);
|
|
|
|
return $query->where(array(
|
|
|
|
"$column IN ($placeholders)" => $values
|
2012-09-20 09:26:05 +02:00
|
|
|
));
|
|
|
|
} else {
|
2013-06-21 00:32:08 +02:00
|
|
|
$whereClause = array();
|
|
|
|
$comparisonClause = DB::get_conn()->comparisonClause(
|
|
|
|
$this->getDbName(),
|
|
|
|
null,
|
|
|
|
true, // exact?
|
|
|
|
false, // negate?
|
|
|
|
$caseSensitive,
|
|
|
|
true
|
|
|
|
);
|
|
|
|
foreach($values as $value) {
|
|
|
|
$whereClause[] = array($comparisonClause => $value);
|
2012-09-20 09:26:05 +02:00
|
|
|
}
|
2013-06-21 00:32:08 +02:00
|
|
|
return $query->whereAny($whereClause);
|
2012-09-20 09:26:05 +02:00
|
|
|
}
|
2012-09-06 09:54:44 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Excludes an exact match (equals) on a field value.
|
|
|
|
*
|
|
|
|
* @return DataQuery
|
|
|
|
*/
|
|
|
|
protected function excludeOne(DataQuery $query) {
|
|
|
|
$this->model = $query->applyRelation($this->relation);
|
2013-06-21 00:32:08 +02:00
|
|
|
$where = DB::get_conn()->comparisonClause(
|
2012-09-06 09:54:44 +02:00
|
|
|
$this->getDbName(),
|
2013-06-21 00:32:08 +02:00
|
|
|
null,
|
2012-12-10 23:35:04 +01:00
|
|
|
true, // exact?
|
|
|
|
true, // negate?
|
2013-06-21 00:32:08 +02:00
|
|
|
$this->getCaseSensitive(),
|
|
|
|
true
|
2012-12-10 23:35:04 +01:00
|
|
|
);
|
2013-06-21 00:32:08 +02:00
|
|
|
return $query->where(array($where => $this->getValue()));
|
2012-09-06 09:54:44 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Excludes an exact match (equals) on a field value against multiple
|
|
|
|
* possible values.
|
|
|
|
*
|
|
|
|
* @return DataQuery
|
|
|
|
*/
|
|
|
|
protected function excludeMany(DataQuery $query) {
|
|
|
|
$this->model = $query->applyRelation($this->relation);
|
2013-06-21 00:32:08 +02:00
|
|
|
$caseSensitive = $this->getCaseSensitive();
|
|
|
|
$values = $this->getValue();
|
|
|
|
if($caseSensitive === null) {
|
|
|
|
// For queries using the default collation (no explicit case) we can use the WHERE .. NOT IN .. syntax,
|
|
|
|
// providing simpler SQL than many WHERE .. AND .. fragments.
|
|
|
|
$column = $this->getDbName();
|
|
|
|
$placeholders = DB::placeholders($values);
|
|
|
|
return $query->where(array(
|
|
|
|
"$column NOT IN ($placeholders)" => $values
|
2012-09-20 09:26:05 +02:00
|
|
|
));
|
|
|
|
} else {
|
2013-06-21 00:32:08 +02:00
|
|
|
// Generate reusable comparison clause
|
|
|
|
$comparisonClause = DB::get_conn()->comparisonClause(
|
|
|
|
$this->getDbName(),
|
|
|
|
null,
|
|
|
|
true, // exact?
|
|
|
|
true, // negate?
|
|
|
|
$this->getCaseSensitive(),
|
|
|
|
true
|
|
|
|
);
|
|
|
|
// Since query connective is ambiguous, use AND explicitly here
|
|
|
|
$count = count($values);
|
|
|
|
$predicate = implode(' AND ', array_fill(0, $count, $comparisonClause));
|
|
|
|
return $query->where(array($predicate => $values));
|
2012-09-20 09:26:05 +02:00
|
|
|
}
|
2012-09-06 09:54:44 +02:00
|
|
|
}
|
2014-08-15 08:53:05 +02:00
|
|
|
|
2008-08-11 02:03:57 +02:00
|
|
|
public function isEmpty() {
|
2012-09-06 09:54:44 +02:00
|
|
|
return $this->getValue() === array() || $this->getValue() === null || $this->getValue() === '';
|
2008-08-11 02:03:57 +02:00
|
|
|
}
|
2008-08-06 05:28:25 +02:00
|
|
|
}
|