yii2源码学习笔记(二十)

Widget类是所有部件的基类。yii2\base\Widget.php

  1 <?php
  2 /**
  3  * @link http://www.yiiframework.com/
  4  * @copyright Copyright (c) 2008 Yii Software LLC
  5  * @license http://www.yiiframework.com/license/
  6  */
  7
  8 namespace yii\base;
  9
 10 use Yii;
 11 use ReflectionClass;
 12
 13 /**
 14  * Widget is the base class for widgets.
 15  * Widget是所有小部件的基类
 16  * @property string $id ID of the widget. 小部件标识
 17  * @property \yii\web\View $view The view object that can be used to render views or view files. Note that the
 18  * type of this property differs in getter and setter. See [[getView()]] and [[setView()]] for details.
 19  * 用于渲染视图或视图文件的视图对象 在getter 和 setter中是不同的
 20  * @property string $viewPath The directory containing the view files for this widget. This property is
 21  * read-only. 包含此控件的视图文件目录
 22  *
 23  * @author Qiang Xue <[email protected]>
 24  * @since 2.0
 25  */
 26 class Widget extends Component implements ViewContextInterface
 27 {
 28     /**
 29      * @var integer a counter used to generate [[id]] for widgets.
 30      * @internal 用于生成widget ID的计数器
 31      */
 32     public static $counter = 0;
 33     /**
 34      * @var string the prefix to the automatically generated widget IDs.
 35      * @see getId() 自动生成的前缀
 36      */
 37     public static $autoIdPrefix = ‘w‘;
 38     /**
 39      * @var Widget[] the widgets that are currently being rendered (not ended). This property
 40      * is maintained by [[begin()]] and [[end()]] methods. 目前正在渲染的小部件
 41      * @internal
 42      */
 43     public static $stack = [];
 44
 45
 46     /**
 47      * Begins a widget.  开始一个部件
 48      * This method creates an instance of the calling class. It will apply the configuration
 49      * to the created instance. A matching [[end()]] call should be called later.
 50      * 将应用配置文件创建调用类的实例,与[end()]方法相对应
 51      * @param array $config name-value pairs that will be used to initialize the object properties
 52      * 用于初始化属性的参数
 53      * @return static the newly created widget instance 静态新创建的部件实例
 54      */
 55     public static function begin($config = [])
 56     {
 57         $config[‘class‘] = get_called_class();//后期静态绑定类的名称
 58         /* @var $widget Widget */
 59         $widget = Yii::createObject($config);//通过类名和传入的配置,实例化调用类
 60         static::$stack[] = $widget;//将对象放入正在渲染的部件堆栈中
 61
 62         return $widget;
 63     }
 64
 65     /**
 66      * Ends a widget.   结束小部件
 67      * Note that the rendering result of the widget is directly echoed out.渲染结果是直接呼应的
 68      * @return static the widget instance that is ended. 静态结束的部件实例。
 69      * @throws InvalidCallException if [[begin()]] and [[end()]] calls are not properly nested
 70      */
 71     public static function end()
 72     {
 73         if (!empty(static::$stack)) {//正在呈现的小部件堆栈中存在调用类实例
 74             $widget = array_pop(static::$stack);//从堆栈中删除最后一个实例
 75             if (get_class($widget) === get_called_class()) {
 76                 echo $widget->run(); //如果删除的实例类名和当前调用类名相同,输出小部件的内容
 77                 return $widget;
 78             } else {
 79                 throw new InvalidCallException("Expecting end() of " . get_class($widget) . ", found " . get_called_class());
 80             }
 81         } else {
 82             throw new InvalidCallException("Unexpected " . get_called_class() . ‘::end() call. A matching begin() is not found.‘);
 83         }
 84     }
 85
 86     /**
 87      * Creates a widget instance and runs it.   创建一个部件实例,并运行
 88      * The widget rendering result is returned by this method. 返回部件渲染的结果。
 89      * @param array $config name-value pairs that will be used to initialize the object properties
 90      * 用于初始化对象属性的参数
 91      * @return string the rendering result of the widget. 控件的渲染结果。
 92      */
 93     public static function widget($config = [])
 94     {
 95         ob_start(); //打开输出缓冲区
 96         ob_implicit_flush(false);//关闭绝对刷新
 97         /* @var $widget Widget */
 98         $config[‘class‘] = get_called_class(); //获取调用类的类名
 99         $widget = Yii::createObject($config);   //实例化类
100         $out = $widget->run();//运行部件
101
102         return ob_get_clean() . $out; //返回内部缓冲区的内容,关闭缓冲区
103     }
104
105     private $_id;
106
107     /**
108      * Returns the ID of the widget. 返回插件的标识
109      * @param boolean $autoGenerate whether to generate an ID if it is not set previously
110      * 是否生成一个唯一标识,如果没有设置
111      * @return string ID of the widget. 部件唯一标识
112      */
113     public function getId($autoGenerate = true)
114     {
115         if ($autoGenerate && $this->_id === null) {
116             //如果标识为空,并且设置为允许自动生成标识,自动生成
117             $this->_id = static::$autoIdPrefix . static::$counter++;
118         }
119
120         return $this->_id;
121     }
122
123     /**
124      * Sets the ID of the widget. 设置小部件标识
125      * @param string $value id of the widget. 部件的标识。
126      */
127     public function setId($value)
128     {
129         $this->_id = $value;
130     }
131
132     private $_view;
133
134     /**
135      * Returns the view object that can be used to render views or view files.返回视图对象
136      * The [[render()]] and [[renderFile()]] methods will use
137      * this view object to implement the actual view rendering.
138      * [render()]和[renderFile()]方法用视图对象实现实际的视图显示。
139      * If not set, it will default to the "view" application component.
140      * @return \yii\web\View the view object that can be used to render views or view files.
141      */
142     public function getView()
143     {
144         if ($this->_view === null) {
145             $this->_view = Yii::$app->getView();//如果视图对象为空,调用getView()取得视图对象实例
146         }
147
148         return $this->_view;
149     }
150
151     /**
152      * Sets the view object to be used by this widget. 设置当前部件调用的视图对象实例
153      * @param View $view the view object that can be used to render views or view files.
154      */
155     public function setView($view)
156     {
157         $this->_view = $view;//要用的视图对象
158     }
159
160     /**
161      * Executes the widget. 执行部件
162      * @return string the result of widget execution to be outputted.
163      * 控件执行的结果输出。
164      */
165     public function run()
166     {
167     }
168
169     /**
170      * Renders a view.
171      * The view to be rendered can be specified in one of the following formats:
172      * 渲染一个视图   实际调用View类中的同名方法 渲染的视图可以用下列方式指定路径
173      * - path alias (e.g. "@app/views/site/index");
174      * - absolute path within application (e.g. "//site/index"): the view name starts with double slashes.
175      *   The actual view file will be looked for under the [[Application::viewPath|view path]] of the application.
176      * - absolute path within module (e.g. "/site/index"): the view name starts with a single slash.
177      *   The actual view file will be looked for under the [[Module::viewPath|view path]] of the currently
178      *   active module.
179      * - relative path (e.g. "index"): the actual view file will be looked for under [[viewPath]].
180      *
181      * If the view name does not contain a file extension, it will use the default one `.php`.
182      *
183      * @param string $view the view name.   视图名
184      * @param array $params the parameters (name-value pairs) that should be made available in the view.
185      * 在视图中可用的参数
186      * @return string the rendering result. 渲染结果
187      * @throws InvalidParamException if the view file does not exist.
188      */
189     public function render($view, $params = [])
190     {
191         //调用view类中的render渲染指定的视图
192         return $this->getView()->render($view, $params, $this);
193     }
194
195     /**
196      * Renders a view file. 渲染一个视图文件 同上
197      * @param string $file the view file to be rendered. This can be either a file path or a path alias.
198      * @param array $params the parameters (name-value pairs) that should be made available in the view.
199      * @return string the rendering result.
200      * @throws InvalidParamException if the view file does not exist.
201      */
202     public function renderFile($file, $params = [])
203     {
204         return $this->getView()->renderFile($file, $params, $this);
205     }
206
207     /**
208      * Returns the directory containing the view files for this widget. 返回视图文件路径
209      * The default implementation returns the ‘views‘ subdirectory under the directory containing the widget class file.
210      * @return string the directory containing the view files for this widget.
211      */
212     public function getViewPath()
213     {
214         $class = new ReflectionClass($this);
215         //取得部件类文件的目录,拼接为视图目录
216         return dirname($class->getFileName()) . DIRECTORY_SEPARATOR . ‘views‘;
217     }
218 }
时间: 2024-10-12 17:06:51

yii2源码学习笔记(二十)的相关文章

yii2源码学习笔记(二)

yii\base\Component代码详解 <?php /** * @link http://www.yiiframework.com/ * @copyright Copyright (c) 2008 Yii Software LLC * @license http://www.yiiframework.com/license/ */ namespace yii\base; use Yii; /** * Object is the base class that implements the

yii2源码学习笔记(八)

Action是所有控制器的基类,接下来了解一下它的源码.yii2\base\Action.php 1 <?php 2 /** 3 * @link http://www.yiiframework.com/ 4 * @copyright Copyright (c) 2008 Yii Software LLC 5 * @license http://www.yiiframework.com/license/ 6 */ 7 8 namespace yii\base; 9 10 use Yii; 11 1

OpenFire源码学习之二十九:集群

集群 Openfire的给集群提供了多种方案.一种是基于Hazelcast插件,还有基于Oracle的coherence插件. Linux集群配置 一.修改配置文件 /etc/hosts文件 openfire1 192.168.2.104 openfire2192.168.2.240 每台主机都需要配置 二.添加jar包 将coherence.jar.coherence-work.jar.tangosol.jar添加到lib目录 将clustering.jar放到plugins下面 Hazelc

OpenFire源码学习之二十:在openfire中使用redis插件(下)

Redis插件实现 首先来看下插件目录: RedisServicePlugin 源码清单: import java.io.File; import java.sql.Connection; import java.sql.PreparedStatement; import java.util.Collection; import java.util.HashMap; import java.util.Map; import org.jivesoftware.database.DbConnecti

yii2源码学习笔记(十二)

继续了解controller基类. /** * Runs a request specified in terms of a route.在路径中指定的请求. * The route can be either an ID of an action within this controller or a complete route consisting * of module IDs, controller ID and action ID. If the route starts with

yii2源码学习笔记(十四)

Module类是模块和应用类的基类. yiisoft\yii2\base\Module.php 1 <?php 2 /** 3 * @link http://www.yiiframework.com/ 4 * @copyright Copyright (c) 2008 Yii Software LLC 5 * @license http://www.yiiframework.com/license/ 6 */ 7 8 namespace yii\base; 9 10 use Yii; 11 us

yii2源码学习笔记(十九)

view剩余代码 1 /** 2 * @return string|boolean the view file currently being rendered. False if no view file is being rendered. 3 * 当前正在渲染的视图文件 4 */ 5 public function getViewFile() 6 { 7 return end($this->_viewFiles); 8 } 9 10 /** 11 * This method is invo

yii2源码学习笔记(十六)

Module类的最后代码 1 /** 2 * Registers sub-modules in the current module. 3 * 注册子模块到当前模块 4 * Each sub-module should be specified as a name-value pair, where 5 * name refers to the ID of the module and value the module or a configuration 6 * array that can

yii2源码学习笔记(十五)

这几天有点忙今天好些了,继续上次的module来吧 1 /** 2 * Returns the directory that contains the controller classes according to [[controllerNamespace]]. 3 *根据控制器的命名空间返回控制器的目录路径 4 * Note that in order for this method to return a value, you must define 5 * an alias for th