码迷,mamicode.com
首页 > Web开发 > 详细

thinkphp框架中“关联操作”的完整定义详解

时间:2015-03-17 19:37:02      阅读:182      评论:0      收藏:0      [点我收藏+]

标签:

转自:http://www.phpthink.cn/html/221.html

 

在复杂的关联操作中,如果要给关联定义增加可选的属性,我们可以采用完整定义方式
完整定义的格式是:
protected $_link = array(
    ‘关联1‘  =>  array(
        ‘该表的关联方式的属性1‘ => ‘定义‘,
        ‘该表的关联方式的属性N‘ => ‘定义‘,
    ),
    ‘关联表名2‘  =>  array(
        ‘该表的关联方式的属性1‘ => ‘定义‘,
        ‘该表的关联方式的属性N‘ => ‘定义‘,
    ),
    ...
);
在上面的格式描述中,对于属性我们使用了一个修饰词:该表的关联方式的属性。
关联操作的定义之所以觉得复杂和容易出错,也许是因为可定义的属性比较多,而且因为各种关联关系不同,可定义的属性也有部分区别,其实只要理解透这个知识点,你会发现关联操作其实也很简单。
我们换一种方式去啃下这个最麻烦的难点,先来了解所有允许定义的属性含义,然后再按照各种关联关系去对号入座。
完整方式的定义,替换上面的格式,会似这样,这里以Area表进行示例说明允许定义的属性这个概念
class UserModel extends Model{
    protected $_link = array(
        ‘Area‘=>array(
             ‘mapping_type‘=> BELONGS_TO,
             ‘mapping_name‘=> ‘Area‘,
             ‘class_name‘ => ‘Area‘,
             ‘foreign_key‘ => ‘area_id‘,
        ),
    );
}
上面代码中,mapping_type,foreign_key ...这些,就是允许定义的属性
-------------------------所有可定义的属性概述-------------------------------- mapping_type 
用以定义该表与主表的关联类型mapping_type所定义的内容必须是常量,共有下面四种方式:
HAS_ONE  表示当前模型(主表)拥有一个子对象,例如本例中的user_info,每个会员对应一个资料表
Belongs_to  表示当前模型从属于另外一个父对象,例如每个会员都从属于一个地区
HAS_MANY  表示当前模型拥有多个子对象,例如每个用户有多个兴趣消费卡
MANY_TO_MANY 表示当前模型可以属于多个对象,而父对象则可能包含有多个子对象,通常两者之间需要一个中间表类约束和关联。例如本例中的每个会员可以属于多个兴趣组,每个兴趣组可以有多个用户
class_name
要关联的模型类名称。
例如示例代码所定义的Area,再次提醒,一定要确保已定义了此模型类(AreaModel)。
mapping_name
关联的映射名称,用于获取数据用,作为数据集中与主表字段并列的数据索引
该名称不能与当前模型的字段重复,否则会导致关联数据获取的冲突mapping_name没有定义的话,会取class_name的定义作为mapping_name。即模型类名称
foreign_key
关联的外键名称
foreign_key如果没定义,则默认是 当前数据对象名称+_id 作为外键
例如:UserModel对应的表是think_user(注意:think只是一个数据表前缀,可以随意配置)
那么think_user表的外键默认为user_id,如果不是,就用该属性进行显式指定,例如数据表定义的外键是userId,则使用‘foreign_key‘=>‘userId‘,这种方式去申明
Condition
关联条件,在关联查询的时候会自动带上外键的值,如果有额外的查询条件,可以使用该属性进行定义
mapping_fields
关联要查询的字段
如果没有定义,默认关联查询的关联数据是该关联表的全部字段。
如果仅仅是需要查询其中的个别字段,可以使用该属性进行指定
as_fields
直接把关联的字段值映射成数据对象中的某个字段
这个特性是ONE_TO_ONE(包括HAS_ONE 和 BELONGS_TO)关联关系特有的,可以直接把关联数据映射到数据对象中,而不是作为一个关联数据。例如当关联数据的字段名和当前数据对象的字段名称有冲突时,可以使用下面这种方式进行定义:
‘as_fields‘=>‘email,nickname:username‘,没有定义该属性时数据类似于:
["id"] => string(1) "2"
["name"] => string(8) "thinkphp"
["Card"] => array(1) {
    [0] => array(1) {
        ["card"] => string(8) "88888888"
    }
如果定义了映射,则类似于
["id"]   => string(1) "2"
["name"] => string(8) "thinkphp"
["card"] => string(8) "88888888"
parent_key
自引用关联的关联字段
默认为parent_id (BELONGS_TO和HAS_MANY才有此属性)
自引用关联是一种比较特殊的关联,也就是关联表就是当前表。
mapping_limit
关联要返回的记录数目(HAS_MANY和MANY_TO_MANY才有此属性)
mapping_order
关联查询的排序 (HAS_MANY和MANY_TO_MANY才有此属性)
relation_foreign_key
关联表的外键名称 (MANY_TO_MANY独有属性)
默认的关联表的外键名称是 表名+_id
例如本示例中的relation_foreign_key是group_id
如果不符合,可通过此属性进行指定
relation_table
关联的中间表名称 (MANY_TO_MANY独有属性)
如果没有设置该属性,默认通过当前模型的getRelationTableName方法自动获取
例如当前模型是User,关联模型是Group,那么关联表的名称会默认使用user_group这样的格式。
默认的中间表命名规则是:
如果两个表存在一个对应的中间表,该中间表的命名方式为
数据表前缀+_ +关联操作的主表名+_+关联表名
例如本示例中,由think_user表操作关联表,所以和think_group表的中间表名称是think_user_group,如果是从think_group表来操作,那么中间命名是think_group_user,也就是说,多对多关联的设置,必须有一个Model类里面需要显式定义中间表,否则双向操作会出错。
另外,中间表的字段无需要有id主键,(不过就算建立了这个字段也不会影响中间表操作的)中间表通常只是由 user_id 和 group_id 构成就可以了。
如果中间表不符合上面的规则,则需要通过该属性去显式指定中间表名称。
各种关联关系类型可用属性归纳如下,使用中可对照此表和参考上面定义解释
HAS_ONE 可用属性
mapping_type
class_name
mapping_name
foreign_key
condition
mapping_fields
as_fields
BELONGS_TO 可用属性
mapping_name
foreign_key
mapping_fields
condition
parent_key
as_fields
HAS_MANY 可用属性
mapping_name
foreign_key
parent_key
mapping_fields
mapping_limit
mapping_order
MANY_TO_MANY 可用属性
mapping_name
foreign_key
elation_foreign_key
mapping_limit
mapping_order
relation_table
关联定义好后,我们就可以轻松使用关联操作了。
以下示例代码来自官方总工程师的关联操作示例,先贴出所有代码再对重点要注意的地方进行讲解
 
<?php
class IndexAction extends Action{
    public function index(){
        $User = D("User");
/*-------------- 关联写入 -------------------------------*/
        // 添加用户数据
        $User->name =  ‘thinkphp‘;
        $User->area_id   =  1;//东区
        // 用户档案数据
        $User->UserInfo =  array(
            ‘email‘  =>‘liu21st@gmail.com‘,
         ‘nickname‘ =>‘流年‘,
        );
        // 用户的消费卡数据
        $User->Card   =  array(
            array(‘id‘=>1,‘card‘=>‘12345678‘),// 消费卡帐号1
            array(‘id‘=>2,‘card‘=>‘88888888‘),// 消费卡帐号2
            );
        // 用户的所属兴趣组数据
        $User->Group =  array(
            array(‘id‘=>1),// 琴
            array(‘id‘=>2),// 棋
        );
        // 关联添加用户数据
        $id = $User->relation(true)->add();
        // 如果用户数据不是User模型 而是一个Data数组
        // 可以使用
        // $id = $User->relation(true)->add($Data);
        $this->assign(‘info1‘, ‘用户数据关联写入完成!‘);
/*-------------- 关联查询 -------------------------------*/
        $user   =  $User->relation(true)->find($id);
        $this->assign(‘user1‘,$user);
        $user   =  $User->relation(‘UserInfo‘)->find($id);
        $this->assign(‘user2‘,$user);
        $list   =  $User->relation(true)->findAll();
        $this->assign(‘list‘,$list);
/*-------------- 关联更新 -------------------------------*/
        $user[‘id‘]   = $id;
        $user[‘name‘] = ‘tp‘;
        // HAS_ONE 关联数据的更新直接赋值
        $user[‘UserInfo‘][‘email‘] =  ‘thinkphp@qq.com‘;
        // 注意HAS_MANY 的关联数据要加上主键的值
        // 可以更新部分数据
        $user[‘Card‘] = array(
            array(‘id‘=>1,‘card‘=>‘66666666‘), // 更新主键为1的记录
            array(‘card‘=>‘77777777‘),// 增加一条新的记录
        );
        // MANY_TO_MANY 的数据更新是重新写入
        $user[‘Group‘] =  array(
            array(‘id‘=>2),
        );
        $User->where(‘id=‘.$id)->relation(true)->save($user);
        // 查询更新后的数据
        $user   =  $User->relation(true)->find($id);
        $this->assign(‘user3‘,$user);
/*-------------- 关联删除 -------------------------------*/
        $User->relation(true)->delete($id);
/*--------------------------------------------------------*/
        $this->assign(‘info2‘, ‘用户ID为‘.$id.‘的数据已经关联删除!‘);
        $this->assign(‘id‘,$id);
        $this->display();
    }
}
?>
代码注解:
TP关联操作支持手动关联和自动关联,我们看到上面代码使用的是手动关联,通过在连贯操作中的relation()方法进行控制,如果需要自动关联操作,可以在UserModel中设置相应属性。
 
class UserModel extends RelationModel{
    protected $autoSaveRelations = true;        // 自动关联保存
    protected $autoDelRelations  = true;        // 自动关联删除
    protected $autoAddRelations  = true;        // 自动关联写入
    protected $autoReadRelations = true;        // 自动关联查询
    protected $_link = array(....);
}
例如当设置了自动关联查询属性为true时,使用$User->select(),系统会自动把所有定义的关联数据都查询出来,自动关联的应用可以自己进行测试体验,官方的建议是:当给模型定义了多个关联的时候,要尽量避免使用自动关联操作,以免影响性能
再来看上面的代码,插入数据时我们使用了这种方式:
// 用户档案数据
$User->UserInfo =  array(
    ‘email‘  =>‘liu21st@gmail.com‘,
    ‘nickname‘ =>‘流年‘,
);
是因为我们以User模型为核心对其它模型类进行关联定义的,其它模型类的mapping_name属性所定义的值,会被映射到User数据对象中成为User数据对象的其中一个属性,黙认mapping_name属性是关联的模型类名称。
如果是ONE_TO_ONE关联关系,并且定义了as_fields字段映射,则as_fields所设置的字段,会直接作为user数据对象的字段,这种情况在数据处理方式上,和单表模型是相同的,即直接赋值就可以:
$User->email    = ‘liu21st@gmail.com‘;
$User->nickname = ‘流年‘;
relation()方法在ThinkPHP1.6版中进行了改进,简化了以前的几种我们所熟悉的xFind(),xFindAll(),relationGet(),relationAdd(),relationSave(),relationDel()这些方法,全部整合到了新定义的relation()中,直接支持使用参数进行连贯操作。
当需要进行关联处理时,我们使用relation(ture)这种方式:
$id = $User->relation(true)->add();
如果要指定关联数据,可以如34行代码中那样,在relation方法中传入参数:
$user =$User->relation(‘UserInfo‘)->find($id);
至于关联更新的需要注意的是HAS_ONE 关联数据的更新直接赋值则可,
$user[‘UserInfo‘][‘email‘] =  ‘thinkphp@qq.com‘;
如果是HAS_MANY 的关联数据则要加上主键的值,可以更新部分数据或添加新的数据
$user[‘Card‘] = array(
    array(‘id‘=>1,‘card‘=>‘66666666‘), // 更新主键为1的记录
    array(‘card‘=>‘77777777‘),// 增加一条新的记录
);
MANY_TO_MANY关联在插入和更新时,都会自动先将原来关联的数据删除再进行处理。

打开Runtime/Logs/的log日志或开启debug模式时,可以留意一下生成sql

thinkphp框架中“关联操作”的完整定义详解

标签:

原文地址:http://www.cnblogs.com/c-961900940/p/4345224.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!