Action类,控制器中方法的基类:

 namespace yii\base;

 use Yii;

 /**
  * Action is the base class for all controller action classes.
  * Action是所有控制器方法的基类
  * Action provides a way to reuse action method code. An action method in an Action
  * class can be used in multiple controllers or in different projects.
  * Action提供了一种重用代码的方法,一个Action类中的方法可以被多个控制器或不同的项目调用
  * Derived classes must implement a method named `run()`. This method
  * will be invoked by the controller when the action is requested.
  * 驱动类必须实现run()方法,该方法在action被请求的时候被控制器调用
  * The `run()` method can have parameters which will be filled up
  * with user input values automatically according to their names.
  * 如果请求带有参数,run方法会自动带参数运行,例如:
  * For example, if the `run()` method is declared as follows:
  *
  * ```php
  * public function run($id, $type = 'book') { ... }
  * ```
  *
  * And the parameters provided for the action are: `['id' => 1]`.
  * Then the `run()` method will be invoked as `run(1)` automatically.
  *
  * @property string $uniqueId The unique ID of this action among the whole application. This property is
  * read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0
  */
 class Action extends Component
 {
     /**
      * @var action的ID
      */
     public $id;
     /**
      * @var Controller|\yii\web\Controller 当前action的控制器
      */
     public $controller;

     /**
      * Constructor.
      * 构造函数,用于初始化action 的ID和控制器,并且调用component的构造方法初始化对象
      *
      * @param string $id the ID of this action
      * @param Controller $controller the controller that owns this action
      * @param array $config name-value pairs that will be used to initialize the object properties
      */
     public function __construct($id, $controller, $config = [])
     {
         $this->id = $id;
         $this->controller = $controller;
         parent::__construct($config);
     }

     /**
      * Returns the unique ID of this action among the whole application.
      * 用于取得当前action的唯一ID  形式为controller ID/action ID
      * @return string the unique ID of this action among the whole application.
      */
     public function getUniqueId()
     {
         return $this->controller->getUniqueId() . '/' . $this->id;
     }

     /**
      * Runs this action with the specified parameters.
      * This method is mainly invoked by the controller.
      * 用指定的参数运行,该方法主要被控制器调用
      *
      * @param array $params the parameters to be bound to the action's run() method.
      * @return mixed the result of the action
      * @throws InvalidConfigException if the action class does not have a run() method
      */
     public function runWithParams($params)
     {
         if (!method_exists($this, 'run')) {//如果run方法不存在,抛出异常
             throw new InvalidConfigException(get_class($this) . ' must define a "run()" method.');
         }
         $args = $this->controller->bindActionParams($this, $params);//绑定参数
         Yii::trace('Running action: ' . get_class($this) . '::run()', __METHOD__);//记录trace信息
         if (Yii::$app->requestedParams === null) {
             Yii::$app->requestedParams = $args;//如果是命令行运行,按命令行方式获取参数
         }
         if ($this->beforeRun()) {//调用run的前置操作
             $result = call_user_func_array([$this, 'run'], $args);//用php内置函数带参数执行run方法
             $this->afterRun();//调用后置操作

             return $result;//返回结果
         } else {
             return null;
         }
     }

     /**
      * This method is called right before `run()` is executed.
      * You may override this method to do preparation work for the action run.
      * If the method returns false, it will cancel the action.
      * run方法的前置方法,通常在子类中重写来实现某些前置功能
      *
      * @return boolean whether to run the action.
      */
     protected function beforeRun()
     {
         return true;
     }

     /**
      * This method is called right after `run()` is executed.
      * You may override this method to do post-processing work for the action run.
      * run方法的后置方法,通常在子类中重写来实现某些后置功能
      *
      */
     protected function afterRun()
     {
     }
 }

Yii源码阅读笔记(十二)的更多相关文章

  1. Yii源码阅读笔记(二十九)

    动态模型DynamicModel类,用于实现模型内数据验证: namespace yii\base; use yii\validators\Validator; /** * DynamicModel ...

  2. Yii源码阅读笔记(二十八)

    Yii/web中的Controller类,实现参数绑定,启动csrf验证功能,重定向页面功能: namespace yii\web; use Yii; use yii\base\InlineActio ...

  3. Yii源码阅读笔记(二十六)

    Application 类中设置路径的方法和调用ServiceLocator(服务定位器)加载运行时的组件的方法注释: /** * Handles the specified request. * 处 ...

  4. Yii源码阅读笔记(二十四)

    Module类中获取子模块,注册子模块,实例化控制器,根据路由运行指定控制器方法的注释: /** * Retrieves the child module of the specified ID. * ...

  5. Yii源码阅读笔记(二十二)

    Module类,属性的注释和构造函数的注释: <?php /** * @link http://www.yiiframework.com/ * @copyright Copyright (c) ...

  6. Yii源码阅读笔记(二十五)

    Module类中剩余部分代码,通过控制器ID实例化当前模块的控制器,当前模块的Action方法的前置和后置方法: /** * This method is invoked right before a ...

  7. Yii源码阅读笔记(二十)

    View中应用布局和缓存内容部分: /** * Begins recording a block. * This method is a shortcut to beginning [[Block]] ...

  8. Yii源码阅读笔记(二)

    接下来阅读BaseYii.php vendor/yiisoft/yii2/BaseYii.php—— namespace yii; use yii\base\InvalidConfigExceptio ...

  9. Yii源码阅读笔记(二十七)

    Theme 类,即一个应用的主题,主要通过替换路径实现主题的应用,里边的方法为获取根路径和根链接,以及应用主题的方法: namespace yii\base; use Yii; use yii\hel ...

  10. Yii源码阅读笔记(二十三)

    Module类中的辅助功能方法: /** * Returns an ID that uniquely identifies this module among all modules within t ...

随机推荐

  1. C++查询网站

    1.C++外文api查询 http://www.cplusplus.com/ 2.https://isocpp.org/ 3.Juce学习 http://www.thinksaas.cn/favori ...

  2. 【ACM - 搜索模板】

    [广搜模板] #include <iostream> #include <stdio.h> #include <string.h> #include <que ...

  3. Mac OS X 上的安装haskell开发环境

    到haskell官方下载haskell的工具包: https://downloads.haskell.org/~platform/2014.2.0.0/Haskell%20Platform%20201 ...

  4. C语言标量类型(转)

    在C语言中,枚举类型.字符型和各种整数的表示形式统一叫做标量类型. 当在C表达式中使用标量类型的值时,编译器就会自动将这些标识符转换为整数保存. 这种机制的作用是,在这些标量类型上执行的操作与整型上执 ...

  5. C++的那些事:你真的了解引用吗

    一.引用的本质是什么 说到引用,一般C++的教材中都是这么定义的: 1,引用就是一个对象的别名. 2,引用不是值不占内存空间. 3,引用必须在定义时赋值,将变量与引用绑定. 那你有没有想过,上面的定义 ...

  6. 2016 Multi-University Training Contest 8

    solved 4/11 2016 Multi-University Training Contest 8 贪心 1001 Ball(BH) 代码: #include <bits/stdc++.h ...

  7. LCS(打印路径) POJ 2250 Compromise

    题目传送门 题意:求单词的最长公共子序列,并要求打印路径 分析:LCS 将单词看成一个点,dp[i][j] = dp[i-1][j-1] + 1 (s1[i] == s2[j]), dp[i][j] ...

  8. LightOJ1060 nth Permutation(不重复全排列+逆康托展开)

    一年多前遇到差不多的题目http://acm.fafu.edu.cn/problem.php?id=1427. 一开始我还用搜索..后来那时意外找到一个不重复全排列的计算公式:M!/(N1!*N2!* ...

  9. ural 1153. Supercomputer

    1153. Supercomputer Time limit: 2.0 secondMemory limit: 64 MB To check the speed of JCN Corporation ...

  10. lua 循环

    x= while i<x do print(x) i=i+ end then local x x = ) else print(x) end print(x)