thecodingmachine /
tdbm
Complex classes like TDBMService often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use TDBMService, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 54 | class TDBMService |
||
| 55 | { |
||
| 56 | const MODE_CURSOR = 1; |
||
| 57 | const MODE_ARRAY = 2; |
||
| 58 | |||
| 59 | /** |
||
| 60 | * The database connection. |
||
| 61 | * |
||
| 62 | * @var Connection |
||
| 63 | */ |
||
| 64 | private $connection; |
||
| 65 | |||
| 66 | /** |
||
| 67 | * @var SchemaAnalyzer |
||
| 68 | */ |
||
| 69 | private $schemaAnalyzer; |
||
| 70 | |||
| 71 | /** |
||
| 72 | * @var MagicQuery |
||
| 73 | */ |
||
| 74 | private $magicQuery; |
||
| 75 | |||
| 76 | /** |
||
| 77 | * @var TDBMSchemaAnalyzer |
||
| 78 | */ |
||
| 79 | private $tdbmSchemaAnalyzer; |
||
| 80 | |||
| 81 | /** |
||
| 82 | * @var string |
||
| 83 | */ |
||
| 84 | private $cachePrefix; |
||
| 85 | |||
| 86 | /** |
||
| 87 | * Cache of table of primary keys. |
||
| 88 | * Primary keys are stored by tables, as an array of column. |
||
| 89 | * For instance $primary_key['my_table'][0] will return the first column of the primary key of table 'my_table'. |
||
| 90 | * |
||
| 91 | * @var string[] |
||
| 92 | */ |
||
| 93 | private $primaryKeysColumns; |
||
| 94 | |||
| 95 | /** |
||
| 96 | * Service storing objects in memory. |
||
| 97 | * Access is done by table name and then by primary key. |
||
| 98 | * If the primary key is split on several columns, access is done by an array of columns, serialized. |
||
| 99 | * |
||
| 100 | * @var StandardObjectStorage|WeakrefObjectStorage |
||
| 101 | */ |
||
| 102 | private $objectStorage; |
||
| 103 | |||
| 104 | /** |
||
| 105 | * The fetch mode of the result sets returned by `getObjects`. |
||
| 106 | * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY or TDBMObjectArray::MODE_COMPATIBLE_ARRAY. |
||
| 107 | * |
||
| 108 | * In 'MODE_ARRAY' mode (default), the result is an array. Use this mode by default (unless the list returned is very big). |
||
| 109 | * 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, |
||
| 110 | * and it cannot be accessed via key. Use this mode for large datasets processed by batch. |
||
| 111 | * In 'MODE_COMPATIBLE_ARRAY' mode, the result is an old TDBMObjectArray (used up to TDBM 3.2). |
||
| 112 | * You can access the array by key, or using foreach, several times. |
||
| 113 | * |
||
| 114 | * @var int |
||
| 115 | */ |
||
| 116 | private $mode = self::MODE_ARRAY; |
||
| 117 | |||
| 118 | /** |
||
| 119 | * Table of new objects not yet inserted in database or objects modified that must be saved. |
||
| 120 | * |
||
| 121 | * @var \SplObjectStorage of DbRow objects |
||
| 122 | */ |
||
| 123 | private $toSaveObjects; |
||
| 124 | |||
| 125 | /** |
||
| 126 | * A cache service to be used. |
||
| 127 | * |
||
| 128 | * @var Cache|null |
||
| 129 | */ |
||
| 130 | private $cache; |
||
| 131 | |||
| 132 | /** |
||
| 133 | * Map associating a table name to a fully qualified Bean class name. |
||
| 134 | * |
||
| 135 | * @var array |
||
| 136 | */ |
||
| 137 | private $tableToBeanMap = []; |
||
| 138 | |||
| 139 | /** |
||
| 140 | * @var \ReflectionClass[] |
||
| 141 | */ |
||
| 142 | private $reflectionClassCache = array(); |
||
| 143 | |||
| 144 | /** |
||
| 145 | * @var LoggerInterface |
||
| 146 | */ |
||
| 147 | private $rootLogger; |
||
| 148 | |||
| 149 | /** |
||
| 150 | * @var LevelFilter|NullLogger |
||
| 151 | */ |
||
| 152 | private $logger; |
||
| 153 | |||
| 154 | /** |
||
| 155 | * @var OrderByAnalyzer |
||
| 156 | */ |
||
| 157 | private $orderByAnalyzer; |
||
| 158 | |||
| 159 | /** |
||
| 160 | * @var string |
||
| 161 | */ |
||
| 162 | private $beanNamespace; |
||
| 163 | |||
| 164 | /** |
||
| 165 | * @var NamingStrategyInterface |
||
| 166 | */ |
||
| 167 | private $namingStrategy; |
||
| 168 | /** |
||
| 169 | * @var ConfigurationInterface |
||
| 170 | */ |
||
| 171 | private $configuration; |
||
| 172 | |||
| 173 | /** |
||
| 174 | * @param ConfigurationInterface $configuration The configuration object |
||
| 175 | */ |
||
| 176 | public function __construct(ConfigurationInterface $configuration) |
||
| 206 | |||
| 207 | /** |
||
| 208 | * Returns the object used to connect to the database. |
||
| 209 | * |
||
| 210 | * @return Connection |
||
| 211 | */ |
||
| 212 | public function getConnection(): Connection |
||
| 216 | |||
| 217 | /** |
||
| 218 | * Sets the default fetch mode of the result sets returned by `findObjects`. |
||
| 219 | * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY. |
||
| 220 | * |
||
| 221 | * 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). |
||
| 222 | * 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 |
||
| 223 | * several times. In cursor mode, you cannot access the result set by key. Use this mode for large datasets processed by batch. |
||
| 224 | * |
||
| 225 | * @param int $mode |
||
| 226 | * |
||
| 227 | * @return $this |
||
| 228 | * |
||
| 229 | * @throws TDBMException |
||
| 230 | */ |
||
| 231 | public function setFetchMode($mode) |
||
| 240 | |||
| 241 | /** |
||
| 242 | * Removes the given object from database. |
||
| 243 | * This cannot be called on an object that is not attached to this TDBMService |
||
| 244 | * (will throw a TDBMInvalidOperationException). |
||
| 245 | * |
||
| 246 | * @param AbstractTDBMObject $object the object to delete |
||
| 247 | * |
||
| 248 | * @throws DBALException |
||
| 249 | * @throws TDBMInvalidOperationException |
||
| 250 | */ |
||
| 251 | public function delete(AbstractTDBMObject $object) |
||
| 302 | |||
| 303 | /** |
||
| 304 | * Removes all many to many relationships for this object. |
||
| 305 | * |
||
| 306 | * @param AbstractTDBMObject $object |
||
| 307 | */ |
||
| 308 | private function deleteManyToManyRelationships(AbstractTDBMObject $object) |
||
| 321 | |||
| 322 | /** |
||
| 323 | * This function removes the given object from the database. It will also remove all objects relied to the one given |
||
| 324 | * by parameter before all. |
||
| 325 | * |
||
| 326 | * Notice: if the object has a multiple primary key, the function will not work. |
||
| 327 | * |
||
| 328 | * @param AbstractTDBMObject $objToDelete |
||
| 329 | */ |
||
| 330 | public function deleteCascade(AbstractTDBMObject $objToDelete) |
||
| 335 | |||
| 336 | /** |
||
| 337 | * This function is used only in TDBMService (private function) |
||
| 338 | * It will call deleteCascade function foreach object relied with a foreign key to the object given by parameter. |
||
| 339 | * |
||
| 340 | * @param AbstractTDBMObject $obj |
||
| 341 | */ |
||
| 342 | private function deleteAllConstraintWithThisObject(AbstractTDBMObject $obj) |
||
| 363 | |||
| 364 | /** |
||
| 365 | * This function performs a save() of all the objects that have been modified. |
||
| 366 | */ |
||
| 367 | public function completeSave() |
||
| 373 | |||
| 374 | /** |
||
| 375 | * Takes in input a filter_bag (which can be about anything from a string to an array of TDBMObjects... see above from documentation), |
||
| 376 | * and gives back a proper Filter object. |
||
| 377 | * |
||
| 378 | * @param mixed $filter_bag |
||
| 379 | * @param AbstractPlatform $platform The platform used to quote identifiers |
||
| 380 | * @param int $counter |
||
| 381 | * @return array First item: filter string, second item: parameters |
||
| 382 | * |
||
| 383 | * @throws TDBMException |
||
| 384 | */ |
||
| 385 | public function buildFilterFromFilterBag($filter_bag, AbstractPlatform $platform, $counter = 1) |
||
| 434 | |||
| 435 | /** |
||
| 436 | * @param string $table |
||
| 437 | * |
||
| 438 | * @return string[] |
||
| 439 | */ |
||
| 440 | public function getPrimaryKeyColumns($table) |
||
| 472 | |||
| 473 | /** |
||
| 474 | * This is an internal function, you should not use it in your application. |
||
| 475 | * This is used internally by TDBM to add an object to the object cache. |
||
| 476 | * |
||
| 477 | * @param DbRow $dbRow |
||
| 478 | */ |
||
| 479 | public function _addToCache(DbRow $dbRow) |
||
| 485 | |||
| 486 | /** |
||
| 487 | * This is an internal function, you should not use it in your application. |
||
| 488 | * This is used internally by TDBM to remove the object from the list of objects that have been |
||
| 489 | * created/updated but not saved yet. |
||
| 490 | * |
||
| 491 | * @param DbRow $myObject |
||
| 492 | */ |
||
| 493 | private function removeFromToSaveObjectList(DbRow $myObject) |
||
| 497 | |||
| 498 | /** |
||
| 499 | * This is an internal function, you should not use it in your application. |
||
| 500 | * This is used internally by TDBM to add an object to the list of objects that have been |
||
| 501 | * created/updated but not saved yet. |
||
| 502 | * |
||
| 503 | * @param DbRow $myObject |
||
| 504 | */ |
||
| 505 | public function _addToToSaveObjectList(DbRow $myObject) |
||
| 509 | |||
| 510 | /** |
||
| 511 | * Generates all the daos and beans. |
||
| 512 | * |
||
| 513 | * @return \string[] the list of tables (key) and bean name (value) |
||
| 514 | */ |
||
| 515 | public function generateAllDaosAndBeans() |
||
| 523 | |||
| 524 | /** |
||
| 525 | * Returns the fully qualified class name of the bean associated with table $tableName. |
||
| 526 | * |
||
| 527 | * |
||
| 528 | * @param string $tableName |
||
| 529 | * |
||
| 530 | * @return string |
||
| 531 | */ |
||
| 532 | public function getBeanClassName(string $tableName) : string |
||
| 547 | |||
| 548 | /** |
||
| 549 | * Saves $object by INSERTing or UPDAT(E)ing it in the database. |
||
| 550 | * |
||
| 551 | * @param AbstractTDBMObject $object |
||
| 552 | * |
||
| 553 | * @throws TDBMException |
||
| 554 | */ |
||
| 555 | public function save(AbstractTDBMObject $object) |
||
| 749 | |||
| 750 | private function persistManyToManyRelationships(AbstractTDBMObject $object) |
||
| 804 | |||
| 805 | private function getPivotFilters(AbstractTDBMObject $localBean, AbstractTDBMObject $remoteBean, ForeignKeyConstraint $localFk, ForeignKeyConstraint $remoteFk, Table $tableDescriptor) |
||
| 827 | |||
| 828 | /** |
||
| 829 | * Returns the "values" of the primary key. |
||
| 830 | * This returns the primary key from the $primaryKey attribute, not the one stored in the columns. |
||
| 831 | * |
||
| 832 | * @param AbstractTDBMObject $bean |
||
| 833 | * |
||
| 834 | * @return array numerically indexed array of values |
||
| 835 | */ |
||
| 836 | private function getPrimaryKeyValues(AbstractTDBMObject $bean) |
||
| 843 | |||
| 844 | /** |
||
| 845 | * Returns a unique hash used to store the object based on its primary key. |
||
| 846 | * If the array contains only one value, then the value is returned. |
||
| 847 | * Otherwise, a hash representing the array is returned. |
||
| 848 | * |
||
| 849 | * @param array $primaryKeys An array of columns => values forming the primary key |
||
| 850 | * |
||
| 851 | * @return string |
||
| 852 | */ |
||
| 853 | public function getObjectHash(array $primaryKeys) |
||
| 863 | |||
| 864 | /** |
||
| 865 | * Returns an array of primary keys from the object. |
||
| 866 | * The primary keys are extracted from the object columns and not from the primary keys stored in the |
||
| 867 | * $primaryKeys variable of the object. |
||
| 868 | * |
||
| 869 | * @param DbRow $dbRow |
||
| 870 | * |
||
| 871 | * @return array Returns an array of column => value |
||
| 872 | */ |
||
| 873 | public function getPrimaryKeysForObjectFromDbRow(DbRow $dbRow) |
||
| 880 | |||
| 881 | /** |
||
| 882 | * Returns an array of primary keys for the given row. |
||
| 883 | * The primary keys are extracted from the object columns. |
||
| 884 | * |
||
| 885 | * @param $table |
||
| 886 | * @param array $columns |
||
| 887 | * |
||
| 888 | * @return array |
||
| 889 | */ |
||
| 890 | public function _getPrimaryKeysFromObjectData($table, array $columns) |
||
| 902 | |||
| 903 | /** |
||
| 904 | * Attaches $object to this TDBMService. |
||
| 905 | * The $object must be in DETACHED state and will pass in NEW state. |
||
| 906 | * |
||
| 907 | * @param AbstractTDBMObject $object |
||
| 908 | * |
||
| 909 | * @throws TDBMInvalidOperationException |
||
| 910 | */ |
||
| 911 | public function attach(AbstractTDBMObject $object) |
||
| 915 | |||
| 916 | /** |
||
| 917 | * Returns an associative array (column => value) for the primary keys from the table name and an |
||
| 918 | * indexed array of primary key values. |
||
| 919 | * |
||
| 920 | * @param string $tableName |
||
| 921 | * @param array $indexedPrimaryKeys |
||
| 922 | */ |
||
| 923 | public function _getPrimaryKeysFromIndexedPrimaryKeys($tableName, array $indexedPrimaryKeys) |
||
| 934 | |||
| 935 | /** |
||
| 936 | * Return the list of tables (from child to parent) joining the tables passed in parameter. |
||
| 937 | * Tables must be in a single line of inheritance. The method will find missing tables. |
||
| 938 | * |
||
| 939 | * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent, |
||
| 940 | * we must be able to find all other tables. |
||
| 941 | * |
||
| 942 | * @param string[] $tables |
||
| 943 | * |
||
| 944 | * @return string[] |
||
| 945 | */ |
||
| 946 | public function _getLinkBetweenInheritedTables(array $tables) |
||
| 957 | |||
| 958 | /** |
||
| 959 | * Return the list of tables (from child to parent) joining the tables passed in parameter. |
||
| 960 | * Tables must be in a single line of inheritance. The method will find missing tables. |
||
| 961 | * |
||
| 962 | * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent, |
||
| 963 | * we must be able to find all other tables. |
||
| 964 | * |
||
| 965 | * @param string[] $tables |
||
| 966 | * |
||
| 967 | * @return string[] |
||
| 968 | */ |
||
| 969 | private function _getLinkBetweenInheritedTablesWithoutCache(array $tables) |
||
| 990 | |||
| 991 | /** |
||
| 992 | * Returns the list of tables related to this table (via a parent or child inheritance relationship). |
||
| 993 | * |
||
| 994 | * @param string $table |
||
| 995 | * |
||
| 996 | * @return string[] |
||
| 997 | */ |
||
| 998 | public function _getRelatedTablesByInheritance($table) |
||
| 1004 | |||
| 1005 | /** |
||
| 1006 | * Returns the list of tables related to this table (via a parent or child inheritance relationship). |
||
| 1007 | * |
||
| 1008 | * @param string $table |
||
| 1009 | * |
||
| 1010 | * @return string[] |
||
| 1011 | */ |
||
| 1012 | private function _getRelatedTablesByInheritanceWithoutCache($table) |
||
| 1032 | |||
| 1033 | /** |
||
| 1034 | * Explore all the children and descendant of $table and returns ForeignKeyConstraints on those. |
||
| 1035 | * |
||
| 1036 | * @param string $table |
||
| 1037 | * |
||
| 1038 | * @return string[] |
||
| 1039 | */ |
||
| 1040 | private function exploreChildrenTablesRelationships(SchemaAnalyzer $schemaAnalyzer, $table) |
||
| 1051 | |||
| 1052 | /** |
||
| 1053 | * Casts a foreign key into SQL, assuming table name is used with no alias. |
||
| 1054 | * The returned value does contain only one table. For instance:. |
||
| 1055 | * |
||
| 1056 | * " LEFT JOIN table2 ON table1.id = table2.table1_id" |
||
| 1057 | * |
||
| 1058 | * @param ForeignKeyConstraint $fk |
||
| 1059 | * @param bool $leftTableIsLocal |
||
| 1060 | * |
||
| 1061 | * @return string |
||
| 1062 | */ |
||
| 1063 | /*private function foreignKeyToSql(ForeignKeyConstraint $fk, $leftTableIsLocal) { |
||
| 1064 | $onClauses = []; |
||
| 1065 | $foreignTableName = $this->connection->quoteIdentifier($fk->getForeignTableName()); |
||
| 1066 | $foreignColumns = $fk->getUnquotedForeignColumns(); |
||
| 1067 | $localTableName = $this->connection->quoteIdentifier($fk->getLocalTableName()); |
||
| 1068 | $localColumns = $fk->getUnquotedLocalColumns(); |
||
| 1069 | $columnCount = count($localTableName); |
||
| 1070 | |||
| 1071 | for ($i = 0; $i < $columnCount; $i++) { |
||
| 1072 | $onClauses[] = sprintf("%s.%s = %s.%s", |
||
| 1073 | $localTableName, |
||
| 1074 | $this->connection->quoteIdentifier($localColumns[$i]), |
||
| 1075 | $foreignColumns, |
||
| 1076 | $this->connection->quoteIdentifier($foreignColumns[$i]) |
||
| 1077 | ); |
||
| 1078 | } |
||
| 1079 | |||
| 1080 | $onClause = implode(' AND ', $onClauses); |
||
| 1081 | |||
| 1082 | if ($leftTableIsLocal) { |
||
| 1083 | return sprintf(" LEFT JOIN %s ON (%s)", $foreignTableName, $onClause); |
||
| 1084 | } else { |
||
| 1085 | return sprintf(" LEFT JOIN %s ON (%s)", $localTableName, $onClause); |
||
| 1086 | } |
||
| 1087 | }*/ |
||
| 1088 | |||
| 1089 | /** |
||
| 1090 | * Returns a `ResultIterator` object representing filtered records of "$mainTable" . |
||
| 1091 | * |
||
| 1092 | * The findObjects method should be the most used query method in TDBM if you want to query the database for objects. |
||
| 1093 | * (Note: if you want to query the database for an object by its primary key, use the findObjectByPk method). |
||
| 1094 | * |
||
| 1095 | * The findObjects method takes in parameter: |
||
| 1096 | * - mainTable: the kind of bean you want to retrieve. In TDBM, a bean matches a database row, so the |
||
| 1097 | * `$mainTable` parameter should be the name of an existing table in database. |
||
| 1098 | * - filter: The filter is a filter bag. It is what you use to filter your request (the WHERE part in SQL). |
||
| 1099 | * It can be a string (SQL Where clause), or even a bean or an associative array (key = column to filter, value = value to find) |
||
| 1100 | * - parameters: The parameters used in the filter. If you pass a SQL string as a filter, be sure to avoid |
||
| 1101 | * concatenating parameters in the string (this leads to SQL injection and also to poor caching performance). |
||
| 1102 | * Instead, please consider passing parameters (see documentation for more details). |
||
| 1103 | * - additionalTablesFetch: An array of SQL tables names. The beans related to those tables will be fetched along |
||
| 1104 | * the main table. This is useful to avoid hitting the database with numerous subqueries. |
||
| 1105 | * - mode: The fetch mode of the result. See `setFetchMode()` method for more details. |
||
| 1106 | * |
||
| 1107 | * The `findObjects` method will return a `ResultIterator`. A `ResultIterator` is an object that behaves as an array |
||
| 1108 | * (in ARRAY mode) at least. It can be iterated using a `foreach` loop. |
||
| 1109 | * |
||
| 1110 | * Finally, if filter_bag is null, the whole table is returned. |
||
| 1111 | * |
||
| 1112 | * @param string $mainTable The name of the table queried |
||
| 1113 | * @param string|array|null $filter The SQL filters to apply to the query (the WHERE part). Columns from tables different from $mainTable must be prefixed by the table name (in the form: table.column) |
||
| 1114 | * @param array $parameters |
||
| 1115 | * @param string|UncheckedOrderBy|null $orderString The ORDER BY part of the query. Columns from tables different from $mainTable must be prefixed by the table name (in the form: table.column) |
||
| 1116 | * @param array $additionalTablesFetch |
||
| 1117 | * @param int $mode |
||
| 1118 | * @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 |
||
| 1119 | * |
||
| 1120 | * @return ResultIterator An object representing an array of results |
||
| 1121 | * |
||
| 1122 | * @throws TDBMException |
||
| 1123 | */ |
||
| 1124 | public function findObjects(string $mainTable, $filter = null, array $parameters = array(), $orderString = null, array $additionalTablesFetch = array(), $mode = null, string $className = null) |
||
| 1143 | |||
| 1144 | /** |
||
| 1145 | * @param string $mainTable The name of the table queried |
||
| 1146 | * @param string $from The from sql statement |
||
| 1147 | * @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) |
||
| 1148 | * @param array $parameters |
||
| 1149 | * @param string|UncheckedOrderBy|null $orderString The ORDER BY part of the query. All columns must be prefixed by the table name (in the form: table.column) |
||
| 1150 | * @param int $mode |
||
| 1151 | * @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 |
||
| 1152 | * |
||
| 1153 | * @return ResultIterator An object representing an array of results |
||
| 1154 | * |
||
| 1155 | * @throws TDBMException |
||
| 1156 | */ |
||
| 1157 | public function findObjectsFromSql(string $mainTable, string $from, $filter = null, array $parameters = array(), $orderString = null, $mode = null, string $className = null) |
||
| 1176 | |||
| 1177 | /** |
||
| 1178 | * @param $table |
||
| 1179 | * @param array $primaryKeys |
||
| 1180 | * @param array $additionalTablesFetch |
||
| 1181 | * @param bool $lazy Whether to perform lazy loading on this object or not |
||
| 1182 | * @param string $className |
||
| 1183 | * |
||
| 1184 | * @return AbstractTDBMObject |
||
| 1185 | * |
||
| 1186 | * @throws TDBMException |
||
| 1187 | */ |
||
| 1188 | public function findObjectByPk(string $table, array $primaryKeys, array $additionalTablesFetch = array(), bool $lazy = false, string $className = null) |
||
| 1233 | |||
| 1234 | /** |
||
| 1235 | * Returns a unique bean (or null) according to the filters passed in parameter. |
||
| 1236 | * |
||
| 1237 | * @param string $mainTable The name of the table queried |
||
| 1238 | * @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) |
||
| 1239 | * @param array $parameters |
||
| 1240 | * @param array $additionalTablesFetch |
||
| 1241 | * @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 |
||
| 1242 | * |
||
| 1243 | * @return AbstractTDBMObject|null The object we want, or null if no object matches the filters |
||
| 1244 | * |
||
| 1245 | * @throws TDBMException |
||
| 1246 | */ |
||
| 1247 | public function findObject(string $mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), string $className = null) |
||
| 1266 | |||
| 1267 | /** |
||
| 1268 | * Returns a unique bean (or null) according to the filters passed in parameter. |
||
| 1269 | * |
||
| 1270 | * @param string $mainTable The name of the table queried |
||
| 1271 | * @param string $from The from sql statement |
||
| 1272 | * @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) |
||
| 1273 | * @param array $parameters |
||
| 1274 | * @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 |
||
| 1275 | * |
||
| 1276 | * @return AbstractTDBMObject|null The object we want, or null if no object matches the filters |
||
| 1277 | * |
||
| 1278 | * @throws TDBMException |
||
| 1279 | */ |
||
| 1280 | public function findObjectFromSql($mainTable, $from, $filter = null, array $parameters = array(), $className = null) |
||
| 1293 | |||
| 1294 | /** |
||
| 1295 | * @param string $mainTable |
||
| 1296 | * @param string $sql |
||
| 1297 | * @param array $parameters |
||
| 1298 | * @param $mode |
||
| 1299 | * @param string|null $className |
||
| 1300 | * @param string $sqlCount |
||
| 1301 | * |
||
| 1302 | * @return ResultIterator |
||
| 1303 | * |
||
| 1304 | * @throws TDBMException |
||
| 1305 | */ |
||
| 1306 | public function findObjectsFromRawSql(string $mainTable, string $sql, array $parameters = array(), $mode, string $className = null, string $sqlCount = null) |
||
| 1319 | |||
| 1320 | /** |
||
| 1321 | * Returns a unique bean according to the filters passed in parameter. |
||
| 1322 | * Throws a NoBeanFoundException if no bean was found for the filter passed in parameter. |
||
| 1323 | * |
||
| 1324 | * @param string $mainTable The name of the table queried |
||
| 1325 | * @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) |
||
| 1326 | * @param array $parameters |
||
| 1327 | * @param array $additionalTablesFetch |
||
| 1328 | * @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 |
||
| 1329 | * |
||
| 1330 | * @return AbstractTDBMObject The object we want |
||
| 1331 | * |
||
| 1332 | * @throws TDBMException |
||
| 1333 | */ |
||
| 1334 | public function findObjectOrFail(string $mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), string $className = null) |
||
| 1343 | |||
| 1344 | /** |
||
| 1345 | * @param array $beanData An array of data: array<table, array<column, value>> |
||
| 1346 | * |
||
| 1347 | * @return array an array with first item = class name, second item = table name and third item = list of tables needed |
||
| 1348 | * |
||
| 1349 | * @throws TDBMInheritanceException |
||
| 1350 | */ |
||
| 1351 | public function _getClassNameFromBeanData(array $beanData) |
||
| 1390 | |||
| 1391 | /** |
||
| 1392 | * Returns an item from cache or computes it using $closure and puts it in cache. |
||
| 1393 | * |
||
| 1394 | * @param string $key |
||
| 1395 | * @param callable $closure |
||
| 1396 | * |
||
| 1397 | * @return mixed |
||
| 1398 | */ |
||
| 1399 | private function fromCache(string $key, callable $closure) |
||
| 1409 | |||
| 1410 | /** |
||
| 1411 | * Returns the foreign key object. |
||
| 1412 | * |
||
| 1413 | * @param string $table |
||
| 1414 | * @param string $fkName |
||
| 1415 | * |
||
| 1416 | * @return ForeignKeyConstraint |
||
| 1417 | */ |
||
| 1418 | public function _getForeignKeyByName(string $table, string $fkName) |
||
| 1422 | |||
| 1423 | /** |
||
| 1424 | * @param $pivotTableName |
||
| 1425 | * @param AbstractTDBMObject $bean |
||
| 1426 | * |
||
| 1427 | * @return AbstractTDBMObject[] |
||
| 1428 | */ |
||
| 1429 | public function _getRelatedBeans(string $pivotTableName, AbstractTDBMObject $bean) |
||
| 1445 | |||
| 1446 | /** |
||
| 1447 | * @param $pivotTableName |
||
| 1448 | * @param AbstractTDBMObject $bean The LOCAL bean |
||
| 1449 | * |
||
| 1450 | * @return ForeignKeyConstraint[] First item: the LOCAL bean, second item: the REMOTE bean |
||
| 1451 | * |
||
| 1452 | * @throws TDBMException |
||
| 1453 | */ |
||
| 1454 | private function getPivotTableForeignKeys(string $pivotTableName, AbstractTDBMObject $bean) |
||
| 1472 | |||
| 1473 | /** |
||
| 1474 | * Returns a list of pivot tables linked to $bean. |
||
| 1475 | * |
||
| 1476 | * @param AbstractTDBMObject $bean |
||
| 1477 | * |
||
| 1478 | * @return string[] |
||
| 1479 | */ |
||
| 1480 | public function _getPivotTablesLinkedToBean(AbstractTDBMObject $bean) |
||
| 1497 | |||
| 1498 | /** |
||
| 1499 | * Array of types for tables. |
||
| 1500 | * Key: table name |
||
| 1501 | * Value: array of types indexed by column. |
||
| 1502 | * |
||
| 1503 | * @var array[] |
||
| 1504 | */ |
||
| 1505 | private $typesForTable = []; |
||
| 1506 | |||
| 1507 | /** |
||
| 1508 | * @internal |
||
| 1509 | * |
||
| 1510 | * @param string $tableName |
||
| 1511 | * |
||
| 1512 | * @return Type[] |
||
| 1513 | */ |
||
| 1514 | public function _getColumnTypesForTable(string $tableName) |
||
| 1525 | |||
| 1526 | /** |
||
| 1527 | * Sets the minimum log level. |
||
| 1528 | * $level must be one of Psr\Log\LogLevel::xxx. |
||
| 1529 | * |
||
| 1530 | * Defaults to LogLevel::WARNING |
||
| 1531 | * |
||
| 1532 | * @param string $level |
||
| 1533 | */ |
||
| 1534 | public function setLogLevel(string $level) |
||
| 1538 | } |
||
| 1539 |
Loading history...
Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.
The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.
This check looks for comments that seem to be mostly valid code and reports them.