* @since 2.0 */ class ActiveRecord extends \yii\db\ActiveRecord { const PRIMARY_KEY_NAME = 'id'; private $_id; private $_version; /** * Returns the database connection used by this AR class. * By default, the "elasticsearch" application component is used as the database connection. * You may override this method if you want to use a different database connection. * @return Connection the database connection used by this AR class. */ public static function getDb() { return \Yii::$app->getComponent('elasticsearch'); } /** * {@inheritdoc} */ public static function find($q = null) { $query = static::createQuery(); if (is_array($q)) { if (count($q) == 1 && (array_key_exists(ActiveRecord::PRIMARY_KEY_NAME, $q))) { $pk = $q[ActiveRecord::PRIMARY_KEY_NAME]; if (is_array($pk)) { return static::mget($pk); } else { return static::get($pk); } } return $query->where($q)->one(); } elseif ($q !== null) { return static::get($q); } return $query; } /** * Gets a record by its primary key. * * @param mixed $primaryKey the primaryKey value * @param array $options options given in this parameter are passed to elasticsearch * as request URI parameters. * Please refer to the [elasticsearch documentation](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-get.html) * for more details on these options. * @return static|null The record instance or null if it was not found. */ public static function get($primaryKey, $options = []) { if ($primaryKey === null) { return null; } $command = static::getDb()->createCommand(); $result = $command->get(static::index(), static::type(), $primaryKey, $options); if ($result['exists']) { return static::create($result); } return null; } /** * Gets a list of records by its primary keys. * * @param array $primaryKeys an array of primaryKey values * @param array $options options given in this parameter are passed to elasticsearch * as request URI parameters. * * Please refer to the [elasticsearch documentation](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-get.html) * for more details on these options. * @return static|null The record instance or null if it was not found. */ public static function mget($primaryKeys, $options = []) { if (empty($primaryKeys)) { return []; } $command = static::getDb()->createCommand(); $result = $command->mget(static::index(), static::type(), $primaryKeys, $options); $models = []; foreach($result['docs'] as $doc) { if ($doc['exists']) { $models[] = static::create($doc); } } return $models; } // TODO add more like this feature http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-more-like-this.html // TODO add percolate functionality http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-percolate.html /** * {@inheritdoc} */ public static function createQuery() { return new ActiveQuery(['modelClass' => get_called_class()]); } /** * {@inheritdoc} */ public static function createActiveRelation($config = []) { return new ActiveRelation($config); } // TODO implement copy and move as pk change is not possible public function getId() { return $this->_id; } /** * Sets the primary key * @param mixed $value * @throws \yii\base\InvalidCallException when record is not new */ public function setId($value) { if ($this->isNewRecord) { $this->_id = $value; } else { throw new InvalidCallException('Changing the primaryKey of an already saved record is not allowed.'); } } /** * {@inheritdoc} */ public function getPrimaryKey($asArray = false) { if ($asArray) { return [ActiveRecord::PRIMARY_KEY_NAME => $this->_id]; } else { return $this->_id; } } /** * {@inheritdoc} */ public function getOldPrimaryKey($asArray = false) { $id = $this->isNewRecord ? null : $this->_id; if ($asArray) { return [ActiveRecord::PRIMARY_KEY_NAME => $id]; } else { return $this->_id; } } /** * This method defines the primary. * * The primaryKey for elasticsearch documents is always `primaryKey`. It can not be changed. * * @return string[] the primary keys of this record. */ public static function primaryKey() { return [ActiveRecord::PRIMARY_KEY_NAME]; } /** * Returns the list of all attribute names of the model. * This method must be overridden by child classes to define available attributes. * @return array list of attribute names. */ public function attributes() { throw new InvalidConfigException('The attributes() method of elasticsearch ActiveRecord has to be implemented by child classes.'); } /** * @return string the name of the index this record is stored in. */ public static function index() { return Inflector::pluralize(Inflector::camel2id(StringHelper::basename(get_called_class()), '-')); } /** * @return string the name of the type of this record. */ public static function type() { return Inflector::camel2id(StringHelper::basename(get_called_class()), '-'); } /** * Creates an active record object using a row of data. * This method is called by [[ActiveQuery]] to populate the query results * into Active Records. It is not meant to be used to create new records. * @param array $row attribute values (name => value) * @return ActiveRecord the newly created active record. */ public static function create($row) { $row['_source'][ActiveRecord::PRIMARY_KEY_NAME] = $row['_id']; $record = parent::create($row['_source']); return $record; } /** * Inserts a document into the associated index using the attribute values of this record. * * This method performs the following steps in order: * * 1. call [[beforeValidate()]] when `$runValidation` is true. If validation * fails, it will skip the rest of the steps; * 2. call [[afterValidate()]] when `$runValidation` is true. * 3. call [[beforeSave()]]. If the method returns false, it will skip the * rest of the steps; * 4. insert the record into database. If this fails, it will skip the rest of the steps; * 5. call [[afterSave()]]; * * In the above step 1, 2, 3 and 5, events [[EVENT_BEFORE_VALIDATE]], * [[EVENT_BEFORE_INSERT]], [[EVENT_AFTER_INSERT]] and [[EVENT_AFTER_VALIDATE]] * will be raised by the corresponding methods. * * Only the [[dirtyAttributes|changed attribute values]] will be inserted into database. * * If the [[primaryKey|primary key]] is not set (null) during insertion, * it will be populated with a * [randomly generated value](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-index_.html#_automatic_id_generation) * after insertion. * * For example, to insert a customer record: * * ~~~ * $customer = new Customer; * $customer->name = $name; * $customer->email = $email; * $customer->insert(); * ~~~ * * @param boolean $runValidation whether to perform validation before saving the record. * If the validation fails, the record will not be inserted into the database. * @param array $attributes list of attributes that need to be saved. Defaults to null, * meaning all attributes will be saved. * @param array $options options given in this parameter are passed to elasticsearch * as request URI parameters. These are among others: * * - `routing` define shard placement of this record. * - `parent` by giving the primaryKey of another record this defines a parent-child relation * - `timestamp` specifies the timestamp to store along with the document. Default is indexing time. * * Please refer to the [elasticsearch documentation](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-index_.html) * for more details on these options. * * By default the `op_type` is set to `create`. * @return boolean whether the attributes are valid and the record is inserted successfully. */ public function insert($runValidation = true, $attributes = null, $options = ['op_type' => 'create']) { if ($runValidation && !$this->validate($attributes)) { return false; } if ($this->beforeSave(true)) { $values = $this->getDirtyAttributes($attributes); $response = static::getDb()->createCommand()->insert( static::index(), static::type(), $values, $this->getPrimaryKey(), $options ); if (!$response['ok']) { return false; } $this->_id = $response['_id']; $this->_version = $response['_version']; $this->setOldAttributes($values); $this->afterSave(true); return true; } return false; } /** * Updates all records whos primary keys are given. * For example, to change the status to be 1 for all customers whose status is 2: * * ~~~ * Customer::updateAll(array('status' => 1), array(2, 3, 4)); * ~~~ * * @param array $attributes attribute values (name-value pairs) to be saved into the table * @param array $condition the conditions that will be put in the WHERE part of the UPDATE SQL. * Please refer to [[ActiveQuery::where()]] on how to specify this parameter. * @param array $params this parameter is ignored in elasticsearch implementation. * @return integer the number of rows updated */ public static function updateAll($attributes, $condition = [], $params = []) { if (count($condition) == 1 && isset($condition[ActiveRecord::PRIMARY_KEY_NAME])) { $primaryKeys = (array) $condition[ActiveRecord::PRIMARY_KEY_NAME]; } else { $primaryKeys = static::find()->where($condition)->column(ActiveRecord::PRIMARY_KEY_NAME); } if (empty($primaryKeys)) { return 0; } $bulk = ''; foreach((array) $primaryKeys as $pk) { $action = Json::encode([ "update" => [ "_id" => $pk, "_type" => static::type(), "_index" => static::index(), ], ]); $data = Json::encode(array( "doc" => $attributes )); $bulk .= $action . "\n" . $data . "\n"; } // TODO do this via command $url = [static::index(), static::type(), '_bulk']; $response = static::getDb()->post($url, [], $bulk); $n=0; foreach($response['items'] as $item) { if ($item['update']['ok']) { $n++; } } return $n; } /** * Deletes rows in the table using the provided conditions. * WARNING: If you do not specify any condition, this method will delete ALL rows in the table. * * For example, to delete all customers whose status is 3: * * ~~~ * Customer::deleteAll('status = 3'); * ~~~ * * @param array $condition the conditions that will be put in the WHERE part of the DELETE SQL. * Please refer to [[ActiveQuery::where()]] on how to specify this parameter. * @param array $params this parameter is ignored in elasticsearch implementation. * @return integer the number of rows deleted */ public static function deleteAll($condition = [], $params = []) { if (count($condition) == 1 && isset($condition[ActiveRecord::PRIMARY_KEY_NAME])) { $primaryKeys = (array) $condition[ActiveRecord::PRIMARY_KEY_NAME]; } else { $primaryKeys = static::find()->where($condition)->column(ActiveRecord::PRIMARY_KEY_NAME); } if (empty($primaryKeys)) { return 0; } $bulk = ''; foreach((array) $primaryKeys as $pk) { $bulk .= Json::encode([ "delete" => [ "_id" => $pk, "_type" => static::type(), "_index" => static::index(), ], ]) . "\n"; } // TODO do this via command $url = [static::index(), static::type(), '_bulk']; $response = static::getDb()->post($url, [], $bulk); $n=0; foreach($response['items'] as $item) { if ($item['delete']['found'] && $item['delete']['ok']) { $n++; } } return $n; } /** * {@inheritdoc} */ public static function updateAllCounters($counters, $condition = null, $params = []) { throw new NotSupportedException('Update Counters is not supported by elasticsearch ActiveRecord.'); } /** * {@inheritdoc} */ public static function getTableSchema() { throw new NotSupportedException('getTableSchema() is not supported by elasticsearch ActiveRecord.'); } /** * {@inheritdoc} */ public static function tableName() { return static::index() . '/' . static::type(); } /** * {@inheritdoc} */ public static function findBySql($sql, $params = []) { throw new NotSupportedException('findBySql() is not supported by elasticsearch ActiveRecord.'); } /** * Returns a value indicating whether the specified operation is transactional in the current [[scenario]]. * This method will always return false as transactional operations are not supported by elasticsearch. * @param integer $operation the operation to check. Possible values are [[OP_INSERT]], [[OP_UPDATE]] and [[OP_DELETE]]. * @return boolean whether the specified operation is transactional in the current [[scenario]]. */ public function isTransactional($operation) { return false; } }