Commit 03bd99a2 authored by Crell's avatar Crell

Update documentation blocks for fully qualified class names.

parent a6b6fa5b
......@@ -70,7 +70,7 @@ abstract class Connection extends PDO {
*
* @var string
*/
protected $statementClass = '\\Drupal\\Core\\Database\\StatementBase';
protected $statementClass = 'Drupal\Core\Database\StatementBase';
/**
* Whether this database connection supports transactions.
......@@ -291,7 +291,7 @@ public function tablePrefix($table = 'default') {
* The query string as SQL, with curly-braces surrounding the
* table names.
*
* @return DatabaseStatementInterface
* @return Drupal\Core\Database\StatementInterface
* A PDO prepared statement ready for its execute() method.
*/
public function prepareQuery($query) {
......@@ -471,7 +471,7 @@ protected function filterComment($comment = '') {
* An associative array of options to control how the query is run. See
* the documentation for DatabaseConnection::defaultOptions() for details.
*
* @return DatabaseStatementInterface
* @return Drupal\Core\Database\StatementInterface
* This method will return one of: the executed statement, the number of
* rows affected by the query (not the number matched), or the generated
* insert IT of the last query, depending on the value of
......@@ -611,12 +611,12 @@ public function getDriverClass($class) {
* @param $options
* An array of options on the query.
*
* @return SelectQueryInterface
* @return Drupal\Core\Database\Query\SelectInterface
* An appropriate SelectQuery object for this database connection. Note that
* it may be a driver-specific subclass of SelectQuery, depending on the
* driver.
*
* @see SelectQuery
* @see Drupal\Core\Database\Query\Select
*/
public function select($table, $alias = NULL, array $options = array()) {
$class = $this->getDriverClass('Select');
......@@ -629,10 +629,10 @@ public function select($table, $alias = NULL, array $options = array()) {
* @param $options
* An array of options on the query.
*
* @return InsertQuery
* A new InsertQuery object.
* @return Drupal\Core\Database\Query\Insert
* A new Insert query object.
*
* @see InsertQuery
* @see Drupal\Core\Database\Query\Insert
*/
public function insert($table, array $options = array()) {
$class = $this->getDriverClass('Insert');
......@@ -645,10 +645,10 @@ public function insert($table, array $options = array()) {
* @param $options
* An array of options on the query.
*
* @return MergeQuery
* A new MergeQuery object.
* @return Drupal\Core\Database\Query\Merge
* A new Merge query object.
*
* @see MergeQuery
* @see Drupal\Core\Database\Query\Merge
*/
public function merge($table, array $options = array()) {
$class = $this->getDriverClass('Merge');
......@@ -662,10 +662,10 @@ public function merge($table, array $options = array()) {
* @param $options
* An array of options on the query.
*
* @return UpdateQuery
* A new UpdateQuery object.
* @return Drupal\Core\Database\Query\Update
* A new Update query object.
*
* @see UpdateQuery
* @see Drupal\Core\Database\Query\Update
*/
public function update($table, array $options = array()) {
$class = $this->getDriverClass('Update');
......@@ -678,10 +678,10 @@ public function update($table, array $options = array()) {
* @param $options
* An array of options on the query.
*
* @return DeleteQuery
* A new DeleteQuery object.
* @return Drupal\Core\Database\Query\Delete
* A new Delete query object.
*
* @see DeleteQuery
* @see Drupal\Core\Database\Query\Delete
*/
public function delete($table, array $options = array()) {
$class = $this->getDriverClass('Delete');
......@@ -694,10 +694,10 @@ public function delete($table, array $options = array()) {
* @param $options
* An array of options on the query.
*
* @return TruncateQuery
* A new TruncateQuery object.
* @return Drupal\Core\Database\Query\Truncate
* A new Truncate query object.
*
* @see TruncateQuery
* @see Drupal\Core\Database\Query\Truncate
*/
public function truncate($table, array $options = array()) {
$class = $this->getDriverClass('Truncate');
......@@ -709,8 +709,8 @@ public function truncate($table, array $options = array()) {
*
* This method will lazy-load the appropriate schema library file.
*
* @return DatabaseSchema
* The DatabaseSchema object for this connection.
* @return Drupal\Core\Database\Schema
* The database Schema object for this connection.
*/
public function schema() {
if (empty($this->schema)) {
......@@ -780,7 +780,7 @@ public function escapeAlias($field) {
* @endcode
*
* Backslash is defined as escape character for LIKE patterns in
* DatabaseCondition::mapConditionOperator().
* Drupal\Core\Database\Query\Condition::mapConditionOperator().
*
* @param $string
* The string to escape.
......@@ -815,7 +815,7 @@ public function transactionDepth() {
* @param $name
* Optional name of the savepoint.
*
* @see DatabaseTransaction
* @see Drupal\Core\Database\Transaction
*/
public function startTransaction($name = '') {
$class = $this->getDriverClass('Transaction');
......@@ -831,7 +831,7 @@ public function startTransaction($name = '') {
* The name of the savepoint. The default, 'drupal_transaction', will roll
* the entire transaction back.
*
* @throws TransactionNoActiveException
* @throws Drupal\Core\Database\TransactionNoActiveException
*
* @see DatabaseTransaction::rollback()
*/
......@@ -882,9 +882,9 @@ public function rollback($savepoint_name = 'drupal_transaction') {
*
* If no transaction is already active, we begin a new transaction.
*
* @throws TransactionNameNonUniqueException
* @throws Drupal\Core\Database\TransactionNameNonUniqueException
*
* @see DatabaseTransaction
* @see Drupal\Core\Database\Transaction
*/
public function pushTransaction($name) {
if (!$this->supportsTransactions()) {
......@@ -914,8 +914,8 @@ public function pushTransaction($name) {
* @param $name
* The name of the savepoint
*
* @throws TransactionNoActiveException
* @throws TransactionCommitFailedException
* @throws Drupal\Core\Database\TransactionNoActiveException
* @throws Drupal\Core\Database\TransactionCommitFailedException
*
* @see DatabaseTransaction
*/
......@@ -979,7 +979,7 @@ protected function popCommittableTransactions() {
* @param $options
* An array of options on the query.
*
* @return DatabaseStatementInterface
* @return Drupal\Core\Database\StatementInterface
* A database query result resource, or NULL if the query was not executed
* correctly.
*/
......@@ -1080,7 +1080,7 @@ public function supportsTransactionalDDL() {
* @return
* The extra handling directives for the specified operator, or NULL.
*
* @see DatabaseCondition::compile()
* @see Drupal\Core\Database\Query\Condition::compile()
*/
abstract public function mapConditionOperator($operator);
......@@ -1092,9 +1092,9 @@ public function supportsTransactionalDDL() {
* A direct commit bypasses all of the safety checks we've built on top of
* PDO's transaction routines.
*
* @throws TransactionExplicitCommitNotAllowedException
* @throws Drupal\Core\Database\TransactionExplicitCommitNotAllowedException
*
* @see DatabaseTransaction
* @see Drupal\Core\Database\Transaction
*/
public function commit() {
throw new TransactionExplicitCommitNotAllowedException();
......
......@@ -85,12 +85,12 @@ abstract class Database {
* @param $key
* The database connection key for which we want to log.
*
* @return DatabaseLog
* @return Drupal\Core\Database\Log
* The query log object. Note that the log object does support richer
* methods than the few exposed through the Database class, so in some
* cases it may be desirable to access it directly.
*
* @see Log
* @see Drupal\Core\Database\Log
*/
final public static function startLog($logging_key, $key = 'default') {
if (empty(self::$logs[$key])) {
......@@ -125,7 +125,7 @@ abstract class Database {
* @return array
* The query log for the specified logging key and connection.
*
* @see Log
* @see Drupal\Core\Database\Log
*/
final public static function getLog($logging_key, $key = 'default') {
if (empty(self::$logs[$key])) {
......@@ -144,7 +144,7 @@ abstract class Database {
* @param $key
* The database connection key. Defaults to NULL which means the active key.
*
* @return Connection
* @return Drupal\Core\Database\Connection
* The corresponding connection object.
*/
final public static function getConnection($target = 'default', $key = NULL) {
......@@ -351,8 +351,8 @@ public static function addConnectionInfo($key, $target, $info) {
* @param $target
* The database target to open.
*
* @throws ConnectionNotDefinedException
* @throws DriverNotSpecifiedException
* @throws Drupal\Core\Database\ConnectionNotDefinedException
* @throws Drupal\Core\Database\DriverNotSpecifiedException
*/
final protected static function openConnection($key, $target) {
if (empty(self::$databaseInfo)) {
......
......@@ -25,4 +25,4 @@ public function execute() {
return parent::execute();
}
}
}
\ No newline at end of file
}
......@@ -19,7 +19,7 @@ interface AlterableInterface {
* @param $tag
* The tag to add.
*
* @return QueryAlterableInterface
* @return Drupal\Core\Database\Query\AlterableInterface
* The called object.
*/
public function addTag($tag);
......@@ -72,7 +72,7 @@ public function hasAnyTag();
* @param $object
* The additional data to add to the query. May be any valid PHP variable.
*
* @return QueryAlterableInterface
* @return Drupal\Core\Database\Query\AlterableInterface
* The called object.
*/
public function addMetaData($key, $object);
......
......@@ -41,7 +41,7 @@ class Condition implements ConditionInterface, Countable {
protected $queryPlaceholderIdentifier;
/**
* Constructs a DataBaseCondition object.
* Constructs a Condition object.
*
* @param string $conjunction
* The operator to use to combine conditions: 'AND' or 'OR'.
......@@ -62,7 +62,7 @@ public function count() {
}
/**
* Implements QueryConditionInterface::condition().
* Implements Drupal\Core\Database\Query\ConditionInterface::condition().
*/
public function condition($field, $value = NULL, $operator = NULL) {
if (!isset($operator)) {
......@@ -85,7 +85,7 @@ public function condition($field, $value = NULL, $operator = NULL) {
}
/**
* Implements QueryConditionInterface::where().
* Implements Drupal\Core\Database\Query\ConditionInterface::where().
*/
public function where($snippet, $args = array()) {
$this->conditions[] = array(
......@@ -99,42 +99,42 @@ public function where($snippet, $args = array()) {
}
/**
* Implements QueryConditionInterface::isNull().
* Implements Drupal\Core\Database\Query\ConditionInterface::isNull().
*/
public function isNull($field) {
return $this->condition($field, NULL, 'IS NULL');
}
/**
* Implements QueryConditionInterface::isNotNull().
* Implements Drupal\Core\Database\Query\ConditionInterface::isNotNull().
*/
public function isNotNull($field) {
return $this->condition($field, NULL, 'IS NOT NULL');
}
/**
* Implements QueryConditionInterface::exists().
* Implements Drupal\Core\Database\Query\ConditionInterface::exists().
*/
public function exists(SelectInterface $select) {
return $this->condition('', $select, 'EXISTS');
}
/**
* Implements QueryConditionInterface::notExists().
* Implements Drupal\Core\Database\Query\ConditionInterface::notExists().
*/
public function notExists(SelectInterface $select) {
return $this->condition('', $select, 'NOT EXISTS');
}
/**
* Implements QueryConditionInterface::conditions().
* Implements Drupal\Core\Database\Query\ConditionInterface::conditions().
*/
public function &conditions() {
return $this->conditions;
}
/**
* Implements QueryConditionInterface::arguments().
* Implements Drupal\Core\Database\Query\ConditionInterface::arguments().
*/
public function arguments() {
// If the caller forgot to call compile() first, refuse to run.
......@@ -145,7 +145,7 @@ public function arguments() {
}
/**
* Implements QueryConditionInterface::compile().
* Implements Drupal\Core\Database\Query\ConditionInterface::compile().
*/
public function compile(Connection $connection, PlaceholderInterface $queryPlaceholder) {
// Re-compile if this condition changed or if we are compiled against a
......@@ -226,7 +226,7 @@ public function compile(Connection $connection, PlaceholderInterface $queryPlace
}
/**
* Implements QueryConditionInterface::compiled().
* Implements Drupal\Core\Database\Query\ConditionInterface::compiled().
*/
public function compiled() {
return !$this->changed;
......@@ -249,7 +249,7 @@ public function __toString() {
/**
* PHP magic __clone() method.
*
* Only copies fields that implement QueryConditionInterface. Also sets
* Only copies fields that implement Drupal\Core\Database\Query\ConditionInterface. Also sets
* $this->changed to TRUE.
*/
function __clone() {
......
......@@ -34,8 +34,8 @@ interface ConditionInterface {
* @return QueryConditionInterface
* The called object.
*
* @see QueryConditionInterface::isNull()
* @see QueryConditionInterface::isNotNull()
* @see Drupal\Core\Database\Query\ConditionInterface::isNull()
* @see Drupal\Core\Database\Query\ConditionInterface::isNotNull()
*/
public function condition($field, $value = NULL, $operator = NULL);
......@@ -48,7 +48,7 @@ public function condition($field, $value = NULL, $operator = NULL);
* @param $args
* An associative array of arguments.
*
* @return QueryConditionInterface
* @return Drupal\Core\Database\Query\ConditionInterface
* The called object.
*/
public function where($snippet, $args = array());
......@@ -59,7 +59,7 @@ public function where($snippet, $args = array());
* @param $field
* The name of the field to check.
*
* @return QueryConditionInterface
* @return Drupal\Core\Database\Query\ConditionInterface
* The called object.
*/
public function isNull($field);
......@@ -70,7 +70,7 @@ public function isNull($field);
* @param $field
* The name of the field to check.
*
* @return QueryConditionInterface
* @return Drupal\Core\Database\Query\ConditionInterface
* The called object.
*/
public function isNotNull($field);
......@@ -78,10 +78,10 @@ public function isNotNull($field);
/**
* Sets a condition that the specified subquery returns values.
*
* @param SelectQueryInterface $select
* @param Drupal\Core\Database\Query\SelectInterface $select
* The subquery that must contain results.
*
* @return QueryConditionInterface
* @return Drupal\Core\Database\Query\ConditionInterface
* The called object.
*/
public function exists(SelectInterface $select);
......@@ -89,10 +89,10 @@ public function exists(SelectInterface $select);
/**
* Sets a condition that the specified subquery returns no values.
*
* @param SelectQueryInterface $select
* @param Drupal\Core\Database\Query\SelectInterface $select
* The subquery that must not contain results.
*
* @return QueryConditionInterface
* @return Drupal\Core\Database\Query\ConditionInterface
* The called object.
*/
public function notExists(SelectInterface $select);
......
......@@ -27,9 +27,9 @@ class Delete extends Query implements ConditionInterface {
protected $condition;
/**
* Constructs a DeleteQuery object.
* Constructs a Delete object.
*
* @param DatabaseConnection $connection
* @param Drupal\Core\Database\Connection $connection
* A DatabaseConnection object.
* @param string $table
* Name of the table to associate with this query.
......@@ -45,7 +45,7 @@ public function __construct(Connection $connection, $table, array $options = arr
}
/**
* Implements QueryConditionInterface::condition().
* Implements Drupal\Core\Database\Query\ConditionInterface::condition().
*/
public function condition($field, $value = NULL, $operator = NULL) {
$this->condition->condition($field, $value, $operator);
......@@ -53,7 +53,7 @@ public function condition($field, $value = NULL, $operator = NULL) {
}
/**
* Implements QueryConditionInterface::isNull().
* Implements Drupal\Core\Database\Query\ConditionInterface::isNull().
*/
public function isNull($field) {
$this->condition->isNull($field);
......@@ -61,7 +61,7 @@ public function isNull($field) {
}
/**
* Implements QueryConditionInterface::isNotNull().
* Implements Drupal\Core\Database\Query\ConditionInterface::isNotNull().
*/
public function isNotNull($field) {
$this->condition->isNotNull($field);
......@@ -69,7 +69,7 @@ public function isNotNull($field) {
}
/**
* Implements QueryConditionInterface::exists().
* Implements Drupal\Core\Database\Query\ConditionInterface::exists().
*/
public function exists(SelectInterface $select) {
$this->condition->exists($select);
......@@ -77,7 +77,7 @@ public function exists(SelectInterface $select) {
}
/**
* Implements QueryConditionInterface::notExists().
* Implements Drupal\Core\Database\Query\ConditionInterface::notExists().
*/
public function notExists(SelectInterface $select) {
$this->condition->notExists($select);
......@@ -85,21 +85,21 @@ public function notExists(SelectInterface $select) {
}
/**
* Implements QueryConditionInterface::conditions().
* Implements Drupal\Core\Database\Query\ConditionInterface::conditions().
*/
public function &conditions() {
return $this->condition->conditions();
}
/**
* Implements QueryConditionInterface::arguments().
* Implements Drupal\Core\Database\Query\ConditionInterface::arguments().
*/
public function arguments() {
return $this->condition->arguments();
}
/**
* Implements QueryConditionInterface::where().
* Implements Drupal\Core\Database\Query\ConditionInterface::where().
*/
public function where($snippet, $args = array()) {
$this->condition->where($snippet, $args);
......@@ -107,14 +107,14 @@ public function where($snippet, $args = array()) {
}
/**
* Implements QueryConditionInterface::compile().
* Implements Drupal\Core\Database\Query\ConditionInterface::compile().
*/
public function compile(Connection $connection, PlaceholderInterface $queryPlaceholder) {
return $this->condition->compile($connection, $queryPlaceholder);
}
/**
* Implements QueryConditionInterface::compiled().
* Implements Drupal\Core\Database\Query\ConditionInterface::compiled().
*/
public function compiled() {
return $this->condition->compiled();
......
......@@ -22,7 +22,7 @@ interface ExtendableInterface {
* against the current database connection to allow driver-specific subclasses
* as well, using the same logic as the query objects themselves. For example,
* PagerDefault_mysql is the MySQL-specific override for PagerDefault.
* @return QueryExtendableInterface
* @return Drupal\Core\Database\Query\ExtendableInterface
* The extender object, which now contains a reference to this object.
*/
public function extend($extender_name);
......
......@@ -55,9 +55,9 @@ class Insert extends Query {
protected $fromQuery;
/**
* Constructs an InsertQuery object.
* Constructs an Insert object.
*
* @param DatabaseConnection $connection
* @param Drupal\Core\Database\Connection $connection
* A DatabaseConnection object.
* @param string $table
* Name of the table to associate with this query.
......@@ -89,7 +89,7 @@ public function __construct($connection, $table, array $options = array()) {
* An array of fields to insert into the database. The values must be
* specified in the same order as the $fields array.
*
* @return InsertQuery
* @return Drupal\Core\Database\Query\Insert
* The called object.
*/
public function fields(array $fields, array $values = array()) {
......@@ -120,7 +120,7 @@ public function fields(array $fields, array $values = array()) {
* @param $values
* An array of values to add to the query.
*
* @return InsertQuery
* @return Drupal\Core\Database\Query\Insert
* The called object.
*/
public function values(array $values) {
......@@ -154,7 +154,7 @@ public function values(array $values) {
* An array of values for which to use the default values
* specified in the table definition.
*
* @return InsertQuery
* @return Drupal\Core\Database\Query\Insert
* The called object.
*/
public function useDefaults(array $fields) {
......@@ -261,8 +261,8 @@ public function __toString() {
* @return
* TRUE if the validation was successful, FALSE if not.
*
* @throws FieldsOverlapException
* @throws NoFieldsException
* @throws Drupal\Core\Database\Query\FieldsOverlapException
* @throws Drupal\Core\Database\Query\NoFieldsException
*/
public function preExecute() {
// Confirm that the user did not try to specify an identical
......
......@@ -120,10 +120,10 @@ class Merge extends Query implements ConditionInterface {
protected $needsUpdate = FALSE;
/**
* Constructs a MergeQuery object.
* Constructs a Merge object.
*
* @param DatabaseConnection $connection
* A DatabaseConnection object.
* @param Drupal\Core\Database\Connection $connection
* A Drupal\Core\Database\Connection object.
* @param string $table
* Name of the table to associate with this query.
* @param array $options
......@@ -141,10 +141,10 @@ public function __construct(Connection $connection, $table, array $options = arr
* Sets the table or subquery to be used for the condition.
*
* @param $table
* The table name or the subquery to be used. Use a SelectQuery object to
* The table name or the subquery to be used. Use a Select query object to
* pass in a subquery.
*
* @return MergeQuery
* @return Drupal\Core\Database\Query\Merge
* The called object.
*/
protected function conditionTable($table) {
......@@ -159,7 +159,7 @@ protected function conditionTable($table) {
* An associative array of fields to write into the database. The array keys
* are the field names and the values are the values to which to set them.
*
* @return MergeQuery
* @return Drupal\Core\Database\Query\Merge
* The called object.
*/
public function updateFields(array $fields) {
......@@ -184,7 +184,7 @@ public function updateFields(array $fields) {
* If specified, this is an array of key/value pairs for named placeholders
* corresponding to the expression.
*
* @return MergeQuery
* @return Drupal\Core\Database\Query\Merge
* The called object.
*/
public function expression($field, $expression, array $arguments = NULL) {
......@@ -209,7 +209,7 @@ public function expression($field, $expression, array $arguments = NULL) {
* An array of fields to insert into the database. The values must be
* specified in the same order as the $fields array.
*
* @return MergeQuery
* @return Drupal\Core\Database\Query\Merge
* The called object.
*/
public function insertFields(array $fields, array $values = array()) {
......@@ -236,7 +236,7 @@ public function insertFields(array $fields, array $values = array()) {
* An array of values for which to use the default values
* specified in the table definition.
*
* @return MergeQuery
* @return Drupal\Core\Database\Query\Merge
* The called object.
*/
public function useDefaults(array $fields) {
......@@ -262,7 +262,7 @@ public function useDefaults(array $fields) {
* An array of values to set into the database. The values must be
* specified in the same order as the $fields array.
*
* @return MergeQuery
* @return Drupal\Core\Database\Query\Merge
* The called object.
*/
public function fields(array $fields, array $values = array()) {
......@@ -296,7 +296,7 @@ public function fields(array $fields, array $values = array()) {
* An array of values to set into the database. The values must be
* specified in the same order as the $fields array.
*
* @return MergeQuery
* @return Drupal\Core\Database\Query\Merge
* The called object.
*/
public function key(array $fields, array $values = array()) {
......@@ -311,7 +311,7 @@ public function key(array $fields, array $values = array()) {
}
/**
* Implements QueryConditionInterface::condition().
* Implements Drupal\Core\Database\Query\ConditionInterface::condition().
*/
public function condition($field, $value = NULL, $operator = NULL) {
$this->condition->condition($field, $value, $operator);
......@@ -319,7 +319,7 @@ public function condition($field, $value = NULL, $operator = NULL) {
}
/**
* Implements QueryConditionInterface::isNull().
* Implements Drupal\Core\Database\Query\ConditionInterface::isNull().
*/
public function isNull($field) {
$this->condition->isNull($field);
......@@ -327,7 +327,7 @@ public function isNull($field) {
}
/**
* Implements QueryConditionInterface::isNotNull().
* Implements Drupal\Core\Database\Query\ConditionInterface::isNotNull().
*/
public function isNotNull($field) {
$this->condition->isNotNull($field);
......@@ -335,7 +335,7 @@ public function isNotNull($field) {
}
/**
* Implements QueryConditionInterface::exists().
* Implements Drupal\Core\Database\Query\ConditionInterface::exists().
*/
public function exists(SelectInterface $select) {
$this->condition->exists($select);
......@@ -343,7 +343,7 @@ public function exists(SelectInterface $select) {
}
/**
* Implements QueryConditionInterface::notExists().
* Implements Drupal\Core\Database\Query\ConditionInterface::notExists().
*/
public function notExists(SelectInterface $select) {
$this->condition->notExists($select);
......@@ -351,21 +351,21 @@ public function notExists(SelectInterface $select) {
}
/**
* Implements QueryConditionInterface::conditions().
* Implements Drupal\Core\Database\Query\ConditionInterface::conditions().
*/
public function &conditions() {
return $this->condition->conditions();
}
/**
* Implements QueryConditionInterface::arguments().
* Implements Drupal\Core\Database\Query\ConditionInterface::arguments().
*/
public function arguments() {
return $this->condition->arguments();
}
/**
* Implements QueryConditionInterface::where().
* Implements Drupal\Core\Database\Query\ConditionInterface::where().
*/
public function where($snippet, $args = array()) {
$this->condition->where($snippet, $args);
......@@ -373,14 +373,14 @@ public function where($snippet, $args = array()) {
}
/**
* Implements QueryConditionInterface::compile().
* Implements Drupal\Core\Database\Query\ConditionInterface::compile().
*/
public function compile(Connection $connection, PlaceholderInterface $queryPlaceholder) {
return $this->condition->compile($connection, $queryPlaceholder);
}
/**
* Implements QueryConditionInterface::compiled().
* Implements Drupal\Core\Database\Query\ConditionInterface::compiled().
*/
public function compiled() {
return $this->condition->compiled();
......
......@@ -16,7 +16,7 @@ abstract class Query implements PlaceholderInterface {
/**
* The connection object on which to run this query.
*
* @var DatabaseConnection
* @var Drupal\Core\Database\Connection