Controller控制器 · SwooleDistributed

# 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。