| Total Complexity | 53 |
| Total Lines | 300 |
| Duplicated Lines | 0 % |
| Coverage | 12.68% |
| Changes | 0 | ||
Complex classes like ScaffoldController 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.
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 ScaffoldController, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 12 | abstract class ScaffoldController { |
||
| 13 | public static $views = [ "CRUD" => [ "index" => "@framework/crud/index.html","form" => "@framework/crud/form.html","display" => "@framework/crud/display.html" ], |
||
| 14 | "auth" => [ "index" => "@framework/auth/index.html","info" => "@framework/auth/info.html","noAccess" => "@framework/auth/noAccess.html","disconnected" => "@framework/auth/disconnected.html","message" => "@framework/auth/message.html","baseTemplate" => "@framework/auth/baseTemplate.html" ] ]; |
||
| 15 | |||
| 16 | protected abstract function getTemplateDir(); |
||
| 17 | |||
| 18 | protected abstract function storeControllerNameInSession($controller); |
||
| 19 | |||
| 20 | public abstract function showSimpleMessage($content, $type, $title = null, $icon = "info", $timeout = NULL, $staticName = null); |
||
| 21 | |||
| 22 | protected abstract function _addMessageForRouteCreation($path, $jsCallback = ""); |
||
| 23 | |||
| 24 | public function _createMethod($access, $name, $parameters = "", $return = "", $content = "", $comment = "") { |
||
| 28 | } |
||
| 29 | |||
| 30 | 2 | public function _createController($controllerName, $variables = [], $ctrlTemplate = 'controller.tpl', $hasView = false, $jsCallback = "") { |
|
| 64 | } |
||
| 65 | |||
| 66 | public function addCrudController($crudControllerName, $resource, $crudDatas = null, $crudViewer = null, $crudEvents = null, $crudViews = null, $routePath = '') { |
||
| 67 | $classContent = ""; |
||
| 68 | $uses = [ ]; |
||
| 69 | $controllerNS = Startup::getNS ( "controllers" ); |
||
| 70 | $messages = [ ]; |
||
| 71 | $routeName = $crudControllerName; |
||
| 72 | $this->_createMethod ( "public", "__construct", "", "", "\n\t\tparent::__construct();\n\$this->model=\"{$resource}\";" ); |
||
| 73 | |||
| 74 | if (isset ( $crudDatas )) { |
||
| 75 | $uses [] = "use controllers\\crud\\datas\\{$crudControllerName}Datas;"; |
||
| 76 | $uses [] = "use Ubiquity\\controllers\\crud\\CRUDDatas;"; |
||
| 77 | |||
| 78 | $classContent .= $this->_createMethod ( "protected", "getAdminData", "", ": CRUDDatas", "\t\treturn new {$crudControllerName}Datas(\$this);" ); |
||
| 79 | $messages [] = $this->createCRUDDatasClass ( $crudControllerName ); |
||
| 80 | } |
||
| 81 | |||
| 82 | if (isset ( $crudViewer )) { |
||
| 83 | $uses [] = "use controllers\\crud\\viewers\\{$crudControllerName}Viewer;"; |
||
| 84 | $uses [] = "use Ubiquity\\controllers\\admin\\viewers\\ModelViewer;"; |
||
| 85 | |||
| 86 | $classContent .= $this->_createMethod ( "protected", "getModelViewer", "", ": ModelViewer", "\t\treturn new {$crudControllerName}Viewer(\$this);" ); |
||
| 87 | $messages [] = $this->createModelViewerClass ( $crudControllerName ); |
||
| 88 | } |
||
| 89 | if (isset ( $crudEvents )) { |
||
| 90 | $uses [] = "use controllers\\crud\\events\\{$crudControllerName}Events;"; |
||
| 91 | $uses [] = "use Ubiquity\\controllers\\crud\\CRUDEvents;"; |
||
| 92 | |||
| 93 | $classContent .= $this->_createMethod ( "protected", "getEvents", "", ": CRUDEvents", "\t\treturn new {$crudControllerName}Events(\$this);" ); |
||
| 94 | $messages [] = $this->createEventsClass ( $crudControllerName ); |
||
| 95 | } |
||
| 96 | |||
| 97 | if (isset ( $crudViews )) { |
||
| 98 | $crudViews = explode ( ",", $crudViews ); |
||
| 99 | $uses [] = "use controllers\\crud\\files\\{$crudControllerName}Files;"; |
||
| 100 | $uses [] = "use Ubiquity\\controllers\\crud\\CRUDFiles;"; |
||
| 101 | $classContent .= $this->_createMethod ( "protected", "getFiles", "", ": CRUDFiles", "\t\treturn new {$crudControllerName}Files();" ); |
||
| 102 | $classFilesContent = [ ]; |
||
| 103 | foreach ( $crudViews as $file ) { |
||
| 104 | if (isset ( self::$views ["CRUD"] [$file] )) { |
||
| 105 | $frameworkViewname = self::$views ["CRUD"] [$file]; |
||
| 106 | $this->createCrudView ( $frameworkViewname, $crudControllerName, $file ); |
||
| 107 | $classFilesContent [] = $this->_createMethod ( "public", "getView" . ucfirst ( $file ), "", "", "\t\treturn \"" . $crudControllerName . "/" . $file . ".html\";" ); |
||
| 108 | } |
||
| 109 | } |
||
| 110 | $messages [] = $this->createCRUDFilesClass ( $crudControllerName, implode ( "", $classFilesContent ) ); |
||
| 111 | } |
||
| 112 | if ($routePath != null) { |
||
| 113 | if (UString::isNotNull ( $routePath )) { |
||
| 114 | if (! UString::startswith ( $routePath, "/" )) { |
||
| 115 | $routePath = "/" . $routePath; |
||
| 116 | } |
||
| 117 | $routeName = $routePath; |
||
| 118 | $routePath = "\n * @route(\"{$routePath}\",\"inherited\"=>true,\"automated\"=>true)"; |
||
| 119 | } |
||
| 120 | } |
||
| 121 | $uses = implode ( "\n", $uses ); |
||
| 122 | $messages [] = $this->_createController ( $crudControllerName, [ "%routeName%" => $routeName,"%route%" => $routePath,"%resource%" => $resource,"%uses%" => $uses,"%namespace%" => $controllerNS,"%baseClass%" => "\\Ubiquity\\controllers\\crud\\CRUDController","%content%" => $classContent ], "crudController.tpl" ); |
||
| 123 | echo implode ( "\n", $messages ); |
||
| 124 | } |
||
| 125 | |||
| 126 | public function addAuthController($authControllerName, $baseClass, $authViews = null, $routePath = "") { |
||
| 127 | $classContent = ""; |
||
| 128 | if ($baseClass == "\\Ubiquity\\controllers\\auth\\AuthController") { |
||
| 129 | $controllerTemplate = "authController.tpl"; |
||
| 130 | $uses = [ "use Ubiquity\\utils\\http\\USession;","use Ubiquity\\utils\\http\\URequest;" ]; |
||
| 131 | } else { |
||
| 132 | $controllerTemplate = "authController_.tpl"; |
||
| 133 | $uses = [ ]; |
||
| 134 | } |
||
| 135 | $controllerNS = Startup::getNS ( "controllers" ); |
||
| 136 | |||
| 137 | $messages = [ ]; |
||
| 138 | $routeName = $authControllerName; |
||
| 139 | if (isset ( $authViews )) { |
||
| 140 | $authViews = explode ( ",", $authViews ); |
||
| 141 | $uses [] = "use controllers\\auth\\files\\{$authControllerName}Files;"; |
||
| 142 | $uses [] = "use Ubiquity\\controllers\\auth\\AuthFiles;"; |
||
| 143 | $classContent .= $this->_createMethod ( "protected", "getFiles", "", ": AuthFiles", "\t\treturn new {$authControllerName}Files();" ); |
||
| 144 | $classFilesContent = [ ]; |
||
| 145 | foreach ( $authViews as $file ) { |
||
| 146 | if (isset ( self::$views ["auth"] [$file] )) { |
||
| 147 | $frameworkViewname = self::$views ["auth"] [$file]; |
||
| 148 | $this->createCrudView ( $frameworkViewname, $authControllerName, $file ); |
||
| 149 | $classFilesContent [] = $this->_createMethod ( "public", "getView" . ucfirst ( $file ), "", "", "\t\treturn \"" . $authControllerName . "/" . $file . ".html\";" ); |
||
| 150 | } |
||
| 151 | } |
||
| 152 | $messages [] = $this->createAuthFilesClass ( $authControllerName, implode ( "", $classFilesContent ) ); |
||
| 153 | } |
||
| 154 | if ($routePath != null) { |
||
| 155 | if (UString::isNotNull ( $routePath )) { |
||
| 156 | if (! UString::startswith ( $routePath, "/" )) { |
||
| 157 | $routePath = "/" . $routePath; |
||
| 158 | } |
||
| 159 | $routeName = $routePath; |
||
| 160 | $routePath = "\n * @route(\"{$routePath}\",\"inherited\"=>true,\"automated\"=>true)"; |
||
| 161 | } |
||
| 162 | } |
||
| 163 | $uses = implode ( "\n", $uses ); |
||
| 164 | $messages [] = $this->_createController ( $authControllerName, [ "%routeName%" => $routeName,"%route%" => $routePath,"%uses%" => $uses,"%namespace%" => $controllerNS,"%baseClass%" => $baseClass,"%content%" => $classContent ], $controllerTemplate ); |
||
| 165 | echo implode ( "\n", $messages ); |
||
| 166 | } |
||
| 167 | |||
| 168 | public function _createClass($template, $classname, $namespace, $uses, $extendsOrImplements, $classContent) { |
||
| 185 | } |
||
| 186 | |||
| 187 | public function _newAction($controller, $action, $parameters = null, $content = '', $routeInfo = null, $createView = false) { |
||
| 188 | $templateDir = $this->getTemplateDir (); |
||
| 189 | $msgContent = ""; |
||
| 190 | $r = new \ReflectionClass ( $controller ); |
||
| 191 | if (! method_exists ( $controller, $action )) { |
||
| 192 | $ctrlFilename = $r->getFileName (); |
||
| 193 | $content = CodeUtils::indent ( $content, 2 ); |
||
| 194 | $fileContent = \implode ( "", UIntrospection::getClassCode ( $controller ) ); |
||
|
|
|||
| 195 | $fileContent = \trim ( $fileContent ); |
||
| 196 | $posLast = \strrpos ( $fileContent, "}" ); |
||
| 197 | if ($posLast !== false) { |
||
| 198 | if ($createView) { |
||
| 199 | $viewname = $this->_createViewOp ( ClassUtils::getClassSimpleName ( $controller ), $action ); |
||
| 200 | $content .= "\n\t\t\$this->loadView('" . $viewname . "');\n"; |
||
| 201 | $msgContent .= "<br>Created view : <b>" . $viewname . "</b>"; |
||
| 202 | } |
||
| 203 | $routeAnnotation = ""; |
||
| 204 | if (is_array ( $routeInfo )) { |
||
| 205 | $name = "route"; |
||
| 206 | $path = $routeInfo ["path"]; |
||
| 207 | $routeProperties = [ '"' . $path . '"' ]; |
||
| 208 | $methods = $routeInfo ["methods"]; |
||
| 209 | if (UString::isNotNull ( $methods )) { |
||
| 210 | $routeProperties [] = '"methods"=>' . $this->getMethods ( $methods ); |
||
| 211 | } |
||
| 212 | if (isset ( $routeInfo ["ck-Cache"] )) { |
||
| 213 | $routeProperties [] = '"cache"=>true'; |
||
| 214 | if (isset ( $routeInfo ["duration"] )) { |
||
| 215 | $duration = $routeInfo ["duration"]; |
||
| 216 | if (\ctype_digit ( $duration )) { |
||
| 217 | $routeProperties [] = '"duration"=>' . $duration; |
||
| 218 | } |
||
| 219 | } |
||
| 220 | } |
||
| 221 | $routeProperties = \implode ( ",", $routeProperties ); |
||
| 222 | $routeAnnotation = UFileSystem::openReplaceInTemplateFile ( $templateDir . "annotation.tpl", [ "%name%" => $name,"%properties%" => $routeProperties ] ); |
||
| 223 | |||
| 224 | $msgContent .= $this->_addMessageForRouteCreation ( $path ); |
||
| 225 | } |
||
| 226 | $parameters = CodeUtils::cleanParameters ( $parameters ); |
||
| 227 | $actionContent = UFileSystem::openReplaceInTemplateFile ( $templateDir . "action.tpl", [ "%route%" => "\n" . $routeAnnotation,"%actionName%" => $action,"%parameters%" => $parameters,"%content%" => $content ] ); |
||
|
1 ignored issue
–
show
|
|||
| 228 | $fileContent = \substr_replace ( $fileContent, "\n%content%", $posLast - 1, 0 ); |
||
| 229 | if (! CodeUtils::isValidCode ( '<?php ' . $content )) { |
||
| 230 | echo $this->showSimpleMessage ( "Errors parsing action content!", "warning", "Creation", "warning circle", null, "msgControllers" ); |
||
| 231 | return; |
||
| 232 | } else { |
||
| 233 | if (UFileSystem::replaceWriteFromContent ( $fileContent . "\n", $ctrlFilename, [ '%content%' => $actionContent ] )) { |
||
| 234 | $msgContent = "The action <b>{$action}</b> is created in controller <b>{$controller}</b>" . $msgContent; |
||
| 235 | echo $this->showSimpleMessage ( $msgContent, "info", "Creation", "info circle", null, "msgControllers" ); |
||
| 236 | } |
||
| 237 | } |
||
| 238 | } |
||
| 239 | } else { |
||
| 240 | echo $this->showSimpleMessage ( "The action {$action} already exists in {$controller}!", "error", "Creation", "warning circle", null, "msgControllers" ); |
||
| 241 | } |
||
| 242 | } |
||
| 243 | |||
| 244 | protected function getMethods($strMethods) { |
||
| 245 | $methods = \explode ( ",", $strMethods ); |
||
| 246 | $result = [ ]; |
||
| 247 | foreach ( $methods as $method ) { |
||
| 248 | $result [] = '"' . $method . '"'; |
||
| 249 | } |
||
| 250 | return "[" . \implode ( ",", $result ) . "]"; |
||
| 251 | } |
||
| 252 | |||
| 253 | protected function _createViewOp($controller, $action) { |
||
| 254 | $viewName = $controller . "/" . $action . ".html"; |
||
| 255 | UFileSystem::safeMkdir ( \ROOT . \DS . "views" . \DS . $controller ); |
||
| 256 | $templateDir = $this->getTemplateDir (); |
||
| 257 | UFileSystem::openReplaceWriteFromTemplateFile ( $templateDir . "view.tpl", \ROOT . \DS . "views" . \DS . $viewName, [ "%controllerName%" => $controller,"%actionName%" => $action ] ); |
||
| 258 | return $viewName; |
||
| 259 | } |
||
| 260 | |||
| 261 | protected function createCRUDDatasClass($crudControllerName) { |
||
| 262 | $ns = Startup::getNS ( "controllers" ) . "crud\\datas"; |
||
| 263 | $uses = "\nuse Ubiquity\\controllers\\crud\\CRUDDatas;"; |
||
| 264 | return $this->_createClass ( "class.tpl", $crudControllerName . "Datas", $ns, $uses, "extends CRUDDatas", "\t//use override/implement Methods" ); |
||
| 265 | } |
||
| 266 | |||
| 267 | protected function createModelViewerClass($crudControllerName) { |
||
| 268 | $ns = Startup::getNS ( "controllers" ) . "crud\\viewers"; |
||
| 269 | $uses = "\nuse Ubiquity\\controllers\\admin\\viewers\\ModelViewer;"; |
||
| 270 | return $this->_createClass ( "class.tpl", $crudControllerName . "Viewer", $ns, $uses, "extends ModelViewer", "\t//use override/implement Methods" ); |
||
| 271 | } |
||
| 272 | |||
| 273 | protected function createEventsClass($crudControllerName) { |
||
| 274 | $ns = Startup::getNS ( "controllers" ) . "crud\\events"; |
||
| 275 | $uses = "\nuse Ubiquity\\controllers\\crud\\CRUDEvents;"; |
||
| 276 | return $this->_createClass ( "class.tpl", $crudControllerName . "Events", $ns, $uses, "extends CRUDEvents", "\t//use override/implement Methods" ); |
||
| 277 | } |
||
| 278 | |||
| 279 | protected function createCRUDFilesClass($crudControllerName, $classContent = "") { |
||
| 280 | $ns = Startup::getNS ( "controllers" ) . "crud\\files"; |
||
| 281 | $uses = "\nuse Ubiquity\\controllers\\crud\\CRUDFiles;"; |
||
| 282 | return $this->_createClass ( "class.tpl", $crudControllerName . "Files", $ns, $uses, "extends CRUDFiles", $classContent ); |
||
| 283 | } |
||
| 284 | |||
| 285 | protected function createAuthFilesClass($authControllerName, $classContent = "") { |
||
| 286 | $ns = Startup::getNS ( "controllers" ) . "auth\\files"; |
||
| 287 | $uses = "\nuse Ubiquity\\controllers\\auth\\AuthFiles;"; |
||
| 288 | return $this->_createClass ( "class.tpl", $authControllerName . "Files", $ns, $uses, "extends AuthFiles", $classContent ); |
||
| 289 | } |
||
| 290 | |||
| 291 | protected function createCrudView($frameworkName, $controllerName, $newName) { |
||
| 312 | } |
||
| 313 | } |
||
| 314 | } |
||
| 315 | |||
| 316 |