# Controller控制器 了解MVC架构的开发者对此应该并不陌生,在SD框架中更为简单。 以HTTP请求为例,Http://localhost:8081/AppController/test 以上这个url通过默认路由器的解析会转到名为AppController的控制器并调用旗下test方法。 Controller将暴露一组功能的API方法,他是所有对应功能请求的入口。 Controller在底层的实现比较复杂,他既不是单例模式也不是每次new新对象的模式,而是采用了可复用的对象池模式。 # 对象池模式 在SD框架中对象池模式相当的常见,基本大多数组件都是对象池模式,我们还提供了Pool类帮助开发者创建自己的对象池。 使用对象池会大大减少PHP运行时的new操作,减少内存的分配和GC,对运行效率有明显的提升,内存泄露有明显的改善,但是对象池也不是那么容易使用的。 参与对象池的对象一定是具有以下的功能,首先一定是具有一个初始化的函数比如initialization,它用于代替__construct;其次我们还得拥有个destroy方法用于销毁对象中我们自己定义的对象和值;最后我们通过Pool进行对象池的管理,通过Pool回收一个对象,通过Pool获得一个对象。 所以想更加得心应手的使用SD框架,想了解的更全面,你就得先了解对象池是怎么工作的。 # initialization initialization是Controller初始化的方法,前面说过了对象池模式会有个初始化方法来代替__construct。 在到达对应方法之前都会先执行initialization。 Http://localhost:8081/AppController/test 为例,SD会先调用AppController->initialization,如果没有抛出异常那么将会执行AppController->test。 # $http_input 在Controller中我们可以通过$http_input获得请求中所有的属性,具体的参考类介绍中的HttpInput ```php $max = $this->http_input->get('max'); ``` # $http_output 在Controller中我们可以通过$http_output来给游览器返回值,具体的参考类介绍中的HttpOutput 这里一定说明下,和fpm框架不同echo,print_r这些都只会在cli屏幕中打印,并不会返回给远端游览器。 ```php $this->http_output->end($result); ``` # defaultMethod Http://localhost:8081/AppController/test2 如果控制器中没有test2的方法,那么会访问到defaultMethod,开发者可以重写此方法。 # $loader 加载器,可通过加载器加载对应的Model和Task。 ```php $this->testModel = $this->loader->model('TestModel', $this); $result = $this->testModel->contextTest(); ``` # onExceptionHandle 异常的处理,这里很重要! onExceptionHandle是调用链中集中处理异常的地方,什么是调用链,AController通过loader加载了一个AModel,那么这就是一个调用链。 如果你在Model中抛出了一个异常那么如果不进行捕获,那么最终会在Controller的onExceptionHandle 方法中集中处理。 默认的处理方式会返回给游览器错误信息。比如我在AModel中抛出异常那么如果在AController中没有及时捕获,那么最后会在游览器中看到test字样,并且后续的代码不会执行。 ```php throw new SwooleException('test'); ``` 我们通过这一特性可以在实现很多方便的功能。 # destroy 销毁 很多情况下你不需要直接调用这个destory方法,在你向客户端返回值的时候,已经自动destory了。 HttpOutPut的end方法是如下描述的,最后一个字段就是destroy,默认是true代表会自动销毁。所以不要在销毁后继续存有未执行完的代码,并不清楚会有什么样的奇怪后果,最好的办法是始终保持destory是代码的最后一行。 ```php function end($output = '', $gzip = true, $destroy = true) ``` 如果你想以最快的速度返回给客户端值,然后再处理一些操作,你可以先end('test',true,false),最后手动调用destroy,当然如果是耗时操作尽量调用异步task去执行。 如果你在Controller类中声明了类变量,那么你需要在destroy或者在initialization中手动清除,除非你确认这个变量被携带到另一个请求中没有任何关系。 # 解释 每一个请求在结束之前都拥有一个Controller实例,每一个Controller实例都拥有对应调用链条的Model实例,框架确保在一个请求中这些实例是唯一且不会被其他请求抢占。通过显示调用或者隐示调用了destroy接口,Controller会被立即释放,包括调用的Model也一并会被释放,所以Model是不需要主动destory的,被释放的Controller可能会立即被下一个请求所重用,所以为了避免不可预料的奇怪错误,不要在destroy后还继续存在可执行代码。 # 例子 框架中包含了一部分实例,可以找到TestController.php。