中山php|最优网络中山做网站 中山php建站

最优良人

2011/09/06 at 16:13

FleaPHP数据表关联设置

目前,FleaPHP支持四种类型的数据表关联,分别是:

HAS_ONE: 当前表的每一条记录都拥有最多一条(0–1)关联记录
HAS_MANY: 当前表的每一条记录都拥有多条(0-n)关联记录
MANY_TO_MANY: 当前表的每一条记录都和其他表的多条(0-n)记录关联
BELONGS_TO: 当前表的每一条记录都属于另一个表的某条记录

关联中必须设置的属性为:
‘name’, // 关联的名字(如:hasOne、hasMany)
‘tableClass’, // 关联的表数据入口对象名
‘mappingName’, // 字段映射名

可选属性:
‘foreignKey’, //外键字段名
’sort’, //对关联表进行查询时使用的排序参数
‘conditions’, //对关联表进行查询时使用的条件参数
‘fields’, //对关联表进行查询时要获取的关联表字段
‘limit’, //对关联表进行查询时限制查出的记录数
‘enabled’, //是否处理关联,设置为falses时,不处理该表入口的任何关联。enabled 的优先级高于 linkRead、linkCreate、linkUpdate 和 linkRemove。
‘countOnly’, //指示在查询关联表时是否仅仅统计记录数,而不实际查询数据
‘counterCache’, //将关联记录总数缓存到指定的字段,数据表中要建立相应的字段
‘linkRead’, //指示是否在主表读取记录时也读取该关联对应的关联表的记录,默认ture
‘linkCreate’, //指示是否在主表创建记录时也创建该关联对应的关联表的记录,默认ture
‘linkUpdate’, //指示是否在主表更新记录时也更新该关联对应的关联表的记录,默认ture
‘linkRemove’, //指示是否在主表删除记录时也删除该关联对应的关联表的记录,默认ture
‘linkRemoveFillValue’, //当删除主表记录而不删除关联表记录时,用什么值填充关联表记录的外键字段,默认0
’saveAssocMethod’, //指示当保存关联数据时,采用何种方法,默认为 save,可以设置为 create、update 或 replacevar $belongsTo = array(
‘tableClass’ => ‘Table_Users’,
‘mappingName’ => ‘author’,
‘foreignKey’ => ‘user_id’
);

var $hasOne = array(
‘tableClass’ => ‘Table_Profiles’,
‘mappingName’ => ‘profiles’,
‘foreignKey’ => ‘user_id’,
’saveAssocMethod’=> ’save’
);

var $hasMany = array(
‘tableClass’ => ‘Table_Profiles’,
‘mappingName’ => ‘profiles’,
‘foreignKey’ => ‘user_id’,
’saveAssocMethod’=> ’save’
);

var $manyToMany=array(

);

一个表可以有多个关联
var $hasMany = array(
array(
‘tableClass’ => ‘Model_Permissions’,
‘foreignKey’ => ‘pclass_id’,
‘mappingName’ => ‘permissions’,
),
array(
‘tableClass’ => ‘Model_Products’,
‘foreignKey’ => ‘pclass_id’,
‘mappingName’ => ‘products’,
‘enabled’ => false,
),
[
array(
...
),
]
);
关联: 一个关联是一个关系,这个关系属于某一个数据表。例如 users 表可能就拥有一个或者多个关联。
主表: 对于一个关联,拥有该关联的数据表就是主表。例如 posts 表定义了一个 MANY_TO_MANY 关联。
那么在这里(指这个关联),posts 就是主表。

关联表: 在一个关联中,关联表就是除主表外的另一个表。
外键: 在数据库原理中,外键的含义很复杂。但在 FleaPHP 框架中的数据库关联功能中,
外键泛指一个记录中用于关联另一个记录的字段。例如 profile 表中的 user_id 字段就是用于关联 users 表的字段。
这个 user_id 字段就是一个外键。

中间表: 在 MANY_TO_MANY 关联中,除了主表和关联表,还需要另一个表来保存这两个表的记录之间的互相关联关系。
这个表称为中间表。
HAS_ONE 一对一关联
HAS_ONE 是一种非常简单的关联关系。表示一个记录拥有另一个记录。这两个记录分别位于两个数据表中。

示例
在一个信息管理系统中,users 表用于存储用户帐户的基本信息,例如用户名、密码等。
而 profiles 表则用于存储用户的个人信息,例如家庭住址、邮政编码等。

由于每一个用户(一条 users 表中的记录)都有一份对应的个人信息(一条 profiles 表中的记录)。
因此,我们就可以为 users 表定义一个 HAS_ONE 关联。

很明显,users 表的记录拥有一条 profiles 表的记录。因此,当 users 表中的一条记录被删除时,
被删除记录所拥有的 profiles 表中的关联记录也会被自动删除。

表定义
在 HAS_ONE 关联中,要求外键放置在关联表中

分别对应FLEA_Db_TableDataGateway表中的 $hasOne,$hasMany,$manyToMany,$belongsTo 属性

我们下面就用 老师,学生,学生档案,班级的例子说说这几个关系。

以下是SQL代码:

//学生表
Create TABLE `testDB`.`student` (
`stu_id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
`stu_name` VARCHAR(20) NOT NULL,
`stu_class_id` INTEGER UNSIGNED NOT NULL,
PRIMARY KEY (`stu_id`)
)//学生档案表
Create TABLE `testDB`.`stu_record` (
`record_id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
`stu_id` INTEGER UNSIGNED NOT NULL,
`family_add` VARCHAR(150) NULL,
`family_tel` VARCHAR(20) NULL,
PRIMARY KEY (`record_id`)
)

//教师表
Create TABLE `testDB`.`teacher` (
`teacher_id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
`teacher_name` VARCHAR(20) NOT NULL,
PRIMARY KEY (`teacher_id`)
)

//班级表
Create TABLE `testDB`.`classes` (
`class_id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
`class_name` VARCHAR(20) NOT NULL,
PRIMARY KEY (`class_id`)
)

//由于教师与班级是多对多关系,所有建立一个中间连接表以表示该关联
Create TABLE `testDB`.`link_teacher_classes` (
`link_id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
`teacher_id` INTEGER UNSIGNED NOT NULL,
`class_id` INTEGER UNSIGNED NOT NULL,
PRIMARY KEY (`link_id`)
)

现在,建好表之后,我们还要写几个继承自FLEA_Db_TableDataGateway父类的类,以对应数据库中的Student,Teacher,Classes表(连接表不用了)如下:

//学生表对应的类
class Model_Student extends FLEA_Db_TableDataGateway{
var $tableName = ’student’;
var $primaryKey = ’stu_id’;

/*
这是一对一关系,一个学生对应唯一的一个Record档案
tableClass 对应要与之关联一对一的表的对象类,即档案表的类
foreignKey是在档案表中,对应学生表的一个外键接连字段,
用该字段标识该档案属于哪个学生
mappingName 就是用于在你查询学生信息时,学生档案字段的别名
*/
var $hasOne = array(
’tableClass’ => ‘Model_Record’,
’foreignKey’ => ’stu_id’,
’mappingName’ => ‘record’
);
/*
这是从属关系,一个学生属于某一个班级,换过来说就是班级与学生一对多,
一个班级有多个学生,而学生就只属于一个班级
tableClass 指定该类要与之有从属关系的类,这里是班级类
foreignKey 这里指定的是该表里的连接外表的字段,这里是学生表的班级ID字段
注意:这里的foreignKey指的是本表的字段,而上面hasOne关系中的foreignKey
指的是外表中的字段,要注意区分清楚
mappingName这里就不多说了,跟上面的一样,也是用于显示区分的别名
*/
var $belongsTo = array(
array(
’tableClass’ => ‘Model_Classes’,
’foreignKey’ => ’stu_class_id’,
’mappingName’ => ‘class’
)
);
}//档案表对应的类
class Model_Record extends FLEA_Db_TableDataGateway{
var $tableName = ’stu_record’;
var $primaryKey = ‘record_id’;
}

//教师表对应的类
class Model_Teacher extends FLEA_Db_TableDataGateway{
var $tableName = ‘teacher’;
var $primaryKey = ‘teacher_id’;

/*
这里确立了教师与班级的多对多关系,一个教师可以教多个班级
而一个班级也有多个教师
tableClass 指定要建立多对多关系的表的类
joinTable 这个属性要注意一个,这个是指定教师表与班级表关系的连接表
由于二维表的数据结构的原因,所以多对多关系要用一个中间表(即连接表)来表示
连接表中就指明两个表各自的主键ID就可以了,以两个字段作复合主键,如不用复合
主键,就新增加一个字段作主键也可,这没关系
*/
var $manyToMany = array(
array(
’tableClass’ => ‘Model_Classes’,
’mappingName’ => ‘class’,
’joinTable’ => ‘link_teacher_classes’,
)
);
}

class Model_Classes extends FLEA_Db_TableDataGateway{
var $tableName = ‘classes’;
var $primaryKey = ‘class_id’;

/*
这里确立了班级与学生的一对多关系
tableClass 指定该表的类要与哪个表的类建立一对多关系
foreignKey 外键ID,这里即指定学生表中定义的班级ID,这个是外表的字段
*/
var $hasMany = array(
array(
’tableClass’ => ‘Model_Student’,
’foreignKey’ => ’stu_class_id’,
’mappingName’ => ’students’
)
);

var $manyToMany = array(
// 由于多对多关系是双向的,所以班级表也可以定义上与教师表的多对多关系
// 也可以不写,看需求而定,比如你想查看某个班级信息时,一并显示该班
// 有多少个任课老师的话,那就在这个班级类里加上关系,我这里就不写了。。。
);
}

以上的代码就建立好了关系了,现在只管使用就是了。
不过还提醒大家一点,在每个关系里,都有一个 ‘enabled’ 的属性,如果设置为 false的话,则是将该关系禁掉,所以查询出来的结果就没有该关系的相应数据,这样可以节省效率,按需要时才打开相应的关联,该属性默认为true 可以如下设置:

array(
’tableClass’ => ‘Model_Student’,
’foreignKey’ => ’stu_class_id’,
’mappingName’ => ’students’,
‘enabled’ => false
)

现在我们来测试一下数据。(事先自行插入几行数据用以测试)

$classManager = FLEA::getSingleton(‘Model_Classes’);
$class =& $classManager->find(array(‘class_id’ => 1));
dump($class);
标签:,
-