---

Classes

• _global_
• window.Mtils
• window.Mtils.browser
• window.Mtils.constant
• window.Mtils.extention
• window.Mtils.security
• window.Mtils.utils
• window.Mtils.validation

---

Class window.Mtils.utils

工具类
Defined in: Mtils.js.

Class Summary

Constructor Attributes	Constructor Name and Description
	window.Mtils.utils() 提供一些辅助代码封装

Method Summary

Method Attributes	Method Name and Description
<static>	window.Mtils.utils.cache(key, data, objKey) 保存数据到localStorage中,该函数已扩展到Mtils对象中
<static>	window.Mtils.utils.calcAge(birth, now) 计算年龄
<static>	window.Mtils.utils.ChainCallManager(无参数) 简单版本的链式语法函数调用,该函数已扩展到Window/Mtils对象中
<static>	window.Mtils.utils.clearEmpty(param) 清除数组或者对象中的Empty属性,以下会被判断为Empty:空数组/空对象/null/undefined/NaN/'', 该函数已扩展到Mtils对象中
<static>	window.Mtils.utils.copy(varName) 深复制, 该函数已扩展到Mtils对象上
<static>	window.Mtils.utils.decimalConversion(number, from, to) 提供进制转换,最大为64进制
<static>	window.Mtils.utils.extractPropertyValuesInArray(sourceArr, properties, defaultVal) 根据对象属性在数组中抽取所有该对象属性的值组成新数组返回
<static>	window.Mtils.utils.findInArray(serch, arr, regular) 在数组中根据根据条件进行过滤, 该函数已扩展到Mtils对象中
<static>	window.Mtils.utils.formatMoney(long_data, length) 格式化金额, 展示位银行金额格式
<static>	window.Mtils.utils.getById(id, arr, key) 在数组中根据ID获取对象, 该函数已扩展到Mtils对象中
<static>	window.Mtils.utils.getByteLength(str_data) 获取字符串的字节长度
<static>	window.Mtils.utils.getObjectPropertyVal(obj, propName, defaultVal) 获取对象属性值
<static>	window.Mtils.utils.getVarType(varName) 获取变量的数据类型, 推荐使用Mtils.extention下的数据类型校验方法
<static>	window.Mtils.utils.isDefined(varName) 判断变量是否定义, 该函数已扩展到Mtils/window对象中
<static>	window.Mtils.utils.isEmpty(varName) 判断变量是否为空值,请注意以下对象会被判断为空值:空数组/空对象/null/undefined/NaN/'', 该函数已扩展到Mtils/Window对象中
<static>	window.Mtils.utils.makeMap(keys, defaultVal) 用字符串创建map, 该函数已扩展到Mtils对象中
<static>	window.Mtils.utils.makePy(str, extractFirst) 获取汉字拼音或首字母
<static>	window.Mtils.utils.setObjectPropertyVal(obj, propName, defaultVal, isCreate) 设置对象属性值
<static>	window.Mtils.utils.strIntro(str_data, length) 文本简介, 即截取字符串前几个字符

1: Mtils.cache("Authorization", "uc43d452bdb373e4a36c3efc0f91c928d7"), 这里存入了一个名为'Authorization'的数据, 取回方式:  Mtils.cache("Authorization")
2: Mtils.cache("id", {id:235, name:'mr.zr', age:34}), 这里存入了一个对象, 取回方式如下:  Mtils.cache(235) 或者 Mtils.cache("id")
3: Mtils.cache("man", {id:235, name:'mr.zr', age:34}, "id"), 这里存入了一个对象, 取回方式如下:  Mtils.cache(235) 或者 Mtils.cache("man")

Parameters:

{string} key

存取键值, key值重复会导致数据覆盖, 如果参数2为对象, key值可以为该对象属性

{String} data

欲存取数据

{String} objKey Optional

可选项, 当存取数据为对象时, 指定此选项后, 可以通过data[objKey]的值来存取数据

Returns:

{any}

---

Parameters:

{Date} birth

待设置的对象

{Date} now

待设置属性名称

Returns:

{Int} 计算出的年龄

---

此方案简单解决回调的解决方案,使用如下:

ChainCallManager() 返回一个链式调用对象,可以调用.then(fn)来注册需要调用的函数
当函数注册完毕后,调用.start()或.run(),方法启动函数链的调用
.start()该函数需要你在函数中使用this.next()或this.callNext()方法来手动调用下一个函数,适用于函数之间有先后顺序的调用.比如异步且有顺序,.next()/.callNext()可以传递参数给下一个函数
.run()函数则系统自动按注册顺序调用调用,适合于函数之间没有关联的调用.比如:函数中有异步请求,则系统不会消耗时间等待异步请求返回.会在发送异步请求后直接调用下一个函数
ChainCallManager().then(function(params) {
	 console.log('this is one function', params);
  this.next('call function2'); //请注意,如果这里不调用.next(),函数调用将在这里终止,.next()函数中的参数将会传递给下一个函数
}).then(function(params) {
  console.log('this is two function', params);
}).start('start');  //携带启动参数 start

上面将会依次输出: 
line1: this is one function start
line2: this is two function call function2


ChainCallManager().then(function(params) {
	 console.log('this is one function', params);
  return 'call funtcion2';    //这里的返回值将会传递给下一个函数
}).then(function(params) {
  console.log('this is two function', params);
}).run('start'); //携带启动参数 start


上面将会依次输出: 
line1: this is one function start
line2: this is two function call funtcion2

Parameters:

{none} 无参数

Returns:

{none} , 无返回值

---

Parameters:

{Array|Object} param

欲清除的目标对象

Returns:

{any} result 已清除empty属性的对象

---

Parameters:

{any} varName

待复制的数据

Returns:

{any} , 返回深复制的新对象

---

把16进制0x7b转为2进制, Mtils.utils.decimalConversion("7b",16,2);

Parameters:

{String} number

待转换进制序列

{number} from

待转换进制(2-64)

{number} to

转换到进制(2-64)

Returns:

{String} , 转换后的进制序列

---

Parameters:

{array} sourceArr

待查找的数组

{string} properties

要获取的字段

{string} defaultVal

默认值

Returns:

{Array} , 指定属性的集合

---

Parameters:

{any} serch

查询条件,可以为字符串,也可以用数组一次查询多个

{array} arr

数据源

{boolean} regular

在匹配字符串时是否启用正则,启用正则后,查询条件中的值将转化为正则表达式

Returns:

{array} result 符合条件的返回结果集

---

Parameters:

{Long} long_data

待格式化数值

{Integer} length Optional

可选,格式化金额精度, 即小数点位数. 如: 3 标示保留小数点后三位, 默认为2位

Returns:

{String} , 格式化后金额

---

Parameters:

{string|number|array} id

欲获取的ID值

{array} arr

数据源

{string} key

如指定此参数则使用此参数为key进行查询

Returns:

{array} result 符合条件的返回结果集,如果传入的不是数组则返回结果集中的第一个元素

---

Parameters:

{String} str_data

待获取长度的数据

Returns:

{Long} , 字符串长度

---

Parameters:

{String} obj

待获取长度的数据

{String} propName

待获取属性名称

{String} defaultVal

待获取属性未定义则返回此值

Returns:

{Any} , 获取的属性值

---

Parameters:

{varName} varName

待取数据类型的变量

Returns:

{string} , 变量的数据类型,可能能为以下类型object,array,number,string,function,date,null,undefined

---

Parameters:

{varName} varName

待判断的变量

Returns:

{boolean} , true/false

---

Parameters:

{varName} varName

待判断数据类型的变量

Returns:

{boolean} , true/false

---

Mtils.utils.makeMap('id,name,sex');  返回值: {id:true, name:true, sex:true}

Parameters:

{string} keys

主键字符串,使用','分隔多个key, 例如'key1, key2,...'

{any} defaultVal

创建对象时使用的默认值

Returns:

{object} , 返回创建完成的对象

---

Parameters:

{String} str

待获取拼音的字符串,除汉字外其余字符会直接返回

{Boolean} extractFirst

只获取汉字拼音首字母

Returns:

{String} 目标的拼音字符串

---

Parameters:

{String} obj

待设置的对象

{String} propName

待设置属性名称

{String} defaultVal

待设置属性的值

{String} isCreate

如没有该属性是否创建,默认不创建

Returns:

{Void}

---

Parameters:

{String} str_data

待截取文本

{Integer} length

待截取长度

Returns:

{String} , 文本简介

---