Zend_Controller_Front->dispatch 注解

Zend_Controller_Front
public   function  dispatch(Zend_Controller_Request_Abstract  $request   =   null ,  Zend_Controller_Response_Abstract  $response   =   null )
{

//     注册出错的插件

     if  ( ! $this -> getParam( ' noErrorHandler ' )  &&   ! $this -> _plugins -> hasPlugin( ' Zend_Controller_Plugin_ErrorHandler ' )) {
         //  Register with stack index of 100 该插件存放在序号是 100的位置
         $this -> _plugins -> registerPlugin( new  Zend_Controller_Plugin_ErrorHandler() ,   100 );
    }

//     添加视图渲染助手
     if  ( ! $this -> getParam( ' noViewRenderer ' )  &&   ! Zend_Controller_Action_HelperBroker :: hasHelper( ' viewRenderer ' )) {
        Zend_Controller_Action_HelperBroker :: addHelper( new  Zend_Controller_Action_Helper_ViewRenderer());
    }

// 设置请求对象 如果没提供则实例化默认http方式的请求对象(该对象封装了 module  controller  action 对应的名字 及对$_GET  $_POST )
     /* *
     * Instantiate default request object (HTTP version) if none provided
      */
     if  ( null   !==   $request ) {
         $this -> setRequest( $request );
    }  elseif  (( null   ===   $request )  &&  ( null   ===  ( $request   =   $this -> getRequest()))) {
         require_once   ' Zend/Controller/Request/Http.php ' ;
         $request   =   new  Zend_Controller_Request_Http();
         $this -> setRequest( $request );
    }

// 重新设置 BaseUrl  通过调用 request对象的 setBaseUrl
         /* *
         * Set base URL of request object, if available
          */
         if  ( is_callable ( array ( $this -> _request ,   ' setBaseUrl ' ))) {
             if  ( null   !==  ( $baseUrl   =   $this -> getBaseUrl())) {     // 存在 $baseUrl 时才执行
                 $this -> _request -> setBaseUrl( $baseUrl );
            }
        }

// 设置 响应对象 如果没提供则实例化默认http方式的响应对象 (该对象处理服务端向客户端的响应 比如 显示网页内容)
         /* *
         * Instantiate default response object (HTTP version) if none provided
          */
         if  ( null   !==   $response ) {
             $this -> setResponse( $response );
        }  elseif  (( null   ===   $this -> _response)  &&  ( null   ===  ( $this -> _response  =   $this -> getResponse()))) {
             require_once   ' Zend/Controller/Response/Http.php ' ;
             $response   =   new  Zend_Controller_Response_Http();
             $this -> setResponse( $response );
        }

// 把 request 和 response 对象保存在 提供的plugin 中
         /* *
         * Register request and response objects with plugin broker
          */
         $this -> _plugins
              -> setRequest( $this -> _request)
              -> setResponse( $this -> _response);


// 初始化路由
         /* *
         * Initialize router
          */
         $router   =   $this -> getRouter();     // 这里是采用 Zend_Controller_Router_Rewrite 
         $router -> setParams( $this -> getParams());     // 传递引用的参数到路由

//初始化调配器
         /* *
         * Initialize dispatcher
          */
         $dispatcher   =   $this -> getDispatcher();         // 这里是采用 Zend_Controller_Dispatcher_Standard
         $dispatcher -> setParams( $this -> getParams())
                    -> setResponse( $this -> _response);     // 保存 Response 在 dispatcher 因为在 Zend_Controller_Action 中用到

    //开始 调配过程
       // Begin dispatch
         try  {
             /* *
             * Route request to controller/action, if a router is provided
              */

             /* *
            * Notify plugins of router startup        通知各个插件 路由启动
             */
             $this -> _plugins -> routeStartup( $this -> _request);

             $router -> route( $this -> _request);         // 启动路由 得到了 module  controller  action 值

             /* *
            * Notify plugins of router completion    通知各个插件 路由结束
             */
             $this -> _plugins -> routeShutdown( $this -> _request);

             /* *
             * Notify plugins of dispatch loop startup        通知各个插件 调配 循环开始
              */
             $this -> _plugins -> dispatchLoopStartup( $this -> _request);

            /* *
             *  Attempt to dispatch the controller/action. If the $this->_request
             *  indicates that it needs to be dispatched, move to the next
             *  action in the request.
              */
          // 根据当前的 controller/action 尝试进行调配  对于Request 指定 dispatched 的请求 跳过 
             do  {
                 $this -> _request -> setDispatched( true );

                 /* *
                 * Notify plugins of dispatch startup     通知插件 开始调配
                  */
                 $this -> _plugins -> preDispatch( $this -> _request);

                 /* *
                 * Skip requested action if preDispatch() has reset it 对于Request 指定 dispatched 的请求 跳过 
                  */
                 if  ( ! $this -> _request -> isDispatched()) {
                     continue ;
                }

                 /* *
                 * Dispatch request    调用 Zend_Controller_Dispatcher_Standard-dispatch()
                  */
                 try  {
                     $dispatcher -> dispatch( $this -> _request ,   $this -> _response);
                }  catch  ( Exception   $e ) {
                     if  ( $this -> throwExceptions()) {
                         throw   $e ;
                    }
                     $this -> _response -> setException( $e );
                }
                 /* *
                 * Notify plugins of dispatch completion    调用 Zend_Controller_Plugin_Broker->postDispatch 通知所有插件完成当前调配
                  */
                 $this -> _plugins -> postDispatch( $this -> _request);
            }  while  ( ! $this -> _request -> isDispatched());
        }  catch  ( Exception   $e ) {
             if  ( $this -> throwExceptions()) {
                 throw   $e ;
            }

             $this -> _response -> setException( $e );
        }


         /* *
         * Notify plugins of dispatch loop completion 通知所有插件完成所有调配
          */
         try  {
             $this -> _plugins -> dispatchLoopShutdown();
        }  catch  ( Exception   $e ) {
             if  ( $this -> throwExceptions()) {
                 throw   $e ;
            }

             $this -> _response -> setException( $e );
        }

         if  ( $this -> returnResponse()) {     // 如果设制了 返回响应
             return   $this -> _response;
        }

         $this -> _response -> sendResponse();     // 发送响应到客户端

}