1. module koa-validate
   1. function koa-validate (app)
   2. function koa-validate.FileValidator (context, key, value, exists, params, deleteOnCheckFailed)
   3. function koa-validate.Validator (context, key, value, exists, params , goOn)
   4. object koa-validate.FileValidator.prototype
   5. object koa-validate.Validator.prototype
2. module koa-validate.FileValidator
   1. function koa-validate.FileValidator (context, key, value, exists, params, deleteOnCheckFailed)
   2. function koa-validate.FileValidator.super_ (context, key, value, exists, params , goOn)
3. module koa-validate.FileValidator.prototype
   1. function koa-validate.FileValidator.prototype.contentTypeMatch (reg, tip)
   2. function koa-validate.FileValidator.prototype.copy (dst, afterCopy)
   3. function koa-validate.FileValidator.prototype.delete ()
   4. function koa-validate.FileValidator.prototype.fileNameMatch (reg, tip)
   5. function koa-validate.FileValidator.prototype.isImageContentType (tip)
   6. function koa-validate.FileValidator.prototype.move (dst, afterMove)
   7. function koa-validate.FileValidator.prototype.notEmpty (tip)
   8. function koa-validate.FileValidator.prototype.size (min, max, tip)
   9. function koa-validate.FileValidator.prototype.suffixIn (arr, tip)
4. module koa-validate.Validator
   1. function koa-validate.Validator (context, key, value, exists, params , goOn)
5. module koa-validate.Validator.prototype
   1. function koa-validate.Validator.prototype.addError (tip)
   2. function koa-validate.Validator.prototype.blacklist (s)
   3. function koa-validate.Validator.prototype.byteLength (min, max, charset, tip)
   4. function koa-validate.Validator.prototype.check (fn , tip, scope)
   5. function koa-validate.Validator.prototype.clone (key , value)
   6. function koa-validate.Validator.prototype.contains (s, tip)
   7. function koa-validate.Validator.prototype.decodeBase64 (inBuffer , tip)
   8. function koa-validate.Validator.prototype.decodeURI (tip)
   9. function koa-validate.Validator.prototype.decodeURIComponent (tip)
   10. function koa-validate.Validator.prototype.default (d)
   11. function koa-validate.Validator.prototype.empty ()
   12. function koa-validate.Validator.prototype.encodeBase64 ()
   13. function koa-validate.Validator.prototype.encodeURI ()
   14. function koa-validate.Validator.prototype.encodeURIComponent ()
   15. function koa-validate.Validator.prototype.ensure (assertion, tip, shouldBail)
   16. function koa-validate.Validator.prototype.ensureNot (assertion, tip, shouldBail)
   17. function koa-validate.Validator.prototype.eq (l, tip)
   18. function koa-validate.Validator.prototype.escape ()
   19. function koa-validate.Validator.prototype.exist (tip)
   20. function koa-validate.Validator.prototype.filter (cb, scope)
   21. function koa-validate.Validator.prototype.first (index)
   22. function koa-validate.Validator.prototype.ge (l, tip)
   23. function koa-validate.Validator.prototype.get (index)
   24. function koa-validate.Validator.prototype.gt (l, tip)
   25. function koa-validate.Validator.prototype.hasError ()
   26. function koa-validate.Validator.prototype.hash (alg , enc)
   27. function koa-validate.Validator.prototype.in (arr, tip)
   28. function koa-validate.Validator.prototype.isAfter (d, tip)
   29. function koa-validate.Validator.prototype.isAlpha (tip, locale)
   30. function koa-validate.Validator.prototype.isAlphanumeric (tip, locale)
   31. function koa-validate.Validator.prototype.isAscii (tip)
   32. function koa-validate.Validator.prototype.isBase64 (tip)
   33. function koa-validate.Validator.prototype.isBefore (d, tip)
   34. function koa-validate.Validator.prototype.isByteLength (min, max, charset, tip)
   35. function koa-validate.Validator.prototype.isCreditCard (tip)
   36. function koa-validate.Validator.prototype.isCurrency (tip, options)
   37. function koa-validate.Validator.prototype.isDataURI (tip)
   38. function koa-validate.Validator.prototype.isDate (tip)
   39. function koa-validate.Validator.prototype.isDivisibleBy (n, tip)
   40. function koa-validate.Validator.prototype.isEmail (tip, options)
   41. function koa-validate.Validator.prototype.isFQDN (tip, options)
   42. function koa-validate.Validator.prototype.isFloat (tip, options)
   43. function koa-validate.Validator.prototype.isFullWidth (tip)
   44. function koa-validate.Validator.prototype.isHalfWidth (tip)
   45. function koa-validate.Validator.prototype.isHexColor (tip)
   46. function koa-validate.Validator.prototype.isHexadecimal (tip)
   47. function koa-validate.Validator.prototype.isISBN (tip, version)
   48. function koa-validate.Validator.prototype.isISIN (tip)
   49. function koa-validate.Validator.prototype.isISO8601 (tip)
   50. function koa-validate.Validator.prototype.isIn (arr, tip)
   51. function koa-validate.Validator.prototype.isInt (tip, options)
   52. function koa-validate.Validator.prototype.isIp (tip, version)
   53. function koa-validate.Validator.prototype.isJSON (tip)
   54. function koa-validate.Validator.prototype.isLength (min, max, tip)
   55. function koa-validate.Validator.prototype.isLowercase (tip)
   56. function koa-validate.Validator.prototype.isMACAddress (tip)
   57. function koa-validate.Validator.prototype.isMobilePhone (tip, locale)
   58. function koa-validate.Validator.prototype.isMultibyte (tip)
   59. function koa-validate.Validator.prototype.isNull (tip)
   60. function koa-validate.Validator.prototype.isNumeric (tip)
   61. function koa-validate.Validator.prototype.isSurrogatePair (tip)
   62. function koa-validate.Validator.prototype.isTime (tip)
   63. function koa-validate.Validator.prototype.isUUID (tip, ver)
   64. function koa-validate.Validator.prototype.isUppercase (tip)
   65. function koa-validate.Validator.prototype.isUrl (tip, options)
   66. function koa-validate.Validator.prototype.isVariableWidth (tip)
   67. function koa-validate.Validator.prototype.le (l, tip)
   68. function koa-validate.Validator.prototype.len (min, max, tip)
   69. function koa-validate.Validator.prototype.lt (l, tip)
   70. function koa-validate.Validator.prototype.ltrim (c)
   71. function koa-validate.Validator.prototype.match (reg, tip)
   72. function koa-validate.Validator.prototype.md5 ()
   73. function koa-validate.Validator.prototype.neq (l, tip)
   74. function koa-validate.Validator.prototype.notBlank (tip)
   75. function koa-validate.Validator.prototype.notContains (s, tip)
   76. function koa-validate.Validator.prototype.notEmpty (tip)
   77. function koa-validate.Validator.prototype.notMatch (reg, tip)
   78. function koa-validate.Validator.prototype.optional ()
   79. function koa-validate.Validator.prototype.replace (a, b)
   80. function koa-validate.Validator.prototype.rtrim (c)
   81. function koa-validate.Validator.prototype.sha1 ()
   82. function koa-validate.Validator.prototype.stripLow (nl)
   83. function koa-validate.Validator.prototype.toBoolean ()
   84. function koa-validate.Validator.prototype.toDate ()
   85. function koa-validate.Validator.prototype.toFloat (tip)
   86. function koa-validate.Validator.prototype.toInt (tip, radix, options)
   87. function koa-validate.Validator.prototype.toJson (tip)
   88. function koa-validate.Validator.prototype.toLow ()
   89. function koa-validate.Validator.prototype.toLowercase ()
   90. function koa-validate.Validator.prototype.toUp ()
   91. function koa-validate.Validator.prototype.toUppercase ()
   92. function koa-validate.Validator.prototype.trim (c)
   93. function koa-validate.Validator.prototype.type (t, tip)
   94. function koa-validate.Validator.prototype.whitelist (s)

module koa-validate

function koa-validate (app)

• description and source-code

  koa-validate = function (app) {
  	app.context.checkQuery = function(key,transFn) {
  		return new Validator(this, key, getValue(this.request.query,key,transFn), hasKey(this.request.query, key, transFn),this.request
  .query);
  	};
  	app.context.checkParams = function(key) {
  		return new Validator(this, key, this.params[key], key in this.params,this.params);
  	};
  	app.context.checkHeader = function(key) {
  		return new Validator(this, key, this.header[key], key in this.header,this.header);
  	};
  	app.context.checkBody = function(key,transFn) {
  		var body = this.request.body;
  
  		if(!body) {
  			if(!this.errors){
  				this.errors = ['no body to check!'];
  			}
  			return new Validator(this, null, null,false, null ,false );
  		}
  		var body =  body.fields || body;	// koa-body fileds. multipart fields in body.fields
  		return new Validator(this, key,getValue(body,key,transFn), hasKey(body, key, transFn), body);
  	};
  	app.context.checkFile = function(key , deleteOnCheckFailed) {
  		if('undefined' == typeof this.request.body || 'undefined' == typeof this.request.body.files ) {
  			if(!this.errors){
  				this.errors = ['no file to check'];
  			}
  			return new Validator(this, null, null,false, null,false );
  		}
  		deleteOnCheckFailed = ('undefined' == typeof deleteOnCheckFailed?true :false);
  		var files = this.request.body.files;
  		return new FileValidator(this, key ,files&&files[key],!!(files&&files[key]) , this.request.body , deleteOnCheckFailed);
  	};
  	// return function* (next) {
  	// 	yield next;
  	// };
  
  }

• example usage

  n/a

function koa-validate.FileValidator (context, key, value, exists, params, deleteOnCheckFailed)

• description and source-code

  function FileValidator(context, key, value, exists, params, deleteOnCheckFailed){
  	Validator.call(this,context, key, value, exists, params ,true);
  	this.deleteOnCheckFailed = deleteOnCheckFailed;
  }

• example usage

  n/a

function koa-validate.Validator (context, key, value, exists, params , goOn)

• description and source-code

  function Validator(context, key, value, exists, params , goOn) {
  	this.params = params;
  	this.context = context;
  	this.key = key;
  	this.value = value;
  	this.exists = exists;
  	this.goOn = (false===goOn?false:true);
  	if(this.value && this instanceof FileValidator && 'goOn' in this.value ){
  		this.goOn = this.value.goOn;
  	}
  }

• example usage

  n/a

module koa-validate.FileValidator

function koa-validate.FileValidator (context, key, value, exists, params, deleteOnCheckFailed)

• description and source-code

  function FileValidator(context, key, value, exists, params, deleteOnCheckFailed){
  	Validator.call(this,context, key, value, exists, params ,true);
  	this.deleteOnCheckFailed = deleteOnCheckFailed;
  }

• example usage

  n/a

function koa-validate.FileValidator.super_ (context, key, value, exists, params , goOn)

• description and source-code

  function Validator(context, key, value, exists, params , goOn) {
  	this.params = params;
  	this.context = context;
  	this.key = key;
  	this.value = value;
  	this.exists = exists;
  	this.goOn = (false===goOn?false:true);
  	if(this.value && this instanceof FileValidator && 'goOn' in this.value ){
  		this.goOn = this.value.goOn;
  	}
  }

• example usage

  n/a

module koa-validate.FileValidator.prototype

function koa-validate.FileValidator.prototype.contentTypeMatch (reg, tip)

• description and source-code

  contentTypeMatch = function (reg, tip){
  	if (this.goOn && (!this.value || !reg.test(this.value.type))) {
  		this.addError(tip || "file "+ (this.value && this.value.name||this.key) + " is bad format.");
  		if(this.deleteOnCheckFailed){
  			delFileAsync(this.value &&this.value.path);
  		}
  	}
  	return this;
  }

• example usage

  ...
  
  describe('koa-validate' , function(){
  	// this.timeout(100000);
  	it("file check ok" , function(done){
  		var app = appFactory.create(1);
  		app.router.post('/upload',function*(){
  			this.checkFile('empty').empty();
  			// this.checkFile('file1').empty().contentTypeMatch(/^text/);
  			this.checkFile('file').empty().contentTypeMatch(/^application\//);
  			yield this.checkFile('file1').empty().move(__dirname+"/temp", function(file , context){
  			});
  			this.checkFile('file').notEmpty();
  			yield this.checkFile('file').notEmpty().copy(__dirname+"/tempdir/" , function(file , context){
  			});
  			yield this.checkFile('file').notEmpty().copy(__dirname);
  ...

function koa-validate.FileValidator.prototype.copy (dst, afterCopy)

• description and source-code

  function* (dst, afterCopy){
  	if (this.goOn && this.value ) {
  		var dstFile = dst;
  		if('function' == typeof dst){
  			if(isGeneratorFunction(dst)){
  				dstFile = yield dst(this.value,this.key,this.context);
  			}else{
  				dstFile = dst(this.value,this.key,this.context);
  			}
  		}
  		if(!(yield coFsExists(this.value.path))){
  			this.addError('upload file not exists');
  			return;
  		}
  		if(dstFile.length-1 == dstFile.lastIndexOf('/') ||dstFile.length-1 == dstFile.lastIndexOf('\\')||(yield coFsExists(dstFile)) && (
  yield coFsIsDir(dstFile))){
  			dstFile = path.join(dstFile , path.basename(this.value.path));
  		}
  		yield ensureDir(path.dirname(dstFile));
  		yield coFsCopy(this.value.path,dstFile);
  		this.value.newPath = dstFile;
  		if('function' == typeof afterCopy){
  			if(isGeneratorFunction(afterCopy)){
  				yield afterCopy(this.value,this.key,this.context);
  			}else{
  				afterCopy(this.value,this.key,this.context);
  			}
  		}
  	}
  	return this;
  }

• example usage

  ...
  - **size(min,max,[tip])** - limit the file size.
  - **contentTypeMatch(reg,[tip])** - check the file's contentType with regular expression.
  - **isImageContentType([tip])** - check the file's contentType if is image content type.
  - **fileNameMatch(reg,[tip])** - check the file's name with regular expression.
  - **suffixIn(arr,[tip])** - check the suffix of file's if in specified arr. `arr` eg. ['png','jpg']
  
  #### Sanitizers:
  File sanitizers are generators,we should use `yield` to execute them. eg. `yield this.checkFile('file').notEmpty().copy('/')`;
  
  - **move(target,[afterMove])** - move upload file to the target location. target can be a `string` or `function` or `function*`.
  if target end with '/' or '\\',the target will be deemed as directory.
  target function interface:`string function(fileObject,fieldName,context)`.this function will return a string of the target file.
  afterMove:it can be a `function` or `function*`.interface:`function(fileObject,fieldName,context)`
  - **copy(target,[afterCopy])** - move upload file to the target location. target can be a `string` or `function` or `function*`.
  target function interface:`function (fileObject,fieldName,context)` .
  afterCopy:it can be a `function` or `function*`.interface:`function(fileObject,fieldName,context)`
  - **delete()** - delete upload file.
  ...

function koa-validate.FileValidator.prototype.delete ()

• description and source-code

  function* (){
  	if (this.goOn && this.value ) {
  		yield coFsDel(this.value.path);
  	}
  	return this;
  }

• example usage

  ...
  			this.checkFile('file').notEmpty();
  			yield this.checkFile('file').notEmpty().copy(__dirname+"/tempdir/" , function(file , context){
  			});
  			yield this.checkFile('file').notEmpty().copy(__dirname);
  			yield this.checkFile('file').notEmpty().copy(function(){return __dirname+"/temp"});
  			yield (yield this.checkFile('file').notEmpty().fileNameMatch(/^.*.js$/).size(0,10*1024).suffixIn(['js']).
  copy(function*(obj){
  				return __dirname+"/temp";
  			})).delete();
  			require('fs').unlinkSync(__dirname+'/temp');
  			require('fs').unlinkSync(__dirname+'/'+require('path').basename(this.request.body.files.file.path
  ));
  			require('fs').unlinkSync(__dirname+'/tempdir/'+require('path').basename(this.request.body.files
  .file.path));
  			// require('fs').unlinkSync(__dirname+'/tempdir');
  			if(this.errors){
  				this.body = this.errors;
  				return;
  ...

function koa-validate.FileValidator.prototype.fileNameMatch (reg, tip)

• description and source-code

  fileNameMatch = function (reg, tip){
  	if (this.goOn && (!this.value || !reg.test(this.value.name))) {
  		this.addError(tip || "file "+ (this.value && this.value.name||this.key) + " is bad file type.");
  		if(this.deleteOnCheckFailed){
  			delFileAsync(this.value&&this.value.path);
  		}
  	}
  	return this;
  }

• example usage

  ...
  			yield this.checkFile('file1').empty().move(__dirname+"/temp", function(file , context){
  			});
  			this.checkFile('file').notEmpty();
  			yield this.checkFile('file').notEmpty().copy(__dirname+"/tempdir/" , function(file , context){
  			});
  			yield this.checkFile('file').notEmpty().copy(__dirname);
  			yield this.checkFile('file').notEmpty().copy(function(){return __dirname+"/temp"});
  			yield (yield this.checkFile('file').notEmpty().fileNameMatch(/^.*.js$/).
  size(0,10*1024).suffixIn(['js']).copy(function*(obj){
  				return __dirname+"/temp";
  			})).delete();
  			require('fs').unlinkSync(__dirname+'/temp');
  			require('fs').unlinkSync(__dirname+'/'+require('path').basename(this.request.body.files.file.path
  ));
  			require('fs').unlinkSync(__dirname+'/tempdir/'+require('path').basename(this.request.body.files
  .file.path));
  			// require('fs').unlinkSync(__dirname+'/tempdir');
  			if(this.errors){
  ...

function koa-validate.FileValidator.prototype.isImageContentType (tip)

• description and source-code

  isImageContentType = function (tip){
  	if (this.goOn && (!this.value || 0!==this.value.type.indexOf('image/'))) {
  		this.addError(tip || "file "+ (this.value && this.value.name||this.key) + " is not a image format.");
  		if(this.deleteOnCheckFailed){
  			delFileAsync(this.value &&this.value.path);
  		}
  	}
  	return this;
  }

• example usage

  ...
  			this.checkFile('file0').size(10,10 );
  			this.checkFile('file').size(1024*100,1024*1024*10 );
  			this.checkFile('file1').size(1024*100,1024*1024*1024*10 );
  			this.checkFile('file2').suffixIn(['png']);
  			this.checkFile('file3').contentTypeMatch(/^image\/.*$/);
  			this.checkFile('file4').contentTypeMatch(/^image\/.*$/);
  			this.checkFile('file5').fileNameMatch(/\.png$/);
  			this.checkFile('file6').isImageContentType("not image content type.&#
  x22;);
  
  
  			if(9 === this.errors.length){
  				this.body = 'ok';
  				return ;
  			}else{
  				this.body = 'not ok';
  ...

function koa-validate.FileValidator.prototype.move (dst, afterMove)

• description and source-code

  function* (dst, afterMove){
  	if (this.goOn && this.value ) {
  		yield this.copy(dst);
  		yield coFsDel(this.value.path);
  		if('function' == typeof afterMove){
  			if(isGeneratorFunction(afterMove)){
  				yield afterMove(this.value,this.key,this.context);
  			}else{
  				afterMove(this.value,this.key,this.context);
  			}
  		}
  	}
  	return this;
  }

• example usage

  ...
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?");
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" , function*(file,context){
  		//resize image
  	});
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  ...

function koa-validate.FileValidator.prototype.notEmpty (tip)

• description and source-code

  notEmpty = function (tip){
  	if (this.goOn && (!this.value||this.value.size<=0)) {
  		this.addError(tip || "file "+ this.key + " can not be a empty file.");
  		if(this.deleteOnCheckFailed){
  			delFileAsync(this.value&&this.value.path);
  		}
  	}
  	return this;
  }

• example usage

  ...
  
  app.use(require('koa-body')({multipart:true , formidable:{keepExtensions:true}}));
  app.use(router.routes()).use(router.allowedMethods());
  router.post('/signup', function * () {
  	//optional() means this param may not in the params.
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?");
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" ,
  function*(file,context){
  		//resize image
  	});
  ...

function koa-validate.FileValidator.prototype.size (min, max, tip)

• description and source-code

  size = function (min, max, tip){
  	if (this.goOn && (!this.value||this.value.size<min || this.value.size>max)) {
  		this.addError(tip || "file "+(this.value && this.value.name||this.key) + "' length must between "+formatSize(min)+" and "+formatSize
  (max)+".");
  		if(this.deleteOnCheckFailed){
  			delFileAsync(this.value &&this.value.path);
  		}
  	}
  	return this;
  }

• example usage

  ...
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?");
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large
  ').move("/static/icon/" , function*(file,context){
  		//resize image
  	});
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  ...

function koa-validate.FileValidator.prototype.suffixIn (arr, tip)

• description and source-code

  suffixIn = function (arr, tip){
  	if (this.goOn && (!this.value || -1==arr.indexOf(-1==this.value.name.lastIndexOf('.')?"":this.value.name.substring(this.value.name
  .lastIndexOf('.')+1)))) {
  		this.addError(tip || "file "+ (this.value && this.value.name||this.key) + " is bad file type.");
  		if(this.deleteOnCheckFailed){
  			delFileAsync(this.value &&this.value.path);
  		}
  	}
  	return this;
  }

• example usage

  ...
  			yield this.checkFile('file1').empty().move(__dirname+"/temp", function(file , context){
  			});
  			this.checkFile('file').notEmpty();
  			yield this.checkFile('file').notEmpty().copy(__dirname+"/tempdir/" , function(file , context){
  			});
  			yield this.checkFile('file').notEmpty().copy(__dirname);
  			yield this.checkFile('file').notEmpty().copy(function(){return __dirname+"/temp"});
  			yield (yield this.checkFile('file').notEmpty().fileNameMatch(/^.*.js$/).size(0,10*1024).suffixIn(['js']).copy(function*(obj){
  				return __dirname+"/temp";
  			})).delete();
  			require('fs').unlinkSync(__dirname+'/temp');
  			require('fs').unlinkSync(__dirname+'/'+require('path').basename(this.request.body.files.file.path
  ));
  			require('fs').unlinkSync(__dirname+'/tempdir/'+require('path').basename(this.request.body.files
  .file.path));
  			// require('fs').unlinkSync(__dirname+'/tempdir');
  			if(this.errors){
  ...

module koa-validate.Validator

function koa-validate.Validator (context, key, value, exists, params , goOn)

• description and source-code

  function Validator(context, key, value, exists, params , goOn) {
  	this.params = params;
  	this.context = context;
  	this.key = key;
  	this.value = value;
  	this.exists = exists;
  	this.goOn = (false===goOn?false:true);
  	if(this.value && this instanceof FileValidator && 'goOn' in this.value ){
  		this.goOn = this.value.goOn;
  	}
  }

• example usage

  n/a

module koa-validate.Validator.prototype

function koa-validate.Validator.prototype.addError (tip)

• description and source-code

  addError = function (tip) {
  	this.goOn = false;
  	if(this.value && this instanceof FileValidator ){
  		this.value.goOn = false;
  	}
  	if (!this.context.errors) {
  		this.context.errors = [];
  	}
  	var e = {};
  	e[this.key] = tip;
  	this.context.errors.push(e);
  }

• example usage

  ...
  	if (!this.exists) {
  		this.goOn = false;
  	}
  	return this;
  };
  Validator.prototype.notEmpty = function(tip) {
  	if (this.goOn && (null==this.value||'undefined'==typeof(this.value) || ('string' == typeof(this.value
  ) &&!this.value))) {
  		this.addError(tip || this.key + " can not be empty.");
  	}
  	return this;
  };
  Validator.prototype.empty = function() {
  	if (this.goOn) {
  		if (!this.value) {
  			this.goOn = false;
  ...

function koa-validate.Validator.prototype.blacklist (s)

• description and source-code

  blacklist = function (s) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.blacklist(this.value,s);
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.whitelist(this.value,s);
  	}
  	return this;
  };
  Validator.prototype.blacklist = function(s) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.blacklist(this.value,s);
  	}
  	return this;
  };
  Validator.prototype.encodeURI = function() {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = encodeURI(this.value);
  	}
  ...

function koa-validate.Validator.prototype.byteLength (min, max, charset, tip)

• description and source-code

  byteLength = function (min, max, charset, tip) {
  	min = min || 0;
  	max = max || Number.MAX_VALUE;
  	charset = charset||'utf8';
  	this.notEmpty(tip);
  	if (this.goOn) {
  		var bl = Buffer.byteLength(this.value , charset);
  		tip = 'number' != typeof max ? max : tip;
  		if (bl<min || bl>max) {
  			this.addError(tip || this.key + "'s byte lenth great than " + min +" and less than " + max + "." );
  		}
  	}
  	return this;
  }

• example usage

  ...
  };
  Validator.prototype.isByteLength = function(min, max,charset,tip) {
  	min = min || 0;
  	max = max || Number.MAX_VALUE;
  	charset = charset||'utf8';
  	this.notEmpty(tip);
  	if (this.goOn) {
  		var bl = Buffer.byteLength(this.value , charset);
  		tip = 'number' != typeof max ? max : tip;
  		if (bl<min || bl>max) {
  			this.addError(tip || this.key + "'s byte lenth great than " + min +" and less than " + max + ".&#
  x22; );
  		}
  	}
  	return this;
  };
  ...

function koa-validate.Validator.prototype.check (fn , tip, scope)

• description and source-code

  check = function (fn , tip, scope) {
  	if(this.goOn && !this.hasError()&&!fn.call(scope||this,this.value,this.key,this.context)) {
  		this.addError(tip||this.key+" check failed.")
  	}
  	return this;
  }

• example usage

  n/a

function koa-validate.Validator.prototype.clone (key , value)

• description and source-code

  clone = function (key , value) {
  	if (!this.hasError()&&this.value) {
  		this.value = this.params[key] = ('undefined' == typeof value?this.value:value);
  		this.key = key;
  	}
  	return this;
  }

• example usage

  ...
  - **whitelist(value)** - remove characters that do not appear in the whitelist.
  - **blacklist(value)** - remove characters that appear in the blacklist.
  - **encodeURI()** - ref mdn [encodeURI](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURI
  )
  - **decodeURI([tip])** - ref mdn [decodeURI](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURI
  )
  - **encodeURIComponent()** - ref mdn [encodeURIComponent](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects
  /encodeURIComponent)
  - **decodeURIComponent([tip])** - ref mdn [decodeURIComponent](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference
  /Global_Objects/decodeURIComponent)
  - **replace(regexp|substr, newSubStr|function)** - the same as [String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/
  Reference/Global_Objects/String/replace) replace
  - **clone(newKey,[newValue])** - clone current value to the new key, if newValue supplied , use it. eg. `this.checkBody('v1
  ').clone('md5').md5()`; then your can use `this.request.body.md5`.
  - **encodeBase64()** - encode current value to base64 string.
  - **decodeBase64([inBuffer],[tip])** - decode current base64 to a normal string,if inBuffer is true , the value will be a Buffer
  .
  - **hash(alg , [encoding])** - hash current value use specified algorithm and encoding(if supplied , default is 'hex').
  ref [hash](http://nodejs.org/api/crypto.html#crypto_class_hash)
  - **md5()** - md5 current value into hex string.
  - **sha1()** - sha1 current value into hex string.
  
  ### For json path:
  ...

function koa-validate.Validator.prototype.contains (s, tip)

• description and source-code

  contains = function (s, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.contains(this.value,s))) {
  		this.addError(tip || this.key + " is must contain " + s + ".");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.le = function(l, tip) {
  	if (this.goOn && this.value > l) {
  		this.addError(tip || this.key + " must less than or equal " + l + ".");
  	}
  	return this;
  };
  Validator.prototype.contains = function(s, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.contains(this.value,s))) {
  		this.addError(tip || this.key + " is must contain " + s + ".");
  	}
  	return this;
  };
  Validator.prototype.notContains = function(s, tip) {
  	if (this.goOn && (!isString(this.value) ||v.contains(this.value,s))) {
  		this.addError(tip || this.key + " is must not contain " + s + ".");
  ...

function koa-validate.Validator.prototype.decodeBase64 (inBuffer , tip)

• description and source-code

  decodeBase64 = function (inBuffer , tip) {
  	if (!this.hasError()&&this.value) {
  		try{
  			if(inBuffer){
  				this.value = this.params[this.key] = new Buffer(this.value , 'base64');
  			}else{
  				this.value = this.params[this.key] = new Buffer(this.value , 'base64').toString();
  			}
  		}catch(e){
  			this.addError(tip||"bad base64 format value");
  		}
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('whitelist').whitelist('ll');
  			this.checkBody('blacklist').blacklist('ll');
  			this.checkBody('encodeURI').decodeURI();
  			this.checkBody('decodeURI').encodeURI();
  			this.checkBody('encodeURIComponent').decodeURIComponent();
  			this.checkBody('decodeURIComponent').encodeURIComponent();
  			this.checkBody('rep').replace(',' ,'');
  			this.checkBody('base64').clone('base64Buffer').decodeBase64(true
  );
  			this.checkBody('base64').decodeBase64();
  			this.checkBody('debase64').encodeBase64();
  			this.checkBody('hash').clone('md5').md5();
  			this.checkBody('hash').clone('sha1').sha1();
  			this.checkBody('hash').clone('num1' ,1);
  			this.checkBody('json').toJson();
  			//console.log(this.request.body)
  ...

function koa-validate.Validator.prototype.decodeURI (tip)

• description and source-code

  decodeURI = function (tip) {
  	if (this.goOn && !this.hasError()&&this.value) {
  		try{
  			this.value = this.params[this.key] = decodeURI(this.value);
  		}catch(e){
  			this.addError(tip||'bad uri to decode.');
  		}
  	}
  	return this;
  }

• example usage

  ...
  		req.post('/decodeURIComponent')
  		.send({uri:"%"})
  		.expect(500 , done);
  	});
  	it("bad uri decodeURI should not to be ok" , function(done){
  		var app = appFactory.create(1);
  		app.router.post('/decodeURI',function*(){
  			this.checkBody('uri').decodeURI();
  			if(this.errors) {
  				this.status=500;
  			}else{
  				this.status=200;
  			}
  		});
  		var req = request(app.listen());
  ...

function koa-validate.Validator.prototype.decodeURIComponent (tip)

• description and source-code

  decodeURIComponent = function (tip) {
  	if (this.goOn && !this.hasError()&&this.value) {
  		try{
  			this.value = this.params[this.key] = decodeURIComponent(this.value);
  		}catch(e){
  			this.addError(tip||'bad uri to decode.');
  		}
  	}
  	return this;
  }

• example usage

  ...
  
  
  
  describe('koa-validate' , function(){
  	it("bad uri decodeURIComponent should not to be ok" , function(done){
  		var app = appFactory.create(1);
  		app.router.post('/decodeURIComponent',function*(){
  			this.checkBody('uri').decodeURIComponent();
  			if(this.errors) {
  				this.status=500;
  			}else{
  				this.status=200;
  			}
  		});
  		var req = request(app.listen());
  ...

function koa-validate.Validator.prototype.default (d)

• description and source-code

  default = function (d) {
  	if(!this.hasError()&&!this.value){
  		this.value = this.params[this.key] = d;
  	}
  	return this;
  }

• example usage

  ...
  		.expect(200)
  		.expect('ok' , done);
  	});
  	it('there sanitizers should be to okay' , function(done){
  		var url ="http://www.google.com/"
  		var app = appFactory.create(1);
  		app.router.post('/sanitizers',function*(){
  			this.checkBody('default').default('default');
  			this.checkBody('int_').toInt();
  			this.checkBody('int_').toInt(null, 10, {min:20});
  			this.checkBody('int_').toInt(null, 10, {max:20});
  			this.checkBody('int_').toInt(null, 10, {min:20,max:20});
  			this.checkBody('octal_').toInt(null, 8);
  			this.checkBody('octal_').toInt(null, 8, {min:8});
  			this.checkBody('octal_').toInt(null, 8, {max:8});
  ...

function koa-validate.Validator.prototype.empty ()

• description and source-code

  empty = function () {
  	if (this.goOn) {
  		if (!this.value) {
  			this.goOn = false;
  		}
  	}
  	return this;
  }

• example usage

  ...
  app.use(router.routes()).use(router.allowedMethods());
  router.post('/signup', function * () {
  	//optional() means this param may not in the params.
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?");
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" ,
  function*(file,context){
  		//resize image
  	});
  	if (this.errors) {
  		this.body = this.errors;
  ...

function koa-validate.Validator.prototype.encodeBase64 ()

• description and source-code

  encodeBase64 = function () {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = new Buffer(this.value).toString('base64');
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('encodeURI').decodeURI();
  			this.checkBody('decodeURI').encodeURI();
  			this.checkBody('encodeURIComponent').decodeURIComponent();
  			this.checkBody('decodeURIComponent').encodeURIComponent();
  			this.checkBody('rep').replace(',' ,'');
  			this.checkBody('base64').clone('base64Buffer').decodeBase64(true);
  			this.checkBody('base64').decodeBase64();
  			this.checkBody('debase64').encodeBase64();
  			this.checkBody('hash').clone('md5').md5();
  			this.checkBody('hash').clone('sha1').sha1();
  			this.checkBody('hash').clone('num1' ,1);
  			this.checkBody('json').toJson();
  			//console.log(this.request.body)
  			if(this.errors){
  				this.body = this.errors;
  ...

function koa-validate.Validator.prototype.encodeURI ()

• description and source-code

  encodeURI = function () {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = encodeURI(this.value);
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('up').toUp();
  			this.checkBody('low').toLow();
  			this.checkBody('escape').escape();
  			this.checkBody('stripLow').stripLow();
  			this.checkBody('whitelist').whitelist('ll');
  			this.checkBody('blacklist').blacklist('ll');
  			this.checkBody('encodeURI').decodeURI();
  			this.checkBody('decodeURI').encodeURI();
  			this.checkBody('encodeURIComponent').decodeURIComponent();
  			this.checkBody('decodeURIComponent').encodeURIComponent();
  			this.checkBody('rep').replace(',' ,'');
  			this.checkBody('base64').clone('base64Buffer').decodeBase64(true);
  			this.checkBody('base64').decodeBase64();
  			this.checkBody('debase64').encodeBase64();
  			this.checkBody('hash').clone('md5').md5();
  ...

function koa-validate.Validator.prototype.encodeURIComponent ()

• description and source-code

  encodeURIComponent = function () {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = encodeURIComponent(this.value);
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('escape').escape();
  			this.checkBody('stripLow').stripLow();
  			this.checkBody('whitelist').whitelist('ll');
  			this.checkBody('blacklist').blacklist('ll');
  			this.checkBody('encodeURI').decodeURI();
  			this.checkBody('decodeURI').encodeURI();
  			this.checkBody('encodeURIComponent').decodeURIComponent();
  			this.checkBody('decodeURIComponent').encodeURIComponent();
  			this.checkBody('rep').replace(',' ,'');
  			this.checkBody('base64').clone('base64Buffer').decodeBase64(true);
  			this.checkBody('base64').decodeBase64();
  			this.checkBody('debase64').encodeBase64();
  			this.checkBody('hash').clone('md5').md5();
  			this.checkBody('hash').clone('sha1').sha1();
  			this.checkBody('hash').clone('num1' ,1);
  ...

function koa-validate.Validator.prototype.ensure (assertion, tip, shouldBail)

• description and source-code

  ensure = function (assertion, tip, shouldBail) {
    if (shouldBail) this.goOn = false;
      if (this.goOn && !assertion) {
          this.addError(tip || this.key + ' failed an assertion.');
      }
      return this;
  }

• example usage

  ...
  			this.checkBody('optional').optional().len(1, 100).trim().toInt()
  			this.checkBody('optionalInt').optional().len(1, 100).trim().toInt()
  			this.checkBody('name').notEmpty().len(3,20);
  			this.checkBody('empty').empty();
  			this.checkBody('notBlank').notBlank();
  			this.checkBody('match').match(/^abc$/i);
  			this.checkBody('notMatch').notMatch(/^xyz$/i);
  			this.checkBody('ensure').ensure(true);
  			this.checkBody('ensureNot').ensureNot(false);
  			this.checkBody('integer').isInt();
  			this.checkBody('integer').isInt(null, {min:12});
  			this.checkBody('integer').isInt(null, {max:12});
  			this.checkBody('integer').isInt(null, {min:12,max:12});
  			this.checkBody('stringInteger').isInt();
  			this.checkBody('stringInteger').isInt(null, {min:12});
  ...

function koa-validate.Validator.prototype.ensureNot (assertion, tip, shouldBail)

• description and source-code

  ensureNot = function (assertion, tip, shouldBail) {
    if (shouldBail) this.goOn = false;
      if (this.goOn && !!assertion) {
          this.addError(tip || this.key + ' failed an assertion.');
      }
      return this;
  }

• example usage

  ...
  			this.checkBody('optionalInt').optional().len(1, 100).trim().toInt()
  			this.checkBody('name').notEmpty().len(3,20);
  			this.checkBody('empty').empty();
  			this.checkBody('notBlank').notBlank();
  			this.checkBody('match').match(/^abc$/i);
  			this.checkBody('notMatch').notMatch(/^xyz$/i);
  			this.checkBody('ensure').ensure(true);
  			this.checkBody('ensureNot').ensureNot(false);
  			this.checkBody('integer').isInt();
  			this.checkBody('integer').isInt(null, {min:12});
  			this.checkBody('integer').isInt(null, {max:12});
  			this.checkBody('integer').isInt(null, {min:12,max:12});
  			this.checkBody('stringInteger').isInt();
  			this.checkBody('stringInteger').isInt(null, {min:12});
  			this.checkBody('stringInteger').isInt(null, {max:12});
  ...

function koa-validate.Validator.prototype.eq (l, tip)

• description and source-code

  eq = function (l, tip) {
  	if (this.goOn && this.value != l) {
  		this.addError(tip || this.key + " is must equal " + l + ".");
  	}
  	return this;
  }

• example usage

  ...
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  //json body,we can check it using [json path](https://github.com/flitbit/json-path)(like xpath)
  router.post('/json' , function*(){
  	this.checkBody('/store/book[0]/price').get(0).eq(8.95);
  	this.checkBody('#/store/book[0]/category').first().trim().eq('reference');
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  })
  ...

function koa-validate.Validator.prototype.escape ()

• description and source-code

  escape = function () {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.escape(this.value);
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.rtrim(this.value,c);
  	}
  	return this;
  };
  Validator.prototype.escape = function() {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.escape(this.value);
  	}
  	return this;
  };
  Validator.prototype.stripLow = function(nl) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.stripLow(this.value, nl);
  	}
  ...

function koa-validate.Validator.prototype.exist (tip)

• description and source-code

  exist = function (tip) {
  	if (this.goOn && !this.exists) {
  		 this.addError(tip || this.key +" should exists!");
  	}
  	return this;
  }

• example usage

  ...
  	return this;
  };
  
  Validator.prototype.isLength = function(min, max, tip) {
  	min = min || 0;
  	tip = 'number' != typeof max ? max : tip;
  	max = 'number' == typeof max ? max :-1;
  	this.exist(tip);
  	if (this.goOn) {
  		if(this.value.length<min) {
  			this.addError(tip || this.key + "'s length must equal or great than " + min+".");
  			return this;
  		}
  		if (-1!=max&&this.value.length>max) {
  			this.addError(tip || this.key + "'s length must equal or less than " + max + ".");
  ...

function koa-validate.Validator.prototype.filter (cb, scope)

• description and source-code

  filter = function (cb, scope) {
  	if (this.value&&this.value.length>0) {
  		var vs = []
  		for(var i = 0 ;i<this.value.length;i++) {
  			if(cb.call(scope||this,this.value[i],i,this.key,this.context)){
  				vs.push(this.value[i])
  			}
  		}
  		this.value=vs;
  	}
  	return this;
  }

• example usage

  ...
  		app.router.post('/json',function*(){
  			this.checkBody('/', true).notEmpty();
        this.checkBody('/store/bicycle/color', true).exist()
        this.checkBody('/store/book[0]/price', true).get(0).eq(8.95);
        this.checkBody('/store/book[0]/price', true).get(0).isFloat().eq(8.95);
  			this.checkBody('/store/book[0]/disabled', true).first().notEmpty().toBoolean()
  			this.checkBody('#/store/book[0]/category', true).first().trim().eq('reference');
  			this.checkBody('/store/book[*]/price', true).filter(function(v,k,o){
  				return v>10
  			}).first().gt(10)
  			if(this.errors) {
          // console.log(this.errors)
  				this.status=500;
  			}else{
  				this.status=200;
  ...

function koa-validate.Validator.prototype.first (index)

• description and source-code

  first = function (index) {
  	return this.get(0);
  }

• example usage

  ...
  		this.body = this.errors;
  		return;
  	}
  });
  //json body,we can check it using [json path](https://github.com/flitbit/json-path)(like xpath)
  router.post('/json' , function*(){
  	this.checkBody('/store/book[0]/price').get(0).eq(8.95);
  	this.checkBody('#/store/book[0]/category').first().trim().eq('reference
  ');
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  })
  
  app.listen(3000);
  ...

function koa-validate.Validator.prototype.ge (l, tip)

• description and source-code

  ge = function (l, tip) {
  	if (this.goOn && this.value < l) {
  		this.addError(tip || this.key + " must great than or equal " + l + ".");
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('stringInteger').isInt(null, {min:12,max:12});
  			this.checkBody('float_').isFloat();
  			this.checkBody('in').in([1,2]);
  			this.checkBody('eq').eq("eq");
  			this.checkBody('neq').neq("eq");
  			this.checkBody('number4').gt(3);
  			this.checkBody('number4').lt(5);
  			this.checkBody('number4').ge(4);
  			this.checkBody('number4').le(4);
  			this.checkBody('number4').ge(3);
  			this.checkBody('number4').le(5);
  			this.checkBody('contains').contains("tain");
  			this.checkBody('notContains').notContains(" ");
  			this.checkBody('email').isEmail();
  			this.checkBody('url').isUrl();
  ...

function koa-validate.Validator.prototype.get (index)

• description and source-code

  get = function (index) {
  	if (this.value) {
  		this.value = this.value[index||0]
  	}
  	return this;
  }

• example usage

  ...
  		//resize image
  	});
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/users', function * () {
  	this.checkQuery('department').empty().in(["sale","finance"], "not support this department!&#
  x22;).len(3, 20);
  	this.checkQuery('name').empty().len(2,20,"bad name.").trim().toLow();
  	this.checkQuery('age').empty().gt(10,"too young!").lt(30,"to old!").toInt();
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  ...

function koa-validate.Validator.prototype.gt (l, tip)

• description and source-code

  gt = function (l, tip) {
  	if (this.goOn && this.value <= l) {
  		this.addError(tip || this.key + " must great than " + l + ".");
  	}
  	return this;
  }

• example usage

  ...
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/users', function * () {
  	this.checkQuery('department').empty().in(["sale","finance"], "not support this department!&#
  x22;).len(3, 20);
  	this.checkQuery('name').empty().len(2,20,"bad name.").trim().toLow();
  	this.checkQuery('age').empty().gt(10,"too young!").lt(30,"to
   old!").toInt();
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/user/:id', function * () {
  	this.checkParams('id').toInt(0);
  ...

function koa-validate.Validator.prototype.hasError ()

• description and source-code

  hasError = function () {
  	return this.context.errors && this.context.errors.length > 0 ? true : false;
  }

• example usage

  ...
  	}
  	return this;
  };
  
  
  //Sanitizers
  Validator.prototype.default = function(d) {
  	if(!this.hasError()&&!this.value){
  		this.value = this.params[this.key] = d;
  	}
  	return this;
  };
  Validator.prototype.toDate = function() {
  	this.isDate();
  	if (this.goOn && !this.hasError()) {
  ...

function koa-validate.Validator.prototype.hash (alg , enc)

• description and source-code

  hash = function (alg , enc) {
  	if (!this.hasError()&&this.value) {
  		enc = enc ||'hex';
  		this.value = this.params[this.key] =require('crypto').createHash(alg).update(this.value).digest(enc);
  	}
  	return this;
  }

• example usage

  ...
  	if (!this.hasError()&&this.value) {
  		enc = enc ||'hex';
  		this.value = this.params[this.key] =require('crypto').createHash(alg).update(this.value).digest(enc);
  	}
  	return this;
  };
  Validator.prototype.md5 = function() {
  	this.hash('md5');
  	return this;
  };
  Validator.prototype.sha1 = function() {
  	this.hash('sha1');
  	return this;
  };
  Validator.prototype.clone = function(key , value) {
  ...

function koa-validate.Validator.prototype.in (arr, tip)

• description and source-code

  in = function (arr, tip) {
  	if (this.goOn && arr) {
  		for(var i = 0 ; i < arr.length ;i++){
  			if(this.value == arr[i]){
  				return this;
  			}
  		}
  		this.addError(tip || this.key + " must be in [" + arr.join(',') + "].");
  	}
  	return this;
  }

• example usage

  ...
  	});
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/users', function * () {
  	this.checkQuery('department').empty().in(["sale","finance&#
  x22;], "not support this department!").len(3, 20);
  	this.checkQuery('name').empty().len(2,20,"bad name.").trim().toLow();
  	this.checkQuery('age').empty().gt(10,"too young!").lt(30,"to old!").toInt();
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  ...

function koa-validate.Validator.prototype.isAfter (d, tip)

• description and source-code

  isAfter = function (d, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isAfter(this.value, d))) {
  		this.addError(tip || this.key + " must after " + d + ".");
  	}
  	return this;
  }

• example usage

  ...
  	if(this.goOn && ! timeReg.test(this.value)){
  		this.addError(tip || this.key + " is not a time format.");
  	}
  	return this;
  };
  
  Validator.prototype.isAfter = function(d, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isAfter(this.value, d))) {
  		this.addError(tip || this.key + " must after " + d + ".");
  	}
  	return this;
  };
  Validator.prototype.isBefore = function(d, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isBefore(this.value, d))) {
  		this.addError(tip || this.key + " must before " + d + ".");
  ...

function koa-validate.Validator.prototype.isAlpha (tip, locale)

• description and source-code

  isAlpha = function (tip, locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isAlpha(this.value,locale))) {
  		this.addError(tip || this.key + " is not an alpha string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isIp = function(tip,version) {
  	if (this.goOn && (!isString(this.value) ||!v.isIP(this.value,version))) {
  		this.addError(tip || this.key + " is not ip format.");
  	}
  	return this;
  };
  Validator.prototype.isAlpha = function(tip,locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isAlpha(this.value,locale))) {
  		this.addError(tip || this.key + " is not an alpha string.");
  	}
  	return this;
  };
  Validator.prototype.isNumeric = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isNumeric(this.value))) {
  		this.addError(tip || this.key + " is  not numeric.");
  ...

function koa-validate.Validator.prototype.isAlphanumeric (tip, locale)

• description and source-code

  isAlphanumeric = function (tip, locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isAlphanumeric(this.value,locale))) {
  		this.addError(tip || this.key + " is not an aphanumeric string.");
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && (!isString(this.value) ||!v.isNumeric(this.value))) {
  		this.addError(tip || this.key + " is  not numeric.");
  	}
  	return this;
  };
  
  Validator.prototype.isAlphanumeric = function(tip,locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isAlphanumeric(this.value,locale
  ))) {
  		this.addError(tip || this.key + " is not an aphanumeric string.");
  	}
  	return this;
  };
  Validator.prototype.isBase64 = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isBase64(this.value))) {
  		this.addError(tip || this.key + " is not a base64 string.");
  ...

function koa-validate.Validator.prototype.isAscii (tip)

• description and source-code

  isAscii = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isAscii(this.value))) {
  		this.addError(tip || this.key + " is not a ascii string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isMultibyte = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isMultibyte(this.value))) {
  		this.addError(tip || this.key + " is not a multibyte string.");
  	}
  	return this;
  };
  Validator.prototype.isAscii = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isAscii(this.value))) {
  		this.addError(tip || this.key + " is not a ascii string.");
  	}
  	return this;
  };
  Validator.prototype.isFullWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isFullWidth(this.value))) {
  		this.addError(tip || this.key + " is not a full width string.");
  ...

function koa-validate.Validator.prototype.isBase64 (tip)

• description and source-code

  isBase64 = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isBase64(this.value))) {
  		this.addError(tip || this.key + " is not a base64 string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isAlphanumeric = function(tip,locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isAlphanumeric(this.value,locale))) {
  		this.addError(tip || this.key + " is not an aphanumeric string.");
  	}
  	return this;
  };
  Validator.prototype.isBase64 = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isBase64(this.value))) {
  		this.addError(tip || this.key + " is not a base64 string.");
  	}
  	return this;
  };
  Validator.prototype.isHexadecimal = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHexadecimal(this.value))) {
  		this.addError(tip || this.key + " is not a hexa decimal string.");
  ...

function koa-validate.Validator.prototype.isBefore (d, tip)

• description and source-code

  isBefore = function (d, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isBefore(this.value, d))) {
  		this.addError(tip || this.key + " must before " + d + ".");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isAfter = function(d, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isAfter(this.value, d))) {
  		this.addError(tip || this.key + " must after " + d + ".");
  	}
  	return this;
  };
  Validator.prototype.isBefore = function(d, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isBefore(this.value, d))) {
  		this.addError(tip || this.key + " must before " + d + ".");
  	}
  	return this;
  };
  Validator.prototype.isCreditCard = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isCreditCard(this.value))) {
  		this.addError(tip || this.key + " is not credit card format.");
  ...

function koa-validate.Validator.prototype.isByteLength (min, max, charset, tip)

• description and source-code

  isByteLength = function (min, max, charset, tip) {
  	min = min || 0;
  	max = max || Number.MAX_VALUE;
  	charset = charset||'utf8';
  	this.notEmpty(tip);
  	if (this.goOn) {
  		var bl = Buffer.byteLength(this.value , charset);
  		tip = 'number' != typeof max ? max : tip;
  		if (bl<min || bl>max) {
  			this.addError(tip || this.key + "'s byte lenth great than " + min +" and less than " + max + "." );
  		}
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('color3').isHexColor();
  			this.checkBody('color4').isHexColor();
  			this.checkBody('low').isLowercase();
  			this.checkBody('up').isUppercase();
  			this.checkBody('div').isDivisibleBy(3);
  			this.checkBody('n').isNull();
  			this.checkBody('len').isLength(1,4);
  			this.checkBody('byteLenght').isByteLength(4,6);
  			this.checkBody('uuid').isUUID();
  			this.checkBody('date').isDate();
  			this.checkBody('time').isTime();
  			this.checkBody('after').isAfter("2014-08-06");
  			this.checkBody('before').isBefore("2014-08-08");
  			this.checkBody('in').isIn();
  			this.checkBody('credit').isCreditCard();
  ...

function koa-validate.Validator.prototype.isCreditCard (tip)

• description and source-code

  isCreditCard = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isCreditCard(this.value))) {
  		this.addError(tip || this.key + " is not credit card format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isBefore = function(d, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isBefore(this.value, d))) {
  		this.addError(tip || this.key + " must before " + d + ".");
  	}
  	return this;
  };
  Validator.prototype.isCreditCard = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isCreditCard(this.value))) {
  		this.addError(tip || this.key + " is not credit card format.");
  	}
  	return this;
  };
  Validator.prototype.isISBN = function(tip,version) {
  	if (this.goOn && (!isString(this.value) ||!v.isISBN(this.value,version))) {
  		this.addError(tip || this.key + " is not a ISBN format.");
  ...

function koa-validate.Validator.prototype.isCurrency (tip, options)

• description and source-code

  isCurrency = function (tip, options) {
  	if (this.goOn && (!isString(this.value) ||!v.isCurrency(this.value,options))) {
  		this.addError(tip || this.key + " is not a currency format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isSurrogatePair = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isSurrogatePair(this.value))) {
  		this.addError(tip || this.key + " is not a surrogate pair string.");
  	}
  	return this;
  };
  Validator.prototype.isCurrency = function(tip,options) {
  	if (this.goOn && (!isString(this.value) ||!v.isCurrency(this.value,options
  ))) {
  		this.addError(tip || this.key + " is not a currency format.");
  	}
  	return this;
  };
  Validator.prototype.isDataURI = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isDataURI(this.value))) {
  		this.addError(tip || this.key + " is not a data uri format.");
  ...

function koa-validate.Validator.prototype.isDataURI (tip)

• description and source-code

  isDataURI = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isDataURI(this.value))) {
  		this.addError(tip || this.key + " is not a data uri format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isCurrency = function(tip,options) {
  	if (this.goOn && (!isString(this.value) ||!v.isCurrency(this.value,options))) {
  		this.addError(tip || this.key + " is not a currency format.");
  	}
  	return this;
  };
  Validator.prototype.isDataURI = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isDataURI(this.value))) {
  		this.addError(tip || this.key + " is not a data uri format.");
  	}
  	return this;
  };
  Validator.prototype.isMobilePhone = function(tip,locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isMobilePhone(this.value,locale))) {
  		this.addError(tip || this.key + " is not a mobile phone format.");
  ...

function koa-validate.Validator.prototype.isDate (tip)

• description and source-code

  isDate = function (tip) {
  	if (this.goOn && !util.isDate(this.value)  && (!isString(this.value) ||!v.isDate(this.value))) {
  		this.addError(tip || this.key + " is not a date format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isUUID = function(tip,ver) {
  	if (this.goOn && (!isString(this.value) ||!v.isUUID(this.value,ver))) {
  		this.addError(tip || this.key + " is not a UUID format.");
  	}
  	return this;
  };
  Validator.prototype.isDate = function(tip) {
  	if (this.goOn && !util.isDate(this.value)  && (!isString(this.value
  ) ||!v.isDate(this.value))) {
  		this.addError(tip || this.key + " is not a date format.");
  	}
  	return this;
  };
  Validator.prototype.isTime = function(tip) {
  	var timeReg = /^(([0-1]?[0-9])|([2][0-3])):([0-5]?[0-9])(:([0-5]?[0-9]))?$/;
  	if(this.goOn && ! timeReg.test(this.value)){
  ...

function koa-validate.Validator.prototype.isDivisibleBy (n, tip)

• description and source-code

  isDivisibleBy = function (n, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isDivisibleBy(this.value, n))) {
  		this.addError(tip || this.key + " can not divide by" + n + ".");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isUppercase = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isUppercase(this.value))) {
  		this.addError(tip || this.key + " is not a upper case string.");
  	}
  	return this;
  };
  Validator.prototype.isDivisibleBy = function(n, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isDivisibleBy(this.value, n))) {
  		this.addError(tip || this.key + " can not divide by" + n + ".");
  	}
  	return this;
  };
  Validator.prototype.isNull = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isNull(this.value))) {
  		this.addError(tip || this.key + " is not null.");
  ...

function koa-validate.Validator.prototype.isEmail (tip, options)

• description and source-code

  isEmail = function (tip, options) {
  	if (this.goOn && (!isString(this.value) ||!v.isEmail(this.value,options))) {
  		this.addError(tip || this.key + " is not email format.");
  	}
  	return this;
  }

• example usage

  ...
  require('koa-validate')(app);
  
  app.use(require('koa-body')({multipart:true , formidable:{keepExtensions:true}}));
  app.use(router.routes()).use(router.allowedMethods());
  router.post('/signup', function * () {
  	//optional() means this param may not in the params.
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?");
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" ,
  function*(file,context){
  		//resize image
  ...

function koa-validate.Validator.prototype.isFQDN (tip, options)

• description and source-code

  isFQDN = function (tip, options) {
  	if (this.goOn && (!isString(this.value) ||!v.isFQDN(this.value,options))) {
  		this.addError(tip || this.key + " is not a fully qualified domain name format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isISIN = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isISIN(this.value))) {
  		this.addError(tip || this.key + " is not a ISIN format.");
  	}
  	return this;
  };
  Validator.prototype.isFQDN = function(tip,options) {
  	if (this.goOn && (!isString(this.value) ||!v.isFQDN(this.value,options))) {
  		this.addError(tip || this.key + " is not a fully qualified domain name format.");
  	}
  	return this;
  };
  
  
  //Sanitizers
  ...

function koa-validate.Validator.prototype.isFloat (tip, options)

• description and source-code

  isFloat = function (tip, options) {
  	if (this.goOn && !v.isFloat(String(this.value), options)) {
  		this.addError(tip || this.key + " is not float.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isInt = function(tip, options) {
  	if (this.goOn&& !v.isInt(String(this.value), options)) {
  		this.addError(tip || this.key + " is not integer.");
  	}
  	return this;
  };
  Validator.prototype.isFloat = function(tip,options) {
  	if (this.goOn && !v.isFloat(String(this.value), options)) {
  		this.addError(tip || this.key + " is not float.");
  	}
  	return this;
  };
  
  Validator.prototype.isLength = function(min, max, tip) {
  	min = min || 0;
  ...

function koa-validate.Validator.prototype.isFullWidth (tip)

• description and source-code

  isFullWidth = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isFullWidth(this.value))) {
  		this.addError(tip || this.key + " is not a full width string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isAscii = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isAscii(this.value))) {
  		this.addError(tip || this.key + " is not a ascii string.");
  	}
  	return this;
  };
  Validator.prototype.isFullWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isFullWidth(this.value))) {
  		this.addError(tip || this.key + " is not a full width string.");
  	}
  	return this;
  };
  Validator.prototype.isHalfWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHalfWidth(this.value))) {
  		this.addError(tip || this.key + " is not a half width string.");
  ...

function koa-validate.Validator.prototype.isHalfWidth (tip)

• description and source-code

  isHalfWidth = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHalfWidth(this.value))) {
  		this.addError(tip || this.key + " is not a half width string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isFullWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isFullWidth(this.value))) {
  		this.addError(tip || this.key + " is not a full width string.");
  	}
  	return this;
  };
  Validator.prototype.isHalfWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHalfWidth(this.value))) {
  		this.addError(tip || this.key + " is not a half width string.");
  	}
  	return this;
  };
  Validator.prototype.isVariableWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isVariableWidth(this.value))) {
  		this.addError(tip || this.key + " is not a variable width string.");
  ...

function koa-validate.Validator.prototype.isHexColor (tip)

• description and source-code

  isHexColor = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHexColor(this.value))) {
  		this.addError(tip || this.key + " is  not hex color format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isHexadecimal = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHexadecimal(this.value))) {
  		this.addError(tip || this.key + " is not a hexa decimal string.");
  	}
  	return this;
  };
  Validator.prototype.isHexColor = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHexColor(this.value))) {
  		this.addError(tip || this.key + " is  not hex color format.");
  	}
  	return this;
  };
  Validator.prototype.isLowercase = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isLowercase(this.value))) {
  		this.addError(tip || this.key + " is not a lowwer case string");
  ...

function koa-validate.Validator.prototype.isHexadecimal (tip)

• description and source-code

  isHexadecimal = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHexadecimal(this.value))) {
  		this.addError(tip || this.key + " is not a hexa decimal string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isBase64 = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isBase64(this.value))) {
  		this.addError(tip || this.key + " is not a base64 string.");
  	}
  	return this;
  };
  Validator.prototype.isHexadecimal = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHexadecimal(this.value))) {
  		this.addError(tip || this.key + " is not a hexa decimal string.");
  	}
  	return this;
  };
  Validator.prototype.isHexColor = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHexColor(this.value))) {
  		this.addError(tip || this.key + " is  not hex color format.");
  ...

function koa-validate.Validator.prototype.isISBN (tip, version)

• description and source-code

  isISBN = function (tip, version) {
  	if (this.goOn && (!isString(this.value) ||!v.isISBN(this.value,version))) {
  		this.addError(tip || this.key + " is not a ISBN format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isCreditCard = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isCreditCard(this.value))) {
  		this.addError(tip || this.key + " is not credit card format.");
  	}
  	return this;
  };
  Validator.prototype.isISBN = function(tip,version) {
  	if (this.goOn && (!isString(this.value) ||!v.isISBN(this.value,version))) {
  		this.addError(tip || this.key + " is not a ISBN format.");
  	}
  	return this;
  };
  Validator.prototype.isJSON = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isJSON(this.value))) {
  		this.addError(tip || this.key + " is not a json format.");
  ...

function koa-validate.Validator.prototype.isISIN (tip)

• description and source-code

  isISIN = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isISIN(this.value))) {
  		this.addError(tip || this.key + " is not a ISIN format.");
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && (!isString(this.value) ||!v.isMACAddress(this.value))) {
  		this.addError(tip || this.key + " is not a MAC address format.");
  	}
  	return this;
  };
  
  Validator.prototype.isISIN = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isISIN(this.value))) {
  		this.addError(tip || this.key + " is not a ISIN format.");
  	}
  	return this;
  };
  Validator.prototype.isFQDN = function(tip,options) {
  	if (this.goOn && (!isString(this.value) ||!v.isFQDN(this.value,options))) {
  		this.addError(tip || this.key + " is not a fully qualified domain name format.");
  ...

function koa-validate.Validator.prototype.isISO8601 (tip)

• description and source-code

  isISO8601 = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isISO8601(this.value))) {
  		this.addError(tip || this.key + " is not a ISO8601 string format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isMobilePhone = function(tip,locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isMobilePhone(this.value,locale))) {
  		this.addError(tip || this.key + " is not a mobile phone format.");
  	}
  	return this;
  };
  Validator.prototype.isISO8601 = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isISO8601(this.value))) {
  		this.addError(tip || this.key + " is not a ISO8601 string format.");
  	}
  	return this;
  };
  Validator.prototype.isMACAddress = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isMACAddress(this.value))) {
  		this.addError(tip || this.key + " is not a MAC address format.");
  ...

function koa-validate.Validator.prototype.isIn (arr, tip)

• description and source-code

  isIn = function (arr, tip) {
  	if (this.goOn && arr) {
  		for(var i = 0 ; i < arr.length ;i++){
  			if(this.value == arr[i]){
  				return this;
  			}
  		}
  		this.addError(tip || this.key + " must be in [" + arr.join(',') + "].");
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('len').isLength(1,4);
  			this.checkBody('byteLenght').isByteLength(4,6);
  			this.checkBody('uuid').isUUID();
  			this.checkBody('date').isDate();
  			this.checkBody('time').isTime();
  			this.checkBody('after').isAfter("2014-08-06");
  			this.checkBody('before').isBefore("2014-08-08");
  			this.checkBody('in').isIn();
  			this.checkBody('credit').isCreditCard();
  			this.checkBody('isbn').isISBN();
  			this.checkBody('json').isJSON();
  			this.checkBody('mb').isMultibyte();
  			this.checkBody('ascii').isAscii();
  			this.checkBody('fw').isFullWidth();
  			this.checkBody('hw').isHalfWidth();
  ...

function koa-validate.Validator.prototype.isInt (tip, options)

• description and source-code

  isInt = function (tip, options) {
  	if (this.goOn&& !v.isInt(String(this.value), options)) {
  		this.addError(tip || this.key + " is not integer.");
  	}
  	return this;
  }

• example usage

  ...
      if (this.goOn && !assertion) {
          this.addError(tip || this.key + ' failed an assertion.');
      }
      return this;
  };
  
  Validator.prototype.isInt = function(tip, options) {
  	if (this.goOn&& !v.isInt(String(this.value), options)) {
  		this.addError(tip || this.key + " is not integer.");
  	}
  	return this;
  };
  Validator.prototype.isFloat = function(tip,options) {
  	if (this.goOn && !v.isFloat(String(this.value), options)) {
  		this.addError(tip || this.key + " is not float.");
  ...

function koa-validate.Validator.prototype.isIp (tip, version)

• description and source-code

  isIp = function (tip, version) {
  	if (this.goOn && (!isString(this.value) ||!v.isIP(this.value,version))) {
  		this.addError(tip || this.key + " is not ip format.");
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('number4').le(4);
  			this.checkBody('number4').ge(3);
  			this.checkBody('number4').le(5);
  			this.checkBody('contains').contains("tain");
  			this.checkBody('notContains').notContains(" ");
  			this.checkBody('email').isEmail();
  			this.checkBody('url').isUrl();
  			this.checkBody('ip').isIp();
  			this.checkBody('alpha').isAlpha();
  			this.checkBody('numeric').isNumeric();
  			this.checkBody('an').isAlphanumeric();
  			this.checkBody('base64').isBase64();
  			this.checkBody('hex').isHexadecimal();
  			this.checkBody('color1').isHexColor();
  			this.checkBody('color2').isHexColor();
  ...

function koa-validate.Validator.prototype.isJSON (tip)

• description and source-code

  isJSON = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isJSON(this.value))) {
  		this.addError(tip || this.key + " is not a json format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isISBN = function(tip,version) {
  	if (this.goOn && (!isString(this.value) ||!v.isISBN(this.value,version))) {
  		this.addError(tip || this.key + " is not a ISBN format.");
  	}
  	return this;
  };
  Validator.prototype.isJSON = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isJSON(this.value))) {
  		this.addError(tip || this.key + " is not a json format.");
  	}
  	return this;
  };
  
  Validator.prototype.isMultibyte = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isMultibyte(this.value))) {
  ...

function koa-validate.Validator.prototype.isLength (min, max, tip)

• description and source-code

  isLength = function (min, max, tip) {
  	min = min || 0;
  	tip = 'number' != typeof max ? max : tip;
  	max = 'number' == typeof max ? max :-1;
  	this.exist(tip);
  	if (this.goOn) {
  		if(this.value.length<min) {
  			this.addError(tip || this.key + "'s length must equal or great than " + min+".");
  			return this;
  		}
  		if (-1!=max&&this.value.length>max) {
  			this.addError(tip || this.key + "'s length must equal or less than " + max + ".");
  			return this;
  		}
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('color2').isHexColor();
  			this.checkBody('color3').isHexColor();
  			this.checkBody('color4').isHexColor();
  			this.checkBody('low').isLowercase();
  			this.checkBody('up').isUppercase();
  			this.checkBody('div').isDivisibleBy(3);
  			this.checkBody('n').isNull();
  			this.checkBody('len').isLength(1,4);
  			this.checkBody('byteLenght').isByteLength(4,6);
  			this.checkBody('uuid').isUUID();
  			this.checkBody('date').isDate();
  			this.checkBody('time').isTime();
  			this.checkBody('after').isAfter("2014-08-06");
  			this.checkBody('before').isBefore("2014-08-08");
  			this.checkBody('in').isIn();
  ...

function koa-validate.Validator.prototype.isLowercase (tip)

• description and source-code

  isLowercase = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isLowercase(this.value))) {
  		this.addError(tip || this.key + " is not a lowwer case string");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isHexColor = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHexColor(this.value))) {
  		this.addError(tip || this.key + " is  not hex color format.");
  	}
  	return this;
  };
  Validator.prototype.isLowercase = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isLowercase(this.value))) {
  		this.addError(tip || this.key + " is not a lowwer case string");
  	}
  	return this;
  };
  Validator.prototype.isUppercase = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isUppercase(this.value))) {
  		this.addError(tip || this.key + " is not a upper case string.");
  ...

function koa-validate.Validator.prototype.isMACAddress (tip)

• description and source-code

  isMACAddress = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isMACAddress(this.value))) {
  		this.addError(tip || this.key + " is not a MAC address format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isISO8601 = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isISO8601(this.value))) {
  		this.addError(tip || this.key + " is not a ISO8601 string format.");
  	}
  	return this;
  };
  Validator.prototype.isMACAddress = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isMACAddress(this.value))) {
  		this.addError(tip || this.key + " is not a MAC address format.");
  	}
  	return this;
  };
  
  Validator.prototype.isISIN = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isISIN(this.value))) {
  ...

function koa-validate.Validator.prototype.isMobilePhone (tip, locale)

• description and source-code

  isMobilePhone = function (tip, locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isMobilePhone(this.value,locale))) {
  		this.addError(tip || this.key + " is not a mobile phone format.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isDataURI = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isDataURI(this.value))) {
  		this.addError(tip || this.key + " is not a data uri format.");
  	}
  	return this;
  };
  Validator.prototype.isMobilePhone = function(tip,locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isMobilePhone(this.value,locale
  ))) {
  		this.addError(tip || this.key + " is not a mobile phone format.");
  	}
  	return this;
  };
  Validator.prototype.isISO8601 = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isISO8601(this.value))) {
  		this.addError(tip || this.key + " is not a ISO8601 string format.");
  ...

function koa-validate.Validator.prototype.isMultibyte (tip)

• description and source-code

  isMultibyte = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isMultibyte(this.value))) {
  		this.addError(tip || this.key + " is not a multibyte string.");
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && (!isString(this.value) ||!v.isJSON(this.value))) {
  		this.addError(tip || this.key + " is not a json format.");
  	}
  	return this;
  };
  
  Validator.prototype.isMultibyte = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isMultibyte(this.value))) {
  		this.addError(tip || this.key + " is not a multibyte string.");
  	}
  	return this;
  };
  Validator.prototype.isAscii = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isAscii(this.value))) {
  		this.addError(tip || this.key + " is not a ascii string.");
  ...

function koa-validate.Validator.prototype.isNull (tip)

• description and source-code

  isNull = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isNull(this.value))) {
  		this.addError(tip || this.key + " is not null.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isDivisibleBy = function(n, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isDivisibleBy(this.value, n))) {
  		this.addError(tip || this.key + " can not divide by" + n + ".");
  	}
  	return this;
  };
  Validator.prototype.isNull = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isNull(this.value))) {
  		this.addError(tip || this.key + " is not null.");
  	}
  	return this;
  };
  Validator.prototype.isByteLength = function(min, max,charset,tip) {
  	min = min || 0;
  	max = max || Number.MAX_VALUE;
  ...

function koa-validate.Validator.prototype.isNumeric (tip)

• description and source-code

  isNumeric = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isNumeric(this.value))) {
  		this.addError(tip || this.key + " is  not numeric.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isAlpha = function(tip,locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isAlpha(this.value,locale))) {
  		this.addError(tip || this.key + " is not an alpha string.");
  	}
  	return this;
  };
  Validator.prototype.isNumeric = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isNumeric(this.value))) {
  		this.addError(tip || this.key + " is  not numeric.");
  	}
  	return this;
  };
  
  Validator.prototype.isAlphanumeric = function(tip,locale) {
  	if (this.goOn && (!isString(this.value) ||!v.isAlphanumeric(this.value,locale))) {
  ...

function koa-validate.Validator.prototype.isSurrogatePair (tip)

• description and source-code

  isSurrogatePair = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isSurrogatePair(this.value))) {
  		this.addError(tip || this.key + " is not a surrogate pair string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isVariableWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isVariableWidth(this.value))) {
  		this.addError(tip || this.key + " is not a variable width string.");
  	}
  	return this;
  };
  Validator.prototype.isSurrogatePair = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isSurrogatePair(this.value))) {
  		this.addError(tip || this.key + " is not a surrogate pair string.");
  	}
  	return this;
  };
  Validator.prototype.isCurrency = function(tip,options) {
  	if (this.goOn && (!isString(this.value) ||!v.isCurrency(this.value,options))) {
  		this.addError(tip || this.key + " is not a currency format.");
  ...

function koa-validate.Validator.prototype.isTime (tip)

• description and source-code

  isTime = function (tip) {
  	var timeReg = /^(([0-1]?[0-9])|([2][0-3])):([0-5]?[0-9])(:([0-5]?[0-9]))?$/;
  	if(this.goOn && ! timeReg.test(this.value)){
  		this.addError(tip || this.key + " is not a time format.");
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('up').isUppercase();
  			this.checkBody('div').isDivisibleBy(3);
  			this.checkBody('n').isNull();
  			this.checkBody('len').isLength(1,4);
  			this.checkBody('byteLenght').isByteLength(4,6);
  			this.checkBody('uuid').isUUID();
  			this.checkBody('date').isDate();
  			this.checkBody('time').isTime();
  			this.checkBody('after').isAfter("2014-08-06");
  			this.checkBody('before').isBefore("2014-08-08");
  			this.checkBody('in').isIn();
  			this.checkBody('credit').isCreditCard();
  			this.checkBody('isbn').isISBN();
  			this.checkBody('json').isJSON();
  			this.checkBody('mb').isMultibyte();
  ...

function koa-validate.Validator.prototype.isUUID (tip, ver)

• description and source-code

  isUUID = function (tip, ver) {
  	if (this.goOn && (!isString(this.value) ||!v.isUUID(this.value,ver))) {
  		this.addError(tip || this.key + " is not a UUID format.");
  	}
  	return this;
  }

• example usage

  ...
  			this.addError(tip || this.key + "'s byte lenth great than " + min +" and less than " + max + ".&#
  x22; );
  		}
  	}
  	return this;
  };
  Validator.prototype.byteLength = Validator.prototype.isByteLength;
  Validator.prototype.isUUID = function(tip,ver) {
  	if (this.goOn && (!isString(this.value) ||!v.isUUID(this.value,ver))) {
  		this.addError(tip || this.key + " is not a UUID format.");
  	}
  	return this;
  };
  Validator.prototype.isDate = function(tip) {
  	if (this.goOn && !util.isDate(this.value)  && (!isString(this.value) ||!v.isDate(this.value))) {
  		this.addError(tip || this.key + " is not a date format.");
  ...

function koa-validate.Validator.prototype.isUppercase (tip)

• description and source-code

  isUppercase = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isUppercase(this.value))) {
  		this.addError(tip || this.key + " is not a upper case string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isLowercase = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isLowercase(this.value))) {
  		this.addError(tip || this.key + " is not a lowwer case string");
  	}
  	return this;
  };
  Validator.prototype.isUppercase = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isUppercase(this.value))) {
  		this.addError(tip || this.key + " is not a upper case string.");
  	}
  	return this;
  };
  Validator.prototype.isDivisibleBy = function(n, tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isDivisibleBy(this.value, n))) {
  		this.addError(tip || this.key + " can not divide by" + n + ".");
  ...

function koa-validate.Validator.prototype.isUrl (tip, options)

• description and source-code

  isUrl = function (tip, options) {
  	if (this.goOn && (!isString(this.value) ||!v.isURL(this.value,options))) {
  		this.addError(tip || this.key + " is not url format.");
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('number4').ge(4);
  			this.checkBody('number4').le(4);
  			this.checkBody('number4').ge(3);
  			this.checkBody('number4').le(5);
  			this.checkBody('contains').contains("tain");
  			this.checkBody('notContains').notContains(" ");
  			this.checkBody('email').isEmail();
  			this.checkBody('url').isUrl();
  			this.checkBody('ip').isIp();
  			this.checkBody('alpha').isAlpha();
  			this.checkBody('numeric').isNumeric();
  			this.checkBody('an').isAlphanumeric();
  			this.checkBody('base64').isBase64();
  			this.checkBody('hex').isHexadecimal();
  			this.checkBody('color1').isHexColor();
  ...

function koa-validate.Validator.prototype.isVariableWidth (tip)

• description and source-code

  isVariableWidth = function (tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isVariableWidth(this.value))) {
  		this.addError(tip || this.key + " is not a variable width string.");
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.isHalfWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isHalfWidth(this.value))) {
  		this.addError(tip || this.key + " is not a half width string.");
  	}
  	return this;
  };
  Validator.prototype.isVariableWidth = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isVariableWidth(this.value))) {
  		this.addError(tip || this.key + " is not a variable width string.");
  	}
  	return this;
  };
  Validator.prototype.isSurrogatePair = function(tip) {
  	if (this.goOn && (!isString(this.value) ||!v.isSurrogatePair(this.value))) {
  		this.addError(tip || this.key + " is not a surrogate pair string.");
  ...

function koa-validate.Validator.prototype.le (l, tip)

• description and source-code

  le = function (l, tip) {
  	if (this.goOn && this.value > l) {
  		this.addError(tip || this.key + " must less than or equal " + l + ".");
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('float_').isFloat();
  			this.checkBody('in').in([1,2]);
  			this.checkBody('eq').eq("eq");
  			this.checkBody('neq').neq("eq");
  			this.checkBody('number4').gt(3);
  			this.checkBody('number4').lt(5);
  			this.checkBody('number4').ge(4);
  			this.checkBody('number4').le(4);
  			this.checkBody('number4').ge(3);
  			this.checkBody('number4').le(5);
  			this.checkBody('contains').contains("tain");
  			this.checkBody('notContains').notContains(" ");
  			this.checkBody('email').isEmail();
  			this.checkBody('url').isUrl();
  			this.checkBody('ip').isIp();
  ...

function koa-validate.Validator.prototype.len (min, max, tip)

• description and source-code

  len = function (min, max, tip) {
  	min = min || 0;
  	tip = 'number' != typeof max ? max : tip;
  	max = 'number' == typeof max ? max :-1;
  	this.exist(tip);
  	if (this.goOn) {
  		if(this.value.length<min) {
  			this.addError(tip || this.key + "'s length must equal or great than " + min+".");
  			return this;
  		}
  		if (-1!=max&&this.value.length>max) {
  			this.addError(tip || this.key + "'s length must equal or less than " + max + ".");
  			return this;
  		}
  	}
  	return this;
  }

• example usage

  ...
  var router = require('koa-router')();
  require('koa-validate')(app);
  
  app.use(require('koa-body')({multipart:true , formidable:{keepExtensions:true}}));
  app.use(router.routes()).use(router.allowedMethods());
  router.post('/signup', function * () {
  	//optional() means this param may not in the params.
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?"
  ;);
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" ,
  function*(file,context){
  ...

function koa-validate.Validator.prototype.lt (l, tip)

• description and source-code

  lt = function (l, tip) {
  	if (this.goOn && this.value >= l) {
  		this.addError(tip || this.key + " must less than " + l + ".");
  	}
  	return this;
  }

• example usage

  ...
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/users', function * () {
  	this.checkQuery('department').empty().in(["sale","finance"], "not support this department!&#
  x22;).len(3, 20);
  	this.checkQuery('name').empty().len(2,20,"bad name.").trim().toLow();
  	this.checkQuery('age').empty().gt(10,"too young!").lt(30,"to
   old!").toInt();
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/user/:id', function * () {
  	this.checkParams('id').toInt(0);
  ...

function koa-validate.Validator.prototype.ltrim (c)

• description and source-code

  ltrim = function (c) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.ltrim(this.value,c);
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.trim(this.value,c);
  	}
  	return this;
  };
  Validator.prototype.ltrim = function(c) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.ltrim(this.value,c);
  	}
  	return this;
  };
  Validator.prototype.rtrim = function(c) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.rtrim(this.value,c);
  	}
  ...

function koa-validate.Validator.prototype.match (reg, tip)

• description and source-code

  match = function (reg, tip) {
  	if (this.goOn && !reg.test(this.value)) {
  		this.addError(tip || this.key + " is bad format.");
  	}
  	return this;
  }

• example usage

  ...
  		app.router.post('/validate',function*(){
  			this.checkBody('optional').optional().len(3,20);
  			this.checkBody('optional').optional().len(1, 100).trim().toInt()
  			this.checkBody('optionalInt').optional().len(1, 100).trim().toInt()
  			this.checkBody('name').notEmpty().len(3,20);
  			this.checkBody('empty').empty();
  			this.checkBody('notBlank').notBlank();
  			this.checkBody('match').match(/^abc$/i);
  			this.checkBody('notMatch').notMatch(/^xyz$/i);
  			this.checkBody('ensure').ensure(true);
  			this.checkBody('ensureNot').ensureNot(false);
  			this.checkBody('integer').isInt();
  			this.checkBody('integer').isInt(null, {min:12});
  			this.checkBody('integer').isInt(null, {max:12});
  			this.checkBody('integer').isInt(null, {min:12,max:12});
  ...

function koa-validate.Validator.prototype.md5 ()

• description and source-code

  md5 = function () {
  	this.hash('md5');
  	return this;
  }

• example usage

  ...
  
  app.use(require('koa-body')({multipart:true , formidable:{keepExtensions:true}}));
  app.use(router.routes()).use(router.allowedMethods());
  router.post('/signup', function * () {
  	//optional() means this param may not in the params.
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?");
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" ,
  function*(file,context){
  		//resize image
  	});
  ...

function koa-validate.Validator.prototype.neq (l, tip)

• description and source-code

  neq = function (l, tip) {
  	if (this.goOn && this.value == l) {
  		this.addError(tip || this.key + " is must not equal " + l + ".");
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('stringInteger').isInt();
  			this.checkBody('stringInteger').isInt(null, {min:12});
  			this.checkBody('stringInteger').isInt(null, {max:12});
  			this.checkBody('stringInteger').isInt(null, {min:12,max:12});
  			this.checkBody('float_').isFloat();
  			this.checkBody('in').in([1,2]);
  			this.checkBody('eq').eq("eq");
  			this.checkBody('neq').neq("eq");
  			this.checkBody('number4').gt(3);
  			this.checkBody('number4').lt(5);
  			this.checkBody('number4').ge(4);
  			this.checkBody('number4').le(4);
  			this.checkBody('number4').ge(3);
  			this.checkBody('number4').le(5);
  			this.checkBody('contains').contains("tain");
  ...

function koa-validate.Validator.prototype.notBlank (tip)

• description and source-code

  notBlank = function (tip) {
  	if (this.goOn && (null==this.value||'undefined'==typeof(this.value) || ('string' == typeof(this.value) &&(/^\s*$/gi).test(this.
  value)))) {
  		this.addError(tip || this.key + " can not be blank.");
  	}
  	return this;
  }

• example usage

  ...
  		var app = appFactory.create(1);
  		app.router.post('/validate',function*(){
  			this.checkBody('optional').optional().len(3,20);
  			this.checkBody('optional').optional().len(1, 100).trim().toInt()
  			this.checkBody('optionalInt').optional().len(1, 100).trim().toInt()
  			this.checkBody('name').notEmpty().len(3,20);
  			this.checkBody('empty').empty();
  			this.checkBody('notBlank').notBlank();
  			this.checkBody('match').match(/^abc$/i);
  			this.checkBody('notMatch').notMatch(/^xyz$/i);
  			this.checkBody('ensure').ensure(true);
  			this.checkBody('ensureNot').ensureNot(false);
  			this.checkBody('integer').isInt();
  			this.checkBody('integer').isInt(null, {min:12});
  			this.checkBody('integer').isInt(null, {max:12});
  ...

function koa-validate.Validator.prototype.notContains (s, tip)

• description and source-code

  notContains = function (s, tip) {
  	if (this.goOn && (!isString(this.value) ||v.contains(this.value,s))) {
  		this.addError(tip || this.key + " is must not contain " + s + ".");
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('number4').gt(3);
  			this.checkBody('number4').lt(5);
  			this.checkBody('number4').ge(4);
  			this.checkBody('number4').le(4);
  			this.checkBody('number4').ge(3);
  			this.checkBody('number4').le(5);
  			this.checkBody('contains').contains("tain");
  			this.checkBody('notContains').notContains(" ");
  			this.checkBody('email').isEmail();
  			this.checkBody('url').isUrl();
  			this.checkBody('ip').isIp();
  			this.checkBody('alpha').isAlpha();
  			this.checkBody('numeric').isNumeric();
  			this.checkBody('an').isAlphanumeric();
  			this.checkBody('base64').isBase64();
  ...

function koa-validate.Validator.prototype.notEmpty (tip)

• description and source-code

  notEmpty = function (tip) {
  	if (this.goOn && (null==this.value||'undefined'==typeof(this.value) || ('string' == typeof(this.value) &&!this.value))) {
  		this.addError(tip || this.key + " can not be empty.");
  	}
  	return this;
  }

• example usage

  ...
  
  app.use(require('koa-body')({multipart:true , formidable:{keepExtensions:true}}));
  app.use(router.routes()).use(router.allowedMethods());
  router.post('/signup', function * () {
  	//optional() means this param may not in the params.
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?");
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" ,
  function*(file,context){
  		//resize image
  	});
  ...

function koa-validate.Validator.prototype.notMatch (reg, tip)

• description and source-code

  notMatch = function (reg, tip) {
      if (this.goOn && reg.test(this.value)) {
          this.addError(tip || this.key + ' is bad format.');
      }
      return this;
  }

• example usage

  ...
  			this.checkBody('optional').optional().len(3,20);
  			this.checkBody('optional').optional().len(1, 100).trim().toInt()
  			this.checkBody('optionalInt').optional().len(1, 100).trim().toInt()
  			this.checkBody('name').notEmpty().len(3,20);
  			this.checkBody('empty').empty();
  			this.checkBody('notBlank').notBlank();
  			this.checkBody('match').match(/^abc$/i);
  			this.checkBody('notMatch').notMatch(/^xyz$/i);
  			this.checkBody('ensure').ensure(true);
  			this.checkBody('ensureNot').ensureNot(false);
  			this.checkBody('integer').isInt();
  			this.checkBody('integer').isInt(null, {min:12});
  			this.checkBody('integer').isInt(null, {max:12});
  			this.checkBody('integer').isInt(null, {min:12,max:12});
  			this.checkBody('stringInteger').isInt();
  ...

function koa-validate.Validator.prototype.optional ()

• description and source-code

  optional = function () {
  	if (!this.exists) {
  		this.goOn = false;
  	}
  	return this;
  }

• example usage

  ...
  var router = require('koa-router')();
  require('koa-validate')(app);
  
  app.use(require('koa-body')({multipart:true , formidable:{keepExtensions:true}}));
  app.use(router.routes()).use(router.allowedMethods());
  router.post('/signup', function * () {
  	//optional() means this param may not in the params.
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?"
  ;);
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" ,
  function*(file,context){
  ...

function koa-validate.Validator.prototype.replace (a, b)

• description and source-code

  replace = function (a, b) {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = this.value.replace(a,b);
  	}
  	return this;
  }

• example usage

  ...
  			this.addError(tip||'bad uri to decode.');
  		}
  	}
  	return this;
  };
  Validator.prototype.replace = function(a,b) {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = this.value.replace(a,b);
  	}
  	return this;
  };
  Validator.prototype.encodeBase64 = function() {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = new Buffer(this.value).toString('base64');
  	}
  ...

function koa-validate.Validator.prototype.rtrim (c)

• description and source-code

  rtrim = function (c) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.rtrim(this.value,c);
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.ltrim(this.value,c);
  	}
  	return this;
  };
  Validator.prototype.rtrim = function(c) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.rtrim(this.value,c);
  	}
  	return this;
  };
  Validator.prototype.escape = function() {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.escape(this.value);
  	}
  ...

function koa-validate.Validator.prototype.sha1 ()

• description and source-code

  sha1 = function () {
  	this.hash('sha1');
  	return this;
  }

• example usage

  ...
  			this.checkBody('encodeURIComponent').decodeURIComponent();
  			this.checkBody('decodeURIComponent').encodeURIComponent();
  			this.checkBody('rep').replace(',' ,'');
  			this.checkBody('base64').clone('base64Buffer').decodeBase64(true);
  			this.checkBody('base64').decodeBase64();
  			this.checkBody('debase64').encodeBase64();
  			this.checkBody('hash').clone('md5').md5();
  			this.checkBody('hash').clone('sha1').sha1();
  			this.checkBody('hash').clone('num1' ,1);
  			this.checkBody('json').toJson();
  			//console.log(this.request.body)
  			if(this.errors){
  				this.body = this.errors;
  				 return;
  			}
  ...

function koa-validate.Validator.prototype.stripLow (nl)

• description and source-code

  stripLow = function (nl) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.stripLow(this.value, nl);
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.escape(this.value);
  	}
  	return this;
  };
  Validator.prototype.stripLow = function(nl) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.stripLow(this.value, nl);
  	}
  	return this;
  };
  Validator.prototype.whitelist = function(s) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.whitelist(this.value,s);
  	}
  ...

function koa-validate.Validator.prototype.toBoolean ()

• description and source-code

  toBoolean = function () {
  	if (this.goOn && !this.hasError()) {
  		if('boolean' == typeof(this.value)) {
  			return this;
  		}
  		if('string' == typeof(this.value)){
  			this.value = this.params[this.key] = v.toBoolean(this.value);
  		}
  	}
  	return this;
  }

• example usage

  ...
  Validator.prototype.toUp = Validator.prototype.toUppercase;
  Validator.prototype.toBoolean = function() {
  	if (this.goOn && !this.hasError()) {
  		if('boolean' == typeof(this.value)) {
  			return this;
  		}
  		if('string' == typeof(this.value)){
  			this.value = this.params[this.key] = v.toBoolean(this.value);
  		}
  	}
  	return this;
  };
  Validator.prototype.trim = function(c) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.trim(this.value,c);
  ...

function koa-validate.Validator.prototype.toDate ()

• description and source-code

  toDate = function () {
  	this.isDate();
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.toDate(this.value);
  	}
  	return this;
  }

• example usage

  ...
  		this.value = this.params[this.key] = d;
  	}
  	return this;
  };
  Validator.prototype.toDate = function() {
  	this.isDate();
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.toDate(this.value);
  	}
  	return this;
  };
  Validator.prototype.toInt = function(tip, radix, options) {
  	this.isInt(tip, options);
  	if (this.goOn && !this.hasError()) {
  		if('number' == typeof(this.value)) {
  ...

function koa-validate.Validator.prototype.toFloat (tip)

• description and source-code

  toFloat = function (tip) {
  	this.isFloat(tip);
  	if (this.goOn && !this.hasError()) {
  		if('number' == typeof(this.value)) {
  			return this;
  		}
  		this.value = this.params[this.key] = v.toFloat(this.value);
  	}
  	return this;
  }

• example usage

  ...
  };
  Validator.prototype.toFloat = function(tip) {
  	this.isFloat(tip);
  	if (this.goOn && !this.hasError()) {
  		if('number' == typeof(this.value)) {
  			return this;
  		}
  		this.value = this.params[this.key] = v.toFloat(this.value);
  	}
  	return this;
  };
  Validator.prototype.toJson = function(tip) {
  	if (this.goOn && !this.hasError()) {
  		try{
  			if('object' == typeof(this.value)) {
  ...

function koa-validate.Validator.prototype.toInt (tip, radix, options)

• description and source-code

  toInt = function (tip, radix, options) {
  	this.isInt(tip, options);
  	if (this.goOn && !this.hasError()) {
  		if('number' == typeof(this.value)) {
  			return this;
  		}
  		this.value = this.params[this.key] = v.toInt(this.value, radix);
  	}
  	return this;
  }

• example usage

  ...
  	//optional() means this param may not in the params.
  	this.checkBody('name').optional().len(2, 20,"are you kidding me?");
  	this.checkBody('email').isEmail("your enter a bad email.");
  	this.checkBody('password').notEmpty().len(3, 20).md5();
  	//empty() mean this param can be a empty string.
  	this.checkBody('nick').optional().empty().len(3, 20);
  	//also we can get the sanitized value
  	var age = this.checkBody('age').toInt().value;
  	yield this.checkFile('icon').notEmpty().size(0,300*1024,'file too large').move("/static/icon/" ,
  function*(file,context){
  		//resize image
  	});
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  ...

function koa-validate.Validator.prototype.toJson (tip)

• description and source-code

  toJson = function (tip) {
  	if (this.goOn && !this.hasError()) {
  		try{
  			if('object' == typeof(this.value)) {
  				return this;
  			}
  			this.value = this.params[this.key] = JSON.parse(this.value);
  		}catch(e){
  			this.addError(tip||'not json format');
  		}
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('rep').replace(',' ,'');
  			this.checkBody('base64').clone('base64Buffer').decodeBase64(true);
  			this.checkBody('base64').decodeBase64();
  			this.checkBody('debase64').encodeBase64();
  			this.checkBody('hash').clone('md5').md5();
  			this.checkBody('hash').clone('sha1').sha1();
  			this.checkBody('hash').clone('num1' ,1);
  			this.checkBody('json').toJson();
  			//console.log(this.request.body)
  			if(this.errors){
  				this.body = this.errors;
  				 return;
  			}
  			var body = this.request.body;
  			if('default' != body.default){
  ...

function koa-validate.Validator.prototype.toLow ()

• description and source-code

  toLow = function () {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = this.value.toLowerCase();
  	}
  	return this;
  }

• example usage

  ...
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/users', function * () {
  	this.checkQuery('department').empty().in(["sale","finance"], "not support this department!&#
  x22;).len(3, 20);
  	this.checkQuery('name').empty().len(2,20,"bad name.").trim().toLow();
  	this.checkQuery('age').empty().gt(10,"too young!").lt(30,"to old!").toInt();
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/user/:id', function * () {
  ...

function koa-validate.Validator.prototype.toLowercase ()

• description and source-code

  toLowercase = function () {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = this.value.toLowerCase();
  	}
  	return this;
  }

• example usage

  n/a

function koa-validate.Validator.prototype.toUp ()

• description and source-code

  toUp = function () {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = this.value.toUpperCase();
  	}
  	return this;
  }

• example usage

  ...
  			this.checkBody('float_').toFloat();
  			this.checkBody('bool').toBoolean();
  			this.checkBody('falseValue').notEmpty('value is empty').toBoolean();
  			this.checkBody('date').toDate();
  			this.checkBody('trim').trim();
  			this.checkBody('ltrim').ltrim();
  			this.checkBody('rtrim').rtrim();
  			this.checkBody('up').toUp();
  			this.checkBody('low').toLow();
  			this.checkBody('escape').escape();
  			this.checkBody('stripLow').stripLow();
  			this.checkBody('whitelist').whitelist('ll');
  			this.checkBody('blacklist').blacklist('ll');
  			this.checkBody('encodeURI').decodeURI();
  			this.checkBody('decodeURI').encodeURI();
  ...

function koa-validate.Validator.prototype.toUppercase ()

• description and source-code

  toUppercase = function () {
  	if (this.goOn && !this.hasError()&&this.value) {
  		this.value = this.params[this.key] = this.value.toUpperCase();
  	}
  	return this;
  }

• example usage

  n/a

function koa-validate.Validator.prototype.trim (c)

• description and source-code

  trim = function (c) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.trim(this.value,c);
  	}
  	return this;
  }

• example usage

  ...
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/users', function * () {
  	this.checkQuery('department').empty().in(["sale","finance"], "not support this department!&#
  x22;).len(3, 20);
  	this.checkQuery('name').empty().len(2,20,"bad name.").trim().toLow
  ();
  	this.checkQuery('age').empty().gt(10,"too young!").lt(30,"to old!").toInt();
  	if (this.errors) {
  		this.body = this.errors;
  		return;
  	}
  });
  router.get('/user/:id', function * () {
  ...

function koa-validate.Validator.prototype.type (t, tip)

• description and source-code

  type = function (t, tip) {
  	if(this.value){
  		if('boolean'==t || 'string'==t|| 'number' == t || 'object' == t || 'undefined' ==t){
  			if(t!=typeof(this.value)) this.addError(tip|| this.key+" is not "+t+"");
  		}else if ('array' == t){
  			if(!util.isArray(this.value)) this.addError(tip|| this.key+" is not array");
  		}else if ('date' == t){
  			if(!util.isDate(this.value)) this.addError(tip|| this.key+" is not date.");
  		}else if ('null' == t){
  			if(!util.isNull(this.value)) this.addError(tip|| this.key+" is not null.");
  		}else if ('nullorundefined' == t.toLowerCase()){
  			if(!util.isNullOrUndefined(this.value)) this.addError(tip|| this.key+" is not primitive type.");
  		}else if ('primitive' == t){
  			if(!util.isPrimitive(this.value)) this.addError(tip|| this.key+" is not primitive type.");
  		}else{
  			console.warn("not support this type check,type:'"+t+"'")
  		}
  	}
  	return this;
  }

• example usage

  ...
  });
  
  describe('koa-validate type' , function(){
  it("type check" , function(done){
    var app = appFactory.create(1);
    app.router.post('/json',function*(){
      this.checkBody('/', true).notEmpty();
      this.checkBody('/store/book[0]/price', true).get(0).type('number&#
  x27;).type("primitive")
      this.checkBody('/store/book[0]/price', true).get(0).type('hello') // should warn
      this.checkBody('#/store/book[0]/category', true).first().type('string');
      this.checkBody('/store/book[*]/price', true).type('array')
      this.checkBody('/store/book[0]/publishDate', true).get(0).toDate().type('date').type('object')
      if(this.errors) {
        this.status=500;
      }else{
  ...

function koa-validate.Validator.prototype.whitelist (s)

• description and source-code

  whitelist = function (s) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.whitelist(this.value,s);
  	}
  	return this;
  }

• example usage

  ...
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.stripLow(this.value, nl);
  	}
  	return this;
  };
  Validator.prototype.whitelist = function(s) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.whitelist(this.value,s);
  	}
  	return this;
  };
  Validator.prototype.blacklist = function(s) {
  	if (this.goOn && !this.hasError()) {
  		this.value = this.params[this.key] = v.blacklist(this.value,s);
  	}
  ...