1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
<?php
/**
* TActiveRecordRelationContext class.
*
* @author Wei Zhuo <weizhuo[at]gmail[dot]com>
* @link http://www.pradosoft.com/
* @copyright Copyright © 2005-2007 PradoSoft
* @license http://www.pradosoft.com/license/
* @version $Id$
* @package System.Data.ActiveRecord.Relations
*/
/**
* TActiveRecordRelationContext holds information regarding record relationships
* such as record relation property name, query criteria and foreign object record
* class names.
*
* This class is use internally by passing a context to the TActiveRecordRelation
* constructor.
*
* @author Wei Zhuo <weizho[at]gmail[dot]com>
* @version $Id$
* @package System.Data.ActiveRecord.Relations
* @since 3.1
*/
class TActiveRecordRelationContext
{
/**
* static property name in TActiveRecord that defines the record relationships.
*/
const RELATIONS_CONST = 'RELATIONS';
private $_property;
private $_sourceRecord;
private $_criteria;
private $_relation;
public function __construct($source, $property, $criteria)
{
$this->_sourceRecord=$source;
$this->_property=$property;
$this->_criteria=$criteria;
$this->_relation = $this->getSourceRecordRelation($property);
}
/**
* Uses ReflectionClass to obtain the relation details array of a given
* property from the $RELATIONS static property in TActiveRecord.
* @param string relation property name
* @return array relation definition.
* @throws TActiveRecordException if property is not defined or missing.
*/
protected function getSourceRecordRelation($property)
{
$class = new ReflectionClass($this->_sourceRecord);
$statics = $class->getStaticProperties();
if(!isset($statics[self::RELATIONS_CONST]))
throw new TActiveRecordException('ar_relations_undefined',
get_class($this->_sourceRecord), self::RELATIONS_CONST);
if(isset($statics[self::RELATIONS_CONST][$property]))
return $statics[self::RELATIONS_CONST][$property];
else
throw new TActiveRecordException('ar_undefined_relation_prop',
$property, get_class($this->_sourceRecord), self::RELATIONS_CONST);
}
/**
* @return string name of the record property that the relationship results will be assigned to.
*/
public function getProperty()
{
return $this->_property;
}
/**
* @return TActiveRecordCriteria sql query criteria for fetching the related record.
*/
public function getCriteria()
{
return $this->_criteria;
}
/**
* @return TActiveRecord the active record instance that queried for its related records.
*/
public function getSourceRecord()
{
return $this->_sourceRecord;
}
/**
* @return string foreign record class name.
*/
public function getForeignRecordClass()
{
return $this->_relation[1];
}
/**
* @return string HAS_MANY, HAS_ONE, or BELONGS_TO
*/
public function getRelationType()
{
return $this->_relation[0];
}
/**
* @return string the M-N relationship association table name.
*/
public function getAssociationTable()
{
return $this->_relation[2];
}
/**
* @return boolean true if the relationship is HAS_MANY and requires an association table.
*/
public function hasAssociationTable()
{
return isset($this->_relation[2]);
}
/**
* @return TActiveRecord corresponding relationship foreign object finder instance.
*/
public function getForeignRecordFinder()
{
return TActiveRecord::finder($this->getForeignRecordClass());
}
/**
* Creates and return the TActiveRecordRelation handler for specific relationships.
* An instance of TActiveRecordHasOne, TActiveRecordBelongsTo, TActiveRecordHasMany,
* or TActiveRecordHasManyAssocation will be returned.
* @return TActiveRecordRelation record relationship handler instnace.
*/
public function getRelationHandler()
{
switch($this->getRelationType())
{
case TActiveRecord::HAS_MANY:
if(!$this->hasAssociationTable())
{
Prado::using('System.Data.ActiveRecord.Relations.TActiveRecordHasMany');
return new TActiveRecordHasMany($this);
}
else
{
Prado::using('System.Data.ActiveRecord.Relations.TActiveRecordHasManyAssociation');
return new TActiveRecordHasManyAssociation($this);
}
case TActiveRecord::HAS_ONE:
Prado::using('System.Data.ActiveRecord.Relations.TActiveRecordHasOne');
return new TActiveRecordHasOne($this);
case TActiveRecord::BELONGS_TO:
Prado::using('System.Data.ActiveRecord.Relations.TActiveRecordBelongsTo');
return new TActiveRecordBelongsTo($this);
default:
throw new TException('Not done yet');
}
}
}
?>
|
