Yii源码阅读笔记(二十九)
动态模型DynamicModel类,用于实现模型内数据验证:
namespace yii\base; use yii\validators\Validator; /** * DynamicModel is a model class primarily used to support ad hoc data validation. * DynamicModel是一种主要用于支持ad hoc数据验证模型类 * * The typical usage of DynamicModel is as follows, * 典型用法如下: * * ```php * public function actionSearch($name, $email) * { * $model = DynamicModel::validateData(compact('name', 'email'), [ * [['name', 'email'], 'string', 'max' => 128], * ['email', 'email'], * ]); * if ($model->hasErrors()) { * // validation fails * } else { * // validation succeeds * } * } * ``` * * The above example shows how to validate `$name` and `$email` with the help of DynamicModel. * 上面的例子演示了如何用DynamicModel验证用户名`$name`和邮箱`$email` * The [[validateData()]] method creates an instance of DynamicModel, defines the attributes * using the given data (`name` and `email` in this example), and then calls [[Model::validate()]]. * yii\base\DynamicModel::validateData() 方法会创建一个 DynamicModel 的实例对象 * 并通过给定数据定义模型特性(以 name 和email 为例),之后用给定规则调用 yii\base\Model::validate() 方法。 * * You can check the validation result by [[hasErrors()]], like you do with a normal model. * 可以通过[[hasErrors()]]方法获取验证结果 * You may also access the dynamic attributes defined through the model instance, e.g., * `$model->name` and `$model->email`. * * Alternatively, you may use the following more "classic" syntax to perform ad-hoc data validation: * 除此之外呢,你也可以用如下的更加“传统”的语法来执行临时数据验证: * * ```php * $model = new DynamicModel(compact('name', 'email')); * $model->addRule(['name', 'email'], 'string', ['max' => 128]) * ->addRule('email', 'email') * ->validate(); * ``` * * DynamicModel implements the above ad-hoc data validation feature by supporting the so-called * "dynamic attributes". It basically allows an attribute to be defined dynamically through its constructor * or [[defineAttribute()]]. * * @author Qiang Xue <qiang.xue@gmail.com> * @since 2.0 */ class DynamicModel extends Model { /** * @var array 动态模型内动态属性 */ private $_attributes = []; /** * Constructors. * 构造函数,用于将传入的属性赋值给_attributes,便于使用 * @param array $attributes the dynamic attributes (name-value pairs, or names) being defined * @param array $config the configuration array to be applied to this object. */ public function __construct(array $attributes = [], $config = []) { foreach ($attributes as $name => $value) {//遍历传入的属性 if (is_int($name)) {//如果$name是整型,说明只传入了属性名,将属性名写入_attributes $this->_attributes[$value] = null; } else {//否则,按键值对的形式写入 $this->_attributes[$name] = $value; } } parent::__construct($config);//调用父类方法配置对象 } /** * @inheritdoc 重写父类的__get方法,实现从_attributes中取值 */ public function __get($name) { if (array_key_exists($name, $this->_attributes)) {//如果传入的$name在_attributes中存在,则从_attributes中取值 return $this->_attributes[$name]; } else {//否则调用父类的__get方法取属性值 return parent::__get($name); } } /** * @inheritdoc 重写父类的__set方法,实现给_attributes设置值 */ public function __set($name, $value) { if (array_key_exists($name, $this->_attributes)) {//如果传入的$name在_attributes中存在,则将动态属性$name的值设置为$value $this->_attributes[$name] = $value; } else {//否则调用父类的__set方法设置动态属性值 parent::__set($name, $value); } } /** * @inheritdoc 同上,重写父类的__isset方法,实现判断_attributes中是否设置$name值 */ public function __isset($name) { if (array_key_exists($name, $this->_attributes)) { return isset($this->_attributes[$name]); } else { return parent::__isset($name); } } /** * @inheritdoc 同上,重写父类的__unset方法,实现注销_attributes中的$name动态属性值 */ public function __unset($name) { if (array_key_exists($name, $this->_attributes)) { unset($this->_attributes[$name]); } else { parent::__unset($name); } } /** * Defines an attribute. * 用于定义DynamicModel 的动态属性的方法 * @param string $name the attribute name * @param mixed $value the attribute value */ public function defineAttribute($name, $value = null) { $this->_attributes[$name] = $value; } /** * Undefines an attribute. * 用于注销DynamicModel 的动态属性的方法 * @param string $name the attribute name */ public function undefineAttribute($name) { unset($this->_attributes[$name]); } /** * Adds a validation rule to this model. * 添加验证规则 * You can also directly manipulate [[validators]] to add or remove validation rules. * 可以直接调用[[validators]]来添加或者删除验证规则,本方法提供了一个短方法 * This method provides a shortcut. * @param string|array $attributes the attribute(s) to be validated by the rule * @param mixed $validator the validator for the rule.This can be a built-in validator name, * a method name of the model class, an anonymous function, or a validator class name. * @param array $options the options (name-value pairs) to be applied to the validator * @return $this the model itself */ public function addRule($attributes, $validator, $options = []) { $validators = $this->getValidators();//返回所有的验证规则对象 //生成Validator对象,并且插入 $validators中 $validators->append(Validator::createValidator($validator, $this, (array) $attributes, $options)); return $this; } /** * Validates the given data with the specified validation rules. * 通过指定的规则验证给定的数据 * This method will create a DynamicModel instance, populate it with the data to be validated, * create the specified validation rules, and then validate the data using these rules. * @param array $data the data (name-value pairs) to be validated * @param array $rules the validation rules. Please refer to [[Model::rules()]] on the format of this parameter. * @return static the model instance that contains the data being validated * @throws InvalidConfigException if a validation rule is not specified correctly. */ public static function validateData(array $data, $rules = []) { /* @var $model DynamicModel */ /* new static 用于实例化调用类 new self 用于实例化代码书写的那个类*/ $model = new static($data);//实例化调用类,将$data赋值给_attributes if (!empty($rules)) { $validators = $model->getValidators();//获取所有定义的验证规则对象 foreach ($rules as $rule) {//遍历传入的验证规则 if ($rule instanceof Validator) {//如果$rule是Validator的实例,则添加到$validators中 $validators->append($rule); } elseif (is_array($rule) && isset($rule[0], $rule[1])) { // attributes, validator type //如果$rule是数组,则判断动态属性和验证类型是否存在,存在怎创建Validator对象,添加到$validators中 $validator = Validator::createValidator($rule[1], $model, (array) $rule[0], array_slice($rule, 2)); $validators->append($validator); } else {//否则,抛出异常 throw new InvalidConfigException('Invalid validation rule: a rule must specify both attribute names and validator type.'); } } } $model->validate();//执行验证 return $model; } /** * @inheritdoc //返回所有的动态属性 */ public function attributes() { return array_keys($this->_attributes); } }
Yii源码阅读笔记(二十九)的更多相关文章
- Yii源码阅读笔记(十九)
View中渲染view视图文件的前置和后置方法,以及渲染动态内容的方法: /** * @return string|boolean the view file currently being rend ...
- Yii源码阅读笔记(十二)
Action类,控制器中方法的基类: namespace yii\base; use Yii; /** * Action is the base class for all controller ac ...
- Yii源码阅读笔记(十八)
View中的查找视图文件方法和渲染文件方法 /** * Finds the view file based on the given view name. * 通过view文件名查找view文件 * ...
- Yii源码阅读笔记(十五)
Model类,集中整个应用的数据和业务逻辑——验证 /** * Returns the attribute labels. * 返回属性的标签 * * Attribute labels are mai ...
- Yii源码阅读笔记(十六)
Model类,集中整个应用的数据和业务逻辑—— /** * Generates a user friendly attribute label based on the give attribute ...
- Yii源码阅读笔记(十四)
Model类,集中整个应用的数据和业务逻辑——场景.属性和标签: /** * Returns a list of scenarios and the corresponding active attr ...
- Yii源码阅读笔记(十)
控制器类,所有控制器的基类,用于调用模型和布局,输出到视图 namespace yii\base; use Yii; /** * Controller is the base class for cl ...
- Yii源码阅读笔记(一)
今天开始阅读yii2的源码,想深入了解一下yii框架的工作原理,同时学习一下优秀的编码规范和风格.在此记录一下阅读中的小心得. 每个框架都有一个入口文件,首先从入口文件开始,yii2的入口文件位于we ...
- werkzeug源码阅读笔记(二) 下
wsgi.py----第二部分 pop_path_info()函数 先测试一下这个函数的作用: >>> from werkzeug.wsgi import pop_path_info ...
- werkzeug源码阅读笔记(二) 上
因为第一部分是关于初始化的部分的,我就没有发布出来~ wsgi.py----第一部分 在分析这个模块之前, 需要了解一下WSGI, 大致了解了之后再继续~ get_current_url()函数 很明 ...
随机推荐
- [转]Tangram框架应用开发的一般模式
//转的,怕想百度博客一样搬家,赶紧先复制下来. 框架其实就是一种开发模式,用tangram框架开发应用程序意味着选择一种面向接口.模块化的开发方式.这和传统的Delphi应用程序开发方式有一定区别, ...
- Git Commands
Show ssh key file: ssh -v git@github.com
- 转载:robotium typeText与enterText区别
solo.typeText和solo.enterText方法都可以对EditeText进行测试,达到的测试目的是一样的.存在几点不同: 1.实现上,typeText方法是robotium框架调用系统I ...
- Shell 编程基础之括号的作用
一.小括号() 单小括号 命令组.括号中的命令将会新开一个子shell顺序执行,所以括号中的变量不能够被脚本余下的部分使用.括号中多个命令之间用分号隔开,最后一个命令可以没有分号,各命令和括号之间不必 ...
- UVa 10870 & 矩阵快速幂
题意: 求一个递推式(不好怎么概括..)的函数的值. 即 f(n)=a1f(n-1)+a2f(n-2)+...+adf(n-d); SOL: 根据矩阵乘法的定义我们可以很容易地构造出矩阵,每次乘法即可 ...
- Android HttpURLConnection Post 参数 (https)
声明utf-8: public static String CHARSET_UTF8 = HTTP.UTF_8; eg:登陆请求方法,通过接口返回结果: public static void logi ...
- android NDK入门 windows下安装cygwin
一.Android NDK环境简介 Android NDK 是运行于Android 平台上的Native Development Kit 的缩写. Android 应用开发者可以通过NDK 调用C 或 ...
- [知识点]平衡树之Splay
// 此博文为迁移而来,写于2015年7月18日,不代表本人现在的观点与看法.原始地址:http://blog.sina.com.cn/s/blog_6022c4720102w6rg.html 1.前 ...
- 转:jQuery插件开发精品教程,让你的jQuery提升一个台阶
要说jQuery 最成功的地方,我认为是它的可扩展性吸引了众多开发者为其开发插件,从而建立起了一个生态系统.这好比大公司们争相做平台一样,得平台者得天下.苹果,微软,谷歌等巨头,都有各自的平台及生态圈 ...
- Codeforces Round #210 (Div. 2) C. Levko and Array Recovery
题目链接 线段树的逆过程,想了老一会,然后发现应该是包含区间对存在有影响,就不知怎么做了...然后尚大神,说,So easy,你要倒着来,然后再正着来,判断是不是合法就行了.然后我乱写了写,就过了.数 ...