@@ -9,131 +9,131 @@ |
||
9 | 9 | */ |
10 | 10 | abstract class AbstractBeanPropertyDescriptor |
11 | 11 | { |
12 | - /** |
|
13 | - * @var Table |
|
14 | - */ |
|
15 | - protected $table; |
|
16 | - |
|
17 | - /** |
|
18 | - * Whether to use the more complex name in case of conflict. |
|
19 | - * |
|
20 | - * @var bool |
|
21 | - */ |
|
22 | - protected $alternativeName = false; |
|
23 | - |
|
24 | - /** |
|
25 | - * @param Table $table |
|
26 | - */ |
|
27 | - public function __construct(Table $table) |
|
28 | - { |
|
29 | - $this->table = $table; |
|
30 | - } |
|
31 | - |
|
32 | - /** |
|
33 | - * Use the more complex name in case of conflict. |
|
34 | - */ |
|
35 | - public function useAlternativeName() |
|
36 | - { |
|
37 | - $this->alternativeName = true; |
|
38 | - } |
|
39 | - |
|
40 | - /** |
|
41 | - * Returns the name of the class linked to this property or null if this is not a foreign key. |
|
42 | - * |
|
43 | - * @return null|string |
|
44 | - */ |
|
45 | - abstract public function getClassName(); |
|
46 | - |
|
47 | - /** |
|
48 | - * Returns the param annotation for this property (useful for constructor). |
|
49 | - * |
|
50 | - * @return string |
|
51 | - */ |
|
52 | - abstract public function getParamAnnotation(); |
|
53 | - |
|
54 | - public function getVariableName() |
|
55 | - { |
|
56 | - return '$'.$this->getLowerCamelCaseName(); |
|
57 | - } |
|
58 | - |
|
59 | - public function getLowerCamelCaseName() |
|
60 | - { |
|
61 | - return TDBMDaoGenerator::toVariableName($this->getUpperCamelCaseName()); |
|
62 | - } |
|
63 | - |
|
64 | - abstract public function getUpperCamelCaseName(); |
|
65 | - |
|
66 | - public function getSetterName() |
|
67 | - { |
|
68 | - return 'set'.$this->getUpperCamelCaseName(); |
|
69 | - } |
|
70 | - |
|
71 | - public function getGetterName() |
|
72 | - { |
|
73 | - return 'get'.$this->getUpperCamelCaseName(); |
|
74 | - } |
|
75 | - |
|
76 | - /** |
|
77 | - * Returns the PHP code used in the ben constructor for this property. |
|
78 | - * |
|
79 | - * @return string |
|
80 | - */ |
|
81 | - public function getConstructorAssignCode() |
|
82 | - { |
|
83 | - $str = ' $this->%s(%s);'; |
|
84 | - |
|
85 | - return sprintf($str, $this->getSetterName(), $this->getVariableName()); |
|
86 | - } |
|
87 | - |
|
88 | - /** |
|
89 | - * Returns true if the property is compulsory (and therefore should be fetched in the constructor). |
|
90 | - * |
|
91 | - * @return bool |
|
92 | - */ |
|
93 | - abstract public function isCompulsory(); |
|
94 | - |
|
95 | - /** |
|
96 | - * Returns true if the property has a default value. |
|
97 | - * |
|
98 | - * @return bool |
|
99 | - */ |
|
100 | - abstract public function hasDefault(); |
|
101 | - |
|
102 | - /** |
|
103 | - * Returns the code that assigns a value to its default value. |
|
104 | - * |
|
105 | - * @return string |
|
106 | - * |
|
107 | - * @throws \TDBMException |
|
108 | - */ |
|
109 | - abstract public function assignToDefaultCode(); |
|
110 | - |
|
111 | - /** |
|
112 | - * Returns true if the property is the primary key. |
|
113 | - * |
|
114 | - * @return bool |
|
115 | - */ |
|
116 | - abstract public function isPrimaryKey(); |
|
117 | - |
|
118 | - /** |
|
119 | - * @return Table |
|
120 | - */ |
|
121 | - public function getTable() |
|
122 | - { |
|
123 | - return $this->table; |
|
124 | - } |
|
125 | - |
|
126 | - /** |
|
127 | - * Returns the PHP code for getters and setters. |
|
128 | - * |
|
129 | - * @return string |
|
130 | - */ |
|
131 | - abstract public function getGetterSetterCode(); |
|
132 | - |
|
133 | - /** |
|
134 | - * Returns the part of code useful when doing json serialization. |
|
135 | - * |
|
136 | - * @return string |
|
137 | - */ |
|
138 | - abstract public function getJsonSerializeCode(); |
|
12 | + /** |
|
13 | + * @var Table |
|
14 | + */ |
|
15 | + protected $table; |
|
16 | + |
|
17 | + /** |
|
18 | + * Whether to use the more complex name in case of conflict. |
|
19 | + * |
|
20 | + * @var bool |
|
21 | + */ |
|
22 | + protected $alternativeName = false; |
|
23 | + |
|
24 | + /** |
|
25 | + * @param Table $table |
|
26 | + */ |
|
27 | + public function __construct(Table $table) |
|
28 | + { |
|
29 | + $this->table = $table; |
|
30 | + } |
|
31 | + |
|
32 | + /** |
|
33 | + * Use the more complex name in case of conflict. |
|
34 | + */ |
|
35 | + public function useAlternativeName() |
|
36 | + { |
|
37 | + $this->alternativeName = true; |
|
38 | + } |
|
39 | + |
|
40 | + /** |
|
41 | + * Returns the name of the class linked to this property or null if this is not a foreign key. |
|
42 | + * |
|
43 | + * @return null|string |
|
44 | + */ |
|
45 | + abstract public function getClassName(); |
|
46 | + |
|
47 | + /** |
|
48 | + * Returns the param annotation for this property (useful for constructor). |
|
49 | + * |
|
50 | + * @return string |
|
51 | + */ |
|
52 | + abstract public function getParamAnnotation(); |
|
53 | + |
|
54 | + public function getVariableName() |
|
55 | + { |
|
56 | + return '$'.$this->getLowerCamelCaseName(); |
|
57 | + } |
|
58 | + |
|
59 | + public function getLowerCamelCaseName() |
|
60 | + { |
|
61 | + return TDBMDaoGenerator::toVariableName($this->getUpperCamelCaseName()); |
|
62 | + } |
|
63 | + |
|
64 | + abstract public function getUpperCamelCaseName(); |
|
65 | + |
|
66 | + public function getSetterName() |
|
67 | + { |
|
68 | + return 'set'.$this->getUpperCamelCaseName(); |
|
69 | + } |
|
70 | + |
|
71 | + public function getGetterName() |
|
72 | + { |
|
73 | + return 'get'.$this->getUpperCamelCaseName(); |
|
74 | + } |
|
75 | + |
|
76 | + /** |
|
77 | + * Returns the PHP code used in the ben constructor for this property. |
|
78 | + * |
|
79 | + * @return string |
|
80 | + */ |
|
81 | + public function getConstructorAssignCode() |
|
82 | + { |
|
83 | + $str = ' $this->%s(%s);'; |
|
84 | + |
|
85 | + return sprintf($str, $this->getSetterName(), $this->getVariableName()); |
|
86 | + } |
|
87 | + |
|
88 | + /** |
|
89 | + * Returns true if the property is compulsory (and therefore should be fetched in the constructor). |
|
90 | + * |
|
91 | + * @return bool |
|
92 | + */ |
|
93 | + abstract public function isCompulsory(); |
|
94 | + |
|
95 | + /** |
|
96 | + * Returns true if the property has a default value. |
|
97 | + * |
|
98 | + * @return bool |
|
99 | + */ |
|
100 | + abstract public function hasDefault(); |
|
101 | + |
|
102 | + /** |
|
103 | + * Returns the code that assigns a value to its default value. |
|
104 | + * |
|
105 | + * @return string |
|
106 | + * |
|
107 | + * @throws \TDBMException |
|
108 | + */ |
|
109 | + abstract public function assignToDefaultCode(); |
|
110 | + |
|
111 | + /** |
|
112 | + * Returns true if the property is the primary key. |
|
113 | + * |
|
114 | + * @return bool |
|
115 | + */ |
|
116 | + abstract public function isPrimaryKey(); |
|
117 | + |
|
118 | + /** |
|
119 | + * @return Table |
|
120 | + */ |
|
121 | + public function getTable() |
|
122 | + { |
|
123 | + return $this->table; |
|
124 | + } |
|
125 | + |
|
126 | + /** |
|
127 | + * Returns the PHP code for getters and setters. |
|
128 | + * |
|
129 | + * @return string |
|
130 | + */ |
|
131 | + abstract public function getGetterSetterCode(); |
|
132 | + |
|
133 | + /** |
|
134 | + * Returns the part of code useful when doing json serialization. |
|
135 | + * |
|
136 | + * @return string |
|
137 | + */ |
|
138 | + abstract public function getJsonSerializeCode(); |
|
139 | 139 | } |
@@ -11,128 +11,128 @@ discard block |
||
11 | 11 | */ |
12 | 12 | class ScalarBeanPropertyDescriptor extends AbstractBeanPropertyDescriptor |
13 | 13 | { |
14 | - /** |
|
15 | - * @var Column |
|
16 | - */ |
|
17 | - private $column; |
|
18 | - |
|
19 | - public function __construct(Table $table, Column $column) |
|
20 | - { |
|
21 | - parent::__construct($table); |
|
22 | - $this->table = $table; |
|
23 | - $this->column = $column; |
|
24 | - } |
|
25 | - |
|
26 | - /** |
|
27 | - * Returns the foreign-key the column is part of, if any. null otherwise. |
|
28 | - * |
|
29 | - * @return ForeignKeyConstraint|null |
|
30 | - */ |
|
31 | - public function getForeignKey() |
|
32 | - { |
|
33 | - return false; |
|
34 | - } |
|
35 | - |
|
36 | - /** |
|
37 | - * Returns the param annotation for this property (useful for constructor). |
|
38 | - * |
|
39 | - * @return string |
|
40 | - */ |
|
41 | - public function getParamAnnotation() |
|
42 | - { |
|
43 | - $className = $this->getClassName(); |
|
44 | - $paramType = $className ?: TDBMDaoGenerator::dbalTypeToPhpType($this->column->getType()); |
|
45 | - |
|
46 | - $str = ' * @param %s %s'; |
|
47 | - |
|
48 | - return sprintf($str, $paramType, $this->getVariableName()); |
|
49 | - } |
|
50 | - |
|
51 | - public function getUpperCamelCaseName() |
|
52 | - { |
|
53 | - return TDBMDaoGenerator::toCamelCase($this->column->getName()); |
|
54 | - } |
|
55 | - |
|
56 | - /** |
|
57 | - * Returns the name of the class linked to this property or null if this is not a foreign key. |
|
58 | - * |
|
59 | - * @return null|string |
|
60 | - */ |
|
61 | - public function getClassName() |
|
62 | - { |
|
63 | - return; |
|
64 | - } |
|
65 | - |
|
66 | - /** |
|
67 | - * Returns true if the property is compulsory (and therefore should be fetched in the constructor). |
|
68 | - * |
|
69 | - * @return bool |
|
70 | - */ |
|
71 | - public function isCompulsory() |
|
72 | - { |
|
73 | - return $this->column->getNotnull() && !$this->column->getAutoincrement() && $this->column->getDefault() === null; |
|
74 | - } |
|
75 | - |
|
76 | - /** |
|
77 | - * Returns true if the property has a default value. |
|
78 | - * |
|
79 | - * @return bool |
|
80 | - */ |
|
81 | - public function hasDefault() |
|
82 | - { |
|
83 | - return $this->column->getDefault() !== null; |
|
84 | - } |
|
85 | - |
|
86 | - /** |
|
87 | - * Returns the code that assigns a value to its default value. |
|
88 | - * |
|
89 | - * @return string |
|
90 | - */ |
|
91 | - public function assignToDefaultCode() |
|
92 | - { |
|
93 | - $str = ' $this->%s(%s);'; |
|
94 | - |
|
95 | - $default = $this->column->getDefault(); |
|
96 | - |
|
97 | - if (strtoupper($default) === 'CURRENT_TIMESTAMP') { |
|
98 | - $defaultCode = 'new \DateTimeImmutable()'; |
|
99 | - } else { |
|
100 | - $defaultCode = var_export($this->column->getDefault(), true); |
|
101 | - } |
|
102 | - |
|
103 | - return sprintf($str, $this->getSetterName(), $defaultCode); |
|
104 | - } |
|
105 | - |
|
106 | - /** |
|
107 | - * Returns true if the property is the primary key. |
|
108 | - * |
|
109 | - * @return bool |
|
110 | - */ |
|
111 | - public function isPrimaryKey() |
|
112 | - { |
|
113 | - return in_array($this->column->getName(), $this->table->getPrimaryKeyColumns()); |
|
114 | - } |
|
115 | - |
|
116 | - /** |
|
117 | - * Returns the PHP code for getters and setters. |
|
118 | - * |
|
119 | - * @return string |
|
120 | - */ |
|
121 | - public function getGetterSetterCode() |
|
122 | - { |
|
123 | - $type = $this->column->getType(); |
|
124 | - $normalizedType = TDBMDaoGenerator::dbalTypeToPhpType($type); |
|
125 | - |
|
126 | - $columnGetterName = $this->getGetterName(); |
|
127 | - $columnSetterName = $this->getSetterName(); |
|
128 | - |
|
129 | - if ($normalizedType == '\\DateTimeInterface') { |
|
130 | - $castTo = '\\DateTimeInterface '; |
|
131 | - } else { |
|
132 | - $castTo = ''; |
|
133 | - } |
|
134 | - |
|
135 | - $getterAndSetterCode = ' /** |
|
14 | + /** |
|
15 | + * @var Column |
|
16 | + */ |
|
17 | + private $column; |
|
18 | + |
|
19 | + public function __construct(Table $table, Column $column) |
|
20 | + { |
|
21 | + parent::__construct($table); |
|
22 | + $this->table = $table; |
|
23 | + $this->column = $column; |
|
24 | + } |
|
25 | + |
|
26 | + /** |
|
27 | + * Returns the foreign-key the column is part of, if any. null otherwise. |
|
28 | + * |
|
29 | + * @return ForeignKeyConstraint|null |
|
30 | + */ |
|
31 | + public function getForeignKey() |
|
32 | + { |
|
33 | + return false; |
|
34 | + } |
|
35 | + |
|
36 | + /** |
|
37 | + * Returns the param annotation for this property (useful for constructor). |
|
38 | + * |
|
39 | + * @return string |
|
40 | + */ |
|
41 | + public function getParamAnnotation() |
|
42 | + { |
|
43 | + $className = $this->getClassName(); |
|
44 | + $paramType = $className ?: TDBMDaoGenerator::dbalTypeToPhpType($this->column->getType()); |
|
45 | + |
|
46 | + $str = ' * @param %s %s'; |
|
47 | + |
|
48 | + return sprintf($str, $paramType, $this->getVariableName()); |
|
49 | + } |
|
50 | + |
|
51 | + public function getUpperCamelCaseName() |
|
52 | + { |
|
53 | + return TDBMDaoGenerator::toCamelCase($this->column->getName()); |
|
54 | + } |
|
55 | + |
|
56 | + /** |
|
57 | + * Returns the name of the class linked to this property or null if this is not a foreign key. |
|
58 | + * |
|
59 | + * @return null|string |
|
60 | + */ |
|
61 | + public function getClassName() |
|
62 | + { |
|
63 | + return; |
|
64 | + } |
|
65 | + |
|
66 | + /** |
|
67 | + * Returns true if the property is compulsory (and therefore should be fetched in the constructor). |
|
68 | + * |
|
69 | + * @return bool |
|
70 | + */ |
|
71 | + public function isCompulsory() |
|
72 | + { |
|
73 | + return $this->column->getNotnull() && !$this->column->getAutoincrement() && $this->column->getDefault() === null; |
|
74 | + } |
|
75 | + |
|
76 | + /** |
|
77 | + * Returns true if the property has a default value. |
|
78 | + * |
|
79 | + * @return bool |
|
80 | + */ |
|
81 | + public function hasDefault() |
|
82 | + { |
|
83 | + return $this->column->getDefault() !== null; |
|
84 | + } |
|
85 | + |
|
86 | + /** |
|
87 | + * Returns the code that assigns a value to its default value. |
|
88 | + * |
|
89 | + * @return string |
|
90 | + */ |
|
91 | + public function assignToDefaultCode() |
|
92 | + { |
|
93 | + $str = ' $this->%s(%s);'; |
|
94 | + |
|
95 | + $default = $this->column->getDefault(); |
|
96 | + |
|
97 | + if (strtoupper($default) === 'CURRENT_TIMESTAMP') { |
|
98 | + $defaultCode = 'new \DateTimeImmutable()'; |
|
99 | + } else { |
|
100 | + $defaultCode = var_export($this->column->getDefault(), true); |
|
101 | + } |
|
102 | + |
|
103 | + return sprintf($str, $this->getSetterName(), $defaultCode); |
|
104 | + } |
|
105 | + |
|
106 | + /** |
|
107 | + * Returns true if the property is the primary key. |
|
108 | + * |
|
109 | + * @return bool |
|
110 | + */ |
|
111 | + public function isPrimaryKey() |
|
112 | + { |
|
113 | + return in_array($this->column->getName(), $this->table->getPrimaryKeyColumns()); |
|
114 | + } |
|
115 | + |
|
116 | + /** |
|
117 | + * Returns the PHP code for getters and setters. |
|
118 | + * |
|
119 | + * @return string |
|
120 | + */ |
|
121 | + public function getGetterSetterCode() |
|
122 | + { |
|
123 | + $type = $this->column->getType(); |
|
124 | + $normalizedType = TDBMDaoGenerator::dbalTypeToPhpType($type); |
|
125 | + |
|
126 | + $columnGetterName = $this->getGetterName(); |
|
127 | + $columnSetterName = $this->getSetterName(); |
|
128 | + |
|
129 | + if ($normalizedType == '\\DateTimeInterface') { |
|
130 | + $castTo = '\\DateTimeInterface '; |
|
131 | + } else { |
|
132 | + $castTo = ''; |
|
133 | + } |
|
134 | + |
|
135 | + $getterAndSetterCode = ' /** |
|
136 | 136 | * The getter for the "%s" column. |
137 | 137 | * |
138 | 138 | * @return %s |
@@ -152,50 +152,50 @@ discard block |
||
152 | 152 | |
153 | 153 | '; |
154 | 154 | |
155 | - return sprintf($getterAndSetterCode, |
|
156 | - // Getter |
|
157 | - $this->column->getName(), |
|
158 | - $normalizedType, |
|
159 | - $columnGetterName, |
|
160 | - var_export($this->column->getName(), true), |
|
161 | - var_export($this->table->getName(), true), |
|
162 | - // Setter |
|
163 | - $this->column->getName(), |
|
164 | - $normalizedType, |
|
165 | - $this->column->getName(), |
|
166 | - $columnSetterName, |
|
167 | - $castTo, |
|
168 | - $this->column->getName(), |
|
169 | - var_export($this->column->getName(), true), |
|
170 | - $this->column->getName(), |
|
171 | - var_export($this->table->getName(), true) |
|
172 | - ); |
|
173 | - } |
|
174 | - |
|
175 | - /** |
|
176 | - * Returns the part of code useful when doing json serialization. |
|
177 | - * |
|
178 | - * @return string |
|
179 | - */ |
|
180 | - public function getJsonSerializeCode() |
|
181 | - { |
|
182 | - $type = $this->column->getType(); |
|
183 | - $normalizedType = TDBMDaoGenerator::dbalTypeToPhpType($type); |
|
184 | - |
|
185 | - if ($normalizedType == '\\DateTimeInterface') { |
|
186 | - return ' $array['.var_export($this->getLowerCamelCaseName(), true).'] = ($this->'.$this->getGetterName().'() === null)?null:$this->'.$this->getGetterName()."()->format('c');\n"; |
|
187 | - } else { |
|
188 | - return ' $array['.var_export($this->getLowerCamelCaseName(), true).'] = $this->'.$this->getGetterName()."();\n"; |
|
189 | - } |
|
190 | - } |
|
191 | - |
|
192 | - /** |
|
193 | - * Returns the column name. |
|
194 | - * |
|
195 | - * @return string |
|
196 | - */ |
|
197 | - public function getColumnName() |
|
198 | - { |
|
199 | - return $this->column->getName(); |
|
200 | - } |
|
155 | + return sprintf($getterAndSetterCode, |
|
156 | + // Getter |
|
157 | + $this->column->getName(), |
|
158 | + $normalizedType, |
|
159 | + $columnGetterName, |
|
160 | + var_export($this->column->getName(), true), |
|
161 | + var_export($this->table->getName(), true), |
|
162 | + // Setter |
|
163 | + $this->column->getName(), |
|
164 | + $normalizedType, |
|
165 | + $this->column->getName(), |
|
166 | + $columnSetterName, |
|
167 | + $castTo, |
|
168 | + $this->column->getName(), |
|
169 | + var_export($this->column->getName(), true), |
|
170 | + $this->column->getName(), |
|
171 | + var_export($this->table->getName(), true) |
|
172 | + ); |
|
173 | + } |
|
174 | + |
|
175 | + /** |
|
176 | + * Returns the part of code useful when doing json serialization. |
|
177 | + * |
|
178 | + * @return string |
|
179 | + */ |
|
180 | + public function getJsonSerializeCode() |
|
181 | + { |
|
182 | + $type = $this->column->getType(); |
|
183 | + $normalizedType = TDBMDaoGenerator::dbalTypeToPhpType($type); |
|
184 | + |
|
185 | + if ($normalizedType == '\\DateTimeInterface') { |
|
186 | + return ' $array['.var_export($this->getLowerCamelCaseName(), true).'] = ($this->'.$this->getGetterName().'() === null)?null:$this->'.$this->getGetterName()."()->format('c');\n"; |
|
187 | + } else { |
|
188 | + return ' $array['.var_export($this->getLowerCamelCaseName(), true).'] = $this->'.$this->getGetterName()."();\n"; |
|
189 | + } |
|
190 | + } |
|
191 | + |
|
192 | + /** |
|
193 | + * Returns the column name. |
|
194 | + * |
|
195 | + * @return string |
|
196 | + */ |
|
197 | + public function getColumnName() |
|
198 | + { |
|
199 | + return $this->column->getName(); |
|
200 | + } |
|
201 | 201 | } |
@@ -12,156 +12,156 @@ discard block |
||
12 | 12 | */ |
13 | 13 | class ObjectBeanPropertyDescriptor extends AbstractBeanPropertyDescriptor |
14 | 14 | { |
15 | - /** |
|
16 | - * @var ForeignKeyConstraint |
|
17 | - */ |
|
18 | - private $foreignKey; |
|
19 | - |
|
20 | - /** |
|
21 | - * @var SchemaAnalyzer |
|
22 | - */ |
|
23 | - private $schemaAnalyzer; |
|
24 | - |
|
25 | - public function __construct(Table $table, ForeignKeyConstraint $foreignKey, SchemaAnalyzer $schemaAnalyzer) |
|
26 | - { |
|
27 | - parent::__construct($table); |
|
28 | - $this->foreignKey = $foreignKey; |
|
29 | - $this->schemaAnalyzer = $schemaAnalyzer; |
|
30 | - } |
|
31 | - |
|
32 | - /** |
|
33 | - * Returns the foreignkey the column is part of, if any. null otherwise. |
|
34 | - * |
|
35 | - * @return ForeignKeyConstraint|null |
|
36 | - */ |
|
37 | - public function getForeignKey() |
|
38 | - { |
|
39 | - return $this->foreignKey; |
|
40 | - } |
|
41 | - |
|
42 | - /** |
|
43 | - * Returns the name of the class linked to this property or null if this is not a foreign key. |
|
44 | - * |
|
45 | - * @return null|string |
|
46 | - */ |
|
47 | - public function getClassName() |
|
48 | - { |
|
49 | - return TDBMDaoGenerator::getBeanNameFromTableName($this->foreignKey->getForeignTableName()); |
|
50 | - } |
|
51 | - |
|
52 | - /** |
|
53 | - * Returns the param annotation for this property (useful for constructor). |
|
54 | - * |
|
55 | - * @return string |
|
56 | - */ |
|
57 | - public function getParamAnnotation() |
|
58 | - { |
|
59 | - $str = ' * @param %s %s'; |
|
60 | - |
|
61 | - return sprintf($str, $this->getClassName(), $this->getVariableName()); |
|
62 | - } |
|
63 | - |
|
64 | - public function getUpperCamelCaseName() |
|
65 | - { |
|
66 | - // First, are there many column or only one? |
|
67 | - // If one column, we name the setter after it. Otherwise, we name the setter after the table name |
|
68 | - if (count($this->foreignKey->getLocalColumns()) > 1) { |
|
69 | - $name = TDBMDaoGenerator::toSingular(TDBMDaoGenerator::toCamelCase($this->foreignKey->getForeignTableName())); |
|
70 | - if ($this->alternativeName) { |
|
71 | - $camelizedColumns = array_map(['Mouf\\Database\\TDBM\\Utils\\TDBMDaoGenerator', 'toCamelCase'], $this->foreignKey->getLocalColumns()); |
|
72 | - |
|
73 | - $name .= 'By'.implode('And', $camelizedColumns); |
|
74 | - } |
|
75 | - } else { |
|
76 | - $column = $this->foreignKey->getLocalColumns()[0]; |
|
77 | - // Let's remove any _id or id_. |
|
78 | - if (strpos(strtolower($column), 'id_') === 0) { |
|
79 | - $column = substr($column, 3); |
|
80 | - } |
|
81 | - if (strrpos(strtolower($column), '_id') === strlen($column) - 3) { |
|
82 | - $column = substr($column, 0, strlen($column) - 3); |
|
83 | - } |
|
84 | - $name = TDBMDaoGenerator::toCamelCase($column); |
|
85 | - if ($this->alternativeName) { |
|
86 | - $name .= 'Object'; |
|
87 | - } |
|
88 | - } |
|
89 | - |
|
90 | - return $name; |
|
91 | - } |
|
92 | - |
|
93 | - /** |
|
94 | - * Returns true if the property is compulsory (and therefore should be fetched in the constructor). |
|
95 | - * |
|
96 | - * @return bool |
|
97 | - */ |
|
98 | - public function isCompulsory() |
|
99 | - { |
|
100 | - // Are all columns nullable? |
|
101 | - $localColumnNames = $this->foreignKey->getLocalColumns(); |
|
102 | - |
|
103 | - foreach ($localColumnNames as $name) { |
|
104 | - $column = $this->table->getColumn($name); |
|
105 | - if ($column->getNotnull()) { |
|
106 | - return true; |
|
107 | - } |
|
108 | - } |
|
109 | - |
|
110 | - return false; |
|
111 | - } |
|
112 | - |
|
113 | - /** |
|
114 | - * Returns true if the property has a default value. |
|
115 | - * |
|
116 | - * @return bool |
|
117 | - */ |
|
118 | - public function hasDefault() |
|
119 | - { |
|
120 | - return false; |
|
121 | - } |
|
122 | - |
|
123 | - /** |
|
124 | - * Returns the code that assigns a value to its default value. |
|
125 | - * |
|
126 | - * @return string |
|
127 | - * |
|
128 | - * @throws \TDBMException |
|
129 | - */ |
|
130 | - public function assignToDefaultCode() |
|
131 | - { |
|
132 | - throw new \TDBMException('Foreign key based properties cannot be assigned a default value.'); |
|
133 | - } |
|
134 | - |
|
135 | - /** |
|
136 | - * Returns true if the property is the primary key. |
|
137 | - * |
|
138 | - * @return bool |
|
139 | - */ |
|
140 | - public function isPrimaryKey() |
|
141 | - { |
|
142 | - $fkColumns = $this->foreignKey->getLocalColumns(); |
|
143 | - sort($fkColumns); |
|
144 | - |
|
145 | - $pkColumns = $this->table->getPrimaryKeyColumns(); |
|
146 | - sort($pkColumns); |
|
147 | - |
|
148 | - return $fkColumns == $pkColumns; |
|
149 | - } |
|
150 | - |
|
151 | - /** |
|
152 | - * Returns the PHP code for getters and setters. |
|
153 | - * |
|
154 | - * @return string |
|
155 | - */ |
|
156 | - public function getGetterSetterCode() |
|
157 | - { |
|
158 | - $tableName = $this->table->getName(); |
|
159 | - $getterName = $this->getGetterName(); |
|
160 | - $setterName = $this->getSetterName(); |
|
161 | - |
|
162 | - $referencedBeanName = TDBMDaoGenerator::getBeanNameFromTableName($this->foreignKey->getForeignTableName()); |
|
163 | - |
|
164 | - $str = ' /** |
|
15 | + /** |
|
16 | + * @var ForeignKeyConstraint |
|
17 | + */ |
|
18 | + private $foreignKey; |
|
19 | + |
|
20 | + /** |
|
21 | + * @var SchemaAnalyzer |
|
22 | + */ |
|
23 | + private $schemaAnalyzer; |
|
24 | + |
|
25 | + public function __construct(Table $table, ForeignKeyConstraint $foreignKey, SchemaAnalyzer $schemaAnalyzer) |
|
26 | + { |
|
27 | + parent::__construct($table); |
|
28 | + $this->foreignKey = $foreignKey; |
|
29 | + $this->schemaAnalyzer = $schemaAnalyzer; |
|
30 | + } |
|
31 | + |
|
32 | + /** |
|
33 | + * Returns the foreignkey the column is part of, if any. null otherwise. |
|
34 | + * |
|
35 | + * @return ForeignKeyConstraint|null |
|
36 | + */ |
|
37 | + public function getForeignKey() |
|
38 | + { |
|
39 | + return $this->foreignKey; |
|
40 | + } |
|
41 | + |
|
42 | + /** |
|
43 | + * Returns the name of the class linked to this property or null if this is not a foreign key. |
|
44 | + * |
|
45 | + * @return null|string |
|
46 | + */ |
|
47 | + public function getClassName() |
|
48 | + { |
|
49 | + return TDBMDaoGenerator::getBeanNameFromTableName($this->foreignKey->getForeignTableName()); |
|
50 | + } |
|
51 | + |
|
52 | + /** |
|
53 | + * Returns the param annotation for this property (useful for constructor). |
|
54 | + * |
|
55 | + * @return string |
|
56 | + */ |
|
57 | + public function getParamAnnotation() |
|
58 | + { |
|
59 | + $str = ' * @param %s %s'; |
|
60 | + |
|
61 | + return sprintf($str, $this->getClassName(), $this->getVariableName()); |
|
62 | + } |
|
63 | + |
|
64 | + public function getUpperCamelCaseName() |
|
65 | + { |
|
66 | + // First, are there many column or only one? |
|
67 | + // If one column, we name the setter after it. Otherwise, we name the setter after the table name |
|
68 | + if (count($this->foreignKey->getLocalColumns()) > 1) { |
|
69 | + $name = TDBMDaoGenerator::toSingular(TDBMDaoGenerator::toCamelCase($this->foreignKey->getForeignTableName())); |
|
70 | + if ($this->alternativeName) { |
|
71 | + $camelizedColumns = array_map(['Mouf\\Database\\TDBM\\Utils\\TDBMDaoGenerator', 'toCamelCase'], $this->foreignKey->getLocalColumns()); |
|
72 | + |
|
73 | + $name .= 'By'.implode('And', $camelizedColumns); |
|
74 | + } |
|
75 | + } else { |
|
76 | + $column = $this->foreignKey->getLocalColumns()[0]; |
|
77 | + // Let's remove any _id or id_. |
|
78 | + if (strpos(strtolower($column), 'id_') === 0) { |
|
79 | + $column = substr($column, 3); |
|
80 | + } |
|
81 | + if (strrpos(strtolower($column), '_id') === strlen($column) - 3) { |
|
82 | + $column = substr($column, 0, strlen($column) - 3); |
|
83 | + } |
|
84 | + $name = TDBMDaoGenerator::toCamelCase($column); |
|
85 | + if ($this->alternativeName) { |
|
86 | + $name .= 'Object'; |
|
87 | + } |
|
88 | + } |
|
89 | + |
|
90 | + return $name; |
|
91 | + } |
|
92 | + |
|
93 | + /** |
|
94 | + * Returns true if the property is compulsory (and therefore should be fetched in the constructor). |
|
95 | + * |
|
96 | + * @return bool |
|
97 | + */ |
|
98 | + public function isCompulsory() |
|
99 | + { |
|
100 | + // Are all columns nullable? |
|
101 | + $localColumnNames = $this->foreignKey->getLocalColumns(); |
|
102 | + |
|
103 | + foreach ($localColumnNames as $name) { |
|
104 | + $column = $this->table->getColumn($name); |
|
105 | + if ($column->getNotnull()) { |
|
106 | + return true; |
|
107 | + } |
|
108 | + } |
|
109 | + |
|
110 | + return false; |
|
111 | + } |
|
112 | + |
|
113 | + /** |
|
114 | + * Returns true if the property has a default value. |
|
115 | + * |
|
116 | + * @return bool |
|
117 | + */ |
|
118 | + public function hasDefault() |
|
119 | + { |
|
120 | + return false; |
|
121 | + } |
|
122 | + |
|
123 | + /** |
|
124 | + * Returns the code that assigns a value to its default value. |
|
125 | + * |
|
126 | + * @return string |
|
127 | + * |
|
128 | + * @throws \TDBMException |
|
129 | + */ |
|
130 | + public function assignToDefaultCode() |
|
131 | + { |
|
132 | + throw new \TDBMException('Foreign key based properties cannot be assigned a default value.'); |
|
133 | + } |
|
134 | + |
|
135 | + /** |
|
136 | + * Returns true if the property is the primary key. |
|
137 | + * |
|
138 | + * @return bool |
|
139 | + */ |
|
140 | + public function isPrimaryKey() |
|
141 | + { |
|
142 | + $fkColumns = $this->foreignKey->getLocalColumns(); |
|
143 | + sort($fkColumns); |
|
144 | + |
|
145 | + $pkColumns = $this->table->getPrimaryKeyColumns(); |
|
146 | + sort($pkColumns); |
|
147 | + |
|
148 | + return $fkColumns == $pkColumns; |
|
149 | + } |
|
150 | + |
|
151 | + /** |
|
152 | + * Returns the PHP code for getters and setters. |
|
153 | + * |
|
154 | + * @return string |
|
155 | + */ |
|
156 | + public function getGetterSetterCode() |
|
157 | + { |
|
158 | + $tableName = $this->table->getName(); |
|
159 | + $getterName = $this->getGetterName(); |
|
160 | + $setterName = $this->getSetterName(); |
|
161 | + |
|
162 | + $referencedBeanName = TDBMDaoGenerator::getBeanNameFromTableName($this->foreignKey->getForeignTableName()); |
|
163 | + |
|
164 | + $str = ' /** |
|
165 | 165 | * Returns the '.$referencedBeanName.' object bound to this object via the '.implode(' and ', $this->foreignKey->getLocalColumns()).' column. |
166 | 166 | * |
167 | 167 | * @return '.$referencedBeanName.' |
@@ -181,19 +181,19 @@ discard block |
||
181 | 181 | |
182 | 182 | '; |
183 | 183 | |
184 | - return $str; |
|
185 | - } |
|
186 | - |
|
187 | - /** |
|
188 | - * Returns the part of code useful when doing json serialization. |
|
189 | - * |
|
190 | - * @return string |
|
191 | - */ |
|
192 | - public function getJsonSerializeCode() |
|
193 | - { |
|
194 | - return ' if (!$stopRecursion) { |
|
184 | + return $str; |
|
185 | + } |
|
186 | + |
|
187 | + /** |
|
188 | + * Returns the part of code useful when doing json serialization. |
|
189 | + * |
|
190 | + * @return string |
|
191 | + */ |
|
192 | + public function getJsonSerializeCode() |
|
193 | + { |
|
194 | + return ' if (!$stopRecursion) { |
|
195 | 195 | $array['.var_export($this->getLowerCamelCaseName(), true).'] = $this->'.$this->getGetterName().'()->jsonSerialize(true); |
196 | 196 | } |
197 | 197 | '; |
198 | - } |
|
198 | + } |
|
199 | 199 | } |
@@ -17,200 +17,200 @@ discard block |
||
17 | 17 | */ |
18 | 18 | class TDBMDaoGenerator |
19 | 19 | { |
20 | - /** |
|
21 | - * @var SchemaAnalyzer |
|
22 | - */ |
|
23 | - private $schemaAnalyzer; |
|
24 | - |
|
25 | - /** |
|
26 | - * @var Schema |
|
27 | - */ |
|
28 | - private $schema; |
|
29 | - |
|
30 | - /** |
|
31 | - * The root directory of the project. |
|
32 | - * |
|
33 | - * @var string |
|
34 | - */ |
|
35 | - private $rootPath; |
|
36 | - |
|
37 | - /** |
|
38 | - * Name of composer file. |
|
39 | - * |
|
40 | - * @var string |
|
41 | - */ |
|
42 | - private $composerFile; |
|
43 | - |
|
44 | - /** |
|
45 | - * @var TDBMSchemaAnalyzer |
|
46 | - */ |
|
47 | - private $tdbmSchemaAnalyzer; |
|
48 | - |
|
49 | - /** |
|
50 | - * Constructor. |
|
51 | - * |
|
52 | - * @param SchemaAnalyzer $schemaAnalyzer |
|
53 | - * @param Schema $schema |
|
54 | - * @param TDBMSchemaAnalyzer $tdbmSchemaAnalyzer |
|
55 | - */ |
|
56 | - public function __construct(SchemaAnalyzer $schemaAnalyzer, Schema $schema, TDBMSchemaAnalyzer $tdbmSchemaAnalyzer) |
|
57 | - { |
|
58 | - $this->schemaAnalyzer = $schemaAnalyzer; |
|
59 | - $this->schema = $schema; |
|
60 | - $this->tdbmSchemaAnalyzer = $tdbmSchemaAnalyzer; |
|
61 | - $this->rootPath = __DIR__.'/../../../../../../../../'; |
|
62 | - $this->composerFile = 'composer.json'; |
|
63 | - } |
|
64 | - |
|
65 | - /** |
|
66 | - * Generates all the daos and beans. |
|
67 | - * |
|
68 | - * @param string $daoFactoryClassName The classe name of the DAO factory |
|
69 | - * @param string $daonamespace The namespace for the DAOs, without trailing \ |
|
70 | - * @param string $beannamespace The Namespace for the beans, without trailing \ |
|
71 | - * @param bool $storeInUtc If the generated daos should store the date in UTC timezone instead of user's timezone. |
|
72 | - * |
|
73 | - * @return \string[] the list of tables |
|
74 | - * |
|
75 | - * @throws TDBMException |
|
76 | - */ |
|
77 | - public function generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc) |
|
78 | - { |
|
79 | - $classNameMapper = ClassNameMapper::createFromComposerFile($this->rootPath.$this->composerFile); |
|
80 | - // TODO: check that no class name ends with "Base". Otherwise, there will be name clash. |
|
81 | - |
|
82 | - $tableList = $this->schema->getTables(); |
|
83 | - |
|
84 | - // Remove all beans and daos from junction tables |
|
85 | - $junctionTables = $this->schemaAnalyzer->detectJunctionTables(true); |
|
86 | - $junctionTableNames = array_map(function (Table $table) { |
|
87 | - return $table->getName(); |
|
88 | - }, $junctionTables); |
|
89 | - |
|
90 | - $tableList = array_filter($tableList, function (Table $table) use ($junctionTableNames) { |
|
91 | - return !in_array($table->getName(), $junctionTableNames); |
|
92 | - }); |
|
93 | - |
|
94 | - foreach ($tableList as $table) { |
|
95 | - $this->generateDaoAndBean($table, $daonamespace, $beannamespace, $classNameMapper, $storeInUtc); |
|
96 | - } |
|
97 | - |
|
98 | - $this->generateFactory($tableList, $daoFactoryClassName, $daonamespace, $classNameMapper); |
|
99 | - |
|
100 | - // Ok, let's return the list of all tables. |
|
101 | - // These will be used by the calling script to create Mouf instances. |
|
102 | - |
|
103 | - return array_map(function (Table $table) { return $table->getName(); }, $tableList); |
|
104 | - } |
|
105 | - |
|
106 | - /** |
|
107 | - * Generates in one method call the daos and the beans for one table. |
|
108 | - * |
|
109 | - * @param Table $table |
|
110 | - * @param string $daonamespace |
|
111 | - * @param string $beannamespace |
|
112 | - * @param ClassNameMapper $classNameMapper |
|
113 | - * @param bool $storeInUtc |
|
114 | - * |
|
115 | - * @throws TDBMException |
|
116 | - */ |
|
117 | - public function generateDaoAndBean(Table $table, $daonamespace, $beannamespace, ClassNameMapper $classNameMapper, $storeInUtc) |
|
118 | - { |
|
119 | - $tableName = $table->getName(); |
|
120 | - $daoName = $this->getDaoNameFromTableName($tableName); |
|
121 | - $beanName = $this->getBeanNameFromTableName($tableName); |
|
122 | - $baseBeanName = $this->getBaseBeanNameFromTableName($tableName); |
|
123 | - $baseDaoName = $this->getBaseDaoNameFromTableName($tableName); |
|
124 | - |
|
125 | - $beanDescriptor = new BeanDescriptor($table, $this->schemaAnalyzer, $this->schema, $this->tdbmSchemaAnalyzer); |
|
126 | - $this->generateBean($beanDescriptor, $beanName, $baseBeanName, $table, $beannamespace, $classNameMapper, $storeInUtc); |
|
127 | - $this->generateDao($beanDescriptor, $daoName, $baseDaoName, $beanName, $table, $daonamespace, $beannamespace, $classNameMapper); |
|
128 | - } |
|
129 | - |
|
130 | - /** |
|
131 | - * Returns the name of the bean class from the table name. |
|
132 | - * |
|
133 | - * @param $tableName |
|
134 | - * |
|
135 | - * @return string |
|
136 | - */ |
|
137 | - public static function getBeanNameFromTableName($tableName) |
|
138 | - { |
|
139 | - return self::toSingular(self::toCamelCase($tableName)).'Bean'; |
|
140 | - } |
|
141 | - |
|
142 | - /** |
|
143 | - * Returns the name of the DAO class from the table name. |
|
144 | - * |
|
145 | - * @param $tableName |
|
146 | - * |
|
147 | - * @return string |
|
148 | - */ |
|
149 | - public static function getDaoNameFromTableName($tableName) |
|
150 | - { |
|
151 | - return self::toSingular(self::toCamelCase($tableName)).'Dao'; |
|
152 | - } |
|
153 | - |
|
154 | - /** |
|
155 | - * Returns the name of the base bean class from the table name. |
|
156 | - * |
|
157 | - * @param $tableName |
|
158 | - * |
|
159 | - * @return string |
|
160 | - */ |
|
161 | - public static function getBaseBeanNameFromTableName($tableName) |
|
162 | - { |
|
163 | - return self::toSingular(self::toCamelCase($tableName)).'BaseBean'; |
|
164 | - } |
|
165 | - |
|
166 | - /** |
|
167 | - * Returns the name of the base DAO class from the table name. |
|
168 | - * |
|
169 | - * @param $tableName |
|
170 | - * |
|
171 | - * @return string |
|
172 | - */ |
|
173 | - public static function getBaseDaoNameFromTableName($tableName) |
|
174 | - { |
|
175 | - return self::toSingular(self::toCamelCase($tableName)).'BaseDao'; |
|
176 | - } |
|
177 | - |
|
178 | - /** |
|
179 | - * Writes the PHP bean file with all getters and setters from the table passed in parameter. |
|
180 | - * |
|
181 | - * @param BeanDescriptor $beanDescriptor |
|
182 | - * @param string $className The name of the class |
|
183 | - * @param string $baseClassName The name of the base class which will be extended (name only, no directory) |
|
184 | - * @param Table $table The table |
|
185 | - * @param string $beannamespace The namespace of the bean |
|
186 | - * @param ClassNameMapper $classNameMapper |
|
187 | - * |
|
188 | - * @throws TDBMException |
|
189 | - */ |
|
190 | - public function generateBean(BeanDescriptor $beanDescriptor, $className, $baseClassName, Table $table, $beannamespace, ClassNameMapper $classNameMapper, $storeInUtc) |
|
191 | - { |
|
192 | - $str = $beanDescriptor->generatePhpCode($beannamespace); |
|
193 | - |
|
194 | - $possibleBaseFileNames = $classNameMapper->getPossibleFileNames($beannamespace.'\\Generated\\'.$baseClassName); |
|
195 | - if (empty($possibleBaseFileNames)) { |
|
196 | - throw new TDBMException('Sorry, autoload namespace issue. The class "'.$beannamespace.'\\'.$baseClassName.'" is not autoloadable.'); |
|
197 | - } |
|
198 | - $possibleBaseFileName = $this->rootPath.$possibleBaseFileNames[0]; |
|
199 | - |
|
200 | - $this->ensureDirectoryExist($possibleBaseFileName); |
|
201 | - file_put_contents($possibleBaseFileName, $str); |
|
202 | - @chmod($possibleBaseFileName, 0664); |
|
203 | - |
|
204 | - $possibleFileNames = $classNameMapper->getPossibleFileNames($beannamespace.'\\'.$className); |
|
205 | - if (empty($possibleFileNames)) { |
|
206 | - // @codeCoverageIgnoreStart |
|
207 | - throw new TDBMException('Sorry, autoload namespace issue. The class "'.$beannamespace.'\\'.$className.'" is not autoloadable.'); |
|
208 | - // @codeCoverageIgnoreEnd |
|
209 | - } |
|
210 | - $possibleFileName = $this->rootPath.$possibleFileNames[0]; |
|
211 | - if (!file_exists($possibleFileName)) { |
|
212 | - $tableName = $table->getName(); |
|
213 | - $str = "<?php |
|
20 | + /** |
|
21 | + * @var SchemaAnalyzer |
|
22 | + */ |
|
23 | + private $schemaAnalyzer; |
|
24 | + |
|
25 | + /** |
|
26 | + * @var Schema |
|
27 | + */ |
|
28 | + private $schema; |
|
29 | + |
|
30 | + /** |
|
31 | + * The root directory of the project. |
|
32 | + * |
|
33 | + * @var string |
|
34 | + */ |
|
35 | + private $rootPath; |
|
36 | + |
|
37 | + /** |
|
38 | + * Name of composer file. |
|
39 | + * |
|
40 | + * @var string |
|
41 | + */ |
|
42 | + private $composerFile; |
|
43 | + |
|
44 | + /** |
|
45 | + * @var TDBMSchemaAnalyzer |
|
46 | + */ |
|
47 | + private $tdbmSchemaAnalyzer; |
|
48 | + |
|
49 | + /** |
|
50 | + * Constructor. |
|
51 | + * |
|
52 | + * @param SchemaAnalyzer $schemaAnalyzer |
|
53 | + * @param Schema $schema |
|
54 | + * @param TDBMSchemaAnalyzer $tdbmSchemaAnalyzer |
|
55 | + */ |
|
56 | + public function __construct(SchemaAnalyzer $schemaAnalyzer, Schema $schema, TDBMSchemaAnalyzer $tdbmSchemaAnalyzer) |
|
57 | + { |
|
58 | + $this->schemaAnalyzer = $schemaAnalyzer; |
|
59 | + $this->schema = $schema; |
|
60 | + $this->tdbmSchemaAnalyzer = $tdbmSchemaAnalyzer; |
|
61 | + $this->rootPath = __DIR__.'/../../../../../../../../'; |
|
62 | + $this->composerFile = 'composer.json'; |
|
63 | + } |
|
64 | + |
|
65 | + /** |
|
66 | + * Generates all the daos and beans. |
|
67 | + * |
|
68 | + * @param string $daoFactoryClassName The classe name of the DAO factory |
|
69 | + * @param string $daonamespace The namespace for the DAOs, without trailing \ |
|
70 | + * @param string $beannamespace The Namespace for the beans, without trailing \ |
|
71 | + * @param bool $storeInUtc If the generated daos should store the date in UTC timezone instead of user's timezone. |
|
72 | + * |
|
73 | + * @return \string[] the list of tables |
|
74 | + * |
|
75 | + * @throws TDBMException |
|
76 | + */ |
|
77 | + public function generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc) |
|
78 | + { |
|
79 | + $classNameMapper = ClassNameMapper::createFromComposerFile($this->rootPath.$this->composerFile); |
|
80 | + // TODO: check that no class name ends with "Base". Otherwise, there will be name clash. |
|
81 | + |
|
82 | + $tableList = $this->schema->getTables(); |
|
83 | + |
|
84 | + // Remove all beans and daos from junction tables |
|
85 | + $junctionTables = $this->schemaAnalyzer->detectJunctionTables(true); |
|
86 | + $junctionTableNames = array_map(function (Table $table) { |
|
87 | + return $table->getName(); |
|
88 | + }, $junctionTables); |
|
89 | + |
|
90 | + $tableList = array_filter($tableList, function (Table $table) use ($junctionTableNames) { |
|
91 | + return !in_array($table->getName(), $junctionTableNames); |
|
92 | + }); |
|
93 | + |
|
94 | + foreach ($tableList as $table) { |
|
95 | + $this->generateDaoAndBean($table, $daonamespace, $beannamespace, $classNameMapper, $storeInUtc); |
|
96 | + } |
|
97 | + |
|
98 | + $this->generateFactory($tableList, $daoFactoryClassName, $daonamespace, $classNameMapper); |
|
99 | + |
|
100 | + // Ok, let's return the list of all tables. |
|
101 | + // These will be used by the calling script to create Mouf instances. |
|
102 | + |
|
103 | + return array_map(function (Table $table) { return $table->getName(); }, $tableList); |
|
104 | + } |
|
105 | + |
|
106 | + /** |
|
107 | + * Generates in one method call the daos and the beans for one table. |
|
108 | + * |
|
109 | + * @param Table $table |
|
110 | + * @param string $daonamespace |
|
111 | + * @param string $beannamespace |
|
112 | + * @param ClassNameMapper $classNameMapper |
|
113 | + * @param bool $storeInUtc |
|
114 | + * |
|
115 | + * @throws TDBMException |
|
116 | + */ |
|
117 | + public function generateDaoAndBean(Table $table, $daonamespace, $beannamespace, ClassNameMapper $classNameMapper, $storeInUtc) |
|
118 | + { |
|
119 | + $tableName = $table->getName(); |
|
120 | + $daoName = $this->getDaoNameFromTableName($tableName); |
|
121 | + $beanName = $this->getBeanNameFromTableName($tableName); |
|
122 | + $baseBeanName = $this->getBaseBeanNameFromTableName($tableName); |
|
123 | + $baseDaoName = $this->getBaseDaoNameFromTableName($tableName); |
|
124 | + |
|
125 | + $beanDescriptor = new BeanDescriptor($table, $this->schemaAnalyzer, $this->schema, $this->tdbmSchemaAnalyzer); |
|
126 | + $this->generateBean($beanDescriptor, $beanName, $baseBeanName, $table, $beannamespace, $classNameMapper, $storeInUtc); |
|
127 | + $this->generateDao($beanDescriptor, $daoName, $baseDaoName, $beanName, $table, $daonamespace, $beannamespace, $classNameMapper); |
|
128 | + } |
|
129 | + |
|
130 | + /** |
|
131 | + * Returns the name of the bean class from the table name. |
|
132 | + * |
|
133 | + * @param $tableName |
|
134 | + * |
|
135 | + * @return string |
|
136 | + */ |
|
137 | + public static function getBeanNameFromTableName($tableName) |
|
138 | + { |
|
139 | + return self::toSingular(self::toCamelCase($tableName)).'Bean'; |
|
140 | + } |
|
141 | + |
|
142 | + /** |
|
143 | + * Returns the name of the DAO class from the table name. |
|
144 | + * |
|
145 | + * @param $tableName |
|
146 | + * |
|
147 | + * @return string |
|
148 | + */ |
|
149 | + public static function getDaoNameFromTableName($tableName) |
|
150 | + { |
|
151 | + return self::toSingular(self::toCamelCase($tableName)).'Dao'; |
|
152 | + } |
|
153 | + |
|
154 | + /** |
|
155 | + * Returns the name of the base bean class from the table name. |
|
156 | + * |
|
157 | + * @param $tableName |
|
158 | + * |
|
159 | + * @return string |
|
160 | + */ |
|
161 | + public static function getBaseBeanNameFromTableName($tableName) |
|
162 | + { |
|
163 | + return self::toSingular(self::toCamelCase($tableName)).'BaseBean'; |
|
164 | + } |
|
165 | + |
|
166 | + /** |
|
167 | + * Returns the name of the base DAO class from the table name. |
|
168 | + * |
|
169 | + * @param $tableName |
|
170 | + * |
|
171 | + * @return string |
|
172 | + */ |
|
173 | + public static function getBaseDaoNameFromTableName($tableName) |
|
174 | + { |
|
175 | + return self::toSingular(self::toCamelCase($tableName)).'BaseDao'; |
|
176 | + } |
|
177 | + |
|
178 | + /** |
|
179 | + * Writes the PHP bean file with all getters and setters from the table passed in parameter. |
|
180 | + * |
|
181 | + * @param BeanDescriptor $beanDescriptor |
|
182 | + * @param string $className The name of the class |
|
183 | + * @param string $baseClassName The name of the base class which will be extended (name only, no directory) |
|
184 | + * @param Table $table The table |
|
185 | + * @param string $beannamespace The namespace of the bean |
|
186 | + * @param ClassNameMapper $classNameMapper |
|
187 | + * |
|
188 | + * @throws TDBMException |
|
189 | + */ |
|
190 | + public function generateBean(BeanDescriptor $beanDescriptor, $className, $baseClassName, Table $table, $beannamespace, ClassNameMapper $classNameMapper, $storeInUtc) |
|
191 | + { |
|
192 | + $str = $beanDescriptor->generatePhpCode($beannamespace); |
|
193 | + |
|
194 | + $possibleBaseFileNames = $classNameMapper->getPossibleFileNames($beannamespace.'\\Generated\\'.$baseClassName); |
|
195 | + if (empty($possibleBaseFileNames)) { |
|
196 | + throw new TDBMException('Sorry, autoload namespace issue. The class "'.$beannamespace.'\\'.$baseClassName.'" is not autoloadable.'); |
|
197 | + } |
|
198 | + $possibleBaseFileName = $this->rootPath.$possibleBaseFileNames[0]; |
|
199 | + |
|
200 | + $this->ensureDirectoryExist($possibleBaseFileName); |
|
201 | + file_put_contents($possibleBaseFileName, $str); |
|
202 | + @chmod($possibleBaseFileName, 0664); |
|
203 | + |
|
204 | + $possibleFileNames = $classNameMapper->getPossibleFileNames($beannamespace.'\\'.$className); |
|
205 | + if (empty($possibleFileNames)) { |
|
206 | + // @codeCoverageIgnoreStart |
|
207 | + throw new TDBMException('Sorry, autoload namespace issue. The class "'.$beannamespace.'\\'.$className.'" is not autoloadable.'); |
|
208 | + // @codeCoverageIgnoreEnd |
|
209 | + } |
|
210 | + $possibleFileName = $this->rootPath.$possibleFileNames[0]; |
|
211 | + if (!file_exists($possibleFileName)) { |
|
212 | + $tableName = $table->getName(); |
|
213 | + $str = "<?php |
|
214 | 214 | /* |
215 | 215 | * This file has been automatically generated by TDBM. |
216 | 216 | * You can edit this file as it will not be overwritten. |
@@ -227,76 +227,76 @@ discard block |
||
227 | 227 | { |
228 | 228 | |
229 | 229 | }"; |
230 | - $this->ensureDirectoryExist($possibleFileName); |
|
231 | - file_put_contents($possibleFileName, $str); |
|
232 | - @chmod($possibleFileName, 0664); |
|
233 | - } |
|
234 | - } |
|
235 | - |
|
236 | - /** |
|
237 | - * Tries to find a @defaultSort annotation in one of the columns. |
|
238 | - * |
|
239 | - * @param Table $table |
|
240 | - * |
|
241 | - * @return array First item: column name, Second item: column order (asc/desc) |
|
242 | - */ |
|
243 | - private function getDefaultSortColumnFromAnnotation(Table $table) |
|
244 | - { |
|
245 | - $defaultSort = null; |
|
246 | - $defaultSortDirection = null; |
|
247 | - foreach ($table->getColumns() as $column) { |
|
248 | - $comments = $column->getComment(); |
|
249 | - $matches = []; |
|
250 | - if (preg_match('/@defaultSort(\((desc|asc)\))*/', $comments, $matches) != 0) { |
|
251 | - $defaultSort = $column->getName(); |
|
252 | - if (count($matches) === 3) { |
|
253 | - $defaultSortDirection = $matches[2]; |
|
254 | - } else { |
|
255 | - $defaultSortDirection = 'ASC'; |
|
256 | - } |
|
257 | - } |
|
258 | - } |
|
259 | - |
|
260 | - return [$defaultSort, $defaultSortDirection]; |
|
261 | - } |
|
262 | - |
|
263 | - /** |
|
264 | - * Writes the PHP bean DAO with simple functions to create/get/save objects. |
|
265 | - * |
|
266 | - * @param BeanDescriptor $beanDescriptor |
|
267 | - * @param string $className The name of the class |
|
268 | - * @param string $baseClassName |
|
269 | - * @param string $beanClassName |
|
270 | - * @param Table $table |
|
271 | - * @param string $daonamespace |
|
272 | - * @param string $beannamespace |
|
273 | - * @param ClassNameMapper $classNameMapper |
|
274 | - * |
|
275 | - * @throws TDBMException |
|
276 | - */ |
|
277 | - public function generateDao(BeanDescriptor $beanDescriptor, $className, $baseClassName, $beanClassName, Table $table, $daonamespace, $beannamespace, ClassNameMapper $classNameMapper) |
|
278 | - { |
|
279 | - $tableName = $table->getName(); |
|
280 | - $primaryKeyColumns = $table->getPrimaryKeyColumns(); |
|
281 | - |
|
282 | - list($defaultSort, $defaultSortDirection) = $this->getDefaultSortColumnFromAnnotation($table); |
|
283 | - |
|
284 | - // FIXME: lowercase tables with _ in the name should work! |
|
285 | - $tableCamel = self::toSingular(self::toCamelCase($tableName)); |
|
286 | - |
|
287 | - $beanClassWithoutNameSpace = $beanClassName; |
|
288 | - $beanClassName = $beannamespace.'\\'.$beanClassName; |
|
289 | - |
|
290 | - list($usedBeans, $findByDaoCode) = $beanDescriptor->generateFindByDaoCode($beannamespace, $beanClassWithoutNameSpace); |
|
291 | - |
|
292 | - $usedBeans[] = $beanClassName; |
|
293 | - // Let's suppress duplicates in used beans (if any) |
|
294 | - $usedBeans = array_flip(array_flip($usedBeans)); |
|
295 | - $useStatements = array_map(function ($usedBean) { |
|
296 | - return "use $usedBean;\n"; |
|
297 | - }, $usedBeans); |
|
298 | - |
|
299 | - $str = "<?php |
|
230 | + $this->ensureDirectoryExist($possibleFileName); |
|
231 | + file_put_contents($possibleFileName, $str); |
|
232 | + @chmod($possibleFileName, 0664); |
|
233 | + } |
|
234 | + } |
|
235 | + |
|
236 | + /** |
|
237 | + * Tries to find a @defaultSort annotation in one of the columns. |
|
238 | + * |
|
239 | + * @param Table $table |
|
240 | + * |
|
241 | + * @return array First item: column name, Second item: column order (asc/desc) |
|
242 | + */ |
|
243 | + private function getDefaultSortColumnFromAnnotation(Table $table) |
|
244 | + { |
|
245 | + $defaultSort = null; |
|
246 | + $defaultSortDirection = null; |
|
247 | + foreach ($table->getColumns() as $column) { |
|
248 | + $comments = $column->getComment(); |
|
249 | + $matches = []; |
|
250 | + if (preg_match('/@defaultSort(\((desc|asc)\))*/', $comments, $matches) != 0) { |
|
251 | + $defaultSort = $column->getName(); |
|
252 | + if (count($matches) === 3) { |
|
253 | + $defaultSortDirection = $matches[2]; |
|
254 | + } else { |
|
255 | + $defaultSortDirection = 'ASC'; |
|
256 | + } |
|
257 | + } |
|
258 | + } |
|
259 | + |
|
260 | + return [$defaultSort, $defaultSortDirection]; |
|
261 | + } |
|
262 | + |
|
263 | + /** |
|
264 | + * Writes the PHP bean DAO with simple functions to create/get/save objects. |
|
265 | + * |
|
266 | + * @param BeanDescriptor $beanDescriptor |
|
267 | + * @param string $className The name of the class |
|
268 | + * @param string $baseClassName |
|
269 | + * @param string $beanClassName |
|
270 | + * @param Table $table |
|
271 | + * @param string $daonamespace |
|
272 | + * @param string $beannamespace |
|
273 | + * @param ClassNameMapper $classNameMapper |
|
274 | + * |
|
275 | + * @throws TDBMException |
|
276 | + */ |
|
277 | + public function generateDao(BeanDescriptor $beanDescriptor, $className, $baseClassName, $beanClassName, Table $table, $daonamespace, $beannamespace, ClassNameMapper $classNameMapper) |
|
278 | + { |
|
279 | + $tableName = $table->getName(); |
|
280 | + $primaryKeyColumns = $table->getPrimaryKeyColumns(); |
|
281 | + |
|
282 | + list($defaultSort, $defaultSortDirection) = $this->getDefaultSortColumnFromAnnotation($table); |
|
283 | + |
|
284 | + // FIXME: lowercase tables with _ in the name should work! |
|
285 | + $tableCamel = self::toSingular(self::toCamelCase($tableName)); |
|
286 | + |
|
287 | + $beanClassWithoutNameSpace = $beanClassName; |
|
288 | + $beanClassName = $beannamespace.'\\'.$beanClassName; |
|
289 | + |
|
290 | + list($usedBeans, $findByDaoCode) = $beanDescriptor->generateFindByDaoCode($beannamespace, $beanClassWithoutNameSpace); |
|
291 | + |
|
292 | + $usedBeans[] = $beanClassName; |
|
293 | + // Let's suppress duplicates in used beans (if any) |
|
294 | + $usedBeans = array_flip(array_flip($usedBeans)); |
|
295 | + $useStatements = array_map(function ($usedBean) { |
|
296 | + return "use $usedBean;\n"; |
|
297 | + }, $usedBeans); |
|
298 | + |
|
299 | + $str = "<?php |
|
300 | 300 | |
301 | 301 | /* |
302 | 302 | * This file has been automatically generated by TDBM. |
@@ -373,9 +373,9 @@ discard block |
||
373 | 373 | } |
374 | 374 | "; |
375 | 375 | |
376 | - if (count($primaryKeyColumns) === 1) { |
|
377 | - $primaryKeyColumn = $primaryKeyColumns[0]; |
|
378 | - $str .= " |
|
376 | + if (count($primaryKeyColumns) === 1) { |
|
377 | + $primaryKeyColumn = $primaryKeyColumns[0]; |
|
378 | + $str .= " |
|
379 | 379 | /** |
380 | 380 | * Get $beanClassWithoutNameSpace specified by its ID (its primary key) |
381 | 381 | * If the primary key does not exist, an exception is thrown. |
@@ -390,8 +390,8 @@ discard block |
||
390 | 390 | return \$this->tdbmService->findObjectByPk('$tableName', ['$primaryKeyColumn' => \$id], [], \$lazyLoading); |
391 | 391 | } |
392 | 392 | "; |
393 | - } |
|
394 | - $str .= " |
|
393 | + } |
|
394 | + $str .= " |
|
395 | 395 | /** |
396 | 396 | * Deletes the $beanClassWithoutNameSpace passed in parameter. |
397 | 397 | * |
@@ -449,33 +449,33 @@ discard block |
||
449 | 449 | } |
450 | 450 | "; |
451 | 451 | |
452 | - $str .= $findByDaoCode; |
|
453 | - $str .= '} |
|
452 | + $str .= $findByDaoCode; |
|
453 | + $str .= '} |
|
454 | 454 | '; |
455 | 455 | |
456 | - $possibleBaseFileNames = $classNameMapper->getPossibleFileNames($daonamespace.'\\Generated\\'.$baseClassName); |
|
457 | - if (empty($possibleBaseFileNames)) { |
|
458 | - // @codeCoverageIgnoreStart |
|
459 | - throw new TDBMException('Sorry, autoload namespace issue. The class "'.$baseClassName.'" is not autoloadable.'); |
|
460 | - // @codeCoverageIgnoreEnd |
|
461 | - } |
|
462 | - $possibleBaseFileName = $this->rootPath.$possibleBaseFileNames[0]; |
|
463 | - |
|
464 | - $this->ensureDirectoryExist($possibleBaseFileName); |
|
465 | - file_put_contents($possibleBaseFileName, $str); |
|
466 | - @chmod($possibleBaseFileName, 0664); |
|
467 | - |
|
468 | - $possibleFileNames = $classNameMapper->getPossibleFileNames($daonamespace.'\\'.$className); |
|
469 | - if (empty($possibleFileNames)) { |
|
470 | - // @codeCoverageIgnoreStart |
|
471 | - throw new TDBMException('Sorry, autoload namespace issue. The class "'.$className.'" is not autoloadable.'); |
|
472 | - // @codeCoverageIgnoreEnd |
|
473 | - } |
|
474 | - $possibleFileName = $this->rootPath.$possibleFileNames[0]; |
|
475 | - |
|
476 | - // Now, let's generate the "editable" class |
|
477 | - if (!file_exists($possibleFileName)) { |
|
478 | - $str = "<?php |
|
456 | + $possibleBaseFileNames = $classNameMapper->getPossibleFileNames($daonamespace.'\\Generated\\'.$baseClassName); |
|
457 | + if (empty($possibleBaseFileNames)) { |
|
458 | + // @codeCoverageIgnoreStart |
|
459 | + throw new TDBMException('Sorry, autoload namespace issue. The class "'.$baseClassName.'" is not autoloadable.'); |
|
460 | + // @codeCoverageIgnoreEnd |
|
461 | + } |
|
462 | + $possibleBaseFileName = $this->rootPath.$possibleBaseFileNames[0]; |
|
463 | + |
|
464 | + $this->ensureDirectoryExist($possibleBaseFileName); |
|
465 | + file_put_contents($possibleBaseFileName, $str); |
|
466 | + @chmod($possibleBaseFileName, 0664); |
|
467 | + |
|
468 | + $possibleFileNames = $classNameMapper->getPossibleFileNames($daonamespace.'\\'.$className); |
|
469 | + if (empty($possibleFileNames)) { |
|
470 | + // @codeCoverageIgnoreStart |
|
471 | + throw new TDBMException('Sorry, autoload namespace issue. The class "'.$className.'" is not autoloadable.'); |
|
472 | + // @codeCoverageIgnoreEnd |
|
473 | + } |
|
474 | + $possibleFileName = $this->rootPath.$possibleFileNames[0]; |
|
475 | + |
|
476 | + // Now, let's generate the "editable" class |
|
477 | + if (!file_exists($possibleFileName)) { |
|
478 | + $str = "<?php |
|
479 | 479 | |
480 | 480 | /* |
481 | 481 | * This file has been automatically generated by TDBM. |
@@ -494,22 +494,22 @@ discard block |
||
494 | 494 | |
495 | 495 | } |
496 | 496 | "; |
497 | - $this->ensureDirectoryExist($possibleFileName); |
|
498 | - file_put_contents($possibleFileName, $str); |
|
499 | - @chmod($possibleFileName, 0664); |
|
500 | - } |
|
501 | - } |
|
502 | - |
|
503 | - /** |
|
504 | - * Generates the factory bean. |
|
505 | - * |
|
506 | - * @param Table[] $tableList |
|
507 | - */ |
|
508 | - private function generateFactory(array $tableList, $daoFactoryClassName, $daoNamespace, ClassNameMapper $classNameMapper) |
|
509 | - { |
|
510 | - // For each table, let's write a property. |
|
511 | - |
|
512 | - $str = "<?php |
|
497 | + $this->ensureDirectoryExist($possibleFileName); |
|
498 | + file_put_contents($possibleFileName, $str); |
|
499 | + @chmod($possibleFileName, 0664); |
|
500 | + } |
|
501 | + } |
|
502 | + |
|
503 | + /** |
|
504 | + * Generates the factory bean. |
|
505 | + * |
|
506 | + * @param Table[] $tableList |
|
507 | + */ |
|
508 | + private function generateFactory(array $tableList, $daoFactoryClassName, $daoNamespace, ClassNameMapper $classNameMapper) |
|
509 | + { |
|
510 | + // For each table, let's write a property. |
|
511 | + |
|
512 | + $str = "<?php |
|
513 | 513 | |
514 | 514 | /* |
515 | 515 | * This file has been automatically generated by TDBM. |
@@ -518,13 +518,13 @@ discard block |
||
518 | 518 | |
519 | 519 | namespace {$daoNamespace}\\Generated; |
520 | 520 | "; |
521 | - foreach ($tableList as $table) { |
|
522 | - $tableName = $table->getName(); |
|
523 | - $daoClassName = $this->getDaoNameFromTableName($tableName); |
|
524 | - $str .= "use {$daoNamespace}\\".$daoClassName.";\n"; |
|
525 | - } |
|
521 | + foreach ($tableList as $table) { |
|
522 | + $tableName = $table->getName(); |
|
523 | + $daoClassName = $this->getDaoNameFromTableName($tableName); |
|
524 | + $str .= "use {$daoNamespace}\\".$daoClassName.";\n"; |
|
525 | + } |
|
526 | 526 | |
527 | - $str .= " |
|
527 | + $str .= " |
|
528 | 528 | /** |
529 | 529 | * The $daoFactoryClassName provides an easy access to all DAOs generated by TDBM. |
530 | 530 | * |
@@ -533,12 +533,12 @@ discard block |
||
533 | 533 | { |
534 | 534 | "; |
535 | 535 | |
536 | - foreach ($tableList as $table) { |
|
537 | - $tableName = $table->getName(); |
|
538 | - $daoClassName = $this->getDaoNameFromTableName($tableName); |
|
539 | - $daoInstanceName = self::toVariableName($daoClassName); |
|
536 | + foreach ($tableList as $table) { |
|
537 | + $tableName = $table->getName(); |
|
538 | + $daoClassName = $this->getDaoNameFromTableName($tableName); |
|
539 | + $daoInstanceName = self::toVariableName($daoClassName); |
|
540 | 540 | |
541 | - $str .= ' /** |
|
541 | + $str .= ' /** |
|
542 | 542 | * @var '.$daoClassName.' |
543 | 543 | */ |
544 | 544 | private $'.$daoInstanceName.'; |
@@ -563,158 +563,158 @@ discard block |
||
563 | 563 | } |
564 | 564 | |
565 | 565 | '; |
566 | - } |
|
566 | + } |
|
567 | 567 | |
568 | - $str .= ' |
|
568 | + $str .= ' |
|
569 | 569 | } |
570 | 570 | '; |
571 | 571 | |
572 | - $possibleFileNames = $classNameMapper->getPossibleFileNames($daoNamespace.'\\Generated\\'.$daoFactoryClassName); |
|
573 | - if (empty($possibleFileNames)) { |
|
574 | - throw new TDBMException('Sorry, autoload namespace issue. The class "'.$daoNamespace.'\\'.$daoFactoryClassName.'" is not autoloadable.'); |
|
575 | - } |
|
576 | - $possibleFileName = $this->rootPath.$possibleFileNames[0]; |
|
577 | - |
|
578 | - $this->ensureDirectoryExist($possibleFileName); |
|
579 | - file_put_contents($possibleFileName, $str); |
|
580 | - @chmod($possibleFileName, 0664); |
|
581 | - } |
|
582 | - |
|
583 | - /** |
|
584 | - * Transforms a string to camelCase (except the first letter will be uppercase too). |
|
585 | - * Underscores and spaces are removed and the first letter after the underscore is uppercased. |
|
586 | - * |
|
587 | - * @param $str string |
|
588 | - * |
|
589 | - * @return string |
|
590 | - */ |
|
591 | - public static function toCamelCase($str) |
|
592 | - { |
|
593 | - $str = strtoupper(substr($str, 0, 1)).substr($str, 1); |
|
594 | - while (true) { |
|
595 | - if (strpos($str, '_') === false && strpos($str, ' ') === false) { |
|
596 | - break; |
|
597 | - } |
|
598 | - |
|
599 | - $pos = strpos($str, '_'); |
|
600 | - if ($pos === false) { |
|
601 | - $pos = strpos($str, ' '); |
|
602 | - } |
|
603 | - $before = substr($str, 0, $pos); |
|
604 | - $after = substr($str, $pos + 1); |
|
605 | - $str = $before.strtoupper(substr($after, 0, 1)).substr($after, 1); |
|
606 | - } |
|
607 | - |
|
608 | - return $str; |
|
609 | - } |
|
610 | - |
|
611 | - /** |
|
612 | - * Tries to put string to the singular form (if it is plural). |
|
613 | - * We assume the table names are in english. |
|
614 | - * |
|
615 | - * @param $str string |
|
616 | - * |
|
617 | - * @return string |
|
618 | - */ |
|
619 | - public static function toSingular($str) |
|
620 | - { |
|
621 | - return Inflector::singularize($str); |
|
622 | - } |
|
623 | - |
|
624 | - /** |
|
625 | - * Put the first letter of the string in lower case. |
|
626 | - * Very useful to transform a class name into a variable name. |
|
627 | - * |
|
628 | - * @param $str string |
|
629 | - * |
|
630 | - * @return string |
|
631 | - */ |
|
632 | - public static function toVariableName($str) |
|
633 | - { |
|
634 | - return strtolower(substr($str, 0, 1)).substr($str, 1); |
|
635 | - } |
|
636 | - |
|
637 | - /** |
|
638 | - * Ensures the file passed in parameter can be written in its directory. |
|
639 | - * |
|
640 | - * @param string $fileName |
|
641 | - * |
|
642 | - * @throws TDBMException |
|
643 | - */ |
|
644 | - private function ensureDirectoryExist($fileName) |
|
645 | - { |
|
646 | - $dirName = dirname($fileName); |
|
647 | - if (!file_exists($dirName)) { |
|
648 | - $old = umask(0); |
|
649 | - $result = mkdir($dirName, 0775, true); |
|
650 | - umask($old); |
|
651 | - if ($result === false) { |
|
652 | - throw new TDBMException("Unable to create directory: '".$dirName."'."); |
|
653 | - } |
|
654 | - } |
|
655 | - } |
|
656 | - |
|
657 | - /** |
|
658 | - * Absolute path to composer json file. |
|
659 | - * |
|
660 | - * @param string $composerFile |
|
661 | - */ |
|
662 | - public function setComposerFile($composerFile) |
|
663 | - { |
|
664 | - $this->rootPath = dirname($composerFile).'/'; |
|
665 | - $this->composerFile = basename($composerFile); |
|
666 | - } |
|
667 | - |
|
668 | - /** |
|
669 | - * Transforms a DBAL type into a PHP type (for PHPDoc purpose). |
|
670 | - * |
|
671 | - * @param Type $type The DBAL type |
|
672 | - * |
|
673 | - * @return string The PHP type |
|
674 | - */ |
|
675 | - public static function dbalTypeToPhpType(Type $type) |
|
676 | - { |
|
677 | - $map = [ |
|
678 | - Type::TARRAY => 'array', |
|
679 | - Type::SIMPLE_ARRAY => 'array', |
|
680 | - Type::JSON_ARRAY => 'array', |
|
681 | - Type::BIGINT => 'string', |
|
682 | - Type::BOOLEAN => 'bool', |
|
683 | - Type::DATETIME => '\DateTimeInterface', |
|
684 | - Type::DATETIMETZ => '\DateTimeInterface', |
|
685 | - Type::DATE => '\DateTimeInterface', |
|
686 | - Type::TIME => '\DateTimeInterface', |
|
687 | - Type::DECIMAL => 'float', |
|
688 | - Type::INTEGER => 'int', |
|
689 | - Type::OBJECT => 'string', |
|
690 | - Type::SMALLINT => 'int', |
|
691 | - Type::STRING => 'string', |
|
692 | - Type::TEXT => 'string', |
|
693 | - Type::BINARY => 'string', |
|
694 | - Type::BLOB => 'string', |
|
695 | - Type::FLOAT => 'float', |
|
696 | - Type::GUID => 'string', |
|
697 | - ]; |
|
698 | - |
|
699 | - return isset($map[$type->getName()]) ? $map[$type->getName()] : $type->getName(); |
|
700 | - } |
|
701 | - |
|
702 | - /** |
|
703 | - * @param string $beanNamespace |
|
704 | - * |
|
705 | - * @return \string[] Returns a map mapping table name to beans name |
|
706 | - */ |
|
707 | - public function buildTableToBeanMap($beanNamespace) |
|
708 | - { |
|
709 | - $tableToBeanMap = []; |
|
710 | - |
|
711 | - $tables = $this->schema->getTables(); |
|
712 | - |
|
713 | - foreach ($tables as $table) { |
|
714 | - $tableName = $table->getName(); |
|
715 | - $tableToBeanMap[$tableName] = $beanNamespace.'\\'.self::getBeanNameFromTableName($tableName); |
|
716 | - } |
|
717 | - |
|
718 | - return $tableToBeanMap; |
|
719 | - } |
|
572 | + $possibleFileNames = $classNameMapper->getPossibleFileNames($daoNamespace.'\\Generated\\'.$daoFactoryClassName); |
|
573 | + if (empty($possibleFileNames)) { |
|
574 | + throw new TDBMException('Sorry, autoload namespace issue. The class "'.$daoNamespace.'\\'.$daoFactoryClassName.'" is not autoloadable.'); |
|
575 | + } |
|
576 | + $possibleFileName = $this->rootPath.$possibleFileNames[0]; |
|
577 | + |
|
578 | + $this->ensureDirectoryExist($possibleFileName); |
|
579 | + file_put_contents($possibleFileName, $str); |
|
580 | + @chmod($possibleFileName, 0664); |
|
581 | + } |
|
582 | + |
|
583 | + /** |
|
584 | + * Transforms a string to camelCase (except the first letter will be uppercase too). |
|
585 | + * Underscores and spaces are removed and the first letter after the underscore is uppercased. |
|
586 | + * |
|
587 | + * @param $str string |
|
588 | + * |
|
589 | + * @return string |
|
590 | + */ |
|
591 | + public static function toCamelCase($str) |
|
592 | + { |
|
593 | + $str = strtoupper(substr($str, 0, 1)).substr($str, 1); |
|
594 | + while (true) { |
|
595 | + if (strpos($str, '_') === false && strpos($str, ' ') === false) { |
|
596 | + break; |
|
597 | + } |
|
598 | + |
|
599 | + $pos = strpos($str, '_'); |
|
600 | + if ($pos === false) { |
|
601 | + $pos = strpos($str, ' '); |
|
602 | + } |
|
603 | + $before = substr($str, 0, $pos); |
|
604 | + $after = substr($str, $pos + 1); |
|
605 | + $str = $before.strtoupper(substr($after, 0, 1)).substr($after, 1); |
|
606 | + } |
|
607 | + |
|
608 | + return $str; |
|
609 | + } |
|
610 | + |
|
611 | + /** |
|
612 | + * Tries to put string to the singular form (if it is plural). |
|
613 | + * We assume the table names are in english. |
|
614 | + * |
|
615 | + * @param $str string |
|
616 | + * |
|
617 | + * @return string |
|
618 | + */ |
|
619 | + public static function toSingular($str) |
|
620 | + { |
|
621 | + return Inflector::singularize($str); |
|
622 | + } |
|
623 | + |
|
624 | + /** |
|
625 | + * Put the first letter of the string in lower case. |
|
626 | + * Very useful to transform a class name into a variable name. |
|
627 | + * |
|
628 | + * @param $str string |
|
629 | + * |
|
630 | + * @return string |
|
631 | + */ |
|
632 | + public static function toVariableName($str) |
|
633 | + { |
|
634 | + return strtolower(substr($str, 0, 1)).substr($str, 1); |
|
635 | + } |
|
636 | + |
|
637 | + /** |
|
638 | + * Ensures the file passed in parameter can be written in its directory. |
|
639 | + * |
|
640 | + * @param string $fileName |
|
641 | + * |
|
642 | + * @throws TDBMException |
|
643 | + */ |
|
644 | + private function ensureDirectoryExist($fileName) |
|
645 | + { |
|
646 | + $dirName = dirname($fileName); |
|
647 | + if (!file_exists($dirName)) { |
|
648 | + $old = umask(0); |
|
649 | + $result = mkdir($dirName, 0775, true); |
|
650 | + umask($old); |
|
651 | + if ($result === false) { |
|
652 | + throw new TDBMException("Unable to create directory: '".$dirName."'."); |
|
653 | + } |
|
654 | + } |
|
655 | + } |
|
656 | + |
|
657 | + /** |
|
658 | + * Absolute path to composer json file. |
|
659 | + * |
|
660 | + * @param string $composerFile |
|
661 | + */ |
|
662 | + public function setComposerFile($composerFile) |
|
663 | + { |
|
664 | + $this->rootPath = dirname($composerFile).'/'; |
|
665 | + $this->composerFile = basename($composerFile); |
|
666 | + } |
|
667 | + |
|
668 | + /** |
|
669 | + * Transforms a DBAL type into a PHP type (for PHPDoc purpose). |
|
670 | + * |
|
671 | + * @param Type $type The DBAL type |
|
672 | + * |
|
673 | + * @return string The PHP type |
|
674 | + */ |
|
675 | + public static function dbalTypeToPhpType(Type $type) |
|
676 | + { |
|
677 | + $map = [ |
|
678 | + Type::TARRAY => 'array', |
|
679 | + Type::SIMPLE_ARRAY => 'array', |
|
680 | + Type::JSON_ARRAY => 'array', |
|
681 | + Type::BIGINT => 'string', |
|
682 | + Type::BOOLEAN => 'bool', |
|
683 | + Type::DATETIME => '\DateTimeInterface', |
|
684 | + Type::DATETIMETZ => '\DateTimeInterface', |
|
685 | + Type::DATE => '\DateTimeInterface', |
|
686 | + Type::TIME => '\DateTimeInterface', |
|
687 | + Type::DECIMAL => 'float', |
|
688 | + Type::INTEGER => 'int', |
|
689 | + Type::OBJECT => 'string', |
|
690 | + Type::SMALLINT => 'int', |
|
691 | + Type::STRING => 'string', |
|
692 | + Type::TEXT => 'string', |
|
693 | + Type::BINARY => 'string', |
|
694 | + Type::BLOB => 'string', |
|
695 | + Type::FLOAT => 'float', |
|
696 | + Type::GUID => 'string', |
|
697 | + ]; |
|
698 | + |
|
699 | + return isset($map[$type->getName()]) ? $map[$type->getName()] : $type->getName(); |
|
700 | + } |
|
701 | + |
|
702 | + /** |
|
703 | + * @param string $beanNamespace |
|
704 | + * |
|
705 | + * @return \string[] Returns a map mapping table name to beans name |
|
706 | + */ |
|
707 | + public function buildTableToBeanMap($beanNamespace) |
|
708 | + { |
|
709 | + $tableToBeanMap = []; |
|
710 | + |
|
711 | + $tables = $this->schema->getTables(); |
|
712 | + |
|
713 | + foreach ($tables as $table) { |
|
714 | + $tableName = $table->getName(); |
|
715 | + $tableToBeanMap[$tableName] = $beanNamespace.'\\'.self::getBeanNameFromTableName($tableName); |
|
716 | + } |
|
717 | + |
|
718 | + return $tableToBeanMap; |
|
719 | + } |
|
720 | 720 | } |
@@ -30,239 +30,239 @@ |
||
30 | 30 | */ |
31 | 31 | class ResultIterator implements Result, \ArrayAccess, \JsonSerializable |
32 | 32 | { |
33 | - /** |
|
34 | - * @var Statement |
|
35 | - */ |
|
36 | - protected $statement; |
|
33 | + /** |
|
34 | + * @var Statement |
|
35 | + */ |
|
36 | + protected $statement; |
|
37 | 37 | |
38 | - protected $fetchStarted = false; |
|
39 | - private $objectStorage; |
|
40 | - private $className; |
|
38 | + protected $fetchStarted = false; |
|
39 | + private $objectStorage; |
|
40 | + private $className; |
|
41 | 41 | |
42 | - private $tdbmService; |
|
43 | - private $magicSql; |
|
44 | - private $magicSqlCount; |
|
45 | - private $parameters; |
|
46 | - private $columnDescriptors; |
|
47 | - private $magicQuery; |
|
42 | + private $tdbmService; |
|
43 | + private $magicSql; |
|
44 | + private $magicSqlCount; |
|
45 | + private $parameters; |
|
46 | + private $columnDescriptors; |
|
47 | + private $magicQuery; |
|
48 | 48 | |
49 | - /** |
|
50 | - * @var InnerResultIterator |
|
51 | - */ |
|
52 | - private $innerResultIterator; |
|
49 | + /** |
|
50 | + * @var InnerResultIterator |
|
51 | + */ |
|
52 | + private $innerResultIterator; |
|
53 | 53 | |
54 | - /** |
|
55 | - * The key of the current retrieved object. |
|
56 | - * |
|
57 | - * @var int |
|
58 | - */ |
|
59 | - protected $key = -1; |
|
54 | + /** |
|
55 | + * The key of the current retrieved object. |
|
56 | + * |
|
57 | + * @var int |
|
58 | + */ |
|
59 | + protected $key = -1; |
|
60 | 60 | |
61 | - protected $current = null; |
|
61 | + protected $current = null; |
|
62 | 62 | |
63 | - private $databasePlatform; |
|
63 | + private $databasePlatform; |
|
64 | 64 | |
65 | - private $totalCount; |
|
65 | + private $totalCount; |
|
66 | 66 | |
67 | - private $mode; |
|
67 | + private $mode; |
|
68 | 68 | |
69 | - public function __construct($magicSql, $magicSqlCount, array $parameters, array $columnDescriptors, $objectStorage, $className, TDBMService $tdbmService, MagicQuery $magicQuery, $mode) |
|
70 | - { |
|
71 | - $this->magicSql = $magicSql; |
|
72 | - $this->magicSqlCount = $magicSqlCount; |
|
73 | - $this->objectStorage = $objectStorage; |
|
74 | - $this->className = $className; |
|
75 | - $this->tdbmService = $tdbmService; |
|
76 | - $this->parameters = $parameters; |
|
77 | - $this->columnDescriptors = $columnDescriptors; |
|
78 | - $this->magicQuery = $magicQuery; |
|
79 | - $this->databasePlatform = $this->tdbmService->getConnection()->getDatabasePlatform(); |
|
80 | - $this->mode = $mode; |
|
81 | - } |
|
69 | + public function __construct($magicSql, $magicSqlCount, array $parameters, array $columnDescriptors, $objectStorage, $className, TDBMService $tdbmService, MagicQuery $magicQuery, $mode) |
|
70 | + { |
|
71 | + $this->magicSql = $magicSql; |
|
72 | + $this->magicSqlCount = $magicSqlCount; |
|
73 | + $this->objectStorage = $objectStorage; |
|
74 | + $this->className = $className; |
|
75 | + $this->tdbmService = $tdbmService; |
|
76 | + $this->parameters = $parameters; |
|
77 | + $this->columnDescriptors = $columnDescriptors; |
|
78 | + $this->magicQuery = $magicQuery; |
|
79 | + $this->databasePlatform = $this->tdbmService->getConnection()->getDatabasePlatform(); |
|
80 | + $this->mode = $mode; |
|
81 | + } |
|
82 | 82 | |
83 | - protected function executeCountQuery() |
|
84 | - { |
|
85 | - $sql = $this->magicQuery->build($this->magicSqlCount, $this->parameters); |
|
86 | - $this->totalCount = $this->tdbmService->getConnection()->fetchColumn($sql, $this->parameters); |
|
87 | - } |
|
83 | + protected function executeCountQuery() |
|
84 | + { |
|
85 | + $sql = $this->magicQuery->build($this->magicSqlCount, $this->parameters); |
|
86 | + $this->totalCount = $this->tdbmService->getConnection()->fetchColumn($sql, $this->parameters); |
|
87 | + } |
|
88 | 88 | |
89 | - /** |
|
90 | - * Counts found records (this is the number of records fetched, taking into account the LIMIT and OFFSET settings). |
|
91 | - * |
|
92 | - * @return int |
|
93 | - */ |
|
94 | - public function count() |
|
95 | - { |
|
96 | - if ($this->totalCount === null) { |
|
97 | - $this->executeCountQuery(); |
|
98 | - } |
|
89 | + /** |
|
90 | + * Counts found records (this is the number of records fetched, taking into account the LIMIT and OFFSET settings). |
|
91 | + * |
|
92 | + * @return int |
|
93 | + */ |
|
94 | + public function count() |
|
95 | + { |
|
96 | + if ($this->totalCount === null) { |
|
97 | + $this->executeCountQuery(); |
|
98 | + } |
|
99 | 99 | |
100 | - return $this->totalCount; |
|
101 | - } |
|
100 | + return $this->totalCount; |
|
101 | + } |
|
102 | 102 | |
103 | - /** |
|
104 | - * Casts the result set to a PHP array. |
|
105 | - * |
|
106 | - * @return array |
|
107 | - */ |
|
108 | - public function toArray() |
|
109 | - { |
|
110 | - return iterator_to_array($this->getIterator()); |
|
111 | - } |
|
103 | + /** |
|
104 | + * Casts the result set to a PHP array. |
|
105 | + * |
|
106 | + * @return array |
|
107 | + */ |
|
108 | + public function toArray() |
|
109 | + { |
|
110 | + return iterator_to_array($this->getIterator()); |
|
111 | + } |
|
112 | 112 | |
113 | - /** |
|
114 | - * Returns a new iterator mapping any call using the $callable function. |
|
115 | - * |
|
116 | - * @param callable $callable |
|
117 | - * |
|
118 | - * @return MapIterator |
|
119 | - */ |
|
120 | - public function map(callable $callable) |
|
121 | - { |
|
122 | - return new MapIterator($this->getIterator(), $callable); |
|
123 | - } |
|
113 | + /** |
|
114 | + * Returns a new iterator mapping any call using the $callable function. |
|
115 | + * |
|
116 | + * @param callable $callable |
|
117 | + * |
|
118 | + * @return MapIterator |
|
119 | + */ |
|
120 | + public function map(callable $callable) |
|
121 | + { |
|
122 | + return new MapIterator($this->getIterator(), $callable); |
|
123 | + } |
|
124 | 124 | |
125 | - /** |
|
126 | - * Retrieve an external iterator. |
|
127 | - * |
|
128 | - * @link http://php.net/manual/en/iteratoraggregate.getiterator.php |
|
129 | - * |
|
130 | - * @return InnerResultIterator An instance of an object implementing <b>Iterator</b> or |
|
131 | - * <b>Traversable</b> |
|
132 | - * |
|
133 | - * @since 5.0.0 |
|
134 | - */ |
|
135 | - public function getIterator() |
|
136 | - { |
|
137 | - if ($this->innerResultIterator === null) { |
|
138 | - if ($this->mode === TDBMService::MODE_CURSOR) { |
|
139 | - $this->innerResultIterator = new InnerResultIterator($this->magicSql, $this->parameters, null, null, $this->columnDescriptors, $this->objectStorage, $this->className, $this->tdbmService, $this->magicQuery); |
|
140 | - } else { |
|
141 | - $this->innerResultIterator = new InnerResultArray($this->magicSql, $this->parameters, null, null, $this->columnDescriptors, $this->objectStorage, $this->className, $this->tdbmService, $this->magicQuery); |
|
142 | - } |
|
143 | - } |
|
125 | + /** |
|
126 | + * Retrieve an external iterator. |
|
127 | + * |
|
128 | + * @link http://php.net/manual/en/iteratoraggregate.getiterator.php |
|
129 | + * |
|
130 | + * @return InnerResultIterator An instance of an object implementing <b>Iterator</b> or |
|
131 | + * <b>Traversable</b> |
|
132 | + * |
|
133 | + * @since 5.0.0 |
|
134 | + */ |
|
135 | + public function getIterator() |
|
136 | + { |
|
137 | + if ($this->innerResultIterator === null) { |
|
138 | + if ($this->mode === TDBMService::MODE_CURSOR) { |
|
139 | + $this->innerResultIterator = new InnerResultIterator($this->magicSql, $this->parameters, null, null, $this->columnDescriptors, $this->objectStorage, $this->className, $this->tdbmService, $this->magicQuery); |
|
140 | + } else { |
|
141 | + $this->innerResultIterator = new InnerResultArray($this->magicSql, $this->parameters, null, null, $this->columnDescriptors, $this->objectStorage, $this->className, $this->tdbmService, $this->magicQuery); |
|
142 | + } |
|
143 | + } |
|
144 | 144 | |
145 | - return $this->innerResultIterator; |
|
146 | - } |
|
145 | + return $this->innerResultIterator; |
|
146 | + } |
|
147 | 147 | |
148 | - /** |
|
149 | - * @param int $offset |
|
150 | - * |
|
151 | - * @return PageIterator |
|
152 | - */ |
|
153 | - public function take($offset, $limit) |
|
154 | - { |
|
155 | - return new PageIterator($this, $this->magicSql, $this->parameters, $limit, $offset, $this->columnDescriptors, $this->objectStorage, $this->className, $this->tdbmService, $this->magicQuery, $this->mode); |
|
156 | - } |
|
148 | + /** |
|
149 | + * @param int $offset |
|
150 | + * |
|
151 | + * @return PageIterator |
|
152 | + */ |
|
153 | + public function take($offset, $limit) |
|
154 | + { |
|
155 | + return new PageIterator($this, $this->magicSql, $this->parameters, $limit, $offset, $this->columnDescriptors, $this->objectStorage, $this->className, $this->tdbmService, $this->magicQuery, $this->mode); |
|
156 | + } |
|
157 | 157 | |
158 | - /** |
|
159 | - * Whether a offset exists. |
|
160 | - * |
|
161 | - * @link http://php.net/manual/en/arrayaccess.offsetexists.php |
|
162 | - * |
|
163 | - * @param mixed $offset <p> |
|
164 | - * An offset to check for. |
|
165 | - * </p> |
|
166 | - * |
|
167 | - * @return bool true on success or false on failure. |
|
168 | - * </p> |
|
169 | - * <p> |
|
170 | - * The return value will be casted to boolean if non-boolean was returned. |
|
171 | - * |
|
172 | - * @since 5.0.0 |
|
173 | - */ |
|
174 | - public function offsetExists($offset) |
|
175 | - { |
|
176 | - return $this->getIterator()->offsetExists($offset); |
|
177 | - } |
|
158 | + /** |
|
159 | + * Whether a offset exists. |
|
160 | + * |
|
161 | + * @link http://php.net/manual/en/arrayaccess.offsetexists.php |
|
162 | + * |
|
163 | + * @param mixed $offset <p> |
|
164 | + * An offset to check for. |
|
165 | + * </p> |
|
166 | + * |
|
167 | + * @return bool true on success or false on failure. |
|
168 | + * </p> |
|
169 | + * <p> |
|
170 | + * The return value will be casted to boolean if non-boolean was returned. |
|
171 | + * |
|
172 | + * @since 5.0.0 |
|
173 | + */ |
|
174 | + public function offsetExists($offset) |
|
175 | + { |
|
176 | + return $this->getIterator()->offsetExists($offset); |
|
177 | + } |
|
178 | 178 | |
179 | - /** |
|
180 | - * Offset to retrieve. |
|
181 | - * |
|
182 | - * @link http://php.net/manual/en/arrayaccess.offsetget.php |
|
183 | - * |
|
184 | - * @param mixed $offset <p> |
|
185 | - * The offset to retrieve. |
|
186 | - * </p> |
|
187 | - * |
|
188 | - * @return mixed Can return all value types. |
|
189 | - * |
|
190 | - * @since 5.0.0 |
|
191 | - */ |
|
192 | - public function offsetGet($offset) |
|
193 | - { |
|
194 | - return $this->getIterator()->offsetGet($offset); |
|
195 | - } |
|
179 | + /** |
|
180 | + * Offset to retrieve. |
|
181 | + * |
|
182 | + * @link http://php.net/manual/en/arrayaccess.offsetget.php |
|
183 | + * |
|
184 | + * @param mixed $offset <p> |
|
185 | + * The offset to retrieve. |
|
186 | + * </p> |
|
187 | + * |
|
188 | + * @return mixed Can return all value types. |
|
189 | + * |
|
190 | + * @since 5.0.0 |
|
191 | + */ |
|
192 | + public function offsetGet($offset) |
|
193 | + { |
|
194 | + return $this->getIterator()->offsetGet($offset); |
|
195 | + } |
|
196 | 196 | |
197 | - /** |
|
198 | - * Offset to set. |
|
199 | - * |
|
200 | - * @link http://php.net/manual/en/arrayaccess.offsetset.php |
|
201 | - * |
|
202 | - * @param mixed $offset <p> |
|
203 | - * The offset to assign the value to. |
|
204 | - * </p> |
|
205 | - * @param mixed $value <p> |
|
206 | - * The value to set. |
|
207 | - * </p> |
|
208 | - * |
|
209 | - * @since 5.0.0 |
|
210 | - */ |
|
211 | - public function offsetSet($offset, $value) |
|
212 | - { |
|
213 | - return $this->getIterator()->offsetSet($offset, $value); |
|
214 | - } |
|
197 | + /** |
|
198 | + * Offset to set. |
|
199 | + * |
|
200 | + * @link http://php.net/manual/en/arrayaccess.offsetset.php |
|
201 | + * |
|
202 | + * @param mixed $offset <p> |
|
203 | + * The offset to assign the value to. |
|
204 | + * </p> |
|
205 | + * @param mixed $value <p> |
|
206 | + * The value to set. |
|
207 | + * </p> |
|
208 | + * |
|
209 | + * @since 5.0.0 |
|
210 | + */ |
|
211 | + public function offsetSet($offset, $value) |
|
212 | + { |
|
213 | + return $this->getIterator()->offsetSet($offset, $value); |
|
214 | + } |
|
215 | 215 | |
216 | - /** |
|
217 | - * Offset to unset. |
|
218 | - * |
|
219 | - * @link http://php.net/manual/en/arrayaccess.offsetunset.php |
|
220 | - * |
|
221 | - * @param mixed $offset <p> |
|
222 | - * The offset to unset. |
|
223 | - * </p> |
|
224 | - * |
|
225 | - * @since 5.0.0 |
|
226 | - */ |
|
227 | - public function offsetUnset($offset) |
|
228 | - { |
|
229 | - return $this->getIterator()->offsetUnset($offset); |
|
230 | - } |
|
216 | + /** |
|
217 | + * Offset to unset. |
|
218 | + * |
|
219 | + * @link http://php.net/manual/en/arrayaccess.offsetunset.php |
|
220 | + * |
|
221 | + * @param mixed $offset <p> |
|
222 | + * The offset to unset. |
|
223 | + * </p> |
|
224 | + * |
|
225 | + * @since 5.0.0 |
|
226 | + */ |
|
227 | + public function offsetUnset($offset) |
|
228 | + { |
|
229 | + return $this->getIterator()->offsetUnset($offset); |
|
230 | + } |
|
231 | 231 | |
232 | - /** |
|
233 | - * Specify data which should be serialized to JSON. |
|
234 | - * |
|
235 | - * @link http://php.net/manual/en/jsonserializable.jsonserialize.php |
|
236 | - * |
|
237 | - * @param bool $stopRecursion Parameter used internally by TDBM to |
|
238 | - * stop embedded objects from embedding |
|
239 | - * other objects. |
|
240 | - * |
|
241 | - * @return mixed data which can be serialized by <b>json_encode</b>, |
|
242 | - * which is a value of any type other than a resource. |
|
243 | - * |
|
244 | - * @since 5.4.0 |
|
245 | - */ |
|
246 | - public function jsonSerialize($stopRecursion = false) |
|
247 | - { |
|
248 | - return array_map(function (AbstractTDBMObject $item) use ($stopRecursion) { |
|
249 | - return $item->jsonSerialize($stopRecursion); |
|
250 | - }, $this->toArray()); |
|
251 | - } |
|
232 | + /** |
|
233 | + * Specify data which should be serialized to JSON. |
|
234 | + * |
|
235 | + * @link http://php.net/manual/en/jsonserializable.jsonserialize.php |
|
236 | + * |
|
237 | + * @param bool $stopRecursion Parameter used internally by TDBM to |
|
238 | + * stop embedded objects from embedding |
|
239 | + * other objects. |
|
240 | + * |
|
241 | + * @return mixed data which can be serialized by <b>json_encode</b>, |
|
242 | + * which is a value of any type other than a resource. |
|
243 | + * |
|
244 | + * @since 5.4.0 |
|
245 | + */ |
|
246 | + public function jsonSerialize($stopRecursion = false) |
|
247 | + { |
|
248 | + return array_map(function (AbstractTDBMObject $item) use ($stopRecursion) { |
|
249 | + return $item->jsonSerialize($stopRecursion); |
|
250 | + }, $this->toArray()); |
|
251 | + } |
|
252 | 252 | |
253 | - /** |
|
254 | - * Returns only one value (the first) of the result set. |
|
255 | - * Returns null if no value exists. |
|
256 | - * |
|
257 | - * @return mixed|null |
|
258 | - */ |
|
259 | - public function first() |
|
260 | - { |
|
261 | - $page = $this->take(0, 1); |
|
262 | - foreach ($page as $bean) { |
|
263 | - return $bean; |
|
264 | - } |
|
253 | + /** |
|
254 | + * Returns only one value (the first) of the result set. |
|
255 | + * Returns null if no value exists. |
|
256 | + * |
|
257 | + * @return mixed|null |
|
258 | + */ |
|
259 | + public function first() |
|
260 | + { |
|
261 | + $page = $this->take(0, 1); |
|
262 | + foreach ($page as $bean) { |
|
263 | + return $bean; |
|
264 | + } |
|
265 | 265 | |
266 | - return; |
|
267 | - } |
|
266 | + return; |
|
267 | + } |
|
268 | 268 | } |
@@ -16,228 +16,228 @@ discard block |
||
16 | 16 | */ |
17 | 17 | class BeanDescriptor |
18 | 18 | { |
19 | - /** |
|
20 | - * @var Table |
|
21 | - */ |
|
22 | - private $table; |
|
23 | - |
|
24 | - /** |
|
25 | - * @var SchemaAnalyzer |
|
26 | - */ |
|
27 | - private $schemaAnalyzer; |
|
28 | - |
|
29 | - /** |
|
30 | - * @var Schema |
|
31 | - */ |
|
32 | - private $schema; |
|
33 | - |
|
34 | - /** |
|
35 | - * @var AbstractBeanPropertyDescriptor[] |
|
36 | - */ |
|
37 | - private $beanPropertyDescriptors = []; |
|
38 | - |
|
39 | - /** |
|
40 | - * @var TDBMSchemaAnalyzer |
|
41 | - */ |
|
42 | - private $tdbmSchemaAnalyzer; |
|
43 | - |
|
44 | - public function __construct(Table $table, SchemaAnalyzer $schemaAnalyzer, Schema $schema, TDBMSchemaAnalyzer $tdbmSchemaAnalyzer) |
|
45 | - { |
|
46 | - $this->table = $table; |
|
47 | - $this->schemaAnalyzer = $schemaAnalyzer; |
|
48 | - $this->schema = $schema; |
|
49 | - $this->tdbmSchemaAnalyzer = $tdbmSchemaAnalyzer; |
|
50 | - $this->initBeanPropertyDescriptors(); |
|
51 | - } |
|
52 | - |
|
53 | - private function initBeanPropertyDescriptors() |
|
54 | - { |
|
55 | - $this->beanPropertyDescriptors = $this->getProperties($this->table); |
|
56 | - } |
|
57 | - |
|
58 | - /** |
|
59 | - * Returns the foreign-key the column is part of, if any. null otherwise. |
|
60 | - * |
|
61 | - * @param Table $table |
|
62 | - * @param Column $column |
|
63 | - * |
|
64 | - * @return ForeignKeyConstraint|null |
|
65 | - */ |
|
66 | - private function isPartOfForeignKey(Table $table, Column $column) |
|
67 | - { |
|
68 | - $localColumnName = $column->getName(); |
|
69 | - foreach ($table->getForeignKeys() as $foreignKey) { |
|
70 | - foreach ($foreignKey->getColumns() as $columnName) { |
|
71 | - if ($columnName === $localColumnName) { |
|
72 | - return $foreignKey; |
|
73 | - } |
|
74 | - } |
|
75 | - } |
|
76 | - |
|
77 | - return; |
|
78 | - } |
|
79 | - |
|
80 | - /** |
|
81 | - * @return AbstractBeanPropertyDescriptor[] |
|
82 | - */ |
|
83 | - public function getBeanPropertyDescriptors() |
|
84 | - { |
|
85 | - return $this->beanPropertyDescriptors; |
|
86 | - } |
|
87 | - |
|
88 | - /** |
|
89 | - * Returns the list of columns that are not nullable and not autogenerated for a given table and its parent. |
|
90 | - * |
|
91 | - * @return AbstractBeanPropertyDescriptor[] |
|
92 | - */ |
|
93 | - public function getConstructorProperties() |
|
94 | - { |
|
95 | - $constructorProperties = array_filter($this->beanPropertyDescriptors, function (AbstractBeanPropertyDescriptor $property) { |
|
96 | - return $property->isCompulsory(); |
|
97 | - }); |
|
98 | - |
|
99 | - return $constructorProperties; |
|
100 | - } |
|
101 | - |
|
102 | - /** |
|
103 | - * Returns the list of columns that have default values for a given table. |
|
104 | - * |
|
105 | - * @return AbstractBeanPropertyDescriptor[] |
|
106 | - */ |
|
107 | - public function getPropertiesWithDefault() |
|
108 | - { |
|
109 | - $properties = $this->getPropertiesForTable($this->table); |
|
110 | - $defaultProperties = array_filter($properties, function (AbstractBeanPropertyDescriptor $property) { |
|
111 | - return $property->hasDefault(); |
|
112 | - }); |
|
113 | - |
|
114 | - return $defaultProperties; |
|
115 | - } |
|
116 | - |
|
117 | - /** |
|
118 | - * Returns the list of properties exposed as getters and setters in this class. |
|
119 | - * |
|
120 | - * @return AbstractBeanPropertyDescriptor[] |
|
121 | - */ |
|
122 | - public function getExposedProperties() |
|
123 | - { |
|
124 | - $exposedProperties = array_filter($this->beanPropertyDescriptors, function (AbstractBeanPropertyDescriptor $property) { |
|
125 | - return $property->getTable()->getName() == $this->table->getName(); |
|
126 | - }); |
|
127 | - |
|
128 | - return $exposedProperties; |
|
129 | - } |
|
130 | - |
|
131 | - /** |
|
132 | - * Returns the list of properties for this table (including parent tables). |
|
133 | - * |
|
134 | - * @param Table $table |
|
135 | - * |
|
136 | - * @return AbstractBeanPropertyDescriptor[] |
|
137 | - */ |
|
138 | - private function getProperties(Table $table) |
|
139 | - { |
|
140 | - $parentRelationship = $this->schemaAnalyzer->getParentRelationship($table->getName()); |
|
141 | - if ($parentRelationship) { |
|
142 | - $parentTable = $this->schema->getTable($parentRelationship->getForeignTableName()); |
|
143 | - $properties = $this->getProperties($parentTable); |
|
144 | - // we merge properties by overriding property names. |
|
145 | - $localProperties = $this->getPropertiesForTable($table); |
|
146 | - foreach ($localProperties as $name => $property) { |
|
147 | - // We do not override properties if this is a primary key! |
|
148 | - if ($property->isPrimaryKey()) { |
|
149 | - continue; |
|
150 | - } |
|
151 | - $properties[$name] = $property; |
|
152 | - } |
|
153 | - } else { |
|
154 | - $properties = $this->getPropertiesForTable($table); |
|
155 | - } |
|
156 | - |
|
157 | - return $properties; |
|
158 | - } |
|
159 | - |
|
160 | - /** |
|
161 | - * Returns the list of properties for this table (ignoring parent tables). |
|
162 | - * |
|
163 | - * @param Table $table |
|
164 | - * |
|
165 | - * @return AbstractBeanPropertyDescriptor[] |
|
166 | - */ |
|
167 | - private function getPropertiesForTable(Table $table) |
|
168 | - { |
|
169 | - $parentRelationship = $this->schemaAnalyzer->getParentRelationship($table->getName()); |
|
170 | - if ($parentRelationship) { |
|
171 | - $ignoreColumns = $parentRelationship->getLocalColumns(); |
|
172 | - } else { |
|
173 | - $ignoreColumns = []; |
|
174 | - } |
|
175 | - |
|
176 | - $beanPropertyDescriptors = []; |
|
177 | - |
|
178 | - foreach ($table->getColumns() as $column) { |
|
179 | - if (array_search($column->getName(), $ignoreColumns) !== false) { |
|
180 | - continue; |
|
181 | - } |
|
182 | - |
|
183 | - $fk = $this->isPartOfForeignKey($table, $column); |
|
184 | - if ($fk !== null) { |
|
185 | - // Check that previously added descriptors are not added on same FK (can happen with multi key FK). |
|
186 | - foreach ($beanPropertyDescriptors as $beanDescriptor) { |
|
187 | - if ($beanDescriptor instanceof ObjectBeanPropertyDescriptor && $beanDescriptor->getForeignKey() === $fk) { |
|
188 | - continue 2; |
|
189 | - } |
|
190 | - } |
|
191 | - // Check that this property is not an inheritance relationship |
|
192 | - $parentRelationship = $this->schemaAnalyzer->getParentRelationship($table->getName()); |
|
193 | - if ($parentRelationship === $fk) { |
|
194 | - continue; |
|
195 | - } |
|
196 | - |
|
197 | - $beanPropertyDescriptors[] = new ObjectBeanPropertyDescriptor($table, $fk, $this->schemaAnalyzer); |
|
198 | - } else { |
|
199 | - $beanPropertyDescriptors[] = new ScalarBeanPropertyDescriptor($table, $column); |
|
200 | - } |
|
201 | - } |
|
202 | - |
|
203 | - // Now, let's get the name of all properties and let's check there is no duplicate. |
|
204 | - /** @var $names AbstractBeanPropertyDescriptor[] */ |
|
205 | - $names = []; |
|
206 | - foreach ($beanPropertyDescriptors as $beanDescriptor) { |
|
207 | - $name = $beanDescriptor->getUpperCamelCaseName(); |
|
208 | - if (isset($names[$name])) { |
|
209 | - $names[$name]->useAlternativeName(); |
|
210 | - $beanDescriptor->useAlternativeName(); |
|
211 | - } else { |
|
212 | - $names[$name] = $beanDescriptor; |
|
213 | - } |
|
214 | - } |
|
215 | - |
|
216 | - // Final check (throw exceptions if problem arises) |
|
217 | - $names = []; |
|
218 | - foreach ($beanPropertyDescriptors as $beanDescriptor) { |
|
219 | - $name = $beanDescriptor->getUpperCamelCaseName(); |
|
220 | - if (isset($names[$name])) { |
|
221 | - throw new TDBMException('Unsolvable name conflict while generating method name'); |
|
222 | - } else { |
|
223 | - $names[$name] = $beanDescriptor; |
|
224 | - } |
|
225 | - } |
|
226 | - |
|
227 | - // Last step, let's rebuild the list with a map: |
|
228 | - $beanPropertyDescriptorsMap = []; |
|
229 | - foreach ($beanPropertyDescriptors as $beanDescriptor) { |
|
230 | - $beanPropertyDescriptorsMap[$beanDescriptor->getLowerCamelCaseName()] = $beanDescriptor; |
|
231 | - } |
|
232 | - |
|
233 | - return $beanPropertyDescriptorsMap; |
|
234 | - } |
|
235 | - |
|
236 | - public function generateBeanConstructor() |
|
237 | - { |
|
238 | - $constructorProperties = $this->getConstructorProperties(); |
|
239 | - |
|
240 | - $constructorCode = ' /** |
|
19 | + /** |
|
20 | + * @var Table |
|
21 | + */ |
|
22 | + private $table; |
|
23 | + |
|
24 | + /** |
|
25 | + * @var SchemaAnalyzer |
|
26 | + */ |
|
27 | + private $schemaAnalyzer; |
|
28 | + |
|
29 | + /** |
|
30 | + * @var Schema |
|
31 | + */ |
|
32 | + private $schema; |
|
33 | + |
|
34 | + /** |
|
35 | + * @var AbstractBeanPropertyDescriptor[] |
|
36 | + */ |
|
37 | + private $beanPropertyDescriptors = []; |
|
38 | + |
|
39 | + /** |
|
40 | + * @var TDBMSchemaAnalyzer |
|
41 | + */ |
|
42 | + private $tdbmSchemaAnalyzer; |
|
43 | + |
|
44 | + public function __construct(Table $table, SchemaAnalyzer $schemaAnalyzer, Schema $schema, TDBMSchemaAnalyzer $tdbmSchemaAnalyzer) |
|
45 | + { |
|
46 | + $this->table = $table; |
|
47 | + $this->schemaAnalyzer = $schemaAnalyzer; |
|
48 | + $this->schema = $schema; |
|
49 | + $this->tdbmSchemaAnalyzer = $tdbmSchemaAnalyzer; |
|
50 | + $this->initBeanPropertyDescriptors(); |
|
51 | + } |
|
52 | + |
|
53 | + private function initBeanPropertyDescriptors() |
|
54 | + { |
|
55 | + $this->beanPropertyDescriptors = $this->getProperties($this->table); |
|
56 | + } |
|
57 | + |
|
58 | + /** |
|
59 | + * Returns the foreign-key the column is part of, if any. null otherwise. |
|
60 | + * |
|
61 | + * @param Table $table |
|
62 | + * @param Column $column |
|
63 | + * |
|
64 | + * @return ForeignKeyConstraint|null |
|
65 | + */ |
|
66 | + private function isPartOfForeignKey(Table $table, Column $column) |
|
67 | + { |
|
68 | + $localColumnName = $column->getName(); |
|
69 | + foreach ($table->getForeignKeys() as $foreignKey) { |
|
70 | + foreach ($foreignKey->getColumns() as $columnName) { |
|
71 | + if ($columnName === $localColumnName) { |
|
72 | + return $foreignKey; |
|
73 | + } |
|
74 | + } |
|
75 | + } |
|
76 | + |
|
77 | + return; |
|
78 | + } |
|
79 | + |
|
80 | + /** |
|
81 | + * @return AbstractBeanPropertyDescriptor[] |
|
82 | + */ |
|
83 | + public function getBeanPropertyDescriptors() |
|
84 | + { |
|
85 | + return $this->beanPropertyDescriptors; |
|
86 | + } |
|
87 | + |
|
88 | + /** |
|
89 | + * Returns the list of columns that are not nullable and not autogenerated for a given table and its parent. |
|
90 | + * |
|
91 | + * @return AbstractBeanPropertyDescriptor[] |
|
92 | + */ |
|
93 | + public function getConstructorProperties() |
|
94 | + { |
|
95 | + $constructorProperties = array_filter($this->beanPropertyDescriptors, function (AbstractBeanPropertyDescriptor $property) { |
|
96 | + return $property->isCompulsory(); |
|
97 | + }); |
|
98 | + |
|
99 | + return $constructorProperties; |
|
100 | + } |
|
101 | + |
|
102 | + /** |
|
103 | + * Returns the list of columns that have default values for a given table. |
|
104 | + * |
|
105 | + * @return AbstractBeanPropertyDescriptor[] |
|
106 | + */ |
|
107 | + public function getPropertiesWithDefault() |
|
108 | + { |
|
109 | + $properties = $this->getPropertiesForTable($this->table); |
|
110 | + $defaultProperties = array_filter($properties, function (AbstractBeanPropertyDescriptor $property) { |
|
111 | + return $property->hasDefault(); |
|
112 | + }); |
|
113 | + |
|
114 | + return $defaultProperties; |
|
115 | + } |
|
116 | + |
|
117 | + /** |
|
118 | + * Returns the list of properties exposed as getters and setters in this class. |
|
119 | + * |
|
120 | + * @return AbstractBeanPropertyDescriptor[] |
|
121 | + */ |
|
122 | + public function getExposedProperties() |
|
123 | + { |
|
124 | + $exposedProperties = array_filter($this->beanPropertyDescriptors, function (AbstractBeanPropertyDescriptor $property) { |
|
125 | + return $property->getTable()->getName() == $this->table->getName(); |
|
126 | + }); |
|
127 | + |
|
128 | + return $exposedProperties; |
|
129 | + } |
|
130 | + |
|
131 | + /** |
|
132 | + * Returns the list of properties for this table (including parent tables). |
|
133 | + * |
|
134 | + * @param Table $table |
|
135 | + * |
|
136 | + * @return AbstractBeanPropertyDescriptor[] |
|
137 | + */ |
|
138 | + private function getProperties(Table $table) |
|
139 | + { |
|
140 | + $parentRelationship = $this->schemaAnalyzer->getParentRelationship($table->getName()); |
|
141 | + if ($parentRelationship) { |
|
142 | + $parentTable = $this->schema->getTable($parentRelationship->getForeignTableName()); |
|
143 | + $properties = $this->getProperties($parentTable); |
|
144 | + // we merge properties by overriding property names. |
|
145 | + $localProperties = $this->getPropertiesForTable($table); |
|
146 | + foreach ($localProperties as $name => $property) { |
|
147 | + // We do not override properties if this is a primary key! |
|
148 | + if ($property->isPrimaryKey()) { |
|
149 | + continue; |
|
150 | + } |
|
151 | + $properties[$name] = $property; |
|
152 | + } |
|
153 | + } else { |
|
154 | + $properties = $this->getPropertiesForTable($table); |
|
155 | + } |
|
156 | + |
|
157 | + return $properties; |
|
158 | + } |
|
159 | + |
|
160 | + /** |
|
161 | + * Returns the list of properties for this table (ignoring parent tables). |
|
162 | + * |
|
163 | + * @param Table $table |
|
164 | + * |
|
165 | + * @return AbstractBeanPropertyDescriptor[] |
|
166 | + */ |
|
167 | + private function getPropertiesForTable(Table $table) |
|
168 | + { |
|
169 | + $parentRelationship = $this->schemaAnalyzer->getParentRelationship($table->getName()); |
|
170 | + if ($parentRelationship) { |
|
171 | + $ignoreColumns = $parentRelationship->getLocalColumns(); |
|
172 | + } else { |
|
173 | + $ignoreColumns = []; |
|
174 | + } |
|
175 | + |
|
176 | + $beanPropertyDescriptors = []; |
|
177 | + |
|
178 | + foreach ($table->getColumns() as $column) { |
|
179 | + if (array_search($column->getName(), $ignoreColumns) !== false) { |
|
180 | + continue; |
|
181 | + } |
|
182 | + |
|
183 | + $fk = $this->isPartOfForeignKey($table, $column); |
|
184 | + if ($fk !== null) { |
|
185 | + // Check that previously added descriptors are not added on same FK (can happen with multi key FK). |
|
186 | + foreach ($beanPropertyDescriptors as $beanDescriptor) { |
|
187 | + if ($beanDescriptor instanceof ObjectBeanPropertyDescriptor && $beanDescriptor->getForeignKey() === $fk) { |
|
188 | + continue 2; |
|
189 | + } |
|
190 | + } |
|
191 | + // Check that this property is not an inheritance relationship |
|
192 | + $parentRelationship = $this->schemaAnalyzer->getParentRelationship($table->getName()); |
|
193 | + if ($parentRelationship === $fk) { |
|
194 | + continue; |
|
195 | + } |
|
196 | + |
|
197 | + $beanPropertyDescriptors[] = new ObjectBeanPropertyDescriptor($table, $fk, $this->schemaAnalyzer); |
|
198 | + } else { |
|
199 | + $beanPropertyDescriptors[] = new ScalarBeanPropertyDescriptor($table, $column); |
|
200 | + } |
|
201 | + } |
|
202 | + |
|
203 | + // Now, let's get the name of all properties and let's check there is no duplicate. |
|
204 | + /** @var $names AbstractBeanPropertyDescriptor[] */ |
|
205 | + $names = []; |
|
206 | + foreach ($beanPropertyDescriptors as $beanDescriptor) { |
|
207 | + $name = $beanDescriptor->getUpperCamelCaseName(); |
|
208 | + if (isset($names[$name])) { |
|
209 | + $names[$name]->useAlternativeName(); |
|
210 | + $beanDescriptor->useAlternativeName(); |
|
211 | + } else { |
|
212 | + $names[$name] = $beanDescriptor; |
|
213 | + } |
|
214 | + } |
|
215 | + |
|
216 | + // Final check (throw exceptions if problem arises) |
|
217 | + $names = []; |
|
218 | + foreach ($beanPropertyDescriptors as $beanDescriptor) { |
|
219 | + $name = $beanDescriptor->getUpperCamelCaseName(); |
|
220 | + if (isset($names[$name])) { |
|
221 | + throw new TDBMException('Unsolvable name conflict while generating method name'); |
|
222 | + } else { |
|
223 | + $names[$name] = $beanDescriptor; |
|
224 | + } |
|
225 | + } |
|
226 | + |
|
227 | + // Last step, let's rebuild the list with a map: |
|
228 | + $beanPropertyDescriptorsMap = []; |
|
229 | + foreach ($beanPropertyDescriptors as $beanDescriptor) { |
|
230 | + $beanPropertyDescriptorsMap[$beanDescriptor->getLowerCamelCaseName()] = $beanDescriptor; |
|
231 | + } |
|
232 | + |
|
233 | + return $beanPropertyDescriptorsMap; |
|
234 | + } |
|
235 | + |
|
236 | + public function generateBeanConstructor() |
|
237 | + { |
|
238 | + $constructorProperties = $this->getConstructorProperties(); |
|
239 | + |
|
240 | + $constructorCode = ' /** |
|
241 | 241 | * The constructor takes all compulsory arguments. |
242 | 242 | * |
243 | 243 | %s |
@@ -247,70 +247,70 @@ discard block |
||
247 | 247 | %s } |
248 | 248 | '; |
249 | 249 | |
250 | - $paramAnnotations = []; |
|
251 | - $arguments = []; |
|
252 | - $assigns = []; |
|
253 | - $parentConstructorArguments = []; |
|
254 | - |
|
255 | - foreach ($constructorProperties as $property) { |
|
256 | - $className = $property->getClassName(); |
|
257 | - if ($className) { |
|
258 | - $arguments[] = $className.' '.$property->getVariableName(); |
|
259 | - } else { |
|
260 | - $arguments[] = $property->getVariableName(); |
|
261 | - } |
|
262 | - $paramAnnotations[] = $property->getParamAnnotation(); |
|
263 | - if ($property->getTable()->getName() === $this->table->getName()) { |
|
264 | - $assigns[] = $property->getConstructorAssignCode(); |
|
265 | - } else { |
|
266 | - $parentConstructorArguments[] = $property->getVariableName(); |
|
267 | - } |
|
268 | - } |
|
269 | - |
|
270 | - $parentConstructorCode = sprintf(" parent::__construct(%s);\n", implode(', ', $parentConstructorArguments)); |
|
271 | - |
|
272 | - $defaultAssigns = []; |
|
273 | - foreach ($this->getPropertiesWithDefault() as $property) { |
|
274 | - $defaultAssigns[] = $property->assignToDefaultCode(); |
|
275 | - } |
|
276 | - |
|
277 | - return sprintf($constructorCode, implode("\n", $paramAnnotations), implode(', ', $arguments), $parentConstructorCode, implode("\n", $assigns), implode("\n", $defaultAssigns)); |
|
278 | - } |
|
279 | - |
|
280 | - public function generateDirectForeignKeysCode() |
|
281 | - { |
|
282 | - $fks = $this->tdbmSchemaAnalyzer->getIncomingForeignKeys($this->table->getName()); |
|
283 | - |
|
284 | - $fksByTable = []; |
|
285 | - |
|
286 | - foreach ($fks as $fk) { |
|
287 | - $fksByTable[$fk->getLocalTableName()][] = $fk; |
|
288 | - } |
|
289 | - |
|
290 | - /* @var $fksByMethodName ForeignKeyConstraint[] */ |
|
291 | - $fksByMethodName = []; |
|
292 | - |
|
293 | - foreach ($fksByTable as $tableName => $fksForTable) { |
|
294 | - if (count($fksForTable) > 1) { |
|
295 | - foreach ($fksForTable as $fk) { |
|
296 | - $methodName = 'get'.TDBMDaoGenerator::toCamelCase($fk->getLocalTableName()).'By'; |
|
297 | - |
|
298 | - $camelizedColumns = array_map(['Mouf\\Database\\TDBM\\Utils\\TDBMDaoGenerator', 'toCamelCase'], $fk->getLocalColumns()); |
|
299 | - |
|
300 | - $methodName .= implode('And', $camelizedColumns); |
|
301 | - |
|
302 | - $fksByMethodName[$methodName] = $fk; |
|
303 | - } |
|
304 | - } else { |
|
305 | - $methodName = 'get'.TDBMDaoGenerator::toCamelCase($fksForTable[0]->getLocalTableName()); |
|
306 | - $fksByMethodName[$methodName] = $fksForTable[0]; |
|
307 | - } |
|
308 | - } |
|
309 | - |
|
310 | - $code = ''; |
|
311 | - |
|
312 | - foreach ($fksByMethodName as $methodName => $fk) { |
|
313 | - $getterCode = ' /** |
|
250 | + $paramAnnotations = []; |
|
251 | + $arguments = []; |
|
252 | + $assigns = []; |
|
253 | + $parentConstructorArguments = []; |
|
254 | + |
|
255 | + foreach ($constructorProperties as $property) { |
|
256 | + $className = $property->getClassName(); |
|
257 | + if ($className) { |
|
258 | + $arguments[] = $className.' '.$property->getVariableName(); |
|
259 | + } else { |
|
260 | + $arguments[] = $property->getVariableName(); |
|
261 | + } |
|
262 | + $paramAnnotations[] = $property->getParamAnnotation(); |
|
263 | + if ($property->getTable()->getName() === $this->table->getName()) { |
|
264 | + $assigns[] = $property->getConstructorAssignCode(); |
|
265 | + } else { |
|
266 | + $parentConstructorArguments[] = $property->getVariableName(); |
|
267 | + } |
|
268 | + } |
|
269 | + |
|
270 | + $parentConstructorCode = sprintf(" parent::__construct(%s);\n", implode(', ', $parentConstructorArguments)); |
|
271 | + |
|
272 | + $defaultAssigns = []; |
|
273 | + foreach ($this->getPropertiesWithDefault() as $property) { |
|
274 | + $defaultAssigns[] = $property->assignToDefaultCode(); |
|
275 | + } |
|
276 | + |
|
277 | + return sprintf($constructorCode, implode("\n", $paramAnnotations), implode(', ', $arguments), $parentConstructorCode, implode("\n", $assigns), implode("\n", $defaultAssigns)); |
|
278 | + } |
|
279 | + |
|
280 | + public function generateDirectForeignKeysCode() |
|
281 | + { |
|
282 | + $fks = $this->tdbmSchemaAnalyzer->getIncomingForeignKeys($this->table->getName()); |
|
283 | + |
|
284 | + $fksByTable = []; |
|
285 | + |
|
286 | + foreach ($fks as $fk) { |
|
287 | + $fksByTable[$fk->getLocalTableName()][] = $fk; |
|
288 | + } |
|
289 | + |
|
290 | + /* @var $fksByMethodName ForeignKeyConstraint[] */ |
|
291 | + $fksByMethodName = []; |
|
292 | + |
|
293 | + foreach ($fksByTable as $tableName => $fksForTable) { |
|
294 | + if (count($fksForTable) > 1) { |
|
295 | + foreach ($fksForTable as $fk) { |
|
296 | + $methodName = 'get'.TDBMDaoGenerator::toCamelCase($fk->getLocalTableName()).'By'; |
|
297 | + |
|
298 | + $camelizedColumns = array_map(['Mouf\\Database\\TDBM\\Utils\\TDBMDaoGenerator', 'toCamelCase'], $fk->getLocalColumns()); |
|
299 | + |
|
300 | + $methodName .= implode('And', $camelizedColumns); |
|
301 | + |
|
302 | + $fksByMethodName[$methodName] = $fk; |
|
303 | + } |
|
304 | + } else { |
|
305 | + $methodName = 'get'.TDBMDaoGenerator::toCamelCase($fksForTable[0]->getLocalTableName()); |
|
306 | + $fksByMethodName[$methodName] = $fksForTable[0]; |
|
307 | + } |
|
308 | + } |
|
309 | + |
|
310 | + $code = ''; |
|
311 | + |
|
312 | + foreach ($fksByMethodName as $methodName => $fk) { |
|
313 | + $getterCode = ' /** |
|
314 | 314 | * Returns the list of %s pointing to this bean via the %s column. |
315 | 315 | * |
316 | 316 | * @return %s[]|ResultIterator |
@@ -322,111 +322,111 @@ discard block |
||
322 | 322 | |
323 | 323 | '; |
324 | 324 | |
325 | - list($sql, $parametersCode) = $this->getFilters($fk); |
|
326 | - |
|
327 | - $beanClass = TDBMDaoGenerator::getBeanNameFromTableName($fk->getLocalTableName()); |
|
328 | - $code .= sprintf($getterCode, |
|
329 | - $beanClass, |
|
330 | - implode(', ', $fk->getColumns()), |
|
331 | - $beanClass, |
|
332 | - $methodName, |
|
333 | - var_export($fk->getLocalTableName(), true), |
|
334 | - $sql, |
|
335 | - $parametersCode |
|
336 | - ); |
|
337 | - } |
|
338 | - |
|
339 | - return $code; |
|
340 | - } |
|
341 | - |
|
342 | - private function getFilters(ForeignKeyConstraint $fk) |
|
343 | - { |
|
344 | - $sqlParts = []; |
|
345 | - $counter = 0; |
|
346 | - $parameters = []; |
|
347 | - |
|
348 | - $pkColumns = $this->table->getPrimaryKeyColumns(); |
|
349 | - |
|
350 | - foreach ($fk->getLocalColumns() as $columnName) { |
|
351 | - $paramName = 'tdbmparam'.$counter; |
|
352 | - $sqlParts[] = $fk->getLocalTableName().'.'.$columnName.' = :'.$paramName; |
|
353 | - |
|
354 | - $pkColumn = $pkColumns[$counter]; |
|
355 | - $parameters[] = sprintf('%s => $this->get(%s, %s)', var_export($paramName, true), var_export($pkColumn, true), var_export($this->table->getName(), true)); |
|
356 | - ++$counter; |
|
357 | - } |
|
358 | - $sql = "'".implode(' AND ', $sqlParts)."'"; |
|
359 | - $parametersCode = '[ '.implode(', ', $parameters).' ]'; |
|
360 | - |
|
361 | - return [$sql, $parametersCode]; |
|
362 | - } |
|
363 | - |
|
364 | - /** |
|
365 | - * Generate code section about pivot tables. |
|
366 | - * |
|
367 | - * @return string |
|
368 | - */ |
|
369 | - public function generatePivotTableCode() |
|
370 | - { |
|
371 | - $finalDescs = $this->getPivotTableDescriptors(); |
|
372 | - |
|
373 | - $code = ''; |
|
374 | - |
|
375 | - foreach ($finalDescs as $desc) { |
|
376 | - $code .= $this->getPivotTableCode($desc['name'], $desc['table'], $desc['localFK'], $desc['remoteFK']); |
|
377 | - } |
|
378 | - |
|
379 | - return $code; |
|
380 | - } |
|
381 | - |
|
382 | - private function getPivotTableDescriptors() |
|
383 | - { |
|
384 | - $descs = []; |
|
385 | - foreach ($this->schemaAnalyzer->detectJunctionTables(true) as $table) { |
|
386 | - // There are exactly 2 FKs since this is a pivot table. |
|
387 | - $fks = array_values($table->getForeignKeys()); |
|
388 | - |
|
389 | - if ($fks[0]->getForeignTableName() === $this->table->getName()) { |
|
390 | - $localFK = $fks[0]; |
|
391 | - $remoteFK = $fks[1]; |
|
392 | - } elseif ($fks[1]->getForeignTableName() === $this->table->getName()) { |
|
393 | - $localFK = $fks[1]; |
|
394 | - $remoteFK = $fks[0]; |
|
395 | - } else { |
|
396 | - continue; |
|
397 | - } |
|
398 | - |
|
399 | - $descs[$remoteFK->getForeignTableName()][] = [ |
|
400 | - 'table' => $table, |
|
401 | - 'localFK' => $localFK, |
|
402 | - 'remoteFK' => $remoteFK, |
|
403 | - ]; |
|
404 | - } |
|
405 | - |
|
406 | - $finalDescs = []; |
|
407 | - foreach ($descs as $descArray) { |
|
408 | - if (count($descArray) > 1) { |
|
409 | - foreach ($descArray as $desc) { |
|
410 | - $desc['name'] = TDBMDaoGenerator::toCamelCase($desc['remoteFK']->getForeignTableName()).'By'.TDBMDaoGenerator::toCamelCase($desc['table']->getName()); |
|
411 | - $finalDescs[] = $desc; |
|
412 | - } |
|
413 | - } else { |
|
414 | - $desc = $descArray[0]; |
|
415 | - $desc['name'] = TDBMDaoGenerator::toCamelCase($desc['remoteFK']->getForeignTableName()); |
|
416 | - $finalDescs[] = $desc; |
|
417 | - } |
|
418 | - } |
|
419 | - |
|
420 | - return $finalDescs; |
|
421 | - } |
|
422 | - |
|
423 | - public function getPivotTableCode($name, Table $table, ForeignKeyConstraint $localFK, ForeignKeyConstraint $remoteFK) |
|
424 | - { |
|
425 | - $singularName = TDBMDaoGenerator::toSingular($name); |
|
426 | - $remoteBeanName = TDBMDaoGenerator::getBeanNameFromTableName($remoteFK->getForeignTableName()); |
|
427 | - $variableName = '$'.TDBMDaoGenerator::toVariableName($remoteBeanName); |
|
428 | - |
|
429 | - $str = ' /** |
|
325 | + list($sql, $parametersCode) = $this->getFilters($fk); |
|
326 | + |
|
327 | + $beanClass = TDBMDaoGenerator::getBeanNameFromTableName($fk->getLocalTableName()); |
|
328 | + $code .= sprintf($getterCode, |
|
329 | + $beanClass, |
|
330 | + implode(', ', $fk->getColumns()), |
|
331 | + $beanClass, |
|
332 | + $methodName, |
|
333 | + var_export($fk->getLocalTableName(), true), |
|
334 | + $sql, |
|
335 | + $parametersCode |
|
336 | + ); |
|
337 | + } |
|
338 | + |
|
339 | + return $code; |
|
340 | + } |
|
341 | + |
|
342 | + private function getFilters(ForeignKeyConstraint $fk) |
|
343 | + { |
|
344 | + $sqlParts = []; |
|
345 | + $counter = 0; |
|
346 | + $parameters = []; |
|
347 | + |
|
348 | + $pkColumns = $this->table->getPrimaryKeyColumns(); |
|
349 | + |
|
350 | + foreach ($fk->getLocalColumns() as $columnName) { |
|
351 | + $paramName = 'tdbmparam'.$counter; |
|
352 | + $sqlParts[] = $fk->getLocalTableName().'.'.$columnName.' = :'.$paramName; |
|
353 | + |
|
354 | + $pkColumn = $pkColumns[$counter]; |
|
355 | + $parameters[] = sprintf('%s => $this->get(%s, %s)', var_export($paramName, true), var_export($pkColumn, true), var_export($this->table->getName(), true)); |
|
356 | + ++$counter; |
|
357 | + } |
|
358 | + $sql = "'".implode(' AND ', $sqlParts)."'"; |
|
359 | + $parametersCode = '[ '.implode(', ', $parameters).' ]'; |
|
360 | + |
|
361 | + return [$sql, $parametersCode]; |
|
362 | + } |
|
363 | + |
|
364 | + /** |
|
365 | + * Generate code section about pivot tables. |
|
366 | + * |
|
367 | + * @return string |
|
368 | + */ |
|
369 | + public function generatePivotTableCode() |
|
370 | + { |
|
371 | + $finalDescs = $this->getPivotTableDescriptors(); |
|
372 | + |
|
373 | + $code = ''; |
|
374 | + |
|
375 | + foreach ($finalDescs as $desc) { |
|
376 | + $code .= $this->getPivotTableCode($desc['name'], $desc['table'], $desc['localFK'], $desc['remoteFK']); |
|
377 | + } |
|
378 | + |
|
379 | + return $code; |
|
380 | + } |
|
381 | + |
|
382 | + private function getPivotTableDescriptors() |
|
383 | + { |
|
384 | + $descs = []; |
|
385 | + foreach ($this->schemaAnalyzer->detectJunctionTables(true) as $table) { |
|
386 | + // There are exactly 2 FKs since this is a pivot table. |
|
387 | + $fks = array_values($table->getForeignKeys()); |
|
388 | + |
|
389 | + if ($fks[0]->getForeignTableName() === $this->table->getName()) { |
|
390 | + $localFK = $fks[0]; |
|
391 | + $remoteFK = $fks[1]; |
|
392 | + } elseif ($fks[1]->getForeignTableName() === $this->table->getName()) { |
|
393 | + $localFK = $fks[1]; |
|
394 | + $remoteFK = $fks[0]; |
|
395 | + } else { |
|
396 | + continue; |
|
397 | + } |
|
398 | + |
|
399 | + $descs[$remoteFK->getForeignTableName()][] = [ |
|
400 | + 'table' => $table, |
|
401 | + 'localFK' => $localFK, |
|
402 | + 'remoteFK' => $remoteFK, |
|
403 | + ]; |
|
404 | + } |
|
405 | + |
|
406 | + $finalDescs = []; |
|
407 | + foreach ($descs as $descArray) { |
|
408 | + if (count($descArray) > 1) { |
|
409 | + foreach ($descArray as $desc) { |
|
410 | + $desc['name'] = TDBMDaoGenerator::toCamelCase($desc['remoteFK']->getForeignTableName()).'By'.TDBMDaoGenerator::toCamelCase($desc['table']->getName()); |
|
411 | + $finalDescs[] = $desc; |
|
412 | + } |
|
413 | + } else { |
|
414 | + $desc = $descArray[0]; |
|
415 | + $desc['name'] = TDBMDaoGenerator::toCamelCase($desc['remoteFK']->getForeignTableName()); |
|
416 | + $finalDescs[] = $desc; |
|
417 | + } |
|
418 | + } |
|
419 | + |
|
420 | + return $finalDescs; |
|
421 | + } |
|
422 | + |
|
423 | + public function getPivotTableCode($name, Table $table, ForeignKeyConstraint $localFK, ForeignKeyConstraint $remoteFK) |
|
424 | + { |
|
425 | + $singularName = TDBMDaoGenerator::toSingular($name); |
|
426 | + $remoteBeanName = TDBMDaoGenerator::getBeanNameFromTableName($remoteFK->getForeignTableName()); |
|
427 | + $variableName = '$'.TDBMDaoGenerator::toVariableName($remoteBeanName); |
|
428 | + |
|
429 | + $str = ' /** |
|
430 | 430 | * Returns the list of %s associated to this bean via the %s pivot table. |
431 | 431 | * |
432 | 432 | * @return %s[] |
@@ -436,9 +436,9 @@ discard block |
||
436 | 436 | } |
437 | 437 | '; |
438 | 438 | |
439 | - $getterCode = sprintf($str, $remoteBeanName, $table->getName(), $remoteBeanName, $name, var_export($remoteFK->getLocalTableName(), true)); |
|
439 | + $getterCode = sprintf($str, $remoteBeanName, $table->getName(), $remoteBeanName, $name, var_export($remoteFK->getLocalTableName(), true)); |
|
440 | 440 | |
441 | - $str = ' /** |
|
441 | + $str = ' /** |
|
442 | 442 | * Adds a relationship with %s associated to this bean via the %s pivot table. |
443 | 443 | * |
444 | 444 | * @param %s %s |
@@ -448,9 +448,9 @@ discard block |
||
448 | 448 | } |
449 | 449 | '; |
450 | 450 | |
451 | - $adderCode = sprintf($str, $remoteBeanName, $table->getName(), $remoteBeanName, $variableName, $singularName, $remoteBeanName, $variableName, var_export($remoteFK->getLocalTableName(), true), $variableName); |
|
451 | + $adderCode = sprintf($str, $remoteBeanName, $table->getName(), $remoteBeanName, $variableName, $singularName, $remoteBeanName, $variableName, var_export($remoteFK->getLocalTableName(), true), $variableName); |
|
452 | 452 | |
453 | - $str = ' /** |
|
453 | + $str = ' /** |
|
454 | 454 | * Deletes the relationship with %s associated to this bean via the %s pivot table. |
455 | 455 | * |
456 | 456 | * @param %s %s |
@@ -460,9 +460,9 @@ discard block |
||
460 | 460 | } |
461 | 461 | '; |
462 | 462 | |
463 | - $removerCode = sprintf($str, $remoteBeanName, $table->getName(), $remoteBeanName, $variableName, $singularName, $remoteBeanName, $variableName, var_export($remoteFK->getLocalTableName(), true), $variableName); |
|
463 | + $removerCode = sprintf($str, $remoteBeanName, $table->getName(), $remoteBeanName, $variableName, $singularName, $remoteBeanName, $variableName, var_export($remoteFK->getLocalTableName(), true), $variableName); |
|
464 | 464 | |
465 | - $str = ' /** |
|
465 | + $str = ' /** |
|
466 | 466 | * Returns whether this bean is associated with %s via the %s pivot table. |
467 | 467 | * |
468 | 468 | * @param %s %s |
@@ -473,24 +473,24 @@ discard block |
||
473 | 473 | } |
474 | 474 | '; |
475 | 475 | |
476 | - $hasCode = sprintf($str, $remoteBeanName, $table->getName(), $remoteBeanName, $variableName, $singularName, $remoteBeanName, $variableName, var_export($remoteFK->getLocalTableName(), true), $variableName); |
|
476 | + $hasCode = sprintf($str, $remoteBeanName, $table->getName(), $remoteBeanName, $variableName, $singularName, $remoteBeanName, $variableName, var_export($remoteFK->getLocalTableName(), true), $variableName); |
|
477 | 477 | |
478 | - $code = $getterCode.$adderCode.$removerCode.$hasCode; |
|
478 | + $code = $getterCode.$adderCode.$removerCode.$hasCode; |
|
479 | 479 | |
480 | - return $code; |
|
481 | - } |
|
480 | + return $code; |
|
481 | + } |
|
482 | 482 | |
483 | - public function generateJsonSerialize() |
|
484 | - { |
|
485 | - $tableName = $this->table->getName(); |
|
486 | - $parentFk = $this->schemaAnalyzer->getParentRelationship($tableName); |
|
487 | - if ($parentFk !== null) { |
|
488 | - $initializer = '$array = parent::jsonSerialize($stopRecursion);'; |
|
489 | - } else { |
|
490 | - $initializer = '$array = [];'; |
|
491 | - } |
|
483 | + public function generateJsonSerialize() |
|
484 | + { |
|
485 | + $tableName = $this->table->getName(); |
|
486 | + $parentFk = $this->schemaAnalyzer->getParentRelationship($tableName); |
|
487 | + if ($parentFk !== null) { |
|
488 | + $initializer = '$array = parent::jsonSerialize($stopRecursion);'; |
|
489 | + } else { |
|
490 | + $initializer = '$array = [];'; |
|
491 | + } |
|
492 | 492 | |
493 | - $str = ' |
|
493 | + $str = ' |
|
494 | 494 | /** |
495 | 495 | * Serializes the object for JSON encoding |
496 | 496 | * |
@@ -506,89 +506,89 @@ discard block |
||
506 | 506 | } |
507 | 507 | '; |
508 | 508 | |
509 | - $propertiesCode = ''; |
|
510 | - foreach ($this->beanPropertyDescriptors as $beanPropertyDescriptor) { |
|
511 | - $propertiesCode .= $beanPropertyDescriptor->getJsonSerializeCode(); |
|
512 | - } |
|
509 | + $propertiesCode = ''; |
|
510 | + foreach ($this->beanPropertyDescriptors as $beanPropertyDescriptor) { |
|
511 | + $propertiesCode .= $beanPropertyDescriptor->getJsonSerializeCode(); |
|
512 | + } |
|
513 | 513 | |
514 | - // Many to many relationships: |
|
514 | + // Many to many relationships: |
|
515 | 515 | |
516 | - $descs = $this->getPivotTableDescriptors(); |
|
516 | + $descs = $this->getPivotTableDescriptors(); |
|
517 | 517 | |
518 | - $many2manyCode = ''; |
|
518 | + $many2manyCode = ''; |
|
519 | 519 | |
520 | - foreach ($descs as $desc) { |
|
521 | - $remoteFK = $desc['remoteFK']; |
|
522 | - $remoteBeanName = TDBMDaoGenerator::getBeanNameFromTableName($remoteFK->getForeignTableName()); |
|
523 | - $variableName = '$'.TDBMDaoGenerator::toVariableName($remoteBeanName); |
|
520 | + foreach ($descs as $desc) { |
|
521 | + $remoteFK = $desc['remoteFK']; |
|
522 | + $remoteBeanName = TDBMDaoGenerator::getBeanNameFromTableName($remoteFK->getForeignTableName()); |
|
523 | + $variableName = '$'.TDBMDaoGenerator::toVariableName($remoteBeanName); |
|
524 | 524 | |
525 | - $many2manyCode .= ' if (!$stopRecursion) { |
|
525 | + $many2manyCode .= ' if (!$stopRecursion) { |
|
526 | 526 | $array[\''.lcfirst($desc['name']).'\'] = array_map(function('.$remoteBeanName.' '.$variableName.') { |
527 | 527 | return '.$variableName.'->jsonSerialize(true); |
528 | 528 | }, $this->get'.$desc['name'].'()); |
529 | 529 | } |
530 | 530 | '; |
531 | - } |
|
532 | - |
|
533 | - return sprintf($str, $initializer, $propertiesCode, $many2manyCode); |
|
534 | - } |
|
535 | - |
|
536 | - /** |
|
537 | - * Returns as an array the class we need to extend from and the list of use statements. |
|
538 | - * |
|
539 | - * @return array |
|
540 | - */ |
|
541 | - private function generateExtendsAndUseStatements(ForeignKeyConstraint $parentFk = null) |
|
542 | - { |
|
543 | - $classes = []; |
|
544 | - if ($parentFk !== null) { |
|
545 | - $extends = TDBMDaoGenerator::getBeanNameFromTableName($parentFk->getForeignTableName()); |
|
546 | - $classes[] = $extends; |
|
547 | - } |
|
548 | - |
|
549 | - foreach ($this->getBeanPropertyDescriptors() as $beanPropertyDescriptor) { |
|
550 | - $className = $beanPropertyDescriptor->getClassName(); |
|
551 | - if (null !== $className) { |
|
552 | - $classes[] = $beanPropertyDescriptor->getClassName(); |
|
553 | - } |
|
554 | - } |
|
555 | - |
|
556 | - foreach ($this->getPivotTableDescriptors() as $descriptor) { |
|
557 | - /* @var $fk ForeignKeyConstraint */ |
|
558 | - $fk = $descriptor['remoteFK']; |
|
559 | - $classes[] = TDBMDaoGenerator::getBeanNameFromTableName($fk->getForeignTableName()); |
|
560 | - } |
|
561 | - |
|
562 | - $classes = array_flip(array_flip($classes)); |
|
563 | - |
|
564 | - return $classes; |
|
565 | - } |
|
566 | - |
|
567 | - /** |
|
568 | - * Writes the PHP bean file with all getters and setters from the table passed in parameter. |
|
569 | - * |
|
570 | - * @param string $beannamespace The namespace of the bean |
|
571 | - */ |
|
572 | - public function generatePhpCode($beannamespace) |
|
573 | - { |
|
574 | - $tableName = $this->table->getName(); |
|
575 | - $baseClassName = TDBMDaoGenerator::getBaseBeanNameFromTableName($tableName); |
|
576 | - $className = TDBMDaoGenerator::getBeanNameFromTableName($tableName); |
|
577 | - $parentFk = $this->schemaAnalyzer->getParentRelationship($tableName); |
|
578 | - |
|
579 | - $classes = $this->generateExtendsAndUseStatements($parentFk); |
|
580 | - |
|
581 | - $uses = array_map(function ($className) use ($beannamespace) { return 'use '.$beannamespace.'\\'.$className.";\n"; }, $classes); |
|
582 | - $use = implode('', $uses); |
|
583 | - |
|
584 | - if ($parentFk !== null) { |
|
585 | - $extends = TDBMDaoGenerator::getBeanNameFromTableName($parentFk->getForeignTableName()); |
|
586 | - } else { |
|
587 | - $extends = 'AbstractTDBMObject'; |
|
588 | - $use .= "use Mouf\\Database\\TDBM\\AbstractTDBMObject;\n"; |
|
589 | - } |
|
590 | - |
|
591 | - $str = "<?php |
|
531 | + } |
|
532 | + |
|
533 | + return sprintf($str, $initializer, $propertiesCode, $many2manyCode); |
|
534 | + } |
|
535 | + |
|
536 | + /** |
|
537 | + * Returns as an array the class we need to extend from and the list of use statements. |
|
538 | + * |
|
539 | + * @return array |
|
540 | + */ |
|
541 | + private function generateExtendsAndUseStatements(ForeignKeyConstraint $parentFk = null) |
|
542 | + { |
|
543 | + $classes = []; |
|
544 | + if ($parentFk !== null) { |
|
545 | + $extends = TDBMDaoGenerator::getBeanNameFromTableName($parentFk->getForeignTableName()); |
|
546 | + $classes[] = $extends; |
|
547 | + } |
|
548 | + |
|
549 | + foreach ($this->getBeanPropertyDescriptors() as $beanPropertyDescriptor) { |
|
550 | + $className = $beanPropertyDescriptor->getClassName(); |
|
551 | + if (null !== $className) { |
|
552 | + $classes[] = $beanPropertyDescriptor->getClassName(); |
|
553 | + } |
|
554 | + } |
|
555 | + |
|
556 | + foreach ($this->getPivotTableDescriptors() as $descriptor) { |
|
557 | + /* @var $fk ForeignKeyConstraint */ |
|
558 | + $fk = $descriptor['remoteFK']; |
|
559 | + $classes[] = TDBMDaoGenerator::getBeanNameFromTableName($fk->getForeignTableName()); |
|
560 | + } |
|
561 | + |
|
562 | + $classes = array_flip(array_flip($classes)); |
|
563 | + |
|
564 | + return $classes; |
|
565 | + } |
|
566 | + |
|
567 | + /** |
|
568 | + * Writes the PHP bean file with all getters and setters from the table passed in parameter. |
|
569 | + * |
|
570 | + * @param string $beannamespace The namespace of the bean |
|
571 | + */ |
|
572 | + public function generatePhpCode($beannamespace) |
|
573 | + { |
|
574 | + $tableName = $this->table->getName(); |
|
575 | + $baseClassName = TDBMDaoGenerator::getBaseBeanNameFromTableName($tableName); |
|
576 | + $className = TDBMDaoGenerator::getBeanNameFromTableName($tableName); |
|
577 | + $parentFk = $this->schemaAnalyzer->getParentRelationship($tableName); |
|
578 | + |
|
579 | + $classes = $this->generateExtendsAndUseStatements($parentFk); |
|
580 | + |
|
581 | + $uses = array_map(function ($className) use ($beannamespace) { return 'use '.$beannamespace.'\\'.$className.";\n"; }, $classes); |
|
582 | + $use = implode('', $uses); |
|
583 | + |
|
584 | + if ($parentFk !== null) { |
|
585 | + $extends = TDBMDaoGenerator::getBeanNameFromTableName($parentFk->getForeignTableName()); |
|
586 | + } else { |
|
587 | + $extends = 'AbstractTDBMObject'; |
|
588 | + $use .= "use Mouf\\Database\\TDBM\\AbstractTDBMObject;\n"; |
|
589 | + } |
|
590 | + |
|
591 | + $str = "<?php |
|
592 | 592 | namespace {$beannamespace}\\Generated; |
593 | 593 | |
594 | 594 | use Mouf\\Database\\TDBM\\ResultIterator; |
@@ -606,122 +606,122 @@ discard block |
||
606 | 606 | { |
607 | 607 | "; |
608 | 608 | |
609 | - $str .= $this->generateBeanConstructor(); |
|
609 | + $str .= $this->generateBeanConstructor(); |
|
610 | 610 | |
611 | - foreach ($this->getExposedProperties() as $property) { |
|
612 | - $str .= $property->getGetterSetterCode(); |
|
613 | - } |
|
611 | + foreach ($this->getExposedProperties() as $property) { |
|
612 | + $str .= $property->getGetterSetterCode(); |
|
613 | + } |
|
614 | 614 | |
615 | - $str .= $this->generateDirectForeignKeysCode(); |
|
616 | - $str .= $this->generatePivotTableCode(); |
|
617 | - $str .= $this->generateJsonSerialize(); |
|
615 | + $str .= $this->generateDirectForeignKeysCode(); |
|
616 | + $str .= $this->generatePivotTableCode(); |
|
617 | + $str .= $this->generateJsonSerialize(); |
|
618 | 618 | |
619 | - $str .= '} |
|
619 | + $str .= '} |
|
620 | 620 | '; |
621 | 621 | |
622 | - return $str; |
|
623 | - } |
|
624 | - |
|
625 | - /** |
|
626 | - * @param string $beanNamespace |
|
627 | - * @param string $beanClassName |
|
628 | - * |
|
629 | - * @return array first element: list of used beans, second item: PHP code as a string |
|
630 | - */ |
|
631 | - public function generateFindByDaoCode($beanNamespace, $beanClassName) |
|
632 | - { |
|
633 | - $code = ''; |
|
634 | - $usedBeans = []; |
|
635 | - foreach ($this->table->getIndexes() as $index) { |
|
636 | - if (!$index->isPrimary()) { |
|
637 | - list($usedBeansForIndex, $codeForIndex) = $this->generateFindByDaoCodeForIndex($index, $beanNamespace, $beanClassName); |
|
638 | - $code .= $codeForIndex; |
|
639 | - $usedBeans = array_merge($usedBeans, $usedBeansForIndex); |
|
640 | - } |
|
641 | - } |
|
642 | - |
|
643 | - return [$usedBeans, $code]; |
|
644 | - } |
|
645 | - |
|
646 | - /** |
|
647 | - * @param Index $index |
|
648 | - * @param string $beanNamespace |
|
649 | - * @param string $beanClassName |
|
650 | - * |
|
651 | - * @return array first element: list of used beans, second item: PHP code as a string |
|
652 | - */ |
|
653 | - private function generateFindByDaoCodeForIndex(Index $index, $beanNamespace, $beanClassName) |
|
654 | - { |
|
655 | - $columns = $index->getColumns(); |
|
656 | - $usedBeans = []; |
|
657 | - |
|
658 | - /* |
|
622 | + return $str; |
|
623 | + } |
|
624 | + |
|
625 | + /** |
|
626 | + * @param string $beanNamespace |
|
627 | + * @param string $beanClassName |
|
628 | + * |
|
629 | + * @return array first element: list of used beans, second item: PHP code as a string |
|
630 | + */ |
|
631 | + public function generateFindByDaoCode($beanNamespace, $beanClassName) |
|
632 | + { |
|
633 | + $code = ''; |
|
634 | + $usedBeans = []; |
|
635 | + foreach ($this->table->getIndexes() as $index) { |
|
636 | + if (!$index->isPrimary()) { |
|
637 | + list($usedBeansForIndex, $codeForIndex) = $this->generateFindByDaoCodeForIndex($index, $beanNamespace, $beanClassName); |
|
638 | + $code .= $codeForIndex; |
|
639 | + $usedBeans = array_merge($usedBeans, $usedBeansForIndex); |
|
640 | + } |
|
641 | + } |
|
642 | + |
|
643 | + return [$usedBeans, $code]; |
|
644 | + } |
|
645 | + |
|
646 | + /** |
|
647 | + * @param Index $index |
|
648 | + * @param string $beanNamespace |
|
649 | + * @param string $beanClassName |
|
650 | + * |
|
651 | + * @return array first element: list of used beans, second item: PHP code as a string |
|
652 | + */ |
|
653 | + private function generateFindByDaoCodeForIndex(Index $index, $beanNamespace, $beanClassName) |
|
654 | + { |
|
655 | + $columns = $index->getColumns(); |
|
656 | + $usedBeans = []; |
|
657 | + |
|
658 | + /* |
|
659 | 659 | * The list of elements building this index (expressed as columns or foreign keys) |
660 | 660 | * @var AbstractBeanPropertyDescriptor[] |
661 | 661 | */ |
662 | - $elements = []; |
|
663 | - |
|
664 | - foreach ($columns as $column) { |
|
665 | - $fk = $this->isPartOfForeignKey($this->table, $this->table->getColumn($column)); |
|
666 | - if ($fk !== null) { |
|
667 | - if (!in_array($fk, $elements)) { |
|
668 | - $elements[] = new ObjectBeanPropertyDescriptor($this->table, $fk, $this->schemaAnalyzer); |
|
669 | - } |
|
670 | - } else { |
|
671 | - $elements[] = new ScalarBeanPropertyDescriptor($this->table, $this->table->getColumn($column)); |
|
672 | - } |
|
673 | - } |
|
674 | - |
|
675 | - // If the index is actually only a foreign key, let's bypass it entirely. |
|
676 | - if (count($elements) === 1 && $elements[0] instanceof ObjectBeanPropertyDescriptor) { |
|
677 | - return [[], '']; |
|
678 | - } |
|
679 | - |
|
680 | - $methodNameComponent = []; |
|
681 | - $functionParameters = []; |
|
682 | - $first = true; |
|
683 | - foreach ($elements as $element) { |
|
684 | - $methodNameComponent[] = $element->getUpperCamelCaseName(); |
|
685 | - $functionParameter = $element->getClassName(); |
|
686 | - if ($functionParameter) { |
|
687 | - $usedBeans[] = $beanNamespace.'\\'.$functionParameter; |
|
688 | - $functionParameter .= ' '; |
|
689 | - } |
|
690 | - $functionParameter .= $element->getVariableName(); |
|
691 | - if ($first) { |
|
692 | - $first = false; |
|
693 | - } else { |
|
694 | - $functionParameter .= ' = null'; |
|
695 | - } |
|
696 | - $functionParameters[] = $functionParameter; |
|
697 | - } |
|
698 | - if ($index->isUnique()) { |
|
699 | - $methodName = 'findOneBy'.implode('And', $methodNameComponent); |
|
700 | - $calledMethod = 'findOne'; |
|
701 | - } else { |
|
702 | - $methodName = 'findBy'.implode('And', $methodNameComponent); |
|
703 | - $calledMethod = 'find'; |
|
704 | - } |
|
705 | - $functionParametersString = implode(', ', $functionParameters); |
|
706 | - |
|
707 | - $count = 0; |
|
708 | - |
|
709 | - $params = []; |
|
710 | - $filterArrayCode = ''; |
|
711 | - $commentArguments = []; |
|
712 | - foreach ($elements as $element) { |
|
713 | - $params[] = $element->getParamAnnotation(); |
|
714 | - if ($element instanceof ScalarBeanPropertyDescriptor) { |
|
715 | - $filterArrayCode .= ' '.var_export($element->getColumnName(), true).' => '.$element->getVariableName().",\n"; |
|
716 | - } else { |
|
717 | - ++$count; |
|
718 | - $filterArrayCode .= ' '.$count.' => '.$element->getVariableName().",\n"; |
|
719 | - } |
|
720 | - $commentArguments[] = substr($element->getVariableName(), 1); |
|
721 | - } |
|
722 | - $paramsString = implode("\n", $params); |
|
723 | - |
|
724 | - $code = " |
|
662 | + $elements = []; |
|
663 | + |
|
664 | + foreach ($columns as $column) { |
|
665 | + $fk = $this->isPartOfForeignKey($this->table, $this->table->getColumn($column)); |
|
666 | + if ($fk !== null) { |
|
667 | + if (!in_array($fk, $elements)) { |
|
668 | + $elements[] = new ObjectBeanPropertyDescriptor($this->table, $fk, $this->schemaAnalyzer); |
|
669 | + } |
|
670 | + } else { |
|
671 | + $elements[] = new ScalarBeanPropertyDescriptor($this->table, $this->table->getColumn($column)); |
|
672 | + } |
|
673 | + } |
|
674 | + |
|
675 | + // If the index is actually only a foreign key, let's bypass it entirely. |
|
676 | + if (count($elements) === 1 && $elements[0] instanceof ObjectBeanPropertyDescriptor) { |
|
677 | + return [[], '']; |
|
678 | + } |
|
679 | + |
|
680 | + $methodNameComponent = []; |
|
681 | + $functionParameters = []; |
|
682 | + $first = true; |
|
683 | + foreach ($elements as $element) { |
|
684 | + $methodNameComponent[] = $element->getUpperCamelCaseName(); |
|
685 | + $functionParameter = $element->getClassName(); |
|
686 | + if ($functionParameter) { |
|
687 | + $usedBeans[] = $beanNamespace.'\\'.$functionParameter; |
|
688 | + $functionParameter .= ' '; |
|
689 | + } |
|
690 | + $functionParameter .= $element->getVariableName(); |
|
691 | + if ($first) { |
|
692 | + $first = false; |
|
693 | + } else { |
|
694 | + $functionParameter .= ' = null'; |
|
695 | + } |
|
696 | + $functionParameters[] = $functionParameter; |
|
697 | + } |
|
698 | + if ($index->isUnique()) { |
|
699 | + $methodName = 'findOneBy'.implode('And', $methodNameComponent); |
|
700 | + $calledMethod = 'findOne'; |
|
701 | + } else { |
|
702 | + $methodName = 'findBy'.implode('And', $methodNameComponent); |
|
703 | + $calledMethod = 'find'; |
|
704 | + } |
|
705 | + $functionParametersString = implode(', ', $functionParameters); |
|
706 | + |
|
707 | + $count = 0; |
|
708 | + |
|
709 | + $params = []; |
|
710 | + $filterArrayCode = ''; |
|
711 | + $commentArguments = []; |
|
712 | + foreach ($elements as $element) { |
|
713 | + $params[] = $element->getParamAnnotation(); |
|
714 | + if ($element instanceof ScalarBeanPropertyDescriptor) { |
|
715 | + $filterArrayCode .= ' '.var_export($element->getColumnName(), true).' => '.$element->getVariableName().",\n"; |
|
716 | + } else { |
|
717 | + ++$count; |
|
718 | + $filterArrayCode .= ' '.$count.' => '.$element->getVariableName().",\n"; |
|
719 | + } |
|
720 | + $commentArguments[] = substr($element->getVariableName(), 1); |
|
721 | + } |
|
722 | + $paramsString = implode("\n", $params); |
|
723 | + |
|
724 | + $code = " |
|
725 | 725 | /** |
726 | 726 | * Get a list of $beanClassName filtered by ".implode(', ', $commentArguments).". |
727 | 727 | * |
@@ -739,6 +739,6 @@ discard block |
||
739 | 739 | } |
740 | 740 | "; |
741 | 741 | |
742 | - return [$usedBeans, $code]; |
|
743 | - } |
|
742 | + return [$usedBeans, $code]; |
|
743 | + } |
|
744 | 744 | } |
@@ -31,495 +31,495 @@ |
||
31 | 31 | */ |
32 | 32 | abstract class AbstractTDBMObject implements JsonSerializable |
33 | 33 | { |
34 | - /** |
|
35 | - * The service this object is bound to. |
|
36 | - * |
|
37 | - * @var TDBMService |
|
38 | - */ |
|
39 | - protected $tdbmService; |
|
40 | - |
|
41 | - /** |
|
42 | - * An array of DbRow, indexed by table name. |
|
43 | - * |
|
44 | - * @var DbRow[] |
|
45 | - */ |
|
46 | - protected $dbRows = array(); |
|
47 | - |
|
48 | - /** |
|
49 | - * One of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED. |
|
50 | - * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject. |
|
51 | - * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet. |
|
52 | - * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory. |
|
53 | - * |
|
54 | - * @var string |
|
55 | - */ |
|
56 | - private $status; |
|
57 | - |
|
58 | - /** |
|
59 | - * Array storing beans related via many to many relationships (pivot tables). |
|
60 | - * |
|
61 | - * @var \SplObjectStorage[] Key: pivot table name, value: SplObjectStorage |
|
62 | - */ |
|
63 | - private $relationships = []; |
|
64 | - |
|
65 | - /** |
|
66 | - * @var bool[] Key: pivot table name, value: whether a query was performed to load the data. |
|
67 | - */ |
|
68 | - private $loadedRelationships = []; |
|
69 | - |
|
70 | - /** |
|
71 | - * Used with $primaryKeys when we want to retrieve an existing object |
|
72 | - * and $primaryKeys=[] if we want a new object. |
|
73 | - * |
|
74 | - * @param string $tableName |
|
75 | - * @param array $primaryKeys |
|
76 | - * @param TDBMService $tdbmService |
|
77 | - * |
|
78 | - * @throws TDBMException |
|
79 | - * @throws TDBMInvalidOperationException |
|
80 | - */ |
|
81 | - public function __construct($tableName = null, array $primaryKeys = array(), TDBMService $tdbmService = null) |
|
82 | - { |
|
83 | - // FIXME: lazy loading should be forbidden on tables with inheritance and dynamic type assignation... |
|
84 | - if (!empty($tableName)) { |
|
85 | - $this->dbRows[$tableName] = new DbRow($this, $tableName, $primaryKeys, $tdbmService); |
|
86 | - } |
|
87 | - |
|
88 | - if ($tdbmService === null) { |
|
89 | - $this->_setStatus(TDBMObjectStateEnum::STATE_DETACHED); |
|
90 | - } else { |
|
91 | - $this->_attach($tdbmService); |
|
92 | - if (!empty($primaryKeys)) { |
|
93 | - $this->_setStatus(TDBMObjectStateEnum::STATE_NOT_LOADED); |
|
94 | - } else { |
|
95 | - $this->_setStatus(TDBMObjectStateEnum::STATE_NEW); |
|
96 | - } |
|
97 | - } |
|
98 | - } |
|
99 | - |
|
100 | - /** |
|
101 | - * Alternative constructor called when data is fetched from database via a SELECT. |
|
102 | - * |
|
103 | - * @param array $beanData array<table, array<column, value>> |
|
104 | - * @param TDBMService $tdbmService |
|
105 | - */ |
|
106 | - public function _constructFromData(array $beanData, TDBMService $tdbmService) |
|
107 | - { |
|
108 | - $this->tdbmService = $tdbmService; |
|
109 | - |
|
110 | - foreach ($beanData as $table => $columns) { |
|
111 | - $this->dbRows[$table] = new DbRow($this, $table, $tdbmService->_getPrimaryKeysFromObjectData($table, $columns), $tdbmService, $columns); |
|
112 | - } |
|
113 | - |
|
114 | - $this->status = TDBMObjectStateEnum::STATE_LOADED; |
|
115 | - } |
|
116 | - |
|
117 | - /** |
|
118 | - * Alternative constructor called when bean is lazily loaded. |
|
119 | - * |
|
120 | - * @param string $tableName |
|
121 | - * @param array $primaryKeys |
|
122 | - * @param TDBMService $tdbmService |
|
123 | - */ |
|
124 | - public function _constructLazy($tableName, array $primaryKeys, TDBMService $tdbmService) |
|
125 | - { |
|
126 | - $this->tdbmService = $tdbmService; |
|
127 | - |
|
128 | - $this->dbRows[$tableName] = new DbRow($this, $tableName, $primaryKeys, $tdbmService); |
|
129 | - |
|
130 | - $this->status = TDBMObjectStateEnum::STATE_NOT_LOADED; |
|
131 | - } |
|
132 | - |
|
133 | - public function _attach(TDBMService $tdbmService) |
|
134 | - { |
|
135 | - if ($this->status !== TDBMObjectStateEnum::STATE_DETACHED) { |
|
136 | - throw new TDBMInvalidOperationException('Cannot attach an object that is already attached to TDBM.'); |
|
137 | - } |
|
138 | - $this->tdbmService = $tdbmService; |
|
139 | - |
|
140 | - // If we attach this object, we must work to make sure the tables are in ascending order (from low level to top level) |
|
141 | - $tableNames = array_keys($this->dbRows); |
|
142 | - $tableNames = $this->tdbmService->_getLinkBetweenInheritedTables($tableNames); |
|
143 | - $tableNames = array_reverse($tableNames); |
|
144 | - |
|
145 | - $newDbRows = []; |
|
146 | - |
|
147 | - foreach ($tableNames as $table) { |
|
148 | - if (!isset($this->dbRows[$table])) { |
|
149 | - $this->registerTable($table); |
|
150 | - } |
|
151 | - $newDbRows[$table] = $this->dbRows[$table]; |
|
152 | - } |
|
153 | - $this->dbRows = $newDbRows; |
|
154 | - |
|
155 | - $this->status = TDBMObjectStateEnum::STATE_NEW; |
|
156 | - foreach ($this->dbRows as $dbRow) { |
|
157 | - $dbRow->_attach($tdbmService); |
|
158 | - } |
|
159 | - } |
|
160 | - |
|
161 | - /** |
|
162 | - * Sets the state of the TDBM Object |
|
163 | - * One of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED. |
|
164 | - * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject. |
|
165 | - * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet. |
|
166 | - * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory. |
|
167 | - * |
|
168 | - * @param string $state |
|
169 | - */ |
|
170 | - public function _setStatus($state) |
|
171 | - { |
|
172 | - $this->status = $state; |
|
173 | - |
|
174 | - // TODO: we might ignore the loaded => dirty state here! dirty status comes from the db_row itself. |
|
175 | - foreach ($this->dbRows as $dbRow) { |
|
176 | - $dbRow->_setStatus($state); |
|
177 | - } |
|
178 | - } |
|
179 | - |
|
180 | - /** |
|
181 | - * Checks that $tableName is ok, or returns the only possible table name if "$tableName = null" |
|
182 | - * or throws an error. |
|
183 | - * |
|
184 | - * @param string $tableName |
|
185 | - * |
|
186 | - * @return string |
|
187 | - */ |
|
188 | - private function checkTableName($tableName = null) |
|
189 | - { |
|
190 | - if ($tableName === null) { |
|
191 | - if (count($this->dbRows) > 1) { |
|
192 | - throw new TDBMException('This object is based on several tables. You must specify which table you are retrieving data from.'); |
|
193 | - } elseif (count($this->dbRows) === 1) { |
|
194 | - $tableName = array_keys($this->dbRows)[0]; |
|
195 | - } |
|
196 | - } |
|
197 | - |
|
198 | - if (!isset($this->dbRows[$tableName])) { |
|
199 | - if (count($this->dbRows[$tableName] === 0)) { |
|
200 | - throw new TDBMException('Object is not yet bound to any table.'); |
|
201 | - } else { |
|
202 | - throw new TDBMException('Unknown table "'.$tableName.'"" in object.'); |
|
203 | - } |
|
204 | - } |
|
205 | - |
|
206 | - return $tableName; |
|
207 | - } |
|
208 | - |
|
209 | - protected function get($var, $tableName = null) |
|
210 | - { |
|
211 | - $tableName = $this->checkTableName($tableName); |
|
212 | - |
|
213 | - return $this->dbRows[$tableName]->get($var); |
|
214 | - } |
|
215 | - |
|
216 | - protected function set($var, $value, $tableName = null) |
|
217 | - { |
|
218 | - if ($tableName === null) { |
|
219 | - if (count($this->dbRows) > 1) { |
|
220 | - throw new TDBMException('This object is based on several tables. You must specify which table you are retrieving data from.'); |
|
221 | - } elseif (count($this->dbRows) === 1) { |
|
222 | - $tableName = array_keys($this->dbRows)[0]; |
|
223 | - } else { |
|
224 | - throw new TDBMException('Please specify a table for this object.'); |
|
225 | - } |
|
226 | - } |
|
227 | - |
|
228 | - if (!isset($this->dbRows[$tableName])) { |
|
229 | - $this->registerTable($tableName); |
|
230 | - } |
|
231 | - |
|
232 | - $this->dbRows[$tableName]->set($var, $value); |
|
233 | - if ($this->dbRows[$tableName]->_getStatus() === TDBMObjectStateEnum::STATE_DIRTY) { |
|
234 | - $this->status = TDBMObjectStateEnum::STATE_DIRTY; |
|
235 | - } |
|
236 | - } |
|
237 | - |
|
238 | - /** |
|
239 | - * @param string $foreignKeyName |
|
240 | - * @param AbstractTDBMObject $bean |
|
241 | - */ |
|
242 | - protected function setRef($foreignKeyName, AbstractTDBMObject $bean = null, $tableName = null) |
|
243 | - { |
|
244 | - if ($tableName === null) { |
|
245 | - if (count($this->dbRows) > 1) { |
|
246 | - throw new TDBMException('This object is based on several tables. You must specify which table you are retrieving data from.'); |
|
247 | - } elseif (count($this->dbRows) === 1) { |
|
248 | - $tableName = array_keys($this->dbRows)[0]; |
|
249 | - } else { |
|
250 | - throw new TDBMException('Please specify a table for this object.'); |
|
251 | - } |
|
252 | - } |
|
253 | - |
|
254 | - if (!isset($this->dbRows[$tableName])) { |
|
255 | - $this->registerTable($tableName); |
|
256 | - } |
|
257 | - |
|
258 | - $this->dbRows[$tableName]->setRef($foreignKeyName, $bean); |
|
259 | - if ($this->dbRows[$tableName]->_getStatus() === TDBMObjectStateEnum::STATE_DIRTY) { |
|
260 | - $this->status = TDBMObjectStateEnum::STATE_DIRTY; |
|
261 | - } |
|
262 | - } |
|
263 | - |
|
264 | - /** |
|
265 | - * @param string $foreignKeyName A unique name for this reference |
|
266 | - * |
|
267 | - * @return AbstractTDBMObject|null |
|
268 | - */ |
|
269 | - protected function getRef($foreignKeyName, $tableName = null) |
|
270 | - { |
|
271 | - $tableName = $this->checkTableName($tableName); |
|
272 | - |
|
273 | - return $this->dbRows[$tableName]->getRef($foreignKeyName); |
|
274 | - } |
|
275 | - |
|
276 | - /** |
|
277 | - * Adds a many to many relationship to this bean. |
|
278 | - * |
|
279 | - * @param string $pivotTableName |
|
280 | - * @param AbstractTDBMObject $remoteBean |
|
281 | - */ |
|
282 | - protected function addRelationship($pivotTableName, AbstractTDBMObject $remoteBean) |
|
283 | - { |
|
284 | - $this->setRelationship($pivotTableName, $remoteBean, 'new'); |
|
285 | - } |
|
286 | - |
|
287 | - /** |
|
288 | - * Returns true if there is a relationship to this bean. |
|
289 | - * |
|
290 | - * @param string $pivotTableName |
|
291 | - * @param AbstractTDBMObject $remoteBean |
|
292 | - * |
|
293 | - * @return bool |
|
294 | - */ |
|
295 | - protected function hasRelationship($pivotTableName, AbstractTDBMObject $remoteBean) |
|
296 | - { |
|
297 | - $storage = $this->retrieveRelationshipsStorage($pivotTableName); |
|
298 | - |
|
299 | - if ($storage->contains($remoteBean)) { |
|
300 | - if ($storage[$remoteBean]['status'] !== 'delete') { |
|
301 | - return true; |
|
302 | - } |
|
303 | - } |
|
304 | - |
|
305 | - return false; |
|
306 | - } |
|
307 | - |
|
308 | - /** |
|
309 | - * Internal TDBM method. Removes a many to many relationship from this bean. |
|
310 | - * |
|
311 | - * @param string $pivotTableName |
|
312 | - * @param AbstractTDBMObject $remoteBean |
|
313 | - */ |
|
314 | - public function _removeRelationship($pivotTableName, AbstractTDBMObject $remoteBean) |
|
315 | - { |
|
316 | - if (isset($this->relationships[$pivotTableName][$remoteBean]) && $this->relationships[$pivotTableName][$remoteBean]['status'] === 'new') { |
|
317 | - unset($this->relationships[$pivotTableName][$remoteBean]); |
|
318 | - unset($remoteBean->relationships[$pivotTableName][$this]); |
|
319 | - } else { |
|
320 | - $this->setRelationship($pivotTableName, $remoteBean, 'delete'); |
|
321 | - } |
|
322 | - } |
|
323 | - |
|
324 | - /** |
|
325 | - * Returns the list of objects linked to this bean via $pivotTableName. |
|
326 | - * |
|
327 | - * @param $pivotTableName |
|
328 | - * |
|
329 | - * @return \SplObjectStorage |
|
330 | - */ |
|
331 | - private function retrieveRelationshipsStorage($pivotTableName) |
|
332 | - { |
|
333 | - $storage = $this->getRelationshipStorage($pivotTableName); |
|
334 | - if ($this->status === TDBMObjectStateEnum::STATE_DETACHED || $this->status === TDBMObjectStateEnum::STATE_NEW || isset($this->loadedRelationships[$pivotTableName]) && $this->loadedRelationships[$pivotTableName]) { |
|
335 | - return $storage; |
|
336 | - } |
|
337 | - |
|
338 | - $beans = $this->tdbmService->_getRelatedBeans($pivotTableName, $this); |
|
339 | - $this->loadedRelationships[$pivotTableName] = true; |
|
340 | - |
|
341 | - foreach ($beans as $bean) { |
|
342 | - if (isset($storage[$bean])) { |
|
343 | - $oldStatus = $storage[$bean]['status']; |
|
344 | - if ($oldStatus === 'delete') { |
|
345 | - // Keep deleted things deleted |
|
346 | - continue; |
|
347 | - } |
|
348 | - } |
|
349 | - $this->setRelationship($pivotTableName, $bean, 'loaded'); |
|
350 | - } |
|
351 | - |
|
352 | - return $storage; |
|
353 | - } |
|
354 | - |
|
355 | - /** |
|
356 | - * Internal TDBM method. Returns the list of objects linked to this bean via $pivotTableName. |
|
357 | - * |
|
358 | - * @param $pivotTableName |
|
359 | - * |
|
360 | - * @return AbstractTDBMObject[] |
|
361 | - */ |
|
362 | - public function _getRelationships($pivotTableName) |
|
363 | - { |
|
364 | - return $this->relationshipStorageToArray($this->retrieveRelationshipsStorage($pivotTableName)); |
|
365 | - } |
|
366 | - |
|
367 | - private function relationshipStorageToArray(\SplObjectStorage $storage) |
|
368 | - { |
|
369 | - $beans = []; |
|
370 | - foreach ($storage as $bean) { |
|
371 | - $statusArr = $storage[$bean]; |
|
372 | - if ($statusArr['status'] !== 'delete') { |
|
373 | - $beans[] = $bean; |
|
374 | - } |
|
375 | - } |
|
376 | - |
|
377 | - return $beans; |
|
378 | - } |
|
379 | - |
|
380 | - /** |
|
381 | - * Declares a relationship between. |
|
382 | - * |
|
383 | - * @param string $pivotTableName |
|
384 | - * @param AbstractTDBMObject $remoteBean |
|
385 | - * @param string $status |
|
386 | - */ |
|
387 | - private function setRelationship($pivotTableName, AbstractTDBMObject $remoteBean, $status) |
|
388 | - { |
|
389 | - $storage = $this->getRelationshipStorage($pivotTableName); |
|
390 | - $storage->attach($remoteBean, ['status' => $status, 'reverse' => false]); |
|
391 | - if ($this->status === TDBMObjectStateEnum::STATE_LOADED) { |
|
392 | - $this->_setStatus(TDBMObjectStateEnum::STATE_DIRTY); |
|
393 | - } |
|
394 | - |
|
395 | - $remoteStorage = $remoteBean->getRelationshipStorage($pivotTableName); |
|
396 | - $remoteStorage->attach($this, ['status' => $status, 'reverse' => true]); |
|
397 | - } |
|
398 | - |
|
399 | - /** |
|
400 | - * Returns the SplObjectStorage associated to this relationship (creates it if it does not exists). |
|
401 | - * |
|
402 | - * @param $pivotTableName |
|
403 | - * |
|
404 | - * @return \SplObjectStorage |
|
405 | - */ |
|
406 | - private function getRelationshipStorage($pivotTableName) |
|
407 | - { |
|
408 | - if (isset($this->relationships[$pivotTableName])) { |
|
409 | - $storage = $this->relationships[$pivotTableName]; |
|
410 | - } else { |
|
411 | - $storage = new \SplObjectStorage(); |
|
412 | - $this->relationships[$pivotTableName] = $storage; |
|
413 | - } |
|
414 | - |
|
415 | - return $storage; |
|
416 | - } |
|
417 | - |
|
418 | - /** |
|
419 | - * Reverts any changes made to the object and resumes it to its DB state. |
|
420 | - * This can only be called on objects that come from database and that have not been deleted. |
|
421 | - * Otherwise, this will throw an exception. |
|
422 | - * |
|
423 | - * @throws TDBMException |
|
424 | - */ |
|
425 | - public function discardChanges() |
|
426 | - { |
|
427 | - if ($this->status === TDBMObjectStateEnum::STATE_NEW || $this->status === TDBMObjectStateEnum::STATE_DETACHED) { |
|
428 | - throw new TDBMException("You cannot call discardChanges() on an object that has been created with the 'new' keyword and that has not yet been saved."); |
|
429 | - } |
|
430 | - |
|
431 | - if ($this->status === TDBMObjectStateEnum::STATE_DELETED) { |
|
432 | - throw new TDBMException('You cannot call discardChanges() on an object that has been deleted.'); |
|
433 | - } |
|
434 | - |
|
435 | - $this->_setStatus(TDBMObjectStateEnum::STATE_NOT_LOADED); |
|
436 | - } |
|
437 | - |
|
438 | - /** |
|
439 | - * Method used internally by TDBM. You should not use it directly. |
|
440 | - * This method returns the status of the TDBMObject. |
|
441 | - * This is one of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED. |
|
442 | - * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject. |
|
443 | - * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet. |
|
444 | - * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory. |
|
445 | - * |
|
446 | - * @return string |
|
447 | - */ |
|
448 | - public function _getStatus() |
|
449 | - { |
|
450 | - return $this->status; |
|
451 | - } |
|
452 | - |
|
453 | - /** |
|
454 | - * Override the native php clone function for TDBMObjects. |
|
455 | - */ |
|
456 | - public function __clone() |
|
457 | - { |
|
458 | - // Let's clone the many to many relationships |
|
459 | - if ($this->status === TDBMObjectStateEnum::STATE_DETACHED) { |
|
460 | - $pivotTableList = array_keys($this->relationships); |
|
461 | - } else { |
|
462 | - $pivotTableList = $this->tdbmService->_getPivotTablesLinkedToBean($this); |
|
463 | - } |
|
464 | - |
|
465 | - foreach ($pivotTableList as $pivotTable) { |
|
466 | - $storage = $this->retrieveRelationshipsStorage($pivotTable); |
|
467 | - |
|
468 | - // Let's duplicate the reverse side of the relationship // This is useless: already done by "retrieveRelationshipsStorage"!!! |
|
469 | - /*foreach ($storage as $remoteBean) { |
|
34 | + /** |
|
35 | + * The service this object is bound to. |
|
36 | + * |
|
37 | + * @var TDBMService |
|
38 | + */ |
|
39 | + protected $tdbmService; |
|
40 | + |
|
41 | + /** |
|
42 | + * An array of DbRow, indexed by table name. |
|
43 | + * |
|
44 | + * @var DbRow[] |
|
45 | + */ |
|
46 | + protected $dbRows = array(); |
|
47 | + |
|
48 | + /** |
|
49 | + * One of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED. |
|
50 | + * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject. |
|
51 | + * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet. |
|
52 | + * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory. |
|
53 | + * |
|
54 | + * @var string |
|
55 | + */ |
|
56 | + private $status; |
|
57 | + |
|
58 | + /** |
|
59 | + * Array storing beans related via many to many relationships (pivot tables). |
|
60 | + * |
|
61 | + * @var \SplObjectStorage[] Key: pivot table name, value: SplObjectStorage |
|
62 | + */ |
|
63 | + private $relationships = []; |
|
64 | + |
|
65 | + /** |
|
66 | + * @var bool[] Key: pivot table name, value: whether a query was performed to load the data. |
|
67 | + */ |
|
68 | + private $loadedRelationships = []; |
|
69 | + |
|
70 | + /** |
|
71 | + * Used with $primaryKeys when we want to retrieve an existing object |
|
72 | + * and $primaryKeys=[] if we want a new object. |
|
73 | + * |
|
74 | + * @param string $tableName |
|
75 | + * @param array $primaryKeys |
|
76 | + * @param TDBMService $tdbmService |
|
77 | + * |
|
78 | + * @throws TDBMException |
|
79 | + * @throws TDBMInvalidOperationException |
|
80 | + */ |
|
81 | + public function __construct($tableName = null, array $primaryKeys = array(), TDBMService $tdbmService = null) |
|
82 | + { |
|
83 | + // FIXME: lazy loading should be forbidden on tables with inheritance and dynamic type assignation... |
|
84 | + if (!empty($tableName)) { |
|
85 | + $this->dbRows[$tableName] = new DbRow($this, $tableName, $primaryKeys, $tdbmService); |
|
86 | + } |
|
87 | + |
|
88 | + if ($tdbmService === null) { |
|
89 | + $this->_setStatus(TDBMObjectStateEnum::STATE_DETACHED); |
|
90 | + } else { |
|
91 | + $this->_attach($tdbmService); |
|
92 | + if (!empty($primaryKeys)) { |
|
93 | + $this->_setStatus(TDBMObjectStateEnum::STATE_NOT_LOADED); |
|
94 | + } else { |
|
95 | + $this->_setStatus(TDBMObjectStateEnum::STATE_NEW); |
|
96 | + } |
|
97 | + } |
|
98 | + } |
|
99 | + |
|
100 | + /** |
|
101 | + * Alternative constructor called when data is fetched from database via a SELECT. |
|
102 | + * |
|
103 | + * @param array $beanData array<table, array<column, value>> |
|
104 | + * @param TDBMService $tdbmService |
|
105 | + */ |
|
106 | + public function _constructFromData(array $beanData, TDBMService $tdbmService) |
|
107 | + { |
|
108 | + $this->tdbmService = $tdbmService; |
|
109 | + |
|
110 | + foreach ($beanData as $table => $columns) { |
|
111 | + $this->dbRows[$table] = new DbRow($this, $table, $tdbmService->_getPrimaryKeysFromObjectData($table, $columns), $tdbmService, $columns); |
|
112 | + } |
|
113 | + |
|
114 | + $this->status = TDBMObjectStateEnum::STATE_LOADED; |
|
115 | + } |
|
116 | + |
|
117 | + /** |
|
118 | + * Alternative constructor called when bean is lazily loaded. |
|
119 | + * |
|
120 | + * @param string $tableName |
|
121 | + * @param array $primaryKeys |
|
122 | + * @param TDBMService $tdbmService |
|
123 | + */ |
|
124 | + public function _constructLazy($tableName, array $primaryKeys, TDBMService $tdbmService) |
|
125 | + { |
|
126 | + $this->tdbmService = $tdbmService; |
|
127 | + |
|
128 | + $this->dbRows[$tableName] = new DbRow($this, $tableName, $primaryKeys, $tdbmService); |
|
129 | + |
|
130 | + $this->status = TDBMObjectStateEnum::STATE_NOT_LOADED; |
|
131 | + } |
|
132 | + |
|
133 | + public function _attach(TDBMService $tdbmService) |
|
134 | + { |
|
135 | + if ($this->status !== TDBMObjectStateEnum::STATE_DETACHED) { |
|
136 | + throw new TDBMInvalidOperationException('Cannot attach an object that is already attached to TDBM.'); |
|
137 | + } |
|
138 | + $this->tdbmService = $tdbmService; |
|
139 | + |
|
140 | + // If we attach this object, we must work to make sure the tables are in ascending order (from low level to top level) |
|
141 | + $tableNames = array_keys($this->dbRows); |
|
142 | + $tableNames = $this->tdbmService->_getLinkBetweenInheritedTables($tableNames); |
|
143 | + $tableNames = array_reverse($tableNames); |
|
144 | + |
|
145 | + $newDbRows = []; |
|
146 | + |
|
147 | + foreach ($tableNames as $table) { |
|
148 | + if (!isset($this->dbRows[$table])) { |
|
149 | + $this->registerTable($table); |
|
150 | + } |
|
151 | + $newDbRows[$table] = $this->dbRows[$table]; |
|
152 | + } |
|
153 | + $this->dbRows = $newDbRows; |
|
154 | + |
|
155 | + $this->status = TDBMObjectStateEnum::STATE_NEW; |
|
156 | + foreach ($this->dbRows as $dbRow) { |
|
157 | + $dbRow->_attach($tdbmService); |
|
158 | + } |
|
159 | + } |
|
160 | + |
|
161 | + /** |
|
162 | + * Sets the state of the TDBM Object |
|
163 | + * One of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED. |
|
164 | + * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject. |
|
165 | + * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet. |
|
166 | + * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory. |
|
167 | + * |
|
168 | + * @param string $state |
|
169 | + */ |
|
170 | + public function _setStatus($state) |
|
171 | + { |
|
172 | + $this->status = $state; |
|
173 | + |
|
174 | + // TODO: we might ignore the loaded => dirty state here! dirty status comes from the db_row itself. |
|
175 | + foreach ($this->dbRows as $dbRow) { |
|
176 | + $dbRow->_setStatus($state); |
|
177 | + } |
|
178 | + } |
|
179 | + |
|
180 | + /** |
|
181 | + * Checks that $tableName is ok, or returns the only possible table name if "$tableName = null" |
|
182 | + * or throws an error. |
|
183 | + * |
|
184 | + * @param string $tableName |
|
185 | + * |
|
186 | + * @return string |
|
187 | + */ |
|
188 | + private function checkTableName($tableName = null) |
|
189 | + { |
|
190 | + if ($tableName === null) { |
|
191 | + if (count($this->dbRows) > 1) { |
|
192 | + throw new TDBMException('This object is based on several tables. You must specify which table you are retrieving data from.'); |
|
193 | + } elseif (count($this->dbRows) === 1) { |
|
194 | + $tableName = array_keys($this->dbRows)[0]; |
|
195 | + } |
|
196 | + } |
|
197 | + |
|
198 | + if (!isset($this->dbRows[$tableName])) { |
|
199 | + if (count($this->dbRows[$tableName] === 0)) { |
|
200 | + throw new TDBMException('Object is not yet bound to any table.'); |
|
201 | + } else { |
|
202 | + throw new TDBMException('Unknown table "'.$tableName.'"" in object.'); |
|
203 | + } |
|
204 | + } |
|
205 | + |
|
206 | + return $tableName; |
|
207 | + } |
|
208 | + |
|
209 | + protected function get($var, $tableName = null) |
|
210 | + { |
|
211 | + $tableName = $this->checkTableName($tableName); |
|
212 | + |
|
213 | + return $this->dbRows[$tableName]->get($var); |
|
214 | + } |
|
215 | + |
|
216 | + protected function set($var, $value, $tableName = null) |
|
217 | + { |
|
218 | + if ($tableName === null) { |
|
219 | + if (count($this->dbRows) > 1) { |
|
220 | + throw new TDBMException('This object is based on several tables. You must specify which table you are retrieving data from.'); |
|
221 | + } elseif (count($this->dbRows) === 1) { |
|
222 | + $tableName = array_keys($this->dbRows)[0]; |
|
223 | + } else { |
|
224 | + throw new TDBMException('Please specify a table for this object.'); |
|
225 | + } |
|
226 | + } |
|
227 | + |
|
228 | + if (!isset($this->dbRows[$tableName])) { |
|
229 | + $this->registerTable($tableName); |
|
230 | + } |
|
231 | + |
|
232 | + $this->dbRows[$tableName]->set($var, $value); |
|
233 | + if ($this->dbRows[$tableName]->_getStatus() === TDBMObjectStateEnum::STATE_DIRTY) { |
|
234 | + $this->status = TDBMObjectStateEnum::STATE_DIRTY; |
|
235 | + } |
|
236 | + } |
|
237 | + |
|
238 | + /** |
|
239 | + * @param string $foreignKeyName |
|
240 | + * @param AbstractTDBMObject $bean |
|
241 | + */ |
|
242 | + protected function setRef($foreignKeyName, AbstractTDBMObject $bean = null, $tableName = null) |
|
243 | + { |
|
244 | + if ($tableName === null) { |
|
245 | + if (count($this->dbRows) > 1) { |
|
246 | + throw new TDBMException('This object is based on several tables. You must specify which table you are retrieving data from.'); |
|
247 | + } elseif (count($this->dbRows) === 1) { |
|
248 | + $tableName = array_keys($this->dbRows)[0]; |
|
249 | + } else { |
|
250 | + throw new TDBMException('Please specify a table for this object.'); |
|
251 | + } |
|
252 | + } |
|
253 | + |
|
254 | + if (!isset($this->dbRows[$tableName])) { |
|
255 | + $this->registerTable($tableName); |
|
256 | + } |
|
257 | + |
|
258 | + $this->dbRows[$tableName]->setRef($foreignKeyName, $bean); |
|
259 | + if ($this->dbRows[$tableName]->_getStatus() === TDBMObjectStateEnum::STATE_DIRTY) { |
|
260 | + $this->status = TDBMObjectStateEnum::STATE_DIRTY; |
|
261 | + } |
|
262 | + } |
|
263 | + |
|
264 | + /** |
|
265 | + * @param string $foreignKeyName A unique name for this reference |
|
266 | + * |
|
267 | + * @return AbstractTDBMObject|null |
|
268 | + */ |
|
269 | + protected function getRef($foreignKeyName, $tableName = null) |
|
270 | + { |
|
271 | + $tableName = $this->checkTableName($tableName); |
|
272 | + |
|
273 | + return $this->dbRows[$tableName]->getRef($foreignKeyName); |
|
274 | + } |
|
275 | + |
|
276 | + /** |
|
277 | + * Adds a many to many relationship to this bean. |
|
278 | + * |
|
279 | + * @param string $pivotTableName |
|
280 | + * @param AbstractTDBMObject $remoteBean |
|
281 | + */ |
|
282 | + protected function addRelationship($pivotTableName, AbstractTDBMObject $remoteBean) |
|
283 | + { |
|
284 | + $this->setRelationship($pivotTableName, $remoteBean, 'new'); |
|
285 | + } |
|
286 | + |
|
287 | + /** |
|
288 | + * Returns true if there is a relationship to this bean. |
|
289 | + * |
|
290 | + * @param string $pivotTableName |
|
291 | + * @param AbstractTDBMObject $remoteBean |
|
292 | + * |
|
293 | + * @return bool |
|
294 | + */ |
|
295 | + protected function hasRelationship($pivotTableName, AbstractTDBMObject $remoteBean) |
|
296 | + { |
|
297 | + $storage = $this->retrieveRelationshipsStorage($pivotTableName); |
|
298 | + |
|
299 | + if ($storage->contains($remoteBean)) { |
|
300 | + if ($storage[$remoteBean]['status'] !== 'delete') { |
|
301 | + return true; |
|
302 | + } |
|
303 | + } |
|
304 | + |
|
305 | + return false; |
|
306 | + } |
|
307 | + |
|
308 | + /** |
|
309 | + * Internal TDBM method. Removes a many to many relationship from this bean. |
|
310 | + * |
|
311 | + * @param string $pivotTableName |
|
312 | + * @param AbstractTDBMObject $remoteBean |
|
313 | + */ |
|
314 | + public function _removeRelationship($pivotTableName, AbstractTDBMObject $remoteBean) |
|
315 | + { |
|
316 | + if (isset($this->relationships[$pivotTableName][$remoteBean]) && $this->relationships[$pivotTableName][$remoteBean]['status'] === 'new') { |
|
317 | + unset($this->relationships[$pivotTableName][$remoteBean]); |
|
318 | + unset($remoteBean->relationships[$pivotTableName][$this]); |
|
319 | + } else { |
|
320 | + $this->setRelationship($pivotTableName, $remoteBean, 'delete'); |
|
321 | + } |
|
322 | + } |
|
323 | + |
|
324 | + /** |
|
325 | + * Returns the list of objects linked to this bean via $pivotTableName. |
|
326 | + * |
|
327 | + * @param $pivotTableName |
|
328 | + * |
|
329 | + * @return \SplObjectStorage |
|
330 | + */ |
|
331 | + private function retrieveRelationshipsStorage($pivotTableName) |
|
332 | + { |
|
333 | + $storage = $this->getRelationshipStorage($pivotTableName); |
|
334 | + if ($this->status === TDBMObjectStateEnum::STATE_DETACHED || $this->status === TDBMObjectStateEnum::STATE_NEW || isset($this->loadedRelationships[$pivotTableName]) && $this->loadedRelationships[$pivotTableName]) { |
|
335 | + return $storage; |
|
336 | + } |
|
337 | + |
|
338 | + $beans = $this->tdbmService->_getRelatedBeans($pivotTableName, $this); |
|
339 | + $this->loadedRelationships[$pivotTableName] = true; |
|
340 | + |
|
341 | + foreach ($beans as $bean) { |
|
342 | + if (isset($storage[$bean])) { |
|
343 | + $oldStatus = $storage[$bean]['status']; |
|
344 | + if ($oldStatus === 'delete') { |
|
345 | + // Keep deleted things deleted |
|
346 | + continue; |
|
347 | + } |
|
348 | + } |
|
349 | + $this->setRelationship($pivotTableName, $bean, 'loaded'); |
|
350 | + } |
|
351 | + |
|
352 | + return $storage; |
|
353 | + } |
|
354 | + |
|
355 | + /** |
|
356 | + * Internal TDBM method. Returns the list of objects linked to this bean via $pivotTableName. |
|
357 | + * |
|
358 | + * @param $pivotTableName |
|
359 | + * |
|
360 | + * @return AbstractTDBMObject[] |
|
361 | + */ |
|
362 | + public function _getRelationships($pivotTableName) |
|
363 | + { |
|
364 | + return $this->relationshipStorageToArray($this->retrieveRelationshipsStorage($pivotTableName)); |
|
365 | + } |
|
366 | + |
|
367 | + private function relationshipStorageToArray(\SplObjectStorage $storage) |
|
368 | + { |
|
369 | + $beans = []; |
|
370 | + foreach ($storage as $bean) { |
|
371 | + $statusArr = $storage[$bean]; |
|
372 | + if ($statusArr['status'] !== 'delete') { |
|
373 | + $beans[] = $bean; |
|
374 | + } |
|
375 | + } |
|
376 | + |
|
377 | + return $beans; |
|
378 | + } |
|
379 | + |
|
380 | + /** |
|
381 | + * Declares a relationship between. |
|
382 | + * |
|
383 | + * @param string $pivotTableName |
|
384 | + * @param AbstractTDBMObject $remoteBean |
|
385 | + * @param string $status |
|
386 | + */ |
|
387 | + private function setRelationship($pivotTableName, AbstractTDBMObject $remoteBean, $status) |
|
388 | + { |
|
389 | + $storage = $this->getRelationshipStorage($pivotTableName); |
|
390 | + $storage->attach($remoteBean, ['status' => $status, 'reverse' => false]); |
|
391 | + if ($this->status === TDBMObjectStateEnum::STATE_LOADED) { |
|
392 | + $this->_setStatus(TDBMObjectStateEnum::STATE_DIRTY); |
|
393 | + } |
|
394 | + |
|
395 | + $remoteStorage = $remoteBean->getRelationshipStorage($pivotTableName); |
|
396 | + $remoteStorage->attach($this, ['status' => $status, 'reverse' => true]); |
|
397 | + } |
|
398 | + |
|
399 | + /** |
|
400 | + * Returns the SplObjectStorage associated to this relationship (creates it if it does not exists). |
|
401 | + * |
|
402 | + * @param $pivotTableName |
|
403 | + * |
|
404 | + * @return \SplObjectStorage |
|
405 | + */ |
|
406 | + private function getRelationshipStorage($pivotTableName) |
|
407 | + { |
|
408 | + if (isset($this->relationships[$pivotTableName])) { |
|
409 | + $storage = $this->relationships[$pivotTableName]; |
|
410 | + } else { |
|
411 | + $storage = new \SplObjectStorage(); |
|
412 | + $this->relationships[$pivotTableName] = $storage; |
|
413 | + } |
|
414 | + |
|
415 | + return $storage; |
|
416 | + } |
|
417 | + |
|
418 | + /** |
|
419 | + * Reverts any changes made to the object and resumes it to its DB state. |
|
420 | + * This can only be called on objects that come from database and that have not been deleted. |
|
421 | + * Otherwise, this will throw an exception. |
|
422 | + * |
|
423 | + * @throws TDBMException |
|
424 | + */ |
|
425 | + public function discardChanges() |
|
426 | + { |
|
427 | + if ($this->status === TDBMObjectStateEnum::STATE_NEW || $this->status === TDBMObjectStateEnum::STATE_DETACHED) { |
|
428 | + throw new TDBMException("You cannot call discardChanges() on an object that has been created with the 'new' keyword and that has not yet been saved."); |
|
429 | + } |
|
430 | + |
|
431 | + if ($this->status === TDBMObjectStateEnum::STATE_DELETED) { |
|
432 | + throw new TDBMException('You cannot call discardChanges() on an object that has been deleted.'); |
|
433 | + } |
|
434 | + |
|
435 | + $this->_setStatus(TDBMObjectStateEnum::STATE_NOT_LOADED); |
|
436 | + } |
|
437 | + |
|
438 | + /** |
|
439 | + * Method used internally by TDBM. You should not use it directly. |
|
440 | + * This method returns the status of the TDBMObject. |
|
441 | + * This is one of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED. |
|
442 | + * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject. |
|
443 | + * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet. |
|
444 | + * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory. |
|
445 | + * |
|
446 | + * @return string |
|
447 | + */ |
|
448 | + public function _getStatus() |
|
449 | + { |
|
450 | + return $this->status; |
|
451 | + } |
|
452 | + |
|
453 | + /** |
|
454 | + * Override the native php clone function for TDBMObjects. |
|
455 | + */ |
|
456 | + public function __clone() |
|
457 | + { |
|
458 | + // Let's clone the many to many relationships |
|
459 | + if ($this->status === TDBMObjectStateEnum::STATE_DETACHED) { |
|
460 | + $pivotTableList = array_keys($this->relationships); |
|
461 | + } else { |
|
462 | + $pivotTableList = $this->tdbmService->_getPivotTablesLinkedToBean($this); |
|
463 | + } |
|
464 | + |
|
465 | + foreach ($pivotTableList as $pivotTable) { |
|
466 | + $storage = $this->retrieveRelationshipsStorage($pivotTable); |
|
467 | + |
|
468 | + // Let's duplicate the reverse side of the relationship // This is useless: already done by "retrieveRelationshipsStorage"!!! |
|
469 | + /*foreach ($storage as $remoteBean) { |
|
470 | 470 | $metadata = $storage[$remoteBean]; |
471 | 471 | |
472 | 472 | $remoteStorage = $remoteBean->getRelationshipStorage($pivotTable); |
473 | 473 | $remoteStorage->attach($this, ['status' => $metadata['status'], 'reverse' => !$metadata['reverse']]); |
474 | 474 | }*/ |
475 | - } |
|
476 | - |
|
477 | - // Let's clone each row |
|
478 | - foreach ($this->dbRows as $key => &$dbRow) { |
|
479 | - $dbRow = clone $dbRow; |
|
480 | - $dbRow->setTDBMObject($this); |
|
481 | - } |
|
482 | - |
|
483 | - // Let's set the status to new (to enter the save function) |
|
484 | - $this->status = TDBMObjectStateEnum::STATE_DETACHED; |
|
485 | - } |
|
486 | - |
|
487 | - /** |
|
488 | - * Returns raw database rows. |
|
489 | - * |
|
490 | - * @return DbRow[] Key: table name, Value: DbRow object |
|
491 | - */ |
|
492 | - public function _getDbRows() |
|
493 | - { |
|
494 | - return $this->dbRows; |
|
495 | - } |
|
496 | - |
|
497 | - private function registerTable($tableName) |
|
498 | - { |
|
499 | - $dbRow = new DbRow($this, $tableName); |
|
500 | - |
|
501 | - if (in_array($this->status, [TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DIRTY])) { |
|
502 | - // Let's get the primary key for the new table |
|
503 | - $anotherDbRow = array_values($this->dbRows)[0]; |
|
504 | - /* @var $anotherDbRow DbRow */ |
|
505 | - $indexedPrimaryKeys = array_values($anotherDbRow->_getPrimaryKeys()); |
|
506 | - $primaryKeys = $this->tdbmService->_getPrimaryKeysFromIndexedPrimaryKeys($tableName, $indexedPrimaryKeys); |
|
507 | - $dbRow->_setPrimaryKeys($primaryKeys); |
|
508 | - } |
|
509 | - |
|
510 | - $dbRow->_setStatus($this->status); |
|
511 | - |
|
512 | - $this->dbRows[$tableName] = $dbRow; |
|
513 | - // TODO: look at status (if not new)=> get primary key from tdbmservice |
|
514 | - } |
|
515 | - |
|
516 | - /** |
|
517 | - * Internal function: return the list of relationships. |
|
518 | - * |
|
519 | - * @return \SplObjectStorage[] |
|
520 | - */ |
|
521 | - public function _getCachedRelationships() |
|
522 | - { |
|
523 | - return $this->relationships; |
|
524 | - } |
|
475 | + } |
|
476 | + |
|
477 | + // Let's clone each row |
|
478 | + foreach ($this->dbRows as $key => &$dbRow) { |
|
479 | + $dbRow = clone $dbRow; |
|
480 | + $dbRow->setTDBMObject($this); |
|
481 | + } |
|
482 | + |
|
483 | + // Let's set the status to new (to enter the save function) |
|
484 | + $this->status = TDBMObjectStateEnum::STATE_DETACHED; |
|
485 | + } |
|
486 | + |
|
487 | + /** |
|
488 | + * Returns raw database rows. |
|
489 | + * |
|
490 | + * @return DbRow[] Key: table name, Value: DbRow object |
|
491 | + */ |
|
492 | + public function _getDbRows() |
|
493 | + { |
|
494 | + return $this->dbRows; |
|
495 | + } |
|
496 | + |
|
497 | + private function registerTable($tableName) |
|
498 | + { |
|
499 | + $dbRow = new DbRow($this, $tableName); |
|
500 | + |
|
501 | + if (in_array($this->status, [TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DIRTY])) { |
|
502 | + // Let's get the primary key for the new table |
|
503 | + $anotherDbRow = array_values($this->dbRows)[0]; |
|
504 | + /* @var $anotherDbRow DbRow */ |
|
505 | + $indexedPrimaryKeys = array_values($anotherDbRow->_getPrimaryKeys()); |
|
506 | + $primaryKeys = $this->tdbmService->_getPrimaryKeysFromIndexedPrimaryKeys($tableName, $indexedPrimaryKeys); |
|
507 | + $dbRow->_setPrimaryKeys($primaryKeys); |
|
508 | + } |
|
509 | + |
|
510 | + $dbRow->_setStatus($this->status); |
|
511 | + |
|
512 | + $this->dbRows[$tableName] = $dbRow; |
|
513 | + // TODO: look at status (if not new)=> get primary key from tdbmservice |
|
514 | + } |
|
515 | + |
|
516 | + /** |
|
517 | + * Internal function: return the list of relationships. |
|
518 | + * |
|
519 | + * @return \SplObjectStorage[] |
|
520 | + */ |
|
521 | + public function _getCachedRelationships() |
|
522 | + { |
|
523 | + return $this->relationships; |
|
524 | + } |
|
525 | 525 | } |
@@ -41,213 +41,213 @@ discard block |
||
41 | 41 | */ |
42 | 42 | class TDBMService |
43 | 43 | { |
44 | - const MODE_CURSOR = 1; |
|
45 | - const MODE_ARRAY = 2; |
|
46 | - |
|
47 | - /** |
|
48 | - * The database connection. |
|
49 | - * |
|
50 | - * @var Connection |
|
51 | - */ |
|
52 | - private $connection; |
|
53 | - |
|
54 | - /** |
|
55 | - * @var SchemaAnalyzer |
|
56 | - */ |
|
57 | - private $schemaAnalyzer; |
|
58 | - |
|
59 | - /** |
|
60 | - * @var MagicQuery |
|
61 | - */ |
|
62 | - private $magicQuery; |
|
63 | - |
|
64 | - /** |
|
65 | - * @var TDBMSchemaAnalyzer |
|
66 | - */ |
|
67 | - private $tdbmSchemaAnalyzer; |
|
68 | - |
|
69 | - /** |
|
70 | - * @var string |
|
71 | - */ |
|
72 | - private $cachePrefix; |
|
73 | - |
|
74 | - /** |
|
75 | - * Cache of table of primary keys. |
|
76 | - * Primary keys are stored by tables, as an array of column. |
|
77 | - * For instance $primary_key['my_table'][0] will return the first column of the primary key of table 'my_table'. |
|
78 | - * |
|
79 | - * @var string[] |
|
80 | - */ |
|
81 | - private $primaryKeysColumns; |
|
82 | - |
|
83 | - /** |
|
84 | - * Service storing objects in memory. |
|
85 | - * Access is done by table name and then by primary key. |
|
86 | - * If the primary key is split on several columns, access is done by an array of columns, serialized. |
|
87 | - * |
|
88 | - * @var StandardObjectStorage|WeakrefObjectStorage |
|
89 | - */ |
|
90 | - private $objectStorage; |
|
91 | - |
|
92 | - /** |
|
93 | - * The fetch mode of the result sets returned by `getObjects`. |
|
94 | - * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY or TDBMObjectArray::MODE_COMPATIBLE_ARRAY. |
|
95 | - * |
|
96 | - * In 'MODE_ARRAY' mode (default), the result is an array. Use this mode by default (unless the list returned is very big). |
|
97 | - * In 'MODE_CURSOR' mode, the result is a Generator which is an iterable collection that can be scanned only once (only one "foreach") on it, |
|
98 | - * and it cannot be accessed via key. Use this mode for large datasets processed by batch. |
|
99 | - * In 'MODE_COMPATIBLE_ARRAY' mode, the result is an old TDBMObjectArray (used up to TDBM 3.2). |
|
100 | - * You can access the array by key, or using foreach, several times. |
|
101 | - * |
|
102 | - * @var int |
|
103 | - */ |
|
104 | - private $mode = self::MODE_ARRAY; |
|
105 | - |
|
106 | - /** |
|
107 | - * Table of new objects not yet inserted in database or objects modified that must be saved. |
|
108 | - * |
|
109 | - * @var \SplObjectStorage of DbRow objects |
|
110 | - */ |
|
111 | - private $toSaveObjects; |
|
112 | - |
|
113 | - /** |
|
114 | - * The content of the cache variable. |
|
115 | - * |
|
116 | - * @var array<string, mixed> |
|
117 | - */ |
|
118 | - private $cache; |
|
119 | - |
|
120 | - /** |
|
121 | - * Map associating a table name to a fully qualified Bean class name. |
|
122 | - * |
|
123 | - * @var array |
|
124 | - */ |
|
125 | - private $tableToBeanMap = []; |
|
126 | - |
|
127 | - /** |
|
128 | - * @var \ReflectionClass[] |
|
129 | - */ |
|
130 | - private $reflectionClassCache = array(); |
|
131 | - |
|
132 | - /** |
|
133 | - * @param Connection $connection The DBAL DB connection to use |
|
134 | - * @param Cache|null $cache A cache service to be used |
|
135 | - * @param SchemaAnalyzer $schemaAnalyzer The schema analyzer that will be used to find shortest paths... |
|
136 | - * Will be automatically created if not passed. |
|
137 | - */ |
|
138 | - public function __construct(Connection $connection, Cache $cache = null, SchemaAnalyzer $schemaAnalyzer = null) |
|
139 | - { |
|
140 | - if (extension_loaded('weakref')) { |
|
141 | - $this->objectStorage = new WeakrefObjectStorage(); |
|
142 | - } else { |
|
143 | - $this->objectStorage = new StandardObjectStorage(); |
|
144 | - } |
|
145 | - $this->connection = $connection; |
|
146 | - if ($cache !== null) { |
|
147 | - $this->cache = $cache; |
|
148 | - } else { |
|
149 | - $this->cache = new VoidCache(); |
|
150 | - } |
|
151 | - if ($schemaAnalyzer) { |
|
152 | - $this->schemaAnalyzer = $schemaAnalyzer; |
|
153 | - } else { |
|
154 | - $this->schemaAnalyzer = new SchemaAnalyzer($this->connection->getSchemaManager(), $this->cache, $this->getConnectionUniqueId()); |
|
155 | - } |
|
156 | - |
|
157 | - $this->magicQuery = new MagicQuery($this->connection, $this->cache, $this->schemaAnalyzer); |
|
158 | - |
|
159 | - $this->tdbmSchemaAnalyzer = new TDBMSchemaAnalyzer($connection, $this->cache, $this->schemaAnalyzer); |
|
160 | - $this->cachePrefix = $this->tdbmSchemaAnalyzer->getCachePrefix(); |
|
161 | - |
|
162 | - $this->toSaveObjects = new \SplObjectStorage(); |
|
163 | - } |
|
164 | - |
|
165 | - /** |
|
166 | - * Returns the object used to connect to the database. |
|
167 | - * |
|
168 | - * @return Connection |
|
169 | - */ |
|
170 | - public function getConnection() |
|
171 | - { |
|
172 | - return $this->connection; |
|
173 | - } |
|
174 | - |
|
175 | - /** |
|
176 | - * Creates a unique cache key for the current connection. |
|
177 | - * |
|
178 | - * @return string |
|
179 | - */ |
|
180 | - private function getConnectionUniqueId() |
|
181 | - { |
|
182 | - return hash('md4', $this->connection->getHost().'-'.$this->connection->getPort().'-'.$this->connection->getDatabase().'-'.$this->connection->getDriver()->getName()); |
|
183 | - } |
|
184 | - |
|
185 | - /** |
|
186 | - * Sets the default fetch mode of the result sets returned by `findObjects`. |
|
187 | - * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY. |
|
188 | - * |
|
189 | - * In 'MODE_ARRAY' mode (default), the result is a ResultIterator object that behaves like an array. Use this mode by default (unless the list returned is very big). |
|
190 | - * In 'MODE_CURSOR' mode, the result is a ResultIterator object. If you scan it many times (by calling several time a foreach loop), the query will be run |
|
191 | - * several times. In cursor mode, you cannot access the result set by key. Use this mode for large datasets processed by batch. |
|
192 | - * |
|
193 | - * @param int $mode |
|
194 | - * |
|
195 | - * @return $this |
|
196 | - * |
|
197 | - * @throws TDBMException |
|
198 | - */ |
|
199 | - public function setFetchMode($mode) |
|
200 | - { |
|
201 | - if ($mode !== self::MODE_CURSOR && $mode !== self::MODE_ARRAY) { |
|
202 | - throw new TDBMException("Unknown fetch mode: '".$this->mode."'"); |
|
203 | - } |
|
204 | - $this->mode = $mode; |
|
205 | - |
|
206 | - return $this; |
|
207 | - } |
|
208 | - |
|
209 | - /** |
|
210 | - * Returns a TDBMObject associated from table "$table_name". |
|
211 | - * If the $filters parameter is an int/string, the object returned will be the object whose primary key = $filters. |
|
212 | - * $filters can also be a set of TDBM_Filters (see the findObjects method for more details). |
|
213 | - * |
|
214 | - * For instance, if there is a table 'users', with a primary key on column 'user_id' and a column 'user_name', then |
|
215 | - * $user = $tdbmService->getObject('users',1); |
|
216 | - * echo $user->name; |
|
217 | - * will return the name of the user whose user_id is one. |
|
218 | - * |
|
219 | - * If a table has a primary key over several columns, you should pass to $id an array containing the the value of the various columns. |
|
220 | - * For instance: |
|
221 | - * $group = $tdbmService->getObject('groups',array(1,2)); |
|
222 | - * |
|
223 | - * Note that TDBMObject performs caching for you. If you get twice the same object, the reference of the object you will get |
|
224 | - * will be the same. |
|
225 | - * |
|
226 | - * For instance: |
|
227 | - * $user1 = $tdbmService->getObject('users',1); |
|
228 | - * $user2 = $tdbmService->getObject('users',1); |
|
229 | - * $user1->name = 'John Doe'; |
|
230 | - * echo $user2->name; |
|
231 | - * will return 'John Doe'. |
|
232 | - * |
|
233 | - * You can use filters instead of passing the primary key. For instance: |
|
234 | - * $user = $tdbmService->getObject('users',new EqualFilter('users', 'login', 'jdoe')); |
|
235 | - * This will return the user whose login is 'jdoe'. |
|
236 | - * Please note that if 2 users have the jdoe login in database, the method will throw a TDBM_DuplicateRowException. |
|
237 | - * |
|
238 | - * Also, you can specify the return class for the object (provided the return class extends TDBMObject). |
|
239 | - * For instance: |
|
240 | - * $user = $tdbmService->getObject('users',1,'User'); |
|
241 | - * will return an object from the "User" class. The "User" class must extend the "TDBMObject" class. |
|
242 | - * Please be sure not to override any method or any property unless you perfectly know what you are doing! |
|
243 | - * |
|
244 | - * @param string $table_name The name of the table we retrieve an object from. |
|
245 | - * @param mixed $filters If the filter is a string/integer, it will be considered as the id of the object (the value of the primary key). Otherwise, it can be a filter bag (see the filterbag parameter of the findObjects method for more details about filter bags) |
|
246 | - * @param string $className Optional: The name of the class to instanciate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned. |
|
247 | - * @param bool $lazy_loading If set to true, and if the primary key is passed in parameter of getObject, the object will not be queried in database. It will be queried when you first try to access a column. If at that time the object cannot be found in database, an exception will be thrown. |
|
248 | - * |
|
249 | - * @return TDBMObject |
|
250 | - */ |
|
44 | + const MODE_CURSOR = 1; |
|
45 | + const MODE_ARRAY = 2; |
|
46 | + |
|
47 | + /** |
|
48 | + * The database connection. |
|
49 | + * |
|
50 | + * @var Connection |
|
51 | + */ |
|
52 | + private $connection; |
|
53 | + |
|
54 | + /** |
|
55 | + * @var SchemaAnalyzer |
|
56 | + */ |
|
57 | + private $schemaAnalyzer; |
|
58 | + |
|
59 | + /** |
|
60 | + * @var MagicQuery |
|
61 | + */ |
|
62 | + private $magicQuery; |
|
63 | + |
|
64 | + /** |
|
65 | + * @var TDBMSchemaAnalyzer |
|
66 | + */ |
|
67 | + private $tdbmSchemaAnalyzer; |
|
68 | + |
|
69 | + /** |
|
70 | + * @var string |
|
71 | + */ |
|
72 | + private $cachePrefix; |
|
73 | + |
|
74 | + /** |
|
75 | + * Cache of table of primary keys. |
|
76 | + * Primary keys are stored by tables, as an array of column. |
|
77 | + * For instance $primary_key['my_table'][0] will return the first column of the primary key of table 'my_table'. |
|
78 | + * |
|
79 | + * @var string[] |
|
80 | + */ |
|
81 | + private $primaryKeysColumns; |
|
82 | + |
|
83 | + /** |
|
84 | + * Service storing objects in memory. |
|
85 | + * Access is done by table name and then by primary key. |
|
86 | + * If the primary key is split on several columns, access is done by an array of columns, serialized. |
|
87 | + * |
|
88 | + * @var StandardObjectStorage|WeakrefObjectStorage |
|
89 | + */ |
|
90 | + private $objectStorage; |
|
91 | + |
|
92 | + /** |
|
93 | + * The fetch mode of the result sets returned by `getObjects`. |
|
94 | + * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY or TDBMObjectArray::MODE_COMPATIBLE_ARRAY. |
|
95 | + * |
|
96 | + * In 'MODE_ARRAY' mode (default), the result is an array. Use this mode by default (unless the list returned is very big). |
|
97 | + * In 'MODE_CURSOR' mode, the result is a Generator which is an iterable collection that can be scanned only once (only one "foreach") on it, |
|
98 | + * and it cannot be accessed via key. Use this mode for large datasets processed by batch. |
|
99 | + * In 'MODE_COMPATIBLE_ARRAY' mode, the result is an old TDBMObjectArray (used up to TDBM 3.2). |
|
100 | + * You can access the array by key, or using foreach, several times. |
|
101 | + * |
|
102 | + * @var int |
|
103 | + */ |
|
104 | + private $mode = self::MODE_ARRAY; |
|
105 | + |
|
106 | + /** |
|
107 | + * Table of new objects not yet inserted in database or objects modified that must be saved. |
|
108 | + * |
|
109 | + * @var \SplObjectStorage of DbRow objects |
|
110 | + */ |
|
111 | + private $toSaveObjects; |
|
112 | + |
|
113 | + /** |
|
114 | + * The content of the cache variable. |
|
115 | + * |
|
116 | + * @var array<string, mixed> |
|
117 | + */ |
|
118 | + private $cache; |
|
119 | + |
|
120 | + /** |
|
121 | + * Map associating a table name to a fully qualified Bean class name. |
|
122 | + * |
|
123 | + * @var array |
|
124 | + */ |
|
125 | + private $tableToBeanMap = []; |
|
126 | + |
|
127 | + /** |
|
128 | + * @var \ReflectionClass[] |
|
129 | + */ |
|
130 | + private $reflectionClassCache = array(); |
|
131 | + |
|
132 | + /** |
|
133 | + * @param Connection $connection The DBAL DB connection to use |
|
134 | + * @param Cache|null $cache A cache service to be used |
|
135 | + * @param SchemaAnalyzer $schemaAnalyzer The schema analyzer that will be used to find shortest paths... |
|
136 | + * Will be automatically created if not passed. |
|
137 | + */ |
|
138 | + public function __construct(Connection $connection, Cache $cache = null, SchemaAnalyzer $schemaAnalyzer = null) |
|
139 | + { |
|
140 | + if (extension_loaded('weakref')) { |
|
141 | + $this->objectStorage = new WeakrefObjectStorage(); |
|
142 | + } else { |
|
143 | + $this->objectStorage = new StandardObjectStorage(); |
|
144 | + } |
|
145 | + $this->connection = $connection; |
|
146 | + if ($cache !== null) { |
|
147 | + $this->cache = $cache; |
|
148 | + } else { |
|
149 | + $this->cache = new VoidCache(); |
|
150 | + } |
|
151 | + if ($schemaAnalyzer) { |
|
152 | + $this->schemaAnalyzer = $schemaAnalyzer; |
|
153 | + } else { |
|
154 | + $this->schemaAnalyzer = new SchemaAnalyzer($this->connection->getSchemaManager(), $this->cache, $this->getConnectionUniqueId()); |
|
155 | + } |
|
156 | + |
|
157 | + $this->magicQuery = new MagicQuery($this->connection, $this->cache, $this->schemaAnalyzer); |
|
158 | + |
|
159 | + $this->tdbmSchemaAnalyzer = new TDBMSchemaAnalyzer($connection, $this->cache, $this->schemaAnalyzer); |
|
160 | + $this->cachePrefix = $this->tdbmSchemaAnalyzer->getCachePrefix(); |
|
161 | + |
|
162 | + $this->toSaveObjects = new \SplObjectStorage(); |
|
163 | + } |
|
164 | + |
|
165 | + /** |
|
166 | + * Returns the object used to connect to the database. |
|
167 | + * |
|
168 | + * @return Connection |
|
169 | + */ |
|
170 | + public function getConnection() |
|
171 | + { |
|
172 | + return $this->connection; |
|
173 | + } |
|
174 | + |
|
175 | + /** |
|
176 | + * Creates a unique cache key for the current connection. |
|
177 | + * |
|
178 | + * @return string |
|
179 | + */ |
|
180 | + private function getConnectionUniqueId() |
|
181 | + { |
|
182 | + return hash('md4', $this->connection->getHost().'-'.$this->connection->getPort().'-'.$this->connection->getDatabase().'-'.$this->connection->getDriver()->getName()); |
|
183 | + } |
|
184 | + |
|
185 | + /** |
|
186 | + * Sets the default fetch mode of the result sets returned by `findObjects`. |
|
187 | + * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY. |
|
188 | + * |
|
189 | + * In 'MODE_ARRAY' mode (default), the result is a ResultIterator object that behaves like an array. Use this mode by default (unless the list returned is very big). |
|
190 | + * In 'MODE_CURSOR' mode, the result is a ResultIterator object. If you scan it many times (by calling several time a foreach loop), the query will be run |
|
191 | + * several times. In cursor mode, you cannot access the result set by key. Use this mode for large datasets processed by batch. |
|
192 | + * |
|
193 | + * @param int $mode |
|
194 | + * |
|
195 | + * @return $this |
|
196 | + * |
|
197 | + * @throws TDBMException |
|
198 | + */ |
|
199 | + public function setFetchMode($mode) |
|
200 | + { |
|
201 | + if ($mode !== self::MODE_CURSOR && $mode !== self::MODE_ARRAY) { |
|
202 | + throw new TDBMException("Unknown fetch mode: '".$this->mode."'"); |
|
203 | + } |
|
204 | + $this->mode = $mode; |
|
205 | + |
|
206 | + return $this; |
|
207 | + } |
|
208 | + |
|
209 | + /** |
|
210 | + * Returns a TDBMObject associated from table "$table_name". |
|
211 | + * If the $filters parameter is an int/string, the object returned will be the object whose primary key = $filters. |
|
212 | + * $filters can also be a set of TDBM_Filters (see the findObjects method for more details). |
|
213 | + * |
|
214 | + * For instance, if there is a table 'users', with a primary key on column 'user_id' and a column 'user_name', then |
|
215 | + * $user = $tdbmService->getObject('users',1); |
|
216 | + * echo $user->name; |
|
217 | + * will return the name of the user whose user_id is one. |
|
218 | + * |
|
219 | + * If a table has a primary key over several columns, you should pass to $id an array containing the the value of the various columns. |
|
220 | + * For instance: |
|
221 | + * $group = $tdbmService->getObject('groups',array(1,2)); |
|
222 | + * |
|
223 | + * Note that TDBMObject performs caching for you. If you get twice the same object, the reference of the object you will get |
|
224 | + * will be the same. |
|
225 | + * |
|
226 | + * For instance: |
|
227 | + * $user1 = $tdbmService->getObject('users',1); |
|
228 | + * $user2 = $tdbmService->getObject('users',1); |
|
229 | + * $user1->name = 'John Doe'; |
|
230 | + * echo $user2->name; |
|
231 | + * will return 'John Doe'. |
|
232 | + * |
|
233 | + * You can use filters instead of passing the primary key. For instance: |
|
234 | + * $user = $tdbmService->getObject('users',new EqualFilter('users', 'login', 'jdoe')); |
|
235 | + * This will return the user whose login is 'jdoe'. |
|
236 | + * Please note that if 2 users have the jdoe login in database, the method will throw a TDBM_DuplicateRowException. |
|
237 | + * |
|
238 | + * Also, you can specify the return class for the object (provided the return class extends TDBMObject). |
|
239 | + * For instance: |
|
240 | + * $user = $tdbmService->getObject('users',1,'User'); |
|
241 | + * will return an object from the "User" class. The "User" class must extend the "TDBMObject" class. |
|
242 | + * Please be sure not to override any method or any property unless you perfectly know what you are doing! |
|
243 | + * |
|
244 | + * @param string $table_name The name of the table we retrieve an object from. |
|
245 | + * @param mixed $filters If the filter is a string/integer, it will be considered as the id of the object (the value of the primary key). Otherwise, it can be a filter bag (see the filterbag parameter of the findObjects method for more details about filter bags) |
|
246 | + * @param string $className Optional: The name of the class to instanciate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned. |
|
247 | + * @param bool $lazy_loading If set to true, and if the primary key is passed in parameter of getObject, the object will not be queried in database. It will be queried when you first try to access a column. If at that time the object cannot be found in database, an exception will be thrown. |
|
248 | + * |
|
249 | + * @return TDBMObject |
|
250 | + */ |
|
251 | 251 | /* public function getObject($table_name, $filters, $className = null, $lazy_loading = false) { |
252 | 252 | |
253 | 253 | if (is_array($filters) || $filters instanceof FilterInterface) { |
@@ -333,199 +333,199 @@ discard block |
||
333 | 333 | return $obj; |
334 | 334 | }*/ |
335 | 335 | |
336 | - /** |
|
337 | - * Removes the given object from database. |
|
338 | - * This cannot be called on an object that is not attached to this TDBMService |
|
339 | - * (will throw a TDBMInvalidOperationException). |
|
340 | - * |
|
341 | - * @param AbstractTDBMObject $object the object to delete. |
|
342 | - * |
|
343 | - * @throws TDBMException |
|
344 | - * @throws TDBMInvalidOperationException |
|
345 | - */ |
|
346 | - public function delete(AbstractTDBMObject $object) |
|
347 | - { |
|
348 | - switch ($object->_getStatus()) { |
|
349 | - case TDBMObjectStateEnum::STATE_DELETED: |
|
350 | - // Nothing to do, object already deleted. |
|
351 | - return; |
|
352 | - case TDBMObjectStateEnum::STATE_DETACHED: |
|
353 | - throw new TDBMInvalidOperationException('Cannot delete a detached object'); |
|
354 | - case TDBMObjectStateEnum::STATE_NEW: |
|
355 | - $this->deleteManyToManyRelationships($object); |
|
356 | - foreach ($object->_getDbRows() as $dbRow) { |
|
357 | - $this->removeFromToSaveObjectList($dbRow); |
|
358 | - } |
|
359 | - break; |
|
360 | - case TDBMObjectStateEnum::STATE_DIRTY: |
|
361 | - foreach ($object->_getDbRows() as $dbRow) { |
|
362 | - $this->removeFromToSaveObjectList($dbRow); |
|
363 | - } |
|
364 | - // And continue deleting... |
|
365 | - case TDBMObjectStateEnum::STATE_NOT_LOADED: |
|
366 | - case TDBMObjectStateEnum::STATE_LOADED: |
|
367 | - $this->deleteManyToManyRelationships($object); |
|
368 | - // Let's delete db rows, in reverse order. |
|
369 | - foreach (array_reverse($object->_getDbRows()) as $dbRow) { |
|
370 | - $tableName = $dbRow->_getDbTableName(); |
|
371 | - $primaryKeys = $dbRow->_getPrimaryKeys(); |
|
372 | - $this->connection->delete($tableName, $primaryKeys); |
|
373 | - $this->objectStorage->remove($dbRow->_getDbTableName(), $this->getObjectHash($primaryKeys)); |
|
374 | - } |
|
375 | - break; |
|
376 | - // @codeCoverageIgnoreStart |
|
377 | - default: |
|
378 | - throw new TDBMInvalidOperationException('Unexpected status for bean'); |
|
379 | - // @codeCoverageIgnoreEnd |
|
380 | - } |
|
381 | - |
|
382 | - $object->_setStatus(TDBMObjectStateEnum::STATE_DELETED); |
|
383 | - } |
|
384 | - |
|
385 | - /** |
|
386 | - * Removes all many to many relationships for this object. |
|
387 | - * |
|
388 | - * @param AbstractTDBMObject $object |
|
389 | - */ |
|
390 | - private function deleteManyToManyRelationships(AbstractTDBMObject $object) |
|
391 | - { |
|
392 | - foreach ($object->_getDbRows() as $tableName => $dbRow) { |
|
393 | - $pivotTables = $this->tdbmSchemaAnalyzer->getPivotTableLinkedToTable($tableName); |
|
394 | - foreach ($pivotTables as $pivotTable) { |
|
395 | - $remoteBeans = $object->_getRelationships($pivotTable); |
|
396 | - foreach ($remoteBeans as $remoteBean) { |
|
397 | - $object->_removeRelationship($pivotTable, $remoteBean); |
|
398 | - } |
|
399 | - } |
|
400 | - } |
|
401 | - $this->persistManyToManyRelationships($object); |
|
402 | - } |
|
403 | - |
|
404 | - /** |
|
405 | - * This function removes the given object from the database. It will also remove all objects relied to the one given |
|
406 | - * by parameter before all. |
|
407 | - * |
|
408 | - * Notice: if the object has a multiple primary key, the function will not work. |
|
409 | - * |
|
410 | - * @param AbstractTDBMObject $objToDelete |
|
411 | - */ |
|
412 | - public function deleteCascade(AbstractTDBMObject $objToDelete) |
|
413 | - { |
|
414 | - $this->deleteAllConstraintWithThisObject($objToDelete); |
|
415 | - $this->delete($objToDelete); |
|
416 | - } |
|
417 | - |
|
418 | - /** |
|
419 | - * This function is used only in TDBMService (private function) |
|
420 | - * It will call deleteCascade function foreach object relied with a foreign key to the object given by parameter. |
|
421 | - * |
|
422 | - * @param AbstractTDBMObject $obj |
|
423 | - */ |
|
424 | - private function deleteAllConstraintWithThisObject(AbstractTDBMObject $obj) |
|
425 | - { |
|
426 | - $dbRows = $obj->_getDbRows(); |
|
427 | - foreach ($dbRows as $dbRow) { |
|
428 | - $tableName = $dbRow->_getDbTableName(); |
|
429 | - $pks = array_values($dbRow->_getPrimaryKeys()); |
|
430 | - if (!empty($pks)) { |
|
431 | - $incomingFks = $this->tdbmSchemaAnalyzer->getIncomingForeignKeys($tableName); |
|
432 | - |
|
433 | - foreach ($incomingFks as $incomingFk) { |
|
434 | - $filter = array_combine($incomingFk->getLocalColumns(), $pks); |
|
435 | - |
|
436 | - $results = $this->findObjects($incomingFk->getLocalTableName(), $filter); |
|
437 | - |
|
438 | - foreach ($results as $bean) { |
|
439 | - $this->deleteCascade($bean); |
|
440 | - } |
|
441 | - } |
|
442 | - } |
|
443 | - } |
|
444 | - } |
|
445 | - |
|
446 | - /** |
|
447 | - * This function performs a save() of all the objects that have been modified. |
|
448 | - */ |
|
449 | - public function completeSave() |
|
450 | - { |
|
451 | - foreach ($this->toSaveObjects as $dbRow) { |
|
452 | - $this->save($dbRow->getTDBMObject()); |
|
453 | - } |
|
454 | - } |
|
455 | - |
|
456 | - /** |
|
457 | - * Takes in input a filter_bag (which can be about anything from a string to an array of TDBMObjects... see above from documentation), |
|
458 | - * and gives back a proper Filter object. |
|
459 | - * |
|
460 | - * @param mixed $filter_bag |
|
461 | - * @param int $counter |
|
462 | - * |
|
463 | - * @return array First item: filter string, second item: parameters. |
|
464 | - * |
|
465 | - * @throws TDBMException |
|
466 | - */ |
|
467 | - public function buildFilterFromFilterBag($filter_bag, $counter = 1) |
|
468 | - { |
|
469 | - if ($filter_bag === null) { |
|
470 | - return ['', []]; |
|
471 | - } elseif (is_string($filter_bag)) { |
|
472 | - return [$filter_bag, []]; |
|
473 | - } elseif (is_array($filter_bag)) { |
|
474 | - $sqlParts = []; |
|
475 | - $parameters = []; |
|
476 | - foreach ($filter_bag as $column => $value) { |
|
477 | - if (is_int($column)) { |
|
478 | - list($subSqlPart, $subParameters) = $this->buildFilterFromFilterBag($value, $counter); |
|
479 | - $sqlParts[] = $subSqlPart; |
|
480 | - $parameters += $subParameters; |
|
481 | - } else { |
|
482 | - $paramName = 'tdbmparam'.$counter; |
|
483 | - if (is_array($value)) { |
|
484 | - $sqlParts[] = $this->connection->quoteIdentifier($column).' IN :'.$paramName; |
|
485 | - } else { |
|
486 | - $sqlParts[] = $this->connection->quoteIdentifier($column).' = :'.$paramName; |
|
487 | - } |
|
488 | - $parameters[$paramName] = $value; |
|
489 | - ++$counter; |
|
490 | - } |
|
491 | - } |
|
492 | - |
|
493 | - return [implode(' AND ', $sqlParts), $parameters]; |
|
494 | - } elseif ($filter_bag instanceof AbstractTDBMObject) { |
|
495 | - $sqlParts = []; |
|
496 | - $parameters = []; |
|
497 | - $dbRows = $filter_bag->_getDbRows(); |
|
498 | - $dbRow = reset($dbRows); |
|
499 | - $primaryKeys = $dbRow->_getPrimaryKeys(); |
|
500 | - |
|
501 | - foreach ($primaryKeys as $column => $value) { |
|
502 | - $paramName = 'tdbmparam'.$counter; |
|
503 | - $sqlParts[] = $this->connection->quoteIdentifier($dbRow->_getDbTableName()).'.'.$this->connection->quoteIdentifier($column).' = :'.$paramName; |
|
504 | - $parameters[$paramName] = $value; |
|
505 | - ++$counter; |
|
506 | - } |
|
507 | - |
|
508 | - return [implode(' AND ', $sqlParts), $parameters]; |
|
509 | - } elseif ($filter_bag instanceof \Iterator) { |
|
510 | - return $this->buildFilterFromFilterBag(iterator_to_array($filter_bag), $counter); |
|
511 | - } else { |
|
512 | - throw new TDBMException('Error in filter. An object has been passed that is neither a SQL string, nor an array, nor a bean, nor null.'); |
|
513 | - } |
|
514 | - } |
|
515 | - |
|
516 | - /** |
|
517 | - * @param string $table |
|
518 | - * |
|
519 | - * @return string[] |
|
520 | - */ |
|
521 | - public function getPrimaryKeyColumns($table) |
|
522 | - { |
|
523 | - if (!isset($this->primaryKeysColumns[$table])) { |
|
524 | - $this->primaryKeysColumns[$table] = $this->tdbmSchemaAnalyzer->getSchema()->getTable($table)->getPrimaryKeyColumns(); |
|
525 | - |
|
526 | - // TODO TDBM4: See if we need to improve error reporting if table name does not exist. |
|
527 | - |
|
528 | - /*$arr = array(); |
|
336 | + /** |
|
337 | + * Removes the given object from database. |
|
338 | + * This cannot be called on an object that is not attached to this TDBMService |
|
339 | + * (will throw a TDBMInvalidOperationException). |
|
340 | + * |
|
341 | + * @param AbstractTDBMObject $object the object to delete. |
|
342 | + * |
|
343 | + * @throws TDBMException |
|
344 | + * @throws TDBMInvalidOperationException |
|
345 | + */ |
|
346 | + public function delete(AbstractTDBMObject $object) |
|
347 | + { |
|
348 | + switch ($object->_getStatus()) { |
|
349 | + case TDBMObjectStateEnum::STATE_DELETED: |
|
350 | + // Nothing to do, object already deleted. |
|
351 | + return; |
|
352 | + case TDBMObjectStateEnum::STATE_DETACHED: |
|
353 | + throw new TDBMInvalidOperationException('Cannot delete a detached object'); |
|
354 | + case TDBMObjectStateEnum::STATE_NEW: |
|
355 | + $this->deleteManyToManyRelationships($object); |
|
356 | + foreach ($object->_getDbRows() as $dbRow) { |
|
357 | + $this->removeFromToSaveObjectList($dbRow); |
|
358 | + } |
|
359 | + break; |
|
360 | + case TDBMObjectStateEnum::STATE_DIRTY: |
|
361 | + foreach ($object->_getDbRows() as $dbRow) { |
|
362 | + $this->removeFromToSaveObjectList($dbRow); |
|
363 | + } |
|
364 | + // And continue deleting... |
|
365 | + case TDBMObjectStateEnum::STATE_NOT_LOADED: |
|
366 | + case TDBMObjectStateEnum::STATE_LOADED: |
|
367 | + $this->deleteManyToManyRelationships($object); |
|
368 | + // Let's delete db rows, in reverse order. |
|
369 | + foreach (array_reverse($object->_getDbRows()) as $dbRow) { |
|
370 | + $tableName = $dbRow->_getDbTableName(); |
|
371 | + $primaryKeys = $dbRow->_getPrimaryKeys(); |
|
372 | + $this->connection->delete($tableName, $primaryKeys); |
|
373 | + $this->objectStorage->remove($dbRow->_getDbTableName(), $this->getObjectHash($primaryKeys)); |
|
374 | + } |
|
375 | + break; |
|
376 | + // @codeCoverageIgnoreStart |
|
377 | + default: |
|
378 | + throw new TDBMInvalidOperationException('Unexpected status for bean'); |
|
379 | + // @codeCoverageIgnoreEnd |
|
380 | + } |
|
381 | + |
|
382 | + $object->_setStatus(TDBMObjectStateEnum::STATE_DELETED); |
|
383 | + } |
|
384 | + |
|
385 | + /** |
|
386 | + * Removes all many to many relationships for this object. |
|
387 | + * |
|
388 | + * @param AbstractTDBMObject $object |
|
389 | + */ |
|
390 | + private function deleteManyToManyRelationships(AbstractTDBMObject $object) |
|
391 | + { |
|
392 | + foreach ($object->_getDbRows() as $tableName => $dbRow) { |
|
393 | + $pivotTables = $this->tdbmSchemaAnalyzer->getPivotTableLinkedToTable($tableName); |
|
394 | + foreach ($pivotTables as $pivotTable) { |
|
395 | + $remoteBeans = $object->_getRelationships($pivotTable); |
|
396 | + foreach ($remoteBeans as $remoteBean) { |
|
397 | + $object->_removeRelationship($pivotTable, $remoteBean); |
|
398 | + } |
|
399 | + } |
|
400 | + } |
|
401 | + $this->persistManyToManyRelationships($object); |
|
402 | + } |
|
403 | + |
|
404 | + /** |
|
405 | + * This function removes the given object from the database. It will also remove all objects relied to the one given |
|
406 | + * by parameter before all. |
|
407 | + * |
|
408 | + * Notice: if the object has a multiple primary key, the function will not work. |
|
409 | + * |
|
410 | + * @param AbstractTDBMObject $objToDelete |
|
411 | + */ |
|
412 | + public function deleteCascade(AbstractTDBMObject $objToDelete) |
|
413 | + { |
|
414 | + $this->deleteAllConstraintWithThisObject($objToDelete); |
|
415 | + $this->delete($objToDelete); |
|
416 | + } |
|
417 | + |
|
418 | + /** |
|
419 | + * This function is used only in TDBMService (private function) |
|
420 | + * It will call deleteCascade function foreach object relied with a foreign key to the object given by parameter. |
|
421 | + * |
|
422 | + * @param AbstractTDBMObject $obj |
|
423 | + */ |
|
424 | + private function deleteAllConstraintWithThisObject(AbstractTDBMObject $obj) |
|
425 | + { |
|
426 | + $dbRows = $obj->_getDbRows(); |
|
427 | + foreach ($dbRows as $dbRow) { |
|
428 | + $tableName = $dbRow->_getDbTableName(); |
|
429 | + $pks = array_values($dbRow->_getPrimaryKeys()); |
|
430 | + if (!empty($pks)) { |
|
431 | + $incomingFks = $this->tdbmSchemaAnalyzer->getIncomingForeignKeys($tableName); |
|
432 | + |
|
433 | + foreach ($incomingFks as $incomingFk) { |
|
434 | + $filter = array_combine($incomingFk->getLocalColumns(), $pks); |
|
435 | + |
|
436 | + $results = $this->findObjects($incomingFk->getLocalTableName(), $filter); |
|
437 | + |
|
438 | + foreach ($results as $bean) { |
|
439 | + $this->deleteCascade($bean); |
|
440 | + } |
|
441 | + } |
|
442 | + } |
|
443 | + } |
|
444 | + } |
|
445 | + |
|
446 | + /** |
|
447 | + * This function performs a save() of all the objects that have been modified. |
|
448 | + */ |
|
449 | + public function completeSave() |
|
450 | + { |
|
451 | + foreach ($this->toSaveObjects as $dbRow) { |
|
452 | + $this->save($dbRow->getTDBMObject()); |
|
453 | + } |
|
454 | + } |
|
455 | + |
|
456 | + /** |
|
457 | + * Takes in input a filter_bag (which can be about anything from a string to an array of TDBMObjects... see above from documentation), |
|
458 | + * and gives back a proper Filter object. |
|
459 | + * |
|
460 | + * @param mixed $filter_bag |
|
461 | + * @param int $counter |
|
462 | + * |
|
463 | + * @return array First item: filter string, second item: parameters. |
|
464 | + * |
|
465 | + * @throws TDBMException |
|
466 | + */ |
|
467 | + public function buildFilterFromFilterBag($filter_bag, $counter = 1) |
|
468 | + { |
|
469 | + if ($filter_bag === null) { |
|
470 | + return ['', []]; |
|
471 | + } elseif (is_string($filter_bag)) { |
|
472 | + return [$filter_bag, []]; |
|
473 | + } elseif (is_array($filter_bag)) { |
|
474 | + $sqlParts = []; |
|
475 | + $parameters = []; |
|
476 | + foreach ($filter_bag as $column => $value) { |
|
477 | + if (is_int($column)) { |
|
478 | + list($subSqlPart, $subParameters) = $this->buildFilterFromFilterBag($value, $counter); |
|
479 | + $sqlParts[] = $subSqlPart; |
|
480 | + $parameters += $subParameters; |
|
481 | + } else { |
|
482 | + $paramName = 'tdbmparam'.$counter; |
|
483 | + if (is_array($value)) { |
|
484 | + $sqlParts[] = $this->connection->quoteIdentifier($column).' IN :'.$paramName; |
|
485 | + } else { |
|
486 | + $sqlParts[] = $this->connection->quoteIdentifier($column).' = :'.$paramName; |
|
487 | + } |
|
488 | + $parameters[$paramName] = $value; |
|
489 | + ++$counter; |
|
490 | + } |
|
491 | + } |
|
492 | + |
|
493 | + return [implode(' AND ', $sqlParts), $parameters]; |
|
494 | + } elseif ($filter_bag instanceof AbstractTDBMObject) { |
|
495 | + $sqlParts = []; |
|
496 | + $parameters = []; |
|
497 | + $dbRows = $filter_bag->_getDbRows(); |
|
498 | + $dbRow = reset($dbRows); |
|
499 | + $primaryKeys = $dbRow->_getPrimaryKeys(); |
|
500 | + |
|
501 | + foreach ($primaryKeys as $column => $value) { |
|
502 | + $paramName = 'tdbmparam'.$counter; |
|
503 | + $sqlParts[] = $this->connection->quoteIdentifier($dbRow->_getDbTableName()).'.'.$this->connection->quoteIdentifier($column).' = :'.$paramName; |
|
504 | + $parameters[$paramName] = $value; |
|
505 | + ++$counter; |
|
506 | + } |
|
507 | + |
|
508 | + return [implode(' AND ', $sqlParts), $parameters]; |
|
509 | + } elseif ($filter_bag instanceof \Iterator) { |
|
510 | + return $this->buildFilterFromFilterBag(iterator_to_array($filter_bag), $counter); |
|
511 | + } else { |
|
512 | + throw new TDBMException('Error in filter. An object has been passed that is neither a SQL string, nor an array, nor a bean, nor null.'); |
|
513 | + } |
|
514 | + } |
|
515 | + |
|
516 | + /** |
|
517 | + * @param string $table |
|
518 | + * |
|
519 | + * @return string[] |
|
520 | + */ |
|
521 | + public function getPrimaryKeyColumns($table) |
|
522 | + { |
|
523 | + if (!isset($this->primaryKeysColumns[$table])) { |
|
524 | + $this->primaryKeysColumns[$table] = $this->tdbmSchemaAnalyzer->getSchema()->getTable($table)->getPrimaryKeyColumns(); |
|
525 | + |
|
526 | + // TODO TDBM4: See if we need to improve error reporting if table name does not exist. |
|
527 | + |
|
528 | + /*$arr = array(); |
|
529 | 529 | foreach ($this->connection->getPrimaryKey($table) as $col) { |
530 | 530 | $arr[] = $col->name; |
531 | 531 | } |
@@ -546,141 +546,141 @@ discard block |
||
546 | 546 | throw new TDBMException($str); |
547 | 547 | } |
548 | 548 | }*/ |
549 | - } |
|
550 | - |
|
551 | - return $this->primaryKeysColumns[$table]; |
|
552 | - } |
|
553 | - |
|
554 | - /** |
|
555 | - * This is an internal function, you should not use it in your application. |
|
556 | - * This is used internally by TDBM to add an object to the object cache. |
|
557 | - * |
|
558 | - * @param DbRow $dbRow |
|
559 | - */ |
|
560 | - public function _addToCache(DbRow $dbRow) |
|
561 | - { |
|
562 | - $primaryKey = $this->getPrimaryKeysForObjectFromDbRow($dbRow); |
|
563 | - $hash = $this->getObjectHash($primaryKey); |
|
564 | - $this->objectStorage->set($dbRow->_getDbTableName(), $hash, $dbRow); |
|
565 | - } |
|
566 | - |
|
567 | - /** |
|
568 | - * This is an internal function, you should not use it in your application. |
|
569 | - * This is used internally by TDBM to remove the object from the list of objects that have been |
|
570 | - * created/updated but not saved yet. |
|
571 | - * |
|
572 | - * @param DbRow $myObject |
|
573 | - */ |
|
574 | - private function removeFromToSaveObjectList(DbRow $myObject) |
|
575 | - { |
|
576 | - unset($this->toSaveObjects[$myObject]); |
|
577 | - } |
|
578 | - |
|
579 | - /** |
|
580 | - * This is an internal function, you should not use it in your application. |
|
581 | - * This is used internally by TDBM to add an object to the list of objects that have been |
|
582 | - * created/updated but not saved yet. |
|
583 | - * |
|
584 | - * @param AbstractTDBMObject $myObject |
|
585 | - */ |
|
586 | - public function _addToToSaveObjectList(DbRow $myObject) |
|
587 | - { |
|
588 | - $this->toSaveObjects[$myObject] = true; |
|
589 | - } |
|
590 | - |
|
591 | - /** |
|
592 | - * Generates all the daos and beans. |
|
593 | - * |
|
594 | - * @param string $daoFactoryClassName The classe name of the DAO factory |
|
595 | - * @param string $daonamespace The namespace for the DAOs, without trailing \ |
|
596 | - * @param string $beannamespace The Namespace for the beans, without trailing \ |
|
597 | - * @param bool $storeInUtc If the generated daos should store the date in UTC timezone instead of user's timezone. |
|
598 | - * @param string $composerFile If it's set, location of custom Composer file. Relative to project root. |
|
599 | - * |
|
600 | - * @return \string[] the list of tables |
|
601 | - */ |
|
602 | - public function generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc, $composerFile = null) |
|
603 | - { |
|
604 | - // Purge cache before generating anything. |
|
605 | - $this->cache->deleteAll(); |
|
606 | - |
|
607 | - $tdbmDaoGenerator = new TDBMDaoGenerator($this->schemaAnalyzer, $this->tdbmSchemaAnalyzer->getSchema(), $this->tdbmSchemaAnalyzer); |
|
608 | - if (null !== $composerFile) { |
|
609 | - $tdbmDaoGenerator->setComposerFile(__DIR__.'/../../../../../../../'.$composerFile); |
|
610 | - } |
|
611 | - |
|
612 | - return $tdbmDaoGenerator->generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc); |
|
613 | - } |
|
614 | - |
|
615 | - /** |
|
616 | - * @param array<string, string> $tableToBeanMap |
|
617 | - */ |
|
618 | - public function setTableToBeanMap(array $tableToBeanMap) |
|
619 | - { |
|
620 | - $this->tableToBeanMap = $tableToBeanMap; |
|
621 | - } |
|
622 | - |
|
623 | - /** |
|
624 | - * Saves $object by INSERTing or UPDAT(E)ing it in the database. |
|
625 | - * |
|
626 | - * @param AbstractTDBMObject $object |
|
627 | - * |
|
628 | - * @throws TDBMException |
|
629 | - */ |
|
630 | - public function save(AbstractTDBMObject $object) |
|
631 | - { |
|
632 | - $status = $object->_getStatus(); |
|
633 | - |
|
634 | - if ($status === null) { |
|
635 | - throw new TDBMException(sprintf('Your bean for class %s has no status. It is likely that you overloaded the __construct method and forgot to call parent::__construct.', get_class($object))); |
|
636 | - } |
|
637 | - |
|
638 | - // Let's attach this object if it is in detached state. |
|
639 | - if ($status === TDBMObjectStateEnum::STATE_DETACHED) { |
|
640 | - $object->_attach($this); |
|
641 | - $status = $object->_getStatus(); |
|
642 | - } |
|
643 | - |
|
644 | - if ($status === TDBMObjectStateEnum::STATE_NEW) { |
|
645 | - $dbRows = $object->_getDbRows(); |
|
646 | - |
|
647 | - $unindexedPrimaryKeys = array(); |
|
648 | - |
|
649 | - foreach ($dbRows as $dbRow) { |
|
650 | - $tableName = $dbRow->_getDbTableName(); |
|
651 | - |
|
652 | - $schema = $this->tdbmSchemaAnalyzer->getSchema(); |
|
653 | - $tableDescriptor = $schema->getTable($tableName); |
|
654 | - |
|
655 | - $primaryKeyColumns = $this->getPrimaryKeyColumns($tableName); |
|
656 | - |
|
657 | - if (empty($unindexedPrimaryKeys)) { |
|
658 | - $primaryKeys = $this->getPrimaryKeysForObjectFromDbRow($dbRow); |
|
659 | - } else { |
|
660 | - // First insert, the children must have the same primary key as the parent. |
|
661 | - $primaryKeys = $this->_getPrimaryKeysFromIndexedPrimaryKeys($tableName, $unindexedPrimaryKeys); |
|
662 | - $dbRow->_setPrimaryKeys($primaryKeys); |
|
663 | - } |
|
664 | - |
|
665 | - $references = $dbRow->_getReferences(); |
|
666 | - |
|
667 | - // Let's save all references in NEW or DETACHED state (we need their primary key) |
|
668 | - foreach ($references as $fkName => $reference) { |
|
669 | - if ($reference !== null) { |
|
670 | - $refStatus = $reference->_getStatus(); |
|
671 | - if ($refStatus === TDBMObjectStateEnum::STATE_NEW || $refStatus === TDBMObjectStateEnum::STATE_DETACHED) { |
|
672 | - $this->save($reference); |
|
673 | - } |
|
674 | - } |
|
675 | - } |
|
676 | - |
|
677 | - $dbRowData = $dbRow->_getDbRow(); |
|
678 | - |
|
679 | - // Let's see if the columns for primary key have been set before inserting. |
|
680 | - // We assume that if one of the value of the PK has been set, the PK is set. |
|
681 | - $isPkSet = !empty($primaryKeys); |
|
682 | - |
|
683 | - /*if (!$isPkSet) { |
|
549 | + } |
|
550 | + |
|
551 | + return $this->primaryKeysColumns[$table]; |
|
552 | + } |
|
553 | + |
|
554 | + /** |
|
555 | + * This is an internal function, you should not use it in your application. |
|
556 | + * This is used internally by TDBM to add an object to the object cache. |
|
557 | + * |
|
558 | + * @param DbRow $dbRow |
|
559 | + */ |
|
560 | + public function _addToCache(DbRow $dbRow) |
|
561 | + { |
|
562 | + $primaryKey = $this->getPrimaryKeysForObjectFromDbRow($dbRow); |
|
563 | + $hash = $this->getObjectHash($primaryKey); |
|
564 | + $this->objectStorage->set($dbRow->_getDbTableName(), $hash, $dbRow); |
|
565 | + } |
|
566 | + |
|
567 | + /** |
|
568 | + * This is an internal function, you should not use it in your application. |
|
569 | + * This is used internally by TDBM to remove the object from the list of objects that have been |
|
570 | + * created/updated but not saved yet. |
|
571 | + * |
|
572 | + * @param DbRow $myObject |
|
573 | + */ |
|
574 | + private function removeFromToSaveObjectList(DbRow $myObject) |
|
575 | + { |
|
576 | + unset($this->toSaveObjects[$myObject]); |
|
577 | + } |
|
578 | + |
|
579 | + /** |
|
580 | + * This is an internal function, you should not use it in your application. |
|
581 | + * This is used internally by TDBM to add an object to the list of objects that have been |
|
582 | + * created/updated but not saved yet. |
|
583 | + * |
|
584 | + * @param AbstractTDBMObject $myObject |
|
585 | + */ |
|
586 | + public function _addToToSaveObjectList(DbRow $myObject) |
|
587 | + { |
|
588 | + $this->toSaveObjects[$myObject] = true; |
|
589 | + } |
|
590 | + |
|
591 | + /** |
|
592 | + * Generates all the daos and beans. |
|
593 | + * |
|
594 | + * @param string $daoFactoryClassName The classe name of the DAO factory |
|
595 | + * @param string $daonamespace The namespace for the DAOs, without trailing \ |
|
596 | + * @param string $beannamespace The Namespace for the beans, without trailing \ |
|
597 | + * @param bool $storeInUtc If the generated daos should store the date in UTC timezone instead of user's timezone. |
|
598 | + * @param string $composerFile If it's set, location of custom Composer file. Relative to project root. |
|
599 | + * |
|
600 | + * @return \string[] the list of tables |
|
601 | + */ |
|
602 | + public function generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc, $composerFile = null) |
|
603 | + { |
|
604 | + // Purge cache before generating anything. |
|
605 | + $this->cache->deleteAll(); |
|
606 | + |
|
607 | + $tdbmDaoGenerator = new TDBMDaoGenerator($this->schemaAnalyzer, $this->tdbmSchemaAnalyzer->getSchema(), $this->tdbmSchemaAnalyzer); |
|
608 | + if (null !== $composerFile) { |
|
609 | + $tdbmDaoGenerator->setComposerFile(__DIR__.'/../../../../../../../'.$composerFile); |
|
610 | + } |
|
611 | + |
|
612 | + return $tdbmDaoGenerator->generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc); |
|
613 | + } |
|
614 | + |
|
615 | + /** |
|
616 | + * @param array<string, string> $tableToBeanMap |
|
617 | + */ |
|
618 | + public function setTableToBeanMap(array $tableToBeanMap) |
|
619 | + { |
|
620 | + $this->tableToBeanMap = $tableToBeanMap; |
|
621 | + } |
|
622 | + |
|
623 | + /** |
|
624 | + * Saves $object by INSERTing or UPDAT(E)ing it in the database. |
|
625 | + * |
|
626 | + * @param AbstractTDBMObject $object |
|
627 | + * |
|
628 | + * @throws TDBMException |
|
629 | + */ |
|
630 | + public function save(AbstractTDBMObject $object) |
|
631 | + { |
|
632 | + $status = $object->_getStatus(); |
|
633 | + |
|
634 | + if ($status === null) { |
|
635 | + throw new TDBMException(sprintf('Your bean for class %s has no status. It is likely that you overloaded the __construct method and forgot to call parent::__construct.', get_class($object))); |
|
636 | + } |
|
637 | + |
|
638 | + // Let's attach this object if it is in detached state. |
|
639 | + if ($status === TDBMObjectStateEnum::STATE_DETACHED) { |
|
640 | + $object->_attach($this); |
|
641 | + $status = $object->_getStatus(); |
|
642 | + } |
|
643 | + |
|
644 | + if ($status === TDBMObjectStateEnum::STATE_NEW) { |
|
645 | + $dbRows = $object->_getDbRows(); |
|
646 | + |
|
647 | + $unindexedPrimaryKeys = array(); |
|
648 | + |
|
649 | + foreach ($dbRows as $dbRow) { |
|
650 | + $tableName = $dbRow->_getDbTableName(); |
|
651 | + |
|
652 | + $schema = $this->tdbmSchemaAnalyzer->getSchema(); |
|
653 | + $tableDescriptor = $schema->getTable($tableName); |
|
654 | + |
|
655 | + $primaryKeyColumns = $this->getPrimaryKeyColumns($tableName); |
|
656 | + |
|
657 | + if (empty($unindexedPrimaryKeys)) { |
|
658 | + $primaryKeys = $this->getPrimaryKeysForObjectFromDbRow($dbRow); |
|
659 | + } else { |
|
660 | + // First insert, the children must have the same primary key as the parent. |
|
661 | + $primaryKeys = $this->_getPrimaryKeysFromIndexedPrimaryKeys($tableName, $unindexedPrimaryKeys); |
|
662 | + $dbRow->_setPrimaryKeys($primaryKeys); |
|
663 | + } |
|
664 | + |
|
665 | + $references = $dbRow->_getReferences(); |
|
666 | + |
|
667 | + // Let's save all references in NEW or DETACHED state (we need their primary key) |
|
668 | + foreach ($references as $fkName => $reference) { |
|
669 | + if ($reference !== null) { |
|
670 | + $refStatus = $reference->_getStatus(); |
|
671 | + if ($refStatus === TDBMObjectStateEnum::STATE_NEW || $refStatus === TDBMObjectStateEnum::STATE_DETACHED) { |
|
672 | + $this->save($reference); |
|
673 | + } |
|
674 | + } |
|
675 | + } |
|
676 | + |
|
677 | + $dbRowData = $dbRow->_getDbRow(); |
|
678 | + |
|
679 | + // Let's see if the columns for primary key have been set before inserting. |
|
680 | + // We assume that if one of the value of the PK has been set, the PK is set. |
|
681 | + $isPkSet = !empty($primaryKeys); |
|
682 | + |
|
683 | + /*if (!$isPkSet) { |
|
684 | 684 | // if there is no autoincrement and no pk set, let's go in error. |
685 | 685 | $isAutoIncrement = true; |
686 | 686 | |
@@ -698,25 +698,25 @@ discard block |
||
698 | 698 | |
699 | 699 | }*/ |
700 | 700 | |
701 | - $types = []; |
|
701 | + $types = []; |
|
702 | 702 | |
703 | - foreach ($dbRowData as $columnName => $value) { |
|
704 | - $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
705 | - $types[] = $columnDescriptor->getType(); |
|
706 | - } |
|
703 | + foreach ($dbRowData as $columnName => $value) { |
|
704 | + $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
705 | + $types[] = $columnDescriptor->getType(); |
|
706 | + } |
|
707 | 707 | |
708 | - $this->connection->insert($tableName, $dbRowData, $types); |
|
708 | + $this->connection->insert($tableName, $dbRowData, $types); |
|
709 | 709 | |
710 | - if (!$isPkSet && count($primaryKeyColumns) == 1) { |
|
711 | - $id = $this->connection->lastInsertId(); |
|
712 | - $primaryKeys[$primaryKeyColumns[0]] = $id; |
|
713 | - } |
|
710 | + if (!$isPkSet && count($primaryKeyColumns) == 1) { |
|
711 | + $id = $this->connection->lastInsertId(); |
|
712 | + $primaryKeys[$primaryKeyColumns[0]] = $id; |
|
713 | + } |
|
714 | 714 | |
715 | - // TODO: change this to some private magic accessor in future |
|
716 | - $dbRow->_setPrimaryKeys($primaryKeys); |
|
717 | - $unindexedPrimaryKeys = array_values($primaryKeys); |
|
715 | + // TODO: change this to some private magic accessor in future |
|
716 | + $dbRow->_setPrimaryKeys($primaryKeys); |
|
717 | + $unindexedPrimaryKeys = array_values($primaryKeys); |
|
718 | 718 | |
719 | - /* |
|
719 | + /* |
|
720 | 720 | * When attached, on "save", we check if the column updated is part of a primary key |
721 | 721 | * If this is part of a primary key, we call the _update_id method that updates the id in the list of known objects. |
722 | 722 | * This method should first verify that the id is not already used (and is not auto-incremented) |
@@ -726,7 +726,7 @@ discard block |
||
726 | 726 | * |
727 | 727 | */ |
728 | 728 | |
729 | - /*try { |
|
729 | + /*try { |
|
730 | 730 | $this->db_connection->exec($sql); |
731 | 731 | } catch (TDBMException $e) { |
732 | 732 | $this->db_onerror = true; |
@@ -745,390 +745,390 @@ discard block |
||
745 | 745 | } |
746 | 746 | }*/ |
747 | 747 | |
748 | - // Let's remove this object from the $new_objects static table. |
|
749 | - $this->removeFromToSaveObjectList($dbRow); |
|
750 | - |
|
751 | - // TODO: change this behaviour to something more sensible performance-wise |
|
752 | - // Maybe a setting to trigger this globally? |
|
753 | - //$this->status = TDBMObjectStateEnum::STATE_NOT_LOADED; |
|
754 | - //$this->db_modified_state = false; |
|
755 | - //$dbRow = array(); |
|
756 | - |
|
757 | - // Let's add this object to the list of objects in cache. |
|
758 | - $this->_addToCache($dbRow); |
|
759 | - } |
|
760 | - |
|
761 | - $object->_setStatus(TDBMObjectStateEnum::STATE_LOADED); |
|
762 | - } elseif ($status === TDBMObjectStateEnum::STATE_DIRTY) { |
|
763 | - $dbRows = $object->_getDbRows(); |
|
764 | - |
|
765 | - foreach ($dbRows as $dbRow) { |
|
766 | - $references = $dbRow->_getReferences(); |
|
767 | - |
|
768 | - // Let's save all references in NEW state (we need their primary key) |
|
769 | - foreach ($references as $fkName => $reference) { |
|
770 | - if ($reference !== null && $reference->_getStatus() === TDBMObjectStateEnum::STATE_NEW) { |
|
771 | - $this->save($reference); |
|
772 | - } |
|
773 | - } |
|
774 | - |
|
775 | - // Let's first get the primary keys |
|
776 | - $tableName = $dbRow->_getDbTableName(); |
|
777 | - $dbRowData = $dbRow->_getDbRow(); |
|
778 | - |
|
779 | - $schema = $this->tdbmSchemaAnalyzer->getSchema(); |
|
780 | - $tableDescriptor = $schema->getTable($tableName); |
|
781 | - |
|
782 | - $primaryKeys = $dbRow->_getPrimaryKeys(); |
|
783 | - |
|
784 | - $types = []; |
|
785 | - |
|
786 | - foreach ($dbRowData as $columnName => $value) { |
|
787 | - $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
788 | - $types[] = $columnDescriptor->getType(); |
|
789 | - } |
|
790 | - foreach ($primaryKeys as $columnName => $value) { |
|
791 | - $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
792 | - $types[] = $columnDescriptor->getType(); |
|
793 | - } |
|
794 | - |
|
795 | - $this->connection->update($tableName, $dbRowData, $primaryKeys, $types); |
|
796 | - |
|
797 | - // Let's check if the primary key has been updated... |
|
798 | - $needsUpdatePk = false; |
|
799 | - foreach ($primaryKeys as $column => $value) { |
|
800 | - if (!isset($dbRowData[$column]) || $dbRowData[$column] != $value) { |
|
801 | - $needsUpdatePk = true; |
|
802 | - break; |
|
803 | - } |
|
804 | - } |
|
805 | - if ($needsUpdatePk) { |
|
806 | - $this->objectStorage->remove($tableName, $this->getObjectHash($primaryKeys)); |
|
807 | - $newPrimaryKeys = $this->getPrimaryKeysForObjectFromDbRow($dbRow); |
|
808 | - $dbRow->_setPrimaryKeys($newPrimaryKeys); |
|
809 | - $this->objectStorage->set($tableName, $this->getObjectHash($primaryKeys), $dbRow); |
|
810 | - } |
|
811 | - |
|
812 | - // Let's remove this object from the list of objects to save. |
|
813 | - $this->removeFromToSaveObjectList($dbRow); |
|
814 | - } |
|
815 | - |
|
816 | - $object->_setStatus(TDBMObjectStateEnum::STATE_LOADED); |
|
817 | - } elseif ($status === TDBMObjectStateEnum::STATE_DELETED) { |
|
818 | - throw new TDBMInvalidOperationException('This object has been deleted. It cannot be saved.'); |
|
819 | - } |
|
820 | - |
|
821 | - // Finally, let's save all the many to many relationships to this bean. |
|
822 | - $this->persistManyToManyRelationships($object); |
|
823 | - } |
|
824 | - |
|
825 | - private function persistManyToManyRelationships(AbstractTDBMObject $object) |
|
826 | - { |
|
827 | - foreach ($object->_getCachedRelationships() as $pivotTableName => $storage) { |
|
828 | - $tableDescriptor = $this->tdbmSchemaAnalyzer->getSchema()->getTable($pivotTableName); |
|
829 | - list($localFk, $remoteFk) = $this->getPivotTableForeignKeys($pivotTableName, $object); |
|
830 | - |
|
831 | - foreach ($storage as $remoteBean) { |
|
832 | - /* @var $remoteBean AbstractTDBMObject */ |
|
833 | - $statusArr = $storage[$remoteBean]; |
|
834 | - $status = $statusArr['status']; |
|
835 | - $reverse = $statusArr['reverse']; |
|
836 | - if ($reverse) { |
|
837 | - continue; |
|
838 | - } |
|
839 | - |
|
840 | - if ($status === 'new') { |
|
841 | - $remoteBeanStatus = $remoteBean->_getStatus(); |
|
842 | - if ($remoteBeanStatus === TDBMObjectStateEnum::STATE_NEW || $remoteBeanStatus === TDBMObjectStateEnum::STATE_DETACHED) { |
|
843 | - // Let's save remote bean if needed. |
|
844 | - $this->save($remoteBean); |
|
845 | - } |
|
846 | - |
|
847 | - $filters = $this->getPivotFilters($object, $remoteBean, $localFk, $remoteFk); |
|
848 | - |
|
849 | - $types = []; |
|
850 | - |
|
851 | - foreach ($filters as $columnName => $value) { |
|
852 | - $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
853 | - $types[] = $columnDescriptor->getType(); |
|
854 | - } |
|
855 | - |
|
856 | - $this->connection->insert($pivotTableName, $filters, $types); |
|
857 | - |
|
858 | - // Finally, let's mark relationships as saved. |
|
859 | - $statusArr['status'] = 'loaded'; |
|
860 | - $storage[$remoteBean] = $statusArr; |
|
861 | - $remoteStorage = $remoteBean->_getCachedRelationships()[$pivotTableName]; |
|
862 | - $remoteStatusArr = $remoteStorage[$object]; |
|
863 | - $remoteStatusArr['status'] = 'loaded'; |
|
864 | - $remoteStorage[$object] = $remoteStatusArr; |
|
865 | - } elseif ($status === 'delete') { |
|
866 | - $filters = $this->getPivotFilters($object, $remoteBean, $localFk, $remoteFk); |
|
867 | - |
|
868 | - $types = []; |
|
869 | - |
|
870 | - foreach ($filters as $columnName => $value) { |
|
871 | - $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
872 | - $types[] = $columnDescriptor->getType(); |
|
873 | - } |
|
874 | - |
|
875 | - $this->connection->delete($pivotTableName, $filters, $types); |
|
876 | - |
|
877 | - // Finally, let's remove relationships completely from bean. |
|
878 | - $storage->detach($remoteBean); |
|
879 | - $remoteBean->_getCachedRelationships()[$pivotTableName]->detach($object); |
|
880 | - } |
|
881 | - } |
|
882 | - } |
|
883 | - } |
|
884 | - |
|
885 | - private function getPivotFilters(AbstractTDBMObject $localBean, AbstractTDBMObject $remoteBean, ForeignKeyConstraint $localFk, ForeignKeyConstraint $remoteFk) |
|
886 | - { |
|
887 | - $localBeanPk = $this->getPrimaryKeyValues($localBean); |
|
888 | - $remoteBeanPk = $this->getPrimaryKeyValues($remoteBean); |
|
889 | - $localColumns = $localFk->getLocalColumns(); |
|
890 | - $remoteColumns = $remoteFk->getLocalColumns(); |
|
891 | - |
|
892 | - $localFilters = array_combine($localColumns, $localBeanPk); |
|
893 | - $remoteFilters = array_combine($remoteColumns, $remoteBeanPk); |
|
894 | - |
|
895 | - return array_merge($localFilters, $remoteFilters); |
|
896 | - } |
|
897 | - |
|
898 | - /** |
|
899 | - * Returns the "values" of the primary key. |
|
900 | - * This returns the primary key from the $primaryKey attribute, not the one stored in the columns. |
|
901 | - * |
|
902 | - * @param AbstractTDBMObject $bean |
|
903 | - * |
|
904 | - * @return array numerically indexed array of values. |
|
905 | - */ |
|
906 | - private function getPrimaryKeyValues(AbstractTDBMObject $bean) |
|
907 | - { |
|
908 | - $dbRows = $bean->_getDbRows(); |
|
909 | - $dbRow = reset($dbRows); |
|
910 | - |
|
911 | - return array_values($dbRow->_getPrimaryKeys()); |
|
912 | - } |
|
913 | - |
|
914 | - /** |
|
915 | - * Returns a unique hash used to store the object based on its primary key. |
|
916 | - * If the array contains only one value, then the value is returned. |
|
917 | - * Otherwise, a hash representing the array is returned. |
|
918 | - * |
|
919 | - * @param array $primaryKeys An array of columns => values forming the primary key |
|
920 | - * |
|
921 | - * @return string |
|
922 | - */ |
|
923 | - public function getObjectHash(array $primaryKeys) |
|
924 | - { |
|
925 | - if (count($primaryKeys) === 1) { |
|
926 | - return reset($primaryKeys); |
|
927 | - } else { |
|
928 | - ksort($primaryKeys); |
|
929 | - |
|
930 | - return md5(json_encode($primaryKeys)); |
|
931 | - } |
|
932 | - } |
|
933 | - |
|
934 | - /** |
|
935 | - * Returns an array of primary keys from the object. |
|
936 | - * The primary keys are extracted from the object columns and not from the primary keys stored in the |
|
937 | - * $primaryKeys variable of the object. |
|
938 | - * |
|
939 | - * @param DbRow $dbRow |
|
940 | - * |
|
941 | - * @return array Returns an array of column => value |
|
942 | - */ |
|
943 | - public function getPrimaryKeysForObjectFromDbRow(DbRow $dbRow) |
|
944 | - { |
|
945 | - $table = $dbRow->_getDbTableName(); |
|
946 | - $dbRowData = $dbRow->_getDbRow(); |
|
947 | - |
|
948 | - return $this->_getPrimaryKeysFromObjectData($table, $dbRowData); |
|
949 | - } |
|
950 | - |
|
951 | - /** |
|
952 | - * Returns an array of primary keys for the given row. |
|
953 | - * The primary keys are extracted from the object columns. |
|
954 | - * |
|
955 | - * @param $table |
|
956 | - * @param array $columns |
|
957 | - * |
|
958 | - * @return array |
|
959 | - */ |
|
960 | - public function _getPrimaryKeysFromObjectData($table, array $columns) |
|
961 | - { |
|
962 | - $primaryKeyColumns = $this->getPrimaryKeyColumns($table); |
|
963 | - $values = array(); |
|
964 | - foreach ($primaryKeyColumns as $column) { |
|
965 | - if (isset($columns[$column])) { |
|
966 | - $values[$column] = $columns[$column]; |
|
967 | - } |
|
968 | - } |
|
969 | - |
|
970 | - return $values; |
|
971 | - } |
|
972 | - |
|
973 | - /** |
|
974 | - * Attaches $object to this TDBMService. |
|
975 | - * The $object must be in DETACHED state and will pass in NEW state. |
|
976 | - * |
|
977 | - * @param AbstractTDBMObject $object |
|
978 | - * |
|
979 | - * @throws TDBMInvalidOperationException |
|
980 | - */ |
|
981 | - public function attach(AbstractTDBMObject $object) |
|
982 | - { |
|
983 | - $object->_attach($this); |
|
984 | - } |
|
985 | - |
|
986 | - /** |
|
987 | - * Returns an associative array (column => value) for the primary keys from the table name and an |
|
988 | - * indexed array of primary key values. |
|
989 | - * |
|
990 | - * @param string $tableName |
|
991 | - * @param array $indexedPrimaryKeys |
|
992 | - */ |
|
993 | - public function _getPrimaryKeysFromIndexedPrimaryKeys($tableName, array $indexedPrimaryKeys) |
|
994 | - { |
|
995 | - $primaryKeyColumns = $this->tdbmSchemaAnalyzer->getSchema()->getTable($tableName)->getPrimaryKeyColumns(); |
|
996 | - |
|
997 | - if (count($primaryKeyColumns) !== count($indexedPrimaryKeys)) { |
|
998 | - throw new TDBMException(sprintf('Wrong number of columns passed for primary key. Expected %s columns for table "%s", |
|
748 | + // Let's remove this object from the $new_objects static table. |
|
749 | + $this->removeFromToSaveObjectList($dbRow); |
|
750 | + |
|
751 | + // TODO: change this behaviour to something more sensible performance-wise |
|
752 | + // Maybe a setting to trigger this globally? |
|
753 | + //$this->status = TDBMObjectStateEnum::STATE_NOT_LOADED; |
|
754 | + //$this->db_modified_state = false; |
|
755 | + //$dbRow = array(); |
|
756 | + |
|
757 | + // Let's add this object to the list of objects in cache. |
|
758 | + $this->_addToCache($dbRow); |
|
759 | + } |
|
760 | + |
|
761 | + $object->_setStatus(TDBMObjectStateEnum::STATE_LOADED); |
|
762 | + } elseif ($status === TDBMObjectStateEnum::STATE_DIRTY) { |
|
763 | + $dbRows = $object->_getDbRows(); |
|
764 | + |
|
765 | + foreach ($dbRows as $dbRow) { |
|
766 | + $references = $dbRow->_getReferences(); |
|
767 | + |
|
768 | + // Let's save all references in NEW state (we need their primary key) |
|
769 | + foreach ($references as $fkName => $reference) { |
|
770 | + if ($reference !== null && $reference->_getStatus() === TDBMObjectStateEnum::STATE_NEW) { |
|
771 | + $this->save($reference); |
|
772 | + } |
|
773 | + } |
|
774 | + |
|
775 | + // Let's first get the primary keys |
|
776 | + $tableName = $dbRow->_getDbTableName(); |
|
777 | + $dbRowData = $dbRow->_getDbRow(); |
|
778 | + |
|
779 | + $schema = $this->tdbmSchemaAnalyzer->getSchema(); |
|
780 | + $tableDescriptor = $schema->getTable($tableName); |
|
781 | + |
|
782 | + $primaryKeys = $dbRow->_getPrimaryKeys(); |
|
783 | + |
|
784 | + $types = []; |
|
785 | + |
|
786 | + foreach ($dbRowData as $columnName => $value) { |
|
787 | + $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
788 | + $types[] = $columnDescriptor->getType(); |
|
789 | + } |
|
790 | + foreach ($primaryKeys as $columnName => $value) { |
|
791 | + $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
792 | + $types[] = $columnDescriptor->getType(); |
|
793 | + } |
|
794 | + |
|
795 | + $this->connection->update($tableName, $dbRowData, $primaryKeys, $types); |
|
796 | + |
|
797 | + // Let's check if the primary key has been updated... |
|
798 | + $needsUpdatePk = false; |
|
799 | + foreach ($primaryKeys as $column => $value) { |
|
800 | + if (!isset($dbRowData[$column]) || $dbRowData[$column] != $value) { |
|
801 | + $needsUpdatePk = true; |
|
802 | + break; |
|
803 | + } |
|
804 | + } |
|
805 | + if ($needsUpdatePk) { |
|
806 | + $this->objectStorage->remove($tableName, $this->getObjectHash($primaryKeys)); |
|
807 | + $newPrimaryKeys = $this->getPrimaryKeysForObjectFromDbRow($dbRow); |
|
808 | + $dbRow->_setPrimaryKeys($newPrimaryKeys); |
|
809 | + $this->objectStorage->set($tableName, $this->getObjectHash($primaryKeys), $dbRow); |
|
810 | + } |
|
811 | + |
|
812 | + // Let's remove this object from the list of objects to save. |
|
813 | + $this->removeFromToSaveObjectList($dbRow); |
|
814 | + } |
|
815 | + |
|
816 | + $object->_setStatus(TDBMObjectStateEnum::STATE_LOADED); |
|
817 | + } elseif ($status === TDBMObjectStateEnum::STATE_DELETED) { |
|
818 | + throw new TDBMInvalidOperationException('This object has been deleted. It cannot be saved.'); |
|
819 | + } |
|
820 | + |
|
821 | + // Finally, let's save all the many to many relationships to this bean. |
|
822 | + $this->persistManyToManyRelationships($object); |
|
823 | + } |
|
824 | + |
|
825 | + private function persistManyToManyRelationships(AbstractTDBMObject $object) |
|
826 | + { |
|
827 | + foreach ($object->_getCachedRelationships() as $pivotTableName => $storage) { |
|
828 | + $tableDescriptor = $this->tdbmSchemaAnalyzer->getSchema()->getTable($pivotTableName); |
|
829 | + list($localFk, $remoteFk) = $this->getPivotTableForeignKeys($pivotTableName, $object); |
|
830 | + |
|
831 | + foreach ($storage as $remoteBean) { |
|
832 | + /* @var $remoteBean AbstractTDBMObject */ |
|
833 | + $statusArr = $storage[$remoteBean]; |
|
834 | + $status = $statusArr['status']; |
|
835 | + $reverse = $statusArr['reverse']; |
|
836 | + if ($reverse) { |
|
837 | + continue; |
|
838 | + } |
|
839 | + |
|
840 | + if ($status === 'new') { |
|
841 | + $remoteBeanStatus = $remoteBean->_getStatus(); |
|
842 | + if ($remoteBeanStatus === TDBMObjectStateEnum::STATE_NEW || $remoteBeanStatus === TDBMObjectStateEnum::STATE_DETACHED) { |
|
843 | + // Let's save remote bean if needed. |
|
844 | + $this->save($remoteBean); |
|
845 | + } |
|
846 | + |
|
847 | + $filters = $this->getPivotFilters($object, $remoteBean, $localFk, $remoteFk); |
|
848 | + |
|
849 | + $types = []; |
|
850 | + |
|
851 | + foreach ($filters as $columnName => $value) { |
|
852 | + $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
853 | + $types[] = $columnDescriptor->getType(); |
|
854 | + } |
|
855 | + |
|
856 | + $this->connection->insert($pivotTableName, $filters, $types); |
|
857 | + |
|
858 | + // Finally, let's mark relationships as saved. |
|
859 | + $statusArr['status'] = 'loaded'; |
|
860 | + $storage[$remoteBean] = $statusArr; |
|
861 | + $remoteStorage = $remoteBean->_getCachedRelationships()[$pivotTableName]; |
|
862 | + $remoteStatusArr = $remoteStorage[$object]; |
|
863 | + $remoteStatusArr['status'] = 'loaded'; |
|
864 | + $remoteStorage[$object] = $remoteStatusArr; |
|
865 | + } elseif ($status === 'delete') { |
|
866 | + $filters = $this->getPivotFilters($object, $remoteBean, $localFk, $remoteFk); |
|
867 | + |
|
868 | + $types = []; |
|
869 | + |
|
870 | + foreach ($filters as $columnName => $value) { |
|
871 | + $columnDescriptor = $tableDescriptor->getColumn($columnName); |
|
872 | + $types[] = $columnDescriptor->getType(); |
|
873 | + } |
|
874 | + |
|
875 | + $this->connection->delete($pivotTableName, $filters, $types); |
|
876 | + |
|
877 | + // Finally, let's remove relationships completely from bean. |
|
878 | + $storage->detach($remoteBean); |
|
879 | + $remoteBean->_getCachedRelationships()[$pivotTableName]->detach($object); |
|
880 | + } |
|
881 | + } |
|
882 | + } |
|
883 | + } |
|
884 | + |
|
885 | + private function getPivotFilters(AbstractTDBMObject $localBean, AbstractTDBMObject $remoteBean, ForeignKeyConstraint $localFk, ForeignKeyConstraint $remoteFk) |
|
886 | + { |
|
887 | + $localBeanPk = $this->getPrimaryKeyValues($localBean); |
|
888 | + $remoteBeanPk = $this->getPrimaryKeyValues($remoteBean); |
|
889 | + $localColumns = $localFk->getLocalColumns(); |
|
890 | + $remoteColumns = $remoteFk->getLocalColumns(); |
|
891 | + |
|
892 | + $localFilters = array_combine($localColumns, $localBeanPk); |
|
893 | + $remoteFilters = array_combine($remoteColumns, $remoteBeanPk); |
|
894 | + |
|
895 | + return array_merge($localFilters, $remoteFilters); |
|
896 | + } |
|
897 | + |
|
898 | + /** |
|
899 | + * Returns the "values" of the primary key. |
|
900 | + * This returns the primary key from the $primaryKey attribute, not the one stored in the columns. |
|
901 | + * |
|
902 | + * @param AbstractTDBMObject $bean |
|
903 | + * |
|
904 | + * @return array numerically indexed array of values. |
|
905 | + */ |
|
906 | + private function getPrimaryKeyValues(AbstractTDBMObject $bean) |
|
907 | + { |
|
908 | + $dbRows = $bean->_getDbRows(); |
|
909 | + $dbRow = reset($dbRows); |
|
910 | + |
|
911 | + return array_values($dbRow->_getPrimaryKeys()); |
|
912 | + } |
|
913 | + |
|
914 | + /** |
|
915 | + * Returns a unique hash used to store the object based on its primary key. |
|
916 | + * If the array contains only one value, then the value is returned. |
|
917 | + * Otherwise, a hash representing the array is returned. |
|
918 | + * |
|
919 | + * @param array $primaryKeys An array of columns => values forming the primary key |
|
920 | + * |
|
921 | + * @return string |
|
922 | + */ |
|
923 | + public function getObjectHash(array $primaryKeys) |
|
924 | + { |
|
925 | + if (count($primaryKeys) === 1) { |
|
926 | + return reset($primaryKeys); |
|
927 | + } else { |
|
928 | + ksort($primaryKeys); |
|
929 | + |
|
930 | + return md5(json_encode($primaryKeys)); |
|
931 | + } |
|
932 | + } |
|
933 | + |
|
934 | + /** |
|
935 | + * Returns an array of primary keys from the object. |
|
936 | + * The primary keys are extracted from the object columns and not from the primary keys stored in the |
|
937 | + * $primaryKeys variable of the object. |
|
938 | + * |
|
939 | + * @param DbRow $dbRow |
|
940 | + * |
|
941 | + * @return array Returns an array of column => value |
|
942 | + */ |
|
943 | + public function getPrimaryKeysForObjectFromDbRow(DbRow $dbRow) |
|
944 | + { |
|
945 | + $table = $dbRow->_getDbTableName(); |
|
946 | + $dbRowData = $dbRow->_getDbRow(); |
|
947 | + |
|
948 | + return $this->_getPrimaryKeysFromObjectData($table, $dbRowData); |
|
949 | + } |
|
950 | + |
|
951 | + /** |
|
952 | + * Returns an array of primary keys for the given row. |
|
953 | + * The primary keys are extracted from the object columns. |
|
954 | + * |
|
955 | + * @param $table |
|
956 | + * @param array $columns |
|
957 | + * |
|
958 | + * @return array |
|
959 | + */ |
|
960 | + public function _getPrimaryKeysFromObjectData($table, array $columns) |
|
961 | + { |
|
962 | + $primaryKeyColumns = $this->getPrimaryKeyColumns($table); |
|
963 | + $values = array(); |
|
964 | + foreach ($primaryKeyColumns as $column) { |
|
965 | + if (isset($columns[$column])) { |
|
966 | + $values[$column] = $columns[$column]; |
|
967 | + } |
|
968 | + } |
|
969 | + |
|
970 | + return $values; |
|
971 | + } |
|
972 | + |
|
973 | + /** |
|
974 | + * Attaches $object to this TDBMService. |
|
975 | + * The $object must be in DETACHED state and will pass in NEW state. |
|
976 | + * |
|
977 | + * @param AbstractTDBMObject $object |
|
978 | + * |
|
979 | + * @throws TDBMInvalidOperationException |
|
980 | + */ |
|
981 | + public function attach(AbstractTDBMObject $object) |
|
982 | + { |
|
983 | + $object->_attach($this); |
|
984 | + } |
|
985 | + |
|
986 | + /** |
|
987 | + * Returns an associative array (column => value) for the primary keys from the table name and an |
|
988 | + * indexed array of primary key values. |
|
989 | + * |
|
990 | + * @param string $tableName |
|
991 | + * @param array $indexedPrimaryKeys |
|
992 | + */ |
|
993 | + public function _getPrimaryKeysFromIndexedPrimaryKeys($tableName, array $indexedPrimaryKeys) |
|
994 | + { |
|
995 | + $primaryKeyColumns = $this->tdbmSchemaAnalyzer->getSchema()->getTable($tableName)->getPrimaryKeyColumns(); |
|
996 | + |
|
997 | + if (count($primaryKeyColumns) !== count($indexedPrimaryKeys)) { |
|
998 | + throw new TDBMException(sprintf('Wrong number of columns passed for primary key. Expected %s columns for table "%s", |
|
999 | 999 | got %s instead.', count($primaryKeyColumns), $tableName, count($indexedPrimaryKeys))); |
1000 | - } |
|
1001 | - |
|
1002 | - return array_combine($primaryKeyColumns, $indexedPrimaryKeys); |
|
1003 | - } |
|
1004 | - |
|
1005 | - /** |
|
1006 | - * Return the list of tables (from child to parent) joining the tables passed in parameter. |
|
1007 | - * Tables must be in a single line of inheritance. The method will find missing tables. |
|
1008 | - * |
|
1009 | - * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent, |
|
1010 | - * we must be able to find all other tables. |
|
1011 | - * |
|
1012 | - * @param string[] $tables |
|
1013 | - * |
|
1014 | - * @return string[] |
|
1015 | - */ |
|
1016 | - public function _getLinkBetweenInheritedTables(array $tables) |
|
1017 | - { |
|
1018 | - sort($tables); |
|
1019 | - |
|
1020 | - return $this->fromCache($this->cachePrefix.'_linkbetweeninheritedtables_'.implode('__split__', $tables), |
|
1021 | - function () use ($tables) { |
|
1022 | - return $this->_getLinkBetweenInheritedTablesWithoutCache($tables); |
|
1023 | - }); |
|
1024 | - } |
|
1025 | - |
|
1026 | - /** |
|
1027 | - * Return the list of tables (from child to parent) joining the tables passed in parameter. |
|
1028 | - * Tables must be in a single line of inheritance. The method will find missing tables. |
|
1029 | - * |
|
1030 | - * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent, |
|
1031 | - * we must be able to find all other tables. |
|
1032 | - * |
|
1033 | - * @param string[] $tables |
|
1034 | - * |
|
1035 | - * @return string[] |
|
1036 | - */ |
|
1037 | - private function _getLinkBetweenInheritedTablesWithoutCache(array $tables) |
|
1038 | - { |
|
1039 | - $schemaAnalyzer = $this->schemaAnalyzer; |
|
1040 | - |
|
1041 | - foreach ($tables as $currentTable) { |
|
1042 | - $allParents = [$currentTable]; |
|
1043 | - while ($currentFk = $schemaAnalyzer->getParentRelationship($currentTable)) { |
|
1044 | - $currentTable = $currentFk->getForeignTableName(); |
|
1045 | - $allParents[] = $currentTable; |
|
1046 | - }; |
|
1047 | - |
|
1048 | - // Now, does the $allParents contain all the tables we want? |
|
1049 | - $notFoundTables = array_diff($tables, $allParents); |
|
1050 | - if (empty($notFoundTables)) { |
|
1051 | - // We have a winner! |
|
1052 | - return $allParents; |
|
1053 | - } |
|
1054 | - } |
|
1055 | - |
|
1056 | - throw new TDBMException(sprintf('The tables (%s) cannot be linked by an inheritance relationship.', implode(', ', $tables))); |
|
1057 | - } |
|
1058 | - |
|
1059 | - /** |
|
1060 | - * Returns the list of tables related to this table (via a parent or child inheritance relationship). |
|
1061 | - * |
|
1062 | - * @param string $table |
|
1063 | - * |
|
1064 | - * @return string[] |
|
1065 | - */ |
|
1066 | - public function _getRelatedTablesByInheritance($table) |
|
1067 | - { |
|
1068 | - return $this->fromCache($this->cachePrefix.'_relatedtables_'.$table, function () use ($table) { |
|
1069 | - return $this->_getRelatedTablesByInheritanceWithoutCache($table); |
|
1070 | - }); |
|
1071 | - } |
|
1072 | - |
|
1073 | - /** |
|
1074 | - * Returns the list of tables related to this table (via a parent or child inheritance relationship). |
|
1075 | - * |
|
1076 | - * @param string $table |
|
1077 | - * |
|
1078 | - * @return string[] |
|
1079 | - */ |
|
1080 | - private function _getRelatedTablesByInheritanceWithoutCache($table) |
|
1081 | - { |
|
1082 | - $schemaAnalyzer = $this->schemaAnalyzer; |
|
1083 | - |
|
1084 | - // Let's scan the parent tables |
|
1085 | - $currentTable = $table; |
|
1086 | - |
|
1087 | - $parentTables = []; |
|
1088 | - |
|
1089 | - // Get parent relationship |
|
1090 | - while ($currentFk = $schemaAnalyzer->getParentRelationship($currentTable)) { |
|
1091 | - $currentTable = $currentFk->getForeignTableName(); |
|
1092 | - $parentTables[] = $currentTable; |
|
1093 | - }; |
|
1094 | - |
|
1095 | - // Let's recurse in children |
|
1096 | - $childrenTables = $this->exploreChildrenTablesRelationships($schemaAnalyzer, $table); |
|
1097 | - |
|
1098 | - return array_merge(array_reverse($parentTables), $childrenTables); |
|
1099 | - } |
|
1100 | - |
|
1101 | - /** |
|
1102 | - * Explore all the children and descendant of $table and returns ForeignKeyConstraints on those. |
|
1103 | - * |
|
1104 | - * @param string $table |
|
1105 | - * |
|
1106 | - * @return string[] |
|
1107 | - */ |
|
1108 | - private function exploreChildrenTablesRelationships(SchemaAnalyzer $schemaAnalyzer, $table) |
|
1109 | - { |
|
1110 | - $tables = [$table]; |
|
1111 | - $keys = $schemaAnalyzer->getChildrenRelationships($table); |
|
1112 | - |
|
1113 | - foreach ($keys as $key) { |
|
1114 | - $tables = array_merge($tables, $this->exploreChildrenTablesRelationships($schemaAnalyzer, $key->getLocalTableName())); |
|
1115 | - } |
|
1116 | - |
|
1117 | - return $tables; |
|
1118 | - } |
|
1119 | - |
|
1120 | - /** |
|
1121 | - * Casts a foreign key into SQL, assuming table name is used with no alias. |
|
1122 | - * The returned value does contain only one table. For instance:. |
|
1123 | - * |
|
1124 | - * " LEFT JOIN table2 ON table1.id = table2.table1_id" |
|
1125 | - * |
|
1126 | - * @param ForeignKeyConstraint $fk |
|
1127 | - * @param bool $leftTableIsLocal |
|
1128 | - * |
|
1129 | - * @return string |
|
1130 | - */ |
|
1131 | - /*private function foreignKeyToSql(ForeignKeyConstraint $fk, $leftTableIsLocal) { |
|
1000 | + } |
|
1001 | + |
|
1002 | + return array_combine($primaryKeyColumns, $indexedPrimaryKeys); |
|
1003 | + } |
|
1004 | + |
|
1005 | + /** |
|
1006 | + * Return the list of tables (from child to parent) joining the tables passed in parameter. |
|
1007 | + * Tables must be in a single line of inheritance. The method will find missing tables. |
|
1008 | + * |
|
1009 | + * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent, |
|
1010 | + * we must be able to find all other tables. |
|
1011 | + * |
|
1012 | + * @param string[] $tables |
|
1013 | + * |
|
1014 | + * @return string[] |
|
1015 | + */ |
|
1016 | + public function _getLinkBetweenInheritedTables(array $tables) |
|
1017 | + { |
|
1018 | + sort($tables); |
|
1019 | + |
|
1020 | + return $this->fromCache($this->cachePrefix.'_linkbetweeninheritedtables_'.implode('__split__', $tables), |
|
1021 | + function () use ($tables) { |
|
1022 | + return $this->_getLinkBetweenInheritedTablesWithoutCache($tables); |
|
1023 | + }); |
|
1024 | + } |
|
1025 | + |
|
1026 | + /** |
|
1027 | + * Return the list of tables (from child to parent) joining the tables passed in parameter. |
|
1028 | + * Tables must be in a single line of inheritance. The method will find missing tables. |
|
1029 | + * |
|
1030 | + * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent, |
|
1031 | + * we must be able to find all other tables. |
|
1032 | + * |
|
1033 | + * @param string[] $tables |
|
1034 | + * |
|
1035 | + * @return string[] |
|
1036 | + */ |
|
1037 | + private function _getLinkBetweenInheritedTablesWithoutCache(array $tables) |
|
1038 | + { |
|
1039 | + $schemaAnalyzer = $this->schemaAnalyzer; |
|
1040 | + |
|
1041 | + foreach ($tables as $currentTable) { |
|
1042 | + $allParents = [$currentTable]; |
|
1043 | + while ($currentFk = $schemaAnalyzer->getParentRelationship($currentTable)) { |
|
1044 | + $currentTable = $currentFk->getForeignTableName(); |
|
1045 | + $allParents[] = $currentTable; |
|
1046 | + }; |
|
1047 | + |
|
1048 | + // Now, does the $allParents contain all the tables we want? |
|
1049 | + $notFoundTables = array_diff($tables, $allParents); |
|
1050 | + if (empty($notFoundTables)) { |
|
1051 | + // We have a winner! |
|
1052 | + return $allParents; |
|
1053 | + } |
|
1054 | + } |
|
1055 | + |
|
1056 | + throw new TDBMException(sprintf('The tables (%s) cannot be linked by an inheritance relationship.', implode(', ', $tables))); |
|
1057 | + } |
|
1058 | + |
|
1059 | + /** |
|
1060 | + * Returns the list of tables related to this table (via a parent or child inheritance relationship). |
|
1061 | + * |
|
1062 | + * @param string $table |
|
1063 | + * |
|
1064 | + * @return string[] |
|
1065 | + */ |
|
1066 | + public function _getRelatedTablesByInheritance($table) |
|
1067 | + { |
|
1068 | + return $this->fromCache($this->cachePrefix.'_relatedtables_'.$table, function () use ($table) { |
|
1069 | + return $this->_getRelatedTablesByInheritanceWithoutCache($table); |
|
1070 | + }); |
|
1071 | + } |
|
1072 | + |
|
1073 | + /** |
|
1074 | + * Returns the list of tables related to this table (via a parent or child inheritance relationship). |
|
1075 | + * |
|
1076 | + * @param string $table |
|
1077 | + * |
|
1078 | + * @return string[] |
|
1079 | + */ |
|
1080 | + private function _getRelatedTablesByInheritanceWithoutCache($table) |
|
1081 | + { |
|
1082 | + $schemaAnalyzer = $this->schemaAnalyzer; |
|
1083 | + |
|
1084 | + // Let's scan the parent tables |
|
1085 | + $currentTable = $table; |
|
1086 | + |
|
1087 | + $parentTables = []; |
|
1088 | + |
|
1089 | + // Get parent relationship |
|
1090 | + while ($currentFk = $schemaAnalyzer->getParentRelationship($currentTable)) { |
|
1091 | + $currentTable = $currentFk->getForeignTableName(); |
|
1092 | + $parentTables[] = $currentTable; |
|
1093 | + }; |
|
1094 | + |
|
1095 | + // Let's recurse in children |
|
1096 | + $childrenTables = $this->exploreChildrenTablesRelationships($schemaAnalyzer, $table); |
|
1097 | + |
|
1098 | + return array_merge(array_reverse($parentTables), $childrenTables); |
|
1099 | + } |
|
1100 | + |
|
1101 | + /** |
|
1102 | + * Explore all the children and descendant of $table and returns ForeignKeyConstraints on those. |
|
1103 | + * |
|
1104 | + * @param string $table |
|
1105 | + * |
|
1106 | + * @return string[] |
|
1107 | + */ |
|
1108 | + private function exploreChildrenTablesRelationships(SchemaAnalyzer $schemaAnalyzer, $table) |
|
1109 | + { |
|
1110 | + $tables = [$table]; |
|
1111 | + $keys = $schemaAnalyzer->getChildrenRelationships($table); |
|
1112 | + |
|
1113 | + foreach ($keys as $key) { |
|
1114 | + $tables = array_merge($tables, $this->exploreChildrenTablesRelationships($schemaAnalyzer, $key->getLocalTableName())); |
|
1115 | + } |
|
1116 | + |
|
1117 | + return $tables; |
|
1118 | + } |
|
1119 | + |
|
1120 | + /** |
|
1121 | + * Casts a foreign key into SQL, assuming table name is used with no alias. |
|
1122 | + * The returned value does contain only one table. For instance:. |
|
1123 | + * |
|
1124 | + * " LEFT JOIN table2 ON table1.id = table2.table1_id" |
|
1125 | + * |
|
1126 | + * @param ForeignKeyConstraint $fk |
|
1127 | + * @param bool $leftTableIsLocal |
|
1128 | + * |
|
1129 | + * @return string |
|
1130 | + */ |
|
1131 | + /*private function foreignKeyToSql(ForeignKeyConstraint $fk, $leftTableIsLocal) { |
|
1132 | 1132 | $onClauses = []; |
1133 | 1133 | $foreignTableName = $this->connection->quoteIdentifier($fk->getForeignTableName()); |
1134 | 1134 | $foreignColumns = $fk->getForeignColumns(); |
@@ -1154,400 +1154,400 @@ discard block |
||
1154 | 1154 | } |
1155 | 1155 | }*/ |
1156 | 1156 | |
1157 | - /** |
|
1158 | - * Returns an identifier for the group of tables passed in parameter. |
|
1159 | - * |
|
1160 | - * @param string[] $relatedTables |
|
1161 | - * |
|
1162 | - * @return string |
|
1163 | - */ |
|
1164 | - private function getTableGroupName(array $relatedTables) |
|
1165 | - { |
|
1166 | - sort($relatedTables); |
|
1167 | - |
|
1168 | - return implode('_``_', $relatedTables); |
|
1169 | - } |
|
1170 | - |
|
1171 | - /** |
|
1172 | - * Returns a `ResultIterator` object representing filtered records of "$mainTable" . |
|
1173 | - * |
|
1174 | - * The findObjects method should be the most used query method in TDBM if you want to query the database for objects. |
|
1175 | - * (Note: if you want to query the database for an object by its primary key, use the findObjectByPk method). |
|
1176 | - * |
|
1177 | - * The findObjects method takes in parameter: |
|
1178 | - * - mainTable: the kind of bean you want to retrieve. In TDBM, a bean matches a database row, so the |
|
1179 | - * `$mainTable` parameter should be the name of an existing table in database. |
|
1180 | - * - filter: The filter is a filter bag. It is what you use to filter your request (the WHERE part in SQL). |
|
1181 | - * It can be a string (SQL Where clause), or even a bean or an associative array (key = column to filter, value = value to find) |
|
1182 | - * - parameters: The parameters used in the filter. If you pass a SQL string as a filter, be sure to avoid |
|
1183 | - * concatenating parameters in the string (this leads to SQL injection and also to poor caching performance). |
|
1184 | - * Instead, please consider passing parameters (see documentation for more details). |
|
1185 | - * - additionalTablesFetch: An array of SQL tables names. The beans related to those tables will be fetched along |
|
1186 | - * the main table. This is useful to avoid hitting the database with numerous subqueries. |
|
1187 | - * - mode: The fetch mode of the result. See `setFetchMode()` method for more details. |
|
1188 | - * |
|
1189 | - * The `findObjects` method will return a `ResultIterator`. A `ResultIterator` is an object that behaves as an array |
|
1190 | - * (in ARRAY mode) at least. It can be iterated using a `foreach` loop. |
|
1191 | - * |
|
1192 | - * Finally, if filter_bag is null, the whole table is returned. |
|
1193 | - * |
|
1194 | - * @param string $mainTable The name of the table queried |
|
1195 | - * @param string|array|null $filter The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column) |
|
1196 | - * @param array $parameters |
|
1197 | - * @param string|null $orderString The ORDER BY part of the query. All columns must be prefixed by the table name (in the form: table.column) |
|
1198 | - * @param array $additionalTablesFetch |
|
1199 | - * @param int $mode |
|
1200 | - * @param string $className Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned. |
|
1201 | - * |
|
1202 | - * @return ResultIterator An object representing an array of results. |
|
1203 | - * |
|
1204 | - * @throws TDBMException |
|
1205 | - */ |
|
1206 | - public function findObjects($mainTable, $filter = null, array $parameters = array(), $orderString = null, array $additionalTablesFetch = array(), $mode = null, $className = null) |
|
1207 | - { |
|
1208 | - // $mainTable is not secured in MagicJoin, let's add a bit of security to avoid SQL injection. |
|
1209 | - if (!preg_match('/^[a-zA-Z_][a-zA-Z0-9_]*$/', $mainTable)) { |
|
1210 | - throw new TDBMException(sprintf("Invalid table name: '%s'", $mainTable)); |
|
1211 | - } |
|
1212 | - |
|
1213 | - list($filterString, $additionalParameters) = $this->buildFilterFromFilterBag($filter); |
|
1214 | - |
|
1215 | - $parameters = array_merge($parameters, $additionalParameters); |
|
1216 | - |
|
1217 | - // From the table name and the additional tables we want to fetch, let's build a list of all tables |
|
1218 | - // that must be part of the select columns. |
|
1219 | - |
|
1220 | - $tableGroups = []; |
|
1221 | - $allFetchedTables = $this->_getRelatedTablesByInheritance($mainTable); |
|
1222 | - $tableGroupName = $this->getTableGroupName($allFetchedTables); |
|
1223 | - foreach ($allFetchedTables as $table) { |
|
1224 | - $tableGroups[$table] = $tableGroupName; |
|
1225 | - } |
|
1226 | - |
|
1227 | - foreach ($additionalTablesFetch as $additionalTable) { |
|
1228 | - $relatedTables = $this->_getRelatedTablesByInheritance($additionalTable); |
|
1229 | - $tableGroupName = $this->getTableGroupName($relatedTables); |
|
1230 | - foreach ($relatedTables as $table) { |
|
1231 | - $tableGroups[$table] = $tableGroupName; |
|
1232 | - } |
|
1233 | - $allFetchedTables = array_merge($allFetchedTables, $relatedTables); |
|
1234 | - } |
|
1235 | - |
|
1236 | - // Let's remove any duplicate |
|
1237 | - $allFetchedTables = array_flip(array_flip($allFetchedTables)); |
|
1238 | - |
|
1239 | - $columnsList = []; |
|
1240 | - $columnDescList = []; |
|
1241 | - $schema = $this->tdbmSchemaAnalyzer->getSchema(); |
|
1242 | - |
|
1243 | - // Now, let's build the column list |
|
1244 | - foreach ($allFetchedTables as $table) { |
|
1245 | - foreach ($schema->getTable($table)->getColumns() as $column) { |
|
1246 | - $columnName = $column->getName(); |
|
1247 | - $columnDescList[] = [ |
|
1248 | - 'as' => $table.'____'.$columnName, |
|
1249 | - 'table' => $table, |
|
1250 | - 'column' => $columnName, |
|
1251 | - 'type' => $column->getType(), |
|
1252 | - 'tableGroup' => $tableGroups[$table], |
|
1253 | - ]; |
|
1254 | - $columnsList[] = $this->connection->quoteIdentifier($table).'.'.$this->connection->quoteIdentifier($columnName).' as '. |
|
1255 | - $this->connection->quoteIdentifier($table.'____'.$columnName); |
|
1256 | - } |
|
1257 | - } |
|
1258 | - |
|
1259 | - $sql = 'SELECT DISTINCT '.implode(', ', $columnsList).' FROM MAGICJOIN('.$mainTable.')'; |
|
1260 | - $countSql = 'SELECT COUNT(1) FROM MAGICJOIN('.$mainTable.')'; |
|
1261 | - |
|
1262 | - if (!empty($filterString)) { |
|
1263 | - $sql .= ' WHERE '.$filterString; |
|
1264 | - $countSql .= ' WHERE '.$filterString; |
|
1265 | - } |
|
1266 | - |
|
1267 | - if (!empty($orderString)) { |
|
1268 | - $sql .= ' ORDER BY '.$orderString; |
|
1269 | - $countSql .= ' ORDER BY '.$orderString; |
|
1270 | - } |
|
1271 | - |
|
1272 | - if ($mode !== null && $mode !== self::MODE_CURSOR && $mode !== self::MODE_ARRAY) { |
|
1273 | - throw new TDBMException("Unknown fetch mode: '".$this->mode."'"); |
|
1274 | - } |
|
1275 | - |
|
1276 | - $mode = $mode ?: $this->mode; |
|
1277 | - |
|
1278 | - return new ResultIterator($sql, $countSql, $parameters, $columnDescList, $this->objectStorage, $className, $this, $this->magicQuery, $mode); |
|
1279 | - } |
|
1280 | - |
|
1281 | - /** |
|
1282 | - * @param $table |
|
1283 | - * @param array $primaryKeys |
|
1284 | - * @param array $additionalTablesFetch |
|
1285 | - * @param bool $lazy Whether to perform lazy loading on this object or not. |
|
1286 | - * @param string $className |
|
1287 | - * |
|
1288 | - * @return AbstractTDBMObject |
|
1289 | - * |
|
1290 | - * @throws TDBMException |
|
1291 | - */ |
|
1292 | - public function findObjectByPk($table, array $primaryKeys, array $additionalTablesFetch = array(), $lazy = false, $className = null) |
|
1293 | - { |
|
1294 | - $primaryKeys = $this->_getPrimaryKeysFromObjectData($table, $primaryKeys); |
|
1295 | - $hash = $this->getObjectHash($primaryKeys); |
|
1296 | - |
|
1297 | - if ($this->objectStorage->has($table, $hash)) { |
|
1298 | - $dbRow = $this->objectStorage->get($table, $hash); |
|
1299 | - $bean = $dbRow->getTDBMObject(); |
|
1300 | - if ($className !== null && !is_a($bean, $className)) { |
|
1301 | - throw new TDBMException("TDBM cannot create a bean of class '".$className."'. The requested object was already loaded and its class is '".get_class($bean)."'"); |
|
1302 | - } |
|
1303 | - |
|
1304 | - return $bean; |
|
1305 | - } |
|
1306 | - |
|
1307 | - // Are we performing lazy fetching? |
|
1308 | - if ($lazy === true) { |
|
1309 | - // Can we perform lazy fetching? |
|
1310 | - $tables = $this->_getRelatedTablesByInheritance($table); |
|
1311 | - // Only allowed if no inheritance. |
|
1312 | - if (count($tables) === 1) { |
|
1313 | - if ($className === null) { |
|
1314 | - $className = isset($this->tableToBeanMap[$table]) ? $this->tableToBeanMap[$table] : 'Mouf\\Database\\TDBM\\TDBMObject'; |
|
1315 | - } |
|
1316 | - |
|
1317 | - // Let's construct the bean |
|
1318 | - if (!isset($this->reflectionClassCache[$className])) { |
|
1319 | - $this->reflectionClassCache[$className] = new \ReflectionClass($className); |
|
1320 | - } |
|
1321 | - // Let's bypass the constructor when creating the bean! |
|
1322 | - $bean = $this->reflectionClassCache[$className]->newInstanceWithoutConstructor(); |
|
1323 | - /* @var $bean AbstractTDBMObject */ |
|
1324 | - $bean->_constructLazy($table, $primaryKeys, $this); |
|
1325 | - |
|
1326 | - return $bean; |
|
1327 | - } |
|
1328 | - } |
|
1329 | - |
|
1330 | - // Did not find the object in cache? Let's query it! |
|
1331 | - return $this->findObjectOrFail($table, $primaryKeys, [], $additionalTablesFetch, $className); |
|
1332 | - } |
|
1333 | - |
|
1334 | - /** |
|
1335 | - * Returns a unique bean (or null) according to the filters passed in parameter. |
|
1336 | - * |
|
1337 | - * @param string $mainTable The name of the table queried |
|
1338 | - * @param string|array|null $filter The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column) |
|
1339 | - * @param array $parameters |
|
1340 | - * @param array $additionalTablesFetch |
|
1341 | - * @param string $className Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned. |
|
1342 | - * |
|
1343 | - * @return AbstractTDBMObject|null The object we want, or null if no object matches the filters. |
|
1344 | - * |
|
1345 | - * @throws TDBMException |
|
1346 | - */ |
|
1347 | - public function findObject($mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), $className = null) |
|
1348 | - { |
|
1349 | - $objects = $this->findObjects($mainTable, $filter, $parameters, null, $additionalTablesFetch, self::MODE_ARRAY, $className); |
|
1350 | - $page = $objects->take(0, 2); |
|
1351 | - $count = $page->count(); |
|
1352 | - if ($count > 1) { |
|
1353 | - throw new DuplicateRowException("Error while querying an object for table '$mainTable': More than 1 row have been returned, but we should have received at most one."); |
|
1354 | - } elseif ($count === 0) { |
|
1355 | - return; |
|
1356 | - } |
|
1357 | - |
|
1358 | - return $objects[0]; |
|
1359 | - } |
|
1360 | - |
|
1361 | - /** |
|
1362 | - * Returns a unique bean according to the filters passed in parameter. |
|
1363 | - * Throws a NoBeanFoundException if no bean was found for the filter passed in parameter. |
|
1364 | - * |
|
1365 | - * @param string $mainTable The name of the table queried |
|
1366 | - * @param string|array|null $filter The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column) |
|
1367 | - * @param array $parameters |
|
1368 | - * @param array $additionalTablesFetch |
|
1369 | - * @param string $className Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned. |
|
1370 | - * |
|
1371 | - * @return AbstractTDBMObject The object we want |
|
1372 | - * |
|
1373 | - * @throws TDBMException |
|
1374 | - */ |
|
1375 | - public function findObjectOrFail($mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), $className = null) |
|
1376 | - { |
|
1377 | - $bean = $this->findObject($mainTable, $filter, $parameters, $additionalTablesFetch, $className); |
|
1378 | - if ($bean === null) { |
|
1379 | - throw new NoBeanFoundException("No result found for query on table '".$mainTable."'"); |
|
1380 | - } |
|
1381 | - |
|
1382 | - return $bean; |
|
1383 | - } |
|
1384 | - |
|
1385 | - /** |
|
1386 | - * @param array $beanData An array of data: array<table, array<column, value>> |
|
1387 | - * |
|
1388 | - * @return array an array with first item = class name and second item = table name |
|
1389 | - */ |
|
1390 | - public function _getClassNameFromBeanData(array $beanData) |
|
1391 | - { |
|
1392 | - if (count($beanData) === 1) { |
|
1393 | - $tableName = array_keys($beanData)[0]; |
|
1394 | - } else { |
|
1395 | - $tables = []; |
|
1396 | - foreach ($beanData as $table => $row) { |
|
1397 | - $primaryKeyColumns = $this->getPrimaryKeyColumns($table); |
|
1398 | - $pkSet = false; |
|
1399 | - foreach ($primaryKeyColumns as $columnName) { |
|
1400 | - if ($row[$columnName] !== null) { |
|
1401 | - $pkSet = true; |
|
1402 | - break; |
|
1403 | - } |
|
1404 | - } |
|
1405 | - if ($pkSet) { |
|
1406 | - $tables[] = $table; |
|
1407 | - } |
|
1408 | - } |
|
1409 | - |
|
1410 | - // $tables contains the tables for this bean. Let's view the top most part of the hierarchy |
|
1411 | - $allTables = $this->_getLinkBetweenInheritedTables($tables); |
|
1412 | - $tableName = $allTables[0]; |
|
1413 | - } |
|
1414 | - |
|
1415 | - // Only one table in this bean. Life is sweat, let's look at its type: |
|
1416 | - if (isset($this->tableToBeanMap[$tableName])) { |
|
1417 | - return [$this->tableToBeanMap[$tableName], $tableName]; |
|
1418 | - } else { |
|
1419 | - return ['Mouf\\Database\\TDBM\\TDBMObject', $tableName]; |
|
1420 | - } |
|
1421 | - } |
|
1422 | - |
|
1423 | - /** |
|
1424 | - * Returns an item from cache or computes it using $closure and puts it in cache. |
|
1425 | - * |
|
1426 | - * @param string $key |
|
1427 | - * @param callable $closure |
|
1428 | - * |
|
1429 | - * @return mixed |
|
1430 | - */ |
|
1431 | - private function fromCache($key, callable $closure) |
|
1432 | - { |
|
1433 | - $item = $this->cache->fetch($key); |
|
1434 | - if ($item === false) { |
|
1435 | - $item = $closure(); |
|
1436 | - $this->cache->save($key, $item); |
|
1437 | - } |
|
1438 | - |
|
1439 | - return $item; |
|
1440 | - } |
|
1441 | - |
|
1442 | - /** |
|
1443 | - * Returns the foreign key object. |
|
1444 | - * |
|
1445 | - * @param string $table |
|
1446 | - * @param string $fkName |
|
1447 | - * |
|
1448 | - * @return ForeignKeyConstraint |
|
1449 | - */ |
|
1450 | - public function _getForeignKeyByName($table, $fkName) |
|
1451 | - { |
|
1452 | - return $this->tdbmSchemaAnalyzer->getSchema()->getTable($table)->getForeignKey($fkName); |
|
1453 | - } |
|
1454 | - |
|
1455 | - /** |
|
1456 | - * @param $pivotTableName |
|
1457 | - * @param AbstractTDBMObject $bean |
|
1458 | - * |
|
1459 | - * @return AbstractTDBMObject[] |
|
1460 | - */ |
|
1461 | - public function _getRelatedBeans($pivotTableName, AbstractTDBMObject $bean) |
|
1462 | - { |
|
1463 | - list($localFk, $remoteFk) = $this->getPivotTableForeignKeys($pivotTableName, $bean); |
|
1464 | - /* @var $localFk ForeignKeyConstraint */ |
|
1465 | - /* @var $remoteFk ForeignKeyConstraint */ |
|
1466 | - $remoteTable = $remoteFk->getForeignTableName(); |
|
1467 | - |
|
1468 | - $primaryKeys = $this->getPrimaryKeyValues($bean); |
|
1469 | - $columnNames = array_map(function ($name) use ($pivotTableName) { return $pivotTableName.'.'.$name; }, $localFk->getLocalColumns()); |
|
1470 | - |
|
1471 | - $filter = array_combine($columnNames, $primaryKeys); |
|
1472 | - |
|
1473 | - return $this->findObjects($remoteTable, $filter); |
|
1474 | - } |
|
1475 | - |
|
1476 | - /** |
|
1477 | - * @param $pivotTableName |
|
1478 | - * @param AbstractTDBMObject $bean The LOCAL bean |
|
1479 | - * |
|
1480 | - * @return ForeignKeyConstraint[] First item: the LOCAL bean, second item: the REMOTE bean. |
|
1481 | - * |
|
1482 | - * @throws TDBMException |
|
1483 | - */ |
|
1484 | - private function getPivotTableForeignKeys($pivotTableName, AbstractTDBMObject $bean) |
|
1485 | - { |
|
1486 | - $fks = array_values($this->tdbmSchemaAnalyzer->getSchema()->getTable($pivotTableName)->getForeignKeys()); |
|
1487 | - $table1 = $fks[0]->getForeignTableName(); |
|
1488 | - $table2 = $fks[1]->getForeignTableName(); |
|
1489 | - |
|
1490 | - $beanTables = array_map(function (DbRow $dbRow) { return $dbRow->_getDbTableName(); }, $bean->_getDbRows()); |
|
1491 | - |
|
1492 | - if (in_array($table1, $beanTables)) { |
|
1493 | - return [$fks[0], $fks[1]]; |
|
1494 | - } elseif (in_array($table2, $beanTables)) { |
|
1495 | - return [$fks[1], $fks[0]]; |
|
1496 | - } else { |
|
1497 | - throw new TDBMException("Unexpected bean type in getPivotTableForeignKeys. Awaiting beans from table {$table1} and {$table2} for pivot table {$pivotTableName}"); |
|
1498 | - } |
|
1499 | - } |
|
1500 | - |
|
1501 | - /** |
|
1502 | - * Returns a list of pivot tables linked to $bean. |
|
1503 | - * |
|
1504 | - * @param AbstractTDBMObject $bean |
|
1505 | - * |
|
1506 | - * @return string[] |
|
1507 | - */ |
|
1508 | - public function _getPivotTablesLinkedToBean(AbstractTDBMObject $bean) |
|
1509 | - { |
|
1510 | - $junctionTables = []; |
|
1511 | - $allJunctionTables = $this->schemaAnalyzer->detectJunctionTables(true); |
|
1512 | - foreach ($bean->_getDbRows() as $dbRow) { |
|
1513 | - foreach ($allJunctionTables as $table) { |
|
1514 | - // There are exactly 2 FKs since this is a pivot table. |
|
1515 | - $fks = array_values($table->getForeignKeys()); |
|
1516 | - |
|
1517 | - if ($fks[0]->getForeignTableName() === $dbRow->_getDbTableName() || $fks[1]->getForeignTableName() === $dbRow->_getDbTableName()) { |
|
1518 | - $junctionTables[] = $table->getName(); |
|
1519 | - } |
|
1520 | - } |
|
1521 | - } |
|
1522 | - |
|
1523 | - return $junctionTables; |
|
1524 | - } |
|
1525 | - |
|
1526 | - /** |
|
1527 | - * Array of types for tables. |
|
1528 | - * Key: table name |
|
1529 | - * Value: array of types indexed by column. |
|
1530 | - * |
|
1531 | - * @var array[] |
|
1532 | - */ |
|
1533 | - private $typesForTable = []; |
|
1534 | - |
|
1535 | - /** |
|
1536 | - * @internal |
|
1537 | - * |
|
1538 | - * @param string $tableName |
|
1539 | - * |
|
1540 | - * @return Type[] |
|
1541 | - */ |
|
1542 | - public function _getColumnTypesForTable($tableName) |
|
1543 | - { |
|
1544 | - if (!isset($typesForTable[$tableName])) { |
|
1545 | - $columns = $this->tdbmSchemaAnalyzer->getSchema()->getTable($tableName)->getColumns(); |
|
1546 | - $typesForTable[$tableName] = array_map(function (Column $column) { |
|
1547 | - return $column->getType(); |
|
1548 | - }, $columns); |
|
1549 | - } |
|
1550 | - |
|
1551 | - return $typesForTable[$tableName]; |
|
1552 | - } |
|
1157 | + /** |
|
1158 | + * Returns an identifier for the group of tables passed in parameter. |
|
1159 | + * |
|
1160 | + * @param string[] $relatedTables |
|
1161 | + * |
|
1162 | + * @return string |
|
1163 | + */ |
|
1164 | + private function getTableGroupName(array $relatedTables) |
|
1165 | + { |
|
1166 | + sort($relatedTables); |
|
1167 | + |
|
1168 | + return implode('_``_', $relatedTables); |
|
1169 | + } |
|
1170 | + |
|
1171 | + /** |
|
1172 | + * Returns a `ResultIterator` object representing filtered records of "$mainTable" . |
|
1173 | + * |
|
1174 | + * The findObjects method should be the most used query method in TDBM if you want to query the database for objects. |
|
1175 | + * (Note: if you want to query the database for an object by its primary key, use the findObjectByPk method). |
|
1176 | + * |
|
1177 | + * The findObjects method takes in parameter: |
|
1178 | + * - mainTable: the kind of bean you want to retrieve. In TDBM, a bean matches a database row, so the |
|
1179 | + * `$mainTable` parameter should be the name of an existing table in database. |
|
1180 | + * - filter: The filter is a filter bag. It is what you use to filter your request (the WHERE part in SQL). |
|
1181 | + * It can be a string (SQL Where clause), or even a bean or an associative array (key = column to filter, value = value to find) |
|
1182 | + * - parameters: The parameters used in the filter. If you pass a SQL string as a filter, be sure to avoid |
|
1183 | + * concatenating parameters in the string (this leads to SQL injection and also to poor caching performance). |
|
1184 | + * Instead, please consider passing parameters (see documentation for more details). |
|
1185 | + * - additionalTablesFetch: An array of SQL tables names. The beans related to those tables will be fetched along |
|
1186 | + * the main table. This is useful to avoid hitting the database with numerous subqueries. |
|
1187 | + * - mode: The fetch mode of the result. See `setFetchMode()` method for more details. |
|
1188 | + * |
|
1189 | + * The `findObjects` method will return a `ResultIterator`. A `ResultIterator` is an object that behaves as an array |
|
1190 | + * (in ARRAY mode) at least. It can be iterated using a `foreach` loop. |
|
1191 | + * |
|
1192 | + * Finally, if filter_bag is null, the whole table is returned. |
|
1193 | + * |
|
1194 | + * @param string $mainTable The name of the table queried |
|
1195 | + * @param string|array|null $filter The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column) |
|
1196 | + * @param array $parameters |
|
1197 | + * @param string|null $orderString The ORDER BY part of the query. All columns must be prefixed by the table name (in the form: table.column) |
|
1198 | + * @param array $additionalTablesFetch |
|
1199 | + * @param int $mode |
|
1200 | + * @param string $className Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned. |
|
1201 | + * |
|
1202 | + * @return ResultIterator An object representing an array of results. |
|
1203 | + * |
|
1204 | + * @throws TDBMException |
|
1205 | + */ |
|
1206 | + public function findObjects($mainTable, $filter = null, array $parameters = array(), $orderString = null, array $additionalTablesFetch = array(), $mode = null, $className = null) |
|
1207 | + { |
|
1208 | + // $mainTable is not secured in MagicJoin, let's add a bit of security to avoid SQL injection. |
|
1209 | + if (!preg_match('/^[a-zA-Z_][a-zA-Z0-9_]*$/', $mainTable)) { |
|
1210 | + throw new TDBMException(sprintf("Invalid table name: '%s'", $mainTable)); |
|
1211 | + } |
|
1212 | + |
|
1213 | + list($filterString, $additionalParameters) = $this->buildFilterFromFilterBag($filter); |
|
1214 | + |
|
1215 | + $parameters = array_merge($parameters, $additionalParameters); |
|
1216 | + |
|
1217 | + // From the table name and the additional tables we want to fetch, let's build a list of all tables |
|
1218 | + // that must be part of the select columns. |
|
1219 | + |
|
1220 | + $tableGroups = []; |
|
1221 | + $allFetchedTables = $this->_getRelatedTablesByInheritance($mainTable); |
|
1222 | + $tableGroupName = $this->getTableGroupName($allFetchedTables); |
|
1223 | + foreach ($allFetchedTables as $table) { |
|
1224 | + $tableGroups[$table] = $tableGroupName; |
|
1225 | + } |
|
1226 | + |
|
1227 | + foreach ($additionalTablesFetch as $additionalTable) { |
|
1228 | + $relatedTables = $this->_getRelatedTablesByInheritance($additionalTable); |
|
1229 | + $tableGroupName = $this->getTableGroupName($relatedTables); |
|
1230 | + foreach ($relatedTables as $table) { |
|
1231 | + $tableGroups[$table] = $tableGroupName; |
|
1232 | + } |
|
1233 | + $allFetchedTables = array_merge($allFetchedTables, $relatedTables); |
|
1234 | + } |
|
1235 | + |
|
1236 | + // Let's remove any duplicate |
|
1237 | + $allFetchedTables = array_flip(array_flip($allFetchedTables)); |
|
1238 | + |
|
1239 | + $columnsList = []; |
|
1240 | + $columnDescList = []; |
|
1241 | + $schema = $this->tdbmSchemaAnalyzer->getSchema(); |
|
1242 | + |
|
1243 | + // Now, let's build the column list |
|
1244 | + foreach ($allFetchedTables as $table) { |
|
1245 | + foreach ($schema->getTable($table)->getColumns() as $column) { |
|
1246 | + $columnName = $column->getName(); |
|
1247 | + $columnDescList[] = [ |
|
1248 | + 'as' => $table.'____'.$columnName, |
|
1249 | + 'table' => $table, |
|
1250 | + 'column' => $columnName, |
|
1251 | + 'type' => $column->getType(), |
|
1252 | + 'tableGroup' => $tableGroups[$table], |
|
1253 | + ]; |
|
1254 | + $columnsList[] = $this->connection->quoteIdentifier($table).'.'.$this->connection->quoteIdentifier($columnName).' as '. |
|
1255 | + $this->connection->quoteIdentifier($table.'____'.$columnName); |
|
1256 | + } |
|
1257 | + } |
|
1258 | + |
|
1259 | + $sql = 'SELECT DISTINCT '.implode(', ', $columnsList).' FROM MAGICJOIN('.$mainTable.')'; |
|
1260 | + $countSql = 'SELECT COUNT(1) FROM MAGICJOIN('.$mainTable.')'; |
|
1261 | + |
|
1262 | + if (!empty($filterString)) { |
|
1263 | + $sql .= ' WHERE '.$filterString; |
|
1264 | + $countSql .= ' WHERE '.$filterString; |
|
1265 | + } |
|
1266 | + |
|
1267 | + if (!empty($orderString)) { |
|
1268 | + $sql .= ' ORDER BY '.$orderString; |
|
1269 | + $countSql .= ' ORDER BY '.$orderString; |
|
1270 | + } |
|
1271 | + |
|
1272 | + if ($mode !== null && $mode !== self::MODE_CURSOR && $mode !== self::MODE_ARRAY) { |
|
1273 | + throw new TDBMException("Unknown fetch mode: '".$this->mode."'"); |
|
1274 | + } |
|
1275 | + |
|
1276 | + $mode = $mode ?: $this->mode; |
|
1277 | + |
|
1278 | + return new ResultIterator($sql, $countSql, $parameters, $columnDescList, $this->objectStorage, $className, $this, $this->magicQuery, $mode); |
|
1279 | + } |
|
1280 | + |
|
1281 | + /** |
|
1282 | + * @param $table |
|
1283 | + * @param array $primaryKeys |
|
1284 | + * @param array $additionalTablesFetch |
|
1285 | + * @param bool $lazy Whether to perform lazy loading on this object or not. |
|
1286 | + * @param string $className |
|
1287 | + * |
|
1288 | + * @return AbstractTDBMObject |
|
1289 | + * |
|
1290 | + * @throws TDBMException |
|
1291 | + */ |
|
1292 | + public function findObjectByPk($table, array $primaryKeys, array $additionalTablesFetch = array(), $lazy = false, $className = null) |
|
1293 | + { |
|
1294 | + $primaryKeys = $this->_getPrimaryKeysFromObjectData($table, $primaryKeys); |
|
1295 | + $hash = $this->getObjectHash($primaryKeys); |
|
1296 | + |
|
1297 | + if ($this->objectStorage->has($table, $hash)) { |
|
1298 | + $dbRow = $this->objectStorage->get($table, $hash); |
|
1299 | + $bean = $dbRow->getTDBMObject(); |
|
1300 | + if ($className !== null && !is_a($bean, $className)) { |
|
1301 | + throw new TDBMException("TDBM cannot create a bean of class '".$className."'. The requested object was already loaded and its class is '".get_class($bean)."'"); |
|
1302 | + } |
|
1303 | + |
|
1304 | + return $bean; |
|
1305 | + } |
|
1306 | + |
|
1307 | + // Are we performing lazy fetching? |
|
1308 | + if ($lazy === true) { |
|
1309 | + // Can we perform lazy fetching? |
|
1310 | + $tables = $this->_getRelatedTablesByInheritance($table); |
|
1311 | + // Only allowed if no inheritance. |
|
1312 | + if (count($tables) === 1) { |
|
1313 | + if ($className === null) { |
|
1314 | + $className = isset($this->tableToBeanMap[$table]) ? $this->tableToBeanMap[$table] : 'Mouf\\Database\\TDBM\\TDBMObject'; |
|
1315 | + } |
|
1316 | + |
|
1317 | + // Let's construct the bean |
|
1318 | + if (!isset($this->reflectionClassCache[$className])) { |
|
1319 | + $this->reflectionClassCache[$className] = new \ReflectionClass($className); |
|
1320 | + } |
|
1321 | + // Let's bypass the constructor when creating the bean! |
|
1322 | + $bean = $this->reflectionClassCache[$className]->newInstanceWithoutConstructor(); |
|
1323 | + /* @var $bean AbstractTDBMObject */ |
|
1324 | + $bean->_constructLazy($table, $primaryKeys, $this); |
|
1325 | + |
|
1326 | + return $bean; |
|
1327 | + } |
|
1328 | + } |
|
1329 | + |
|
1330 | + // Did not find the object in cache? Let's query it! |
|
1331 | + return $this->findObjectOrFail($table, $primaryKeys, [], $additionalTablesFetch, $className); |
|
1332 | + } |
|
1333 | + |
|
1334 | + /** |
|
1335 | + * Returns a unique bean (or null) according to the filters passed in parameter. |
|
1336 | + * |
|
1337 | + * @param string $mainTable The name of the table queried |
|
1338 | + * @param string|array|null $filter The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column) |
|
1339 | + * @param array $parameters |
|
1340 | + * @param array $additionalTablesFetch |
|
1341 | + * @param string $className Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned. |
|
1342 | + * |
|
1343 | + * @return AbstractTDBMObject|null The object we want, or null if no object matches the filters. |
|
1344 | + * |
|
1345 | + * @throws TDBMException |
|
1346 | + */ |
|
1347 | + public function findObject($mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), $className = null) |
|
1348 | + { |
|
1349 | + $objects = $this->findObjects($mainTable, $filter, $parameters, null, $additionalTablesFetch, self::MODE_ARRAY, $className); |
|
1350 | + $page = $objects->take(0, 2); |
|
1351 | + $count = $page->count(); |
|
1352 | + if ($count > 1) { |
|
1353 | + throw new DuplicateRowException("Error while querying an object for table '$mainTable': More than 1 row have been returned, but we should have received at most one."); |
|
1354 | + } elseif ($count === 0) { |
|
1355 | + return; |
|
1356 | + } |
|
1357 | + |
|
1358 | + return $objects[0]; |
|
1359 | + } |
|
1360 | + |
|
1361 | + /** |
|
1362 | + * Returns a unique bean according to the filters passed in parameter. |
|
1363 | + * Throws a NoBeanFoundException if no bean was found for the filter passed in parameter. |
|
1364 | + * |
|
1365 | + * @param string $mainTable The name of the table queried |
|
1366 | + * @param string|array|null $filter The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column) |
|
1367 | + * @param array $parameters |
|
1368 | + * @param array $additionalTablesFetch |
|
1369 | + * @param string $className Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned. |
|
1370 | + * |
|
1371 | + * @return AbstractTDBMObject The object we want |
|
1372 | + * |
|
1373 | + * @throws TDBMException |
|
1374 | + */ |
|
1375 | + public function findObjectOrFail($mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), $className = null) |
|
1376 | + { |
|
1377 | + $bean = $this->findObject($mainTable, $filter, $parameters, $additionalTablesFetch, $className); |
|
1378 | + if ($bean === null) { |
|
1379 | + throw new NoBeanFoundException("No result found for query on table '".$mainTable."'"); |
|
1380 | + } |
|
1381 | + |
|
1382 | + return $bean; |
|
1383 | + } |
|
1384 | + |
|
1385 | + /** |
|
1386 | + * @param array $beanData An array of data: array<table, array<column, value>> |
|
1387 | + * |
|
1388 | + * @return array an array with first item = class name and second item = table name |
|
1389 | + */ |
|
1390 | + public function _getClassNameFromBeanData(array $beanData) |
|
1391 | + { |
|
1392 | + if (count($beanData) === 1) { |
|
1393 | + $tableName = array_keys($beanData)[0]; |
|
1394 | + } else { |
|
1395 | + $tables = []; |
|
1396 | + foreach ($beanData as $table => $row) { |
|
1397 | + $primaryKeyColumns = $this->getPrimaryKeyColumns($table); |
|
1398 | + $pkSet = false; |
|
1399 | + foreach ($primaryKeyColumns as $columnName) { |
|
1400 | + if ($row[$columnName] !== null) { |
|
1401 | + $pkSet = true; |
|
1402 | + break; |
|
1403 | + } |
|
1404 | + } |
|
1405 | + if ($pkSet) { |
|
1406 | + $tables[] = $table; |
|
1407 | + } |
|
1408 | + } |
|
1409 | + |
|
1410 | + // $tables contains the tables for this bean. Let's view the top most part of the hierarchy |
|
1411 | + $allTables = $this->_getLinkBetweenInheritedTables($tables); |
|
1412 | + $tableName = $allTables[0]; |
|
1413 | + } |
|
1414 | + |
|
1415 | + // Only one table in this bean. Life is sweat, let's look at its type: |
|
1416 | + if (isset($this->tableToBeanMap[$tableName])) { |
|
1417 | + return [$this->tableToBeanMap[$tableName], $tableName]; |
|
1418 | + } else { |
|
1419 | + return ['Mouf\\Database\\TDBM\\TDBMObject', $tableName]; |
|
1420 | + } |
|
1421 | + } |
|
1422 | + |
|
1423 | + /** |
|
1424 | + * Returns an item from cache or computes it using $closure and puts it in cache. |
|
1425 | + * |
|
1426 | + * @param string $key |
|
1427 | + * @param callable $closure |
|
1428 | + * |
|
1429 | + * @return mixed |
|
1430 | + */ |
|
1431 | + private function fromCache($key, callable $closure) |
|
1432 | + { |
|
1433 | + $item = $this->cache->fetch($key); |
|
1434 | + if ($item === false) { |
|
1435 | + $item = $closure(); |
|
1436 | + $this->cache->save($key, $item); |
|
1437 | + } |
|
1438 | + |
|
1439 | + return $item; |
|
1440 | + } |
|
1441 | + |
|
1442 | + /** |
|
1443 | + * Returns the foreign key object. |
|
1444 | + * |
|
1445 | + * @param string $table |
|
1446 | + * @param string $fkName |
|
1447 | + * |
|
1448 | + * @return ForeignKeyConstraint |
|
1449 | + */ |
|
1450 | + public function _getForeignKeyByName($table, $fkName) |
|
1451 | + { |
|
1452 | + return $this->tdbmSchemaAnalyzer->getSchema()->getTable($table)->getForeignKey($fkName); |
|
1453 | + } |
|
1454 | + |
|
1455 | + /** |
|
1456 | + * @param $pivotTableName |
|
1457 | + * @param AbstractTDBMObject $bean |
|
1458 | + * |
|
1459 | + * @return AbstractTDBMObject[] |
|
1460 | + */ |
|
1461 | + public function _getRelatedBeans($pivotTableName, AbstractTDBMObject $bean) |
|
1462 | + { |
|
1463 | + list($localFk, $remoteFk) = $this->getPivotTableForeignKeys($pivotTableName, $bean); |
|
1464 | + /* @var $localFk ForeignKeyConstraint */ |
|
1465 | + /* @var $remoteFk ForeignKeyConstraint */ |
|
1466 | + $remoteTable = $remoteFk->getForeignTableName(); |
|
1467 | + |
|
1468 | + $primaryKeys = $this->getPrimaryKeyValues($bean); |
|
1469 | + $columnNames = array_map(function ($name) use ($pivotTableName) { return $pivotTableName.'.'.$name; }, $localFk->getLocalColumns()); |
|
1470 | + |
|
1471 | + $filter = array_combine($columnNames, $primaryKeys); |
|
1472 | + |
|
1473 | + return $this->findObjects($remoteTable, $filter); |
|
1474 | + } |
|
1475 | + |
|
1476 | + /** |
|
1477 | + * @param $pivotTableName |
|
1478 | + * @param AbstractTDBMObject $bean The LOCAL bean |
|
1479 | + * |
|
1480 | + * @return ForeignKeyConstraint[] First item: the LOCAL bean, second item: the REMOTE bean. |
|
1481 | + * |
|
1482 | + * @throws TDBMException |
|
1483 | + */ |
|
1484 | + private function getPivotTableForeignKeys($pivotTableName, AbstractTDBMObject $bean) |
|
1485 | + { |
|
1486 | + $fks = array_values($this->tdbmSchemaAnalyzer->getSchema()->getTable($pivotTableName)->getForeignKeys()); |
|
1487 | + $table1 = $fks[0]->getForeignTableName(); |
|
1488 | + $table2 = $fks[1]->getForeignTableName(); |
|
1489 | + |
|
1490 | + $beanTables = array_map(function (DbRow $dbRow) { return $dbRow->_getDbTableName(); }, $bean->_getDbRows()); |
|
1491 | + |
|
1492 | + if (in_array($table1, $beanTables)) { |
|
1493 | + return [$fks[0], $fks[1]]; |
|
1494 | + } elseif (in_array($table2, $beanTables)) { |
|
1495 | + return [$fks[1], $fks[0]]; |
|
1496 | + } else { |
|
1497 | + throw new TDBMException("Unexpected bean type in getPivotTableForeignKeys. Awaiting beans from table {$table1} and {$table2} for pivot table {$pivotTableName}"); |
|
1498 | + } |
|
1499 | + } |
|
1500 | + |
|
1501 | + /** |
|
1502 | + * Returns a list of pivot tables linked to $bean. |
|
1503 | + * |
|
1504 | + * @param AbstractTDBMObject $bean |
|
1505 | + * |
|
1506 | + * @return string[] |
|
1507 | + */ |
|
1508 | + public function _getPivotTablesLinkedToBean(AbstractTDBMObject $bean) |
|
1509 | + { |
|
1510 | + $junctionTables = []; |
|
1511 | + $allJunctionTables = $this->schemaAnalyzer->detectJunctionTables(true); |
|
1512 | + foreach ($bean->_getDbRows() as $dbRow) { |
|
1513 | + foreach ($allJunctionTables as $table) { |
|
1514 | + // There are exactly 2 FKs since this is a pivot table. |
|
1515 | + $fks = array_values($table->getForeignKeys()); |
|
1516 | + |
|
1517 | + if ($fks[0]->getForeignTableName() === $dbRow->_getDbTableName() || $fks[1]->getForeignTableName() === $dbRow->_getDbTableName()) { |
|
1518 | + $junctionTables[] = $table->getName(); |
|
1519 | + } |
|
1520 | + } |
|
1521 | + } |
|
1522 | + |
|
1523 | + return $junctionTables; |
|
1524 | + } |
|
1525 | + |
|
1526 | + /** |
|
1527 | + * Array of types for tables. |
|
1528 | + * Key: table name |
|
1529 | + * Value: array of types indexed by column. |
|
1530 | + * |
|
1531 | + * @var array[] |
|
1532 | + */ |
|
1533 | + private $typesForTable = []; |
|
1534 | + |
|
1535 | + /** |
|
1536 | + * @internal |
|
1537 | + * |
|
1538 | + * @param string $tableName |
|
1539 | + * |
|
1540 | + * @return Type[] |
|
1541 | + */ |
|
1542 | + public function _getColumnTypesForTable($tableName) |
|
1543 | + { |
|
1544 | + if (!isset($typesForTable[$tableName])) { |
|
1545 | + $columns = $this->tdbmSchemaAnalyzer->getSchema()->getTable($tableName)->getColumns(); |
|
1546 | + $typesForTable[$tableName] = array_map(function (Column $column) { |
|
1547 | + return $column->getType(); |
|
1548 | + }, $columns); |
|
1549 | + } |
|
1550 | + |
|
1551 | + return $typesForTable[$tableName]; |
|
1552 | + } |
|
1553 | 1553 | } |
@@ -9,91 +9,91 @@ |
||
9 | 9 | */ |
10 | 10 | class MapIterator implements Iterator, \JsonSerializable |
11 | 11 | { |
12 | - /** |
|
13 | - * @var Iterator |
|
14 | - */ |
|
15 | - protected $iterator; |
|
12 | + /** |
|
13 | + * @var Iterator |
|
14 | + */ |
|
15 | + protected $iterator; |
|
16 | 16 | |
17 | - /** |
|
18 | - * @var callable Modifies the current item in iterator |
|
19 | - */ |
|
20 | - protected $callable; |
|
17 | + /** |
|
18 | + * @var callable Modifies the current item in iterator |
|
19 | + */ |
|
20 | + protected $callable; |
|
21 | 21 | |
22 | - /** |
|
23 | - * @param $iterator Iterator|array |
|
24 | - * @param $callable callable This can have two parameters |
|
25 | - * |
|
26 | - * @throws TDBMException |
|
27 | - */ |
|
28 | - public function __construct($iterator, callable $callable) |
|
29 | - { |
|
30 | - if (is_array($iterator)) { |
|
31 | - $this->iterator = new \ArrayIterator($iterator); |
|
32 | - } elseif (!($iterator instanceof Iterator)) { |
|
33 | - throw new TDBMException('$iterator parameter must be an instance of Iterator'); |
|
34 | - } else { |
|
35 | - $this->iterator = $iterator; |
|
36 | - } |
|
22 | + /** |
|
23 | + * @param $iterator Iterator|array |
|
24 | + * @param $callable callable This can have two parameters |
|
25 | + * |
|
26 | + * @throws TDBMException |
|
27 | + */ |
|
28 | + public function __construct($iterator, callable $callable) |
|
29 | + { |
|
30 | + if (is_array($iterator)) { |
|
31 | + $this->iterator = new \ArrayIterator($iterator); |
|
32 | + } elseif (!($iterator instanceof Iterator)) { |
|
33 | + throw new TDBMException('$iterator parameter must be an instance of Iterator'); |
|
34 | + } else { |
|
35 | + $this->iterator = $iterator; |
|
36 | + } |
|
37 | 37 | |
38 | - if ($callable instanceof \Closure) { |
|
39 | - // make sure there's one argument |
|
40 | - $reflection = new \ReflectionObject($callable); |
|
41 | - if ($reflection->hasMethod('__invoke')) { |
|
42 | - $method = $reflection->getMethod('__invoke'); |
|
43 | - if ($method->getNumberOfParameters() !== 1) { |
|
44 | - throw new TDBMException('$callable must accept one and only one parameter.'); |
|
45 | - } |
|
46 | - } |
|
47 | - } |
|
38 | + if ($callable instanceof \Closure) { |
|
39 | + // make sure there's one argument |
|
40 | + $reflection = new \ReflectionObject($callable); |
|
41 | + if ($reflection->hasMethod('__invoke')) { |
|
42 | + $method = $reflection->getMethod('__invoke'); |
|
43 | + if ($method->getNumberOfParameters() !== 1) { |
|
44 | + throw new TDBMException('$callable must accept one and only one parameter.'); |
|
45 | + } |
|
46 | + } |
|
47 | + } |
|
48 | 48 | |
49 | - $this->callable = $callable; |
|
50 | - } |
|
49 | + $this->callable = $callable; |
|
50 | + } |
|
51 | 51 | |
52 | - /** |
|
53 | - * Alters the current item with $this->callable and returns a new item. |
|
54 | - * Be careful with your types as we can't do static type checking here! |
|
55 | - * |
|
56 | - * @return mixed |
|
57 | - */ |
|
58 | - public function current() |
|
59 | - { |
|
60 | - $callable = $this->callable; |
|
52 | + /** |
|
53 | + * Alters the current item with $this->callable and returns a new item. |
|
54 | + * Be careful with your types as we can't do static type checking here! |
|
55 | + * |
|
56 | + * @return mixed |
|
57 | + */ |
|
58 | + public function current() |
|
59 | + { |
|
60 | + $callable = $this->callable; |
|
61 | 61 | |
62 | - return $callable($this->iterator->current()); |
|
63 | - } |
|
62 | + return $callable($this->iterator->current()); |
|
63 | + } |
|
64 | 64 | |
65 | - public function next() |
|
66 | - { |
|
67 | - $this->iterator->next(); |
|
68 | - } |
|
65 | + public function next() |
|
66 | + { |
|
67 | + $this->iterator->next(); |
|
68 | + } |
|
69 | 69 | |
70 | - public function key() |
|
71 | - { |
|
72 | - return $this->iterator->key(); |
|
73 | - } |
|
70 | + public function key() |
|
71 | + { |
|
72 | + return $this->iterator->key(); |
|
73 | + } |
|
74 | 74 | |
75 | - public function valid() |
|
76 | - { |
|
77 | - return $this->iterator->valid(); |
|
78 | - } |
|
75 | + public function valid() |
|
76 | + { |
|
77 | + return $this->iterator->valid(); |
|
78 | + } |
|
79 | 79 | |
80 | - public function rewind() |
|
81 | - { |
|
82 | - $this->iterator->rewind(); |
|
83 | - } |
|
80 | + public function rewind() |
|
81 | + { |
|
82 | + $this->iterator->rewind(); |
|
83 | + } |
|
84 | 84 | |
85 | - /** |
|
86 | - * Casts the iterator to a PHP array. |
|
87 | - * |
|
88 | - * @return array |
|
89 | - */ |
|
90 | - public function toArray() |
|
91 | - { |
|
92 | - return iterator_to_array($this); |
|
93 | - } |
|
85 | + /** |
|
86 | + * Casts the iterator to a PHP array. |
|
87 | + * |
|
88 | + * @return array |
|
89 | + */ |
|
90 | + public function toArray() |
|
91 | + { |
|
92 | + return iterator_to_array($this); |
|
93 | + } |
|
94 | 94 | |
95 | - public function jsonSerialize() |
|
96 | - { |
|
97 | - return $this->toArray(); |
|
98 | - } |
|
95 | + public function jsonSerialize() |
|
96 | + { |
|
97 | + return $this->toArray(); |
|
98 | + } |
|
99 | 99 | } |