请选择 进入手机版 | 继续访问电脑版

SpeedPHP框架

 找回密码
 注册成为新用户

QQ登录

只需一步,快速开始

查看: 8612|回复: 0

[数据模型] 一对一数据关联

[复制链接]
发表于 2012-8-4 17:09:22 | 显示全部楼层 |阅读模式

在一对一关联中,spLinker提供了几乎全部的spModel拥有的功能,在理解了spModel的基础知识后,很轻易就可以使用spLinker带来的关联功能了。

关联 spLinker类型 可以应用范围 特殊要求

一对一关联 hasone find,findAll,findBy,create,update,delete,deleteByPk

首先看例子,我们先准备了两个数据表,分别是用户表及用户详细资料表,为了方便讲述,这里的数据表都是简化的。

user 用户表

user_id int 用户ID 自增/主键

user_name varchar(50) 用户名 唯一

user_detail 用户详细资料表

user_id int 用户ID 主键

intro varchar(255) 用户个人介绍

一个用户记录对应着一个详细资料,因而这两个表是一对一的。正如前文所述,由于详细资料在逻辑上并非经常和用户表同时出现,所以我们将本来是相关的记录拆分成两个表来对待。(下面我们称user为本表,user_detail为对应表)

第二步,我们分别建立了这两个表的spModel继承类,代码如下:

user.php

  1. <?php
  2. class user extends spModel
  3. {
  4.         public $pk = 'user_id';
  5.         public $table = 'user';
  6.         // 由spModel的变量$linker来设置表间关联
  7.         var $linker = array(
  8.                 array(
  9.                         'type' => 'hasone',   // 关联类型,这里是一对一关联
  10.                         'map' => 'detail',    // 关联的标识
  11.                         'mapkey' => 'user_id', // 本表与对应表关联的字段名
  12.                         'fclass' => 'user_detail', // 对应表的类名
  13.                         'fkey' => 'user_id',    // 对应表中关联的字段名
  14.                         'enabled' => true     // 启用关联
  15.                 )
  16.         );
  17. }
复制代码
user_detail.php
  1. <?php
  2. class user_detail extends spModel
  3. {
  4.         public $pk = 'user_id';
  5.         public $table = 'user_detail';
  6. }
复制代码

我们看到,作为主表的user类,它使用了$linker来设置关联信息(本章的最后将详细介绍$linker的每个设置的作用)。$linker是非常必要的,因为无论是作为模型类的变量出现,或者是在程序过程中动态地载入到spLinker中,都需要按照正确的格式去设置。

下面我们来介绍一对一关联的create,update,delete,find,findAll操作:

CREATE

首先,一般而言如果我们调用了user类的create方法,将在user表中新增一条记录。不过现在我们希望通过使用了一对一的关联,同时地将记录新增到主表和对应表上:

  1. $newrow = array(
  2.         'user_name' => "灰太狼",
  3.         'detail' => array(  // 请注意这里对应的就是$linker的'map' => 'detail',也就是关联的标识
  4.                 'intro' => "草原上的王者" // 这里是增加到对应表上的数据
  5.         ),
  6. );
  7. $userObj = spClass("user");
  8. $userObj->spLinker()->create($newrow); // 和普通的create不同!
复制代码

好了,看看两个数据表,数据已经如我们想象一样出现了:

user表

1 灰太狼

user_detail表

1 草原上的王者

在使用spLinker过程中,需要注意的地方如上面注释的,一个是关联的标识的作用,另一个是spLinker()->形式的函数调用。


$userObj->spLinker()->create($newrow)这种形式的调用在sp框架内尤其是spModel的附属类内经常可以见到,这是一种提高代码写作效率和减少理解误差的好方法。它在spModel的意义就是附加的功能,比如$userObj->spPager()->findAll()就是在findAll上面附加了spPager分页的功能,本例中$userObj->spLinker()->create($newrow); 就是在create的时候加入了spLinker关联功能等等。建议大家能好好的熟悉这种写法,这将为我们的系统开发效率带来非常明显的改善。

UPDATE

在一对一的关联中,更新可以是对主表的记录更新,也可以是对对应表的记录进行更新。当然,前提是更新条件要在主表中都能有记录匹配。

  1. $conditions = array('user_name' => "灰太狼"); // 和普通的update一样,首先是要有更新的条件,条件主要是针对主表的
  2. $updaterow = array( // 这里是需要更新的数据
  3.         'detail' => array( // 注意detail指代的是什么
  4.                 'intro' => "不像草原上的王者"
  5.         ),
  6. );
  7. $userObj = spClass("user");
  8. $userObj->spLinker()->update($conditions, $updaterow); // 完成更新
复制代码

执行了上面代码后,我们再来看看两表:

user表

1 灰太狼

user_detail表

1 不像草原上的王者

显然这里只更新了对应表。当然,如果加入其他的更新数据,那么主表也是能够更新的。

DELETE

一对一的关联中,删除操作是会将两表的对应记录同时删除。

  1. $conditions = array('user_name' => "灰太狼"); // 还是要设置对主表的条件
  2. $userObj = spClass("user");
  3. $userObj->spLinker()->delete($conditions); // 完成删除
复制代码

FIND / FINDALL

我们并没有把find和findAll放到前面去讲述,这是因为我们希望能够先了解数据从何而来,再去熟悉数据的使用。

在spLinker的作用下,拥有表间关联的find和findAll,查找获取的结果都将带上关联表中的内容。

首先我们准备下面的表数据:

user表

1 灰太狼

2 小羊羊

user_detail表

1 不像草原上的王者

2 是一只羊

然后我们用find查找

  1. $conditions = array("user_name"=>"小羊羊");
  2. $userObj = spClass("user");
  3. $result = $userObj->spLinker()->find($conditions);
  4. dump($result);
复制代码
结果是:
  1. Array
  2. (
  3.     [user_id] => 2
  4.     [user_name] => 小羊羊
  5.     [detail] => Array
  6.         (
  7.             [user_id] => 2
  8.             [intro] => 是一只羊
  9.         )
  10. )
复制代码

我们看到detail的标识已经带上了对应表user_detail的记录了。

使用findAll查找

  1. $userObj = spClass("user");
  2. $result = $userObj->spLinker()->findAll();
  3. dump($result);
复制代码
结果是:
  1. Array
  2. (
  3.     [0] => Array
  4.         (
  5.             [user_id] => 12
  6.             [user_name] => 灰太狼
  7.             [detail] => Array
  8.                 (
  9.                     [user_id] => 12
  10.                     [intro] => 不像草原上的王者
  11.                 )
  12.         )
  13.     [1] => Array
  14.         (
  15.             [user_id] => 14
  16.             [user_name] => 小羊羊
  17.             [detail] => Array
  18.                 (
  19.                     [user_id] => 14
  20.                     [intro] => 是一只羊
  21.                 )
  22.         )
  23. )
复制代码

主表和对应表的记录都能查找出来了。

以上,我们已经了解了spLinker的使用以及一对一关联的实例,接下来的教程中我们还将介绍一对多关联和多对多关联的用法。



在这里,我们还需要介绍一下$linker的全部属性,部分是上面已经介绍过的。

一、对本表内容而言

type,关联类型,只能取值"hasone","hasmany"和"manytomany"三者之一。

enabled,取值TRUE/FALSE,指示是否开启本关联

map,关联标识,在返回的结果里面标识关联内容的键值。

mapkey,本表中与对应表关联的字段名

二、对对应表内容而言

fclass,对应表的spModel继承类名称

fkey,对应表中与本表关联的字段名

三、在多对多情况中,还有

midclass,中间表的spModel继承类名称

四、对关联结果的限制

condition,对关联的附加条件,格式和findAll一样

countonly,取值TRUE/FALSE,在关联查找时是否只返回关联结果的记录数量,而并不返回全部结果。

sort,返回关联结果的排序,格式和findAll一样

field,返回关联结果的限定字段,格式和findAll一样

limit,返回关联结果的数量,格式和findAll一样

完整的 $linker 应该是:

  1. var $linker = array(
  2.                 array(
  3.                         'type' => 'hasmany',
  4.                         'map' => 'ulink',
  5.                         'mapkey' => 'user_id',
  6.                         'fclass' => 'gb',
  7.                         'fkey' => 'user_id',
  8.                         'midclass' => 'user2gb',
  9.                         'sort' => '', 'condition' => '', 'field' => '', 'limit' => '',
  10.                         'enabled' => true, 'countonly' => false
  11.                 ),
  12.                 array(
  13.                         ...
  14.                 )
  15. );
复制代码
您需要登录后才可以回帖 登录 | 注册成为新用户

本版积分规则

手机浏览|简版|中文PHP框架|开源协议|SpeedPHP.com ( 粤ICP备08008671号

GMT+8, 2020-7-8 13:13

Powered by Discuz! X3.2

© 2001-2013 Comsenz Inc.

快速回复 返回顶部 返回列表