首页 > 代码库 > ExtJS教程(5)---Ext.data.Model之高级应用

ExtJS教程(5)---Ext.data.Model之高级应用

1、Model的数据验证

这里借助官方的一个例子来说Model数据验证的基本用法

	Ext.define('User', {
	    extend: 'Ext.data.Model',
	    fields: [
	        { name: 'name',     type: 'string' },
	        { name: 'age',      type: 'int' },
	        { name: 'phone',    type: 'string' },
	        { name: 'gender',   type: 'string' },
	        { name: 'username', type: 'string' },
	        { name: 'alive',    type: 'boolean', defaultValue: true }
	    ],
	
	    validators: {
	        age: 'presence',
	        name: { type: 'length', min: 2 },
	        gender: { type: 'inclusion', list: ['Male', 'Female'] },
	        username: [
	            { type: 'exclusion', list: ['Admin', 'Operator'] },
	            { type: 'format', matcher: /([a-z]+)[0-9]{2,3}/i }
	        ]
	    }
	});
	
	var instance = Ext.create('User', {
	    name: 'Ed',
	    gender: 'Male',
	    username: 'edspencer'
	});

	var validation = instance.getValidation();
	console.log(validation);
数据验证在validators属性中定义,数据验证的类型在Ext.data.validator下,Ext提供了8中验证。下面一一解释意思

age:‘presence‘,字段后面直接写字符串表示这个类型的验证,类型查看的方法,打开这个类,在第一行就可以看到,如下

Ext.data.validator.Presencedata: validator.presence

validator.presence中的presence就是这个验证类的type,这种写法等同于{type:‘presence‘},presence类的意思是这个字段的值不能是null或undefined

name:使用的是长度验证,表示最小长度为2,验证类中各属性的配置,参见Ext官方API中这个类的config列表

gender:与name类似,表示这个字段只能是‘Male‘,或者‘Female‘

username:的意思是不能包含Admin和Operator并且需满足后面的正则表达式。如果一个字段有多个验证的话可以参考username的形式。

下面我们自定义一个年龄的验证,首先值必须是数字,其次值需大于0小于160

	Ext.define('Ext.data.validator.Age',{
		extend:'Ext.data.validator.Validator',
		alias: 'data.validator.age',
    	type: 'age',
    	
    	config:{
    		message: 'Is in the wrong age',
    		max:160 //默认最大年龄为160
    	},
    	
    	/**
    	 * 验证类中的核心方法
    	 * @param {Object} value
    	 * @return {Boolean} 返回true表示通过验证,否则返回message
    	 */
    	validate:function(value){
    		console.log(value);
    		var result = Ext.isNumber(value);
    		if(result){
    			result = value>0 && value < this.getMax();
    		}
    		
    		return result ? result : this.getMessage();
    	}
	});
用法如同Ext自带的验证类,需要注意的是这个类的定义需要在使用之前定义

2、Model转换的应用

如下面的转换,我们给电话号码前面加上+86

	Ext.define('User', {
	    extend: 'Ext.data.Model',
	    fields: [
	        { name: 'name',     type: 'string' },
	        { name: 'age',      type: 'int' },
	        { name: 'phone',    type: 'string', convert:function(value){
	        	
	        	//如果值是字符串,并且没有以+86开头
	        	if(Ext.isString(value) && !Ext.String.startsWith(value,'+86')){
	        		return '+86'+value;
	        	}
	        }},
	        { name: 'gender',   type: 'string' },
	        { name: 'username', type: 'string' },
	        { name: 'alive',    type: 'boolean', defaultValue: true }
	    ]
	});
	
	var user = Ext.create('User', {
	    phone:'15938383838'
	});

	//var validation = instance.getValidation();
	console.log(user.get('phone'));
上面的Model我们给phone加上了转换,那么在定义Model或者给phone赋值时,就会自动调用convert,检查phone是否是字符串、是否以+86开头,如果是字符串并且没有以+86开头则自动给phone加上+86

这个在0,1转true、false的时候用的比较多

3、Model之Ajax

	Ext.define('User', {
	    extend: 'Ext.data.Model',
	    idProperty:'id',
	    fields: ['id', 'name', 'email'],
	
	    proxy: {
	        type: 'rest',
	        api: {
			    create: 'user/add',
			    read: 'user/get', //在调用Model的静态方法load时,会默认去这里查数据
			    update: 'user/update',
			    destroy: 'user/del' //在调用Model的erase方法(Ext5.0以前的版本是destroy方法,意思就是根据ID删除Model)
			}
	    }
	});
在调用save方法时,会自动判断Model的id属性是否有值如果有就使用update路径,如果没有就使用create路径,在5.0之前的版本save和update是一个方法,5.0的版本中其实save,update,delete用的都是save方法,这一点从源码中可以看出

    /**
     * Destroys the model using the configured proxy.
     * @param {Object} options Options to pass to the proxy. Config object for {@link Ext.data.operation.Operation}.
     * @return {Ext.data.operation.Operation} The operation
     */
    erase: function(options) {
        this.drop();
        return this.save(options);
    },

    /**
     * Saves the model instance using the configured proxy.
     * @param {Object} [options] Options to pass to the proxy. Config object for {@link Ext.data.operation.Operation}.
     * @return {Ext.data.operation.Operation} The operation
     */
    save: function(options) {
        options = Ext.apply({}, options);
        
        var me = this,
            phantom = me.phantom,
            dropped = me.dropped,
            action = dropped ? 'destroy' : (phantom ? 'create' : 'update'),
            scope  = options.scope || me,
            callback = options.callback,
            proxy = me.getProxy(),
            operation;
            
        options.records = [me];
        options.internalCallback = function(operation) {
            var args = [me, operation],
                success = operation.wasSuccessful();
            if (success) {
                Ext.callback(options.success, scope, args);
            } else {
                Ext.callback(options.failure, scope, args);
            }
            args.push(success);
            Ext.callback(callback, scope, args);
        };
        delete options.callback;
        
        operation = proxy.createOperation(action, options);

        // Not a phantom, then we must perform this operation on the remote datasource.
        // Record will be removed from the store in the callback upon a success response
        if (dropped && phantom) {
            // If it's a phantom, then call the callback directly with a dummy successful ResultSet
            operation.setResultSet(Ext.data.reader.Reader.prototype.nullResultSet);
            me.setErased();
            operation.setSuccessful(true);
        } else {
            operation.execute();
        }
        return operation;
    },

4、Model中的常用方法

Model中常用的方法在上面也提到了一些,下面介绍上面没有提到的

get(filedName):根据字段名获取字段的值,这个在上面用到过,这里重复强调一遍,这个是用的最多的方法之一

getId():获取Model的id,前提是要设置idProperty这个属性

getIdProperty:获取ID字段的值

isVaild():判断Model是否通过验证
set( fieldName, newValue, [options] ):为字段赋值,可以穿一个Object形式的参数如{name:‘jaune‘,age:24}