虚字段

    创建虚拟字段很简单。在每个模型中可以设置 属性,该属性是一个数组,形式如 字段名 => 表达式。下面是一个使用MySQL定义虚字段的例子:

    PostgreSQL中的写法:

    1. public $virtualFields = array(
    2. 'name' => 'User.first_name || \' \' || User.last_name'
    3. );

    在随后的查找操作中,User的查询结果中会一个多出键名为 name 键值为连接内容的字段。虚字段不要与数据库中已存在的字段名相同。否则会导致错误。

    有时可以不带 User.first_name,如果不遵循规范,(比如和其他表有多个关联)可能会出现错误。这种情况下,应该不带模型名,最好使用 first_name || \' \' || last_name

    操作虚拟字段有多种方法。

    如果模型中存在第一个参数指定的实际存在的字段,将返回true。将第二个参数 hasField() 设为true,虚拟字段也会被检查。使用上面的代码来举例:

    1. $this->User->hasField('name'); // 返回false,因为不存在名为name的实际字段
    2. $this->User->hasField('name', true); // 放回true,因为存在名为name的虚字段
    1. $this->User->isVirtualField('name'); //true
    2. $this->User->isVirtualField('first_name'); //false

    该方法用来取得虚字段对应的SQL表达式,如果没有参数,会返回该模型所有的虚字段:

    如前所述, 像处理其他字段一样处理虚字段。虚字段的值会包括在模型的结果中:

    1. $results = $this->User->find('first');
    2.  
    3. // 输出的结果
    4. array(
    5. 'first_name' => 'Mark',
    6. 'last_name' => 'Story',
    7. 'name' => 'Mark Story',
    8. //更多的字段...
    9. )
    10. );

    由于查询时虚字段与一般字段的行为一样,所以也可以用 Controller::paginate() 来排序。

    当你使用虚字段和带别名的模型,可能会遇到虚字段的模型不会更新映射到新的模型别名中去。如果使用的虚字段所在的模型中有多个别名,最好在模型的构造函数中来定义虚字段:

    1. public function __construct($id = false, $table = null, $ds = null) {
    2. parent::__construct($id, $table, $ds);
    3. $this->virtualFields['name'] = sprintf(
    4. 'CONCAT(%s.first_name, " ", %s.last_name)', $this->alias, $this->alias
    5. );
    6. }

    这将使虚字段在给定模型的所有别名中都有效。

    使用query函数直接进行SQL查询,其返回的数据并不和模型的数据一样。比如:

    1. $this->Timelog->query(
    2. "SELECT
    3. project_id, SUM(id) as TotalHours
    4. FROM
    5. timelogs
    6. AS
    7. Timelog
    8. GROUP BY
    9. project_id;"

    如果想把TotalHours放到Timelog数组中,我们需要为合计列指定一个虚拟字段。我们可以临时定义虚拟字段比定义在模型中更有效果。我们设定默认值为 0,免得其他查询使用这个虚拟字段。如果那样,TotalHours列会返回

    1. $this->Timelog->virtualFields['TotalHours'] = 0;

    除了增加虚拟字段,我们还需要用 MyModel__MyField 的形式给列起别名。比如:

    1. $this->Timelog->query(
    2. "SELECT
    3. project_id, SUM(id) as Timelog__TotalHours
    4. FROM
    5. timelogs
    6. AS
    7. Timelog
    8. GROUP BY
    9. project_id;"
    10. );

    在指定虚拟字段后再次查询,将会得到一个格式化好的的结果:

    1. Array
    2. (
    3. [0] => Array
    4. (
    5. [Timelog] => Array
    6. (
    7. [project_id] => 1234
    8. [TotalHours] => 25.5
    9. )
    10. )

    使用虚字段会带来一些局限。首先,不能在模型关联的条件(conditions),排序(order),字段(fields)数组中使用虚拟字段。如果那样做会产生SQL错误。因为字段被没有被ORM替代。很难去估算模型关联的深度。

    常见的解决办法是在运行时将 virtualFields 复制到其他模型:

    或:

    1. $this->virtualFields += $this->Author->virtualFields;