为什么强烈禁止开发人员使用isSuccess作为变量名

在日常开发中,我们会经常要在类中定义布尔类型的变量,比如在给外部系统提供一个RPC接口的时候,我们一般会定义一个字段表示本次请求是否成功的。 关于这个"本次请求是否成功"的字段的定义,其实是有很多种讲究和坑的,稍有不慎就会掉入坑里,作者在很久之前就遇到过类似的问题,本文就来围绕这个简单分析一下。到底该如何定一个布尔类型的成员变量。 一般情况下,我们可以有以下四种方式来定义一个布尔类型的成员变量: boolean successboolean isSuccessBoolean successBoolean isSuccess以上四种定义形式,你日常开发中最常用的是哪种呢?到底哪一种才是正确的使用姿势呢? 通过观察我们可以发现,前两种和后两种的主要区别是变量的类型不同,前者使用的是boolean,后者使用的是Boolean。 另外,第一种和第三种在定义变量的时候,变量命名是success,而另外两种使用isSuccess来命名的。 首先,我们来分析一下,到底应该是用success来命名,还是使用isSuccess更好一点。 success 还是 isSuccess到底应该是用success还是isSuccess来给变量命名呢?从语义上面来讲,两种命名方式都可以讲的通,并且也都没有歧义。那么还有什么原则可以参考来让我们做选择呢。 在阿里巴巴Java开发手册中关于这一点,有过一个『强制性』规定:  那么,为什么会有这样的规定呢?我们看一下POJO中布尔类型变量不同的命名有什么区别吧。 class Model1 { private Boolean isSuccess; public void setSuccess(Boolean success) { isSuccess = success; } public Boolean getSuccess() { return isSuccess; } }class Model2 { private Boolean success; public Boolean getSuccess() { return success; } public void setSuccess(Boolean success) { this.success = success; }}class Model3 { private boolean isSuccess; public boolean isSuccess() { return isSuccess; } public void setSuccess(boolean success) { isSuccess = success; }}class Model4 { private boolean success; public boolean isSuccess() { return success; } public void setSuccess(boolean success) { this.success = success; }}以上代码的setter/getter是使用Intellij IDEA自动生成的,仔细观察以上代码,你会发现以下规律: ...

May 8, 2019 · 3 min · jiezi

underscore中的小技巧

在阅读 underscore 的过程中,发现了它的一些小技巧,对我们平时的编程很有用。在这里向大家介绍一二void 0 代替 underfined首先,看源码:_.isUndefined = function(obj) { return obj === void 0;};这里为啥要用 obj === void 0, 而不是 obj === undefined 呢?因为,在 js 中,undefined 并不是类似关键字(js 关键字有 function,return …),所以,理论上是可以更改的。事实上,在 IE8 上也的确是可以被更改的,var undefined = 1;alert(undefined); // 1 – IE8, undefined — chrome而在 chrome 或高版本的 IE 中,并不能更改全局的 undefined 。但是,局部的 undefined 仍然可以被改变。例如:(function() { var undefined = 1; alert(undefined); // 1 – chrome})();所以, undefined 并不十分可靠,所以才需要 void 0 , void 是 js 的保留字,所以不可被更改。在 MDN 上定义是:The void operator evaluates the given expression and then returns undefined.翻译:void 操作符会对 void 后面的表达式进行运算,然后返回 undefined所以,使用void会一直返回 undefined ,所以,可以用void 0替代undefined.复制数组Array.prototype.slice.call(array); 可用来复制一个数组,或将类数组转换为数组在 js 中,如果我们想复制一个数组,要如何复制呢?也许你会这样做:function copy(array) { var copyArray = []; for (var i = 0, len = array.length; i < len; i++) { copyArray.push(array[i]); } return copyArray;}其实,我们可以利用数组的 slice 和 concat 方法返回新的数组这个特性,来实现复制数组的功能;var newArray = Array.prototype.slice.call(array);var newArray2 = Array.prototype.concat.call(array);而且,性能方面, slice 以及 concat 比单纯使用 for 循环还要更加高效var array = .range(10000000); //.range,是undescore一个方法,用于生成一个从0到10000000的数组console.time(‘for copy push’);var copyArray1 = [];for (var i = 0, length = array.length; i < length; i++) { copyArray1.push(array[i]);}console.timeEnd(‘for copy push’);console.time(‘slice’);var copyArray2 = Array.prototype.slice.call(array);console.timeEnd(‘slice’);console.time(‘concat’);var copyArray3 = Array.prototype.concat.call(array);console.timeEnd(‘concat’);//结果//for copy push: 379.315ms//slice: 109.300ms//concat: 92.852ms另外,也是通过 slice , call 将类数组转换为数组function test() { console.log(Array.prototype.slice.call(arguments));}test(1, 2, 3); //输出[1, 2, 3]使用 Array[length]=value 代替 push 添加元素实际业务代码,除非对性能要求极高,否则还是推荐 push,毕竟更符合习惯首先看源码 .values().values = function(obj) { var keys = .keys(obj); var length = keys.length; var values = Array(length); //等同于new Array(length) for (var i = 0; i < length; i++) { values[i] = obj[keys[i]]; } return values;};一开始看这种写法,并不习惯,我们大多数人可能更习惯这样写(使用 push ):.values = function(obj) { var keys = _.keys(obj); var length = keys.length; var values = []; // for (var i = 0; i < length; i++) { values.push(obj[keys[i]]); //使用push } return values;};实际测试中,第一种写法会比第二种更快。关键在于,我们事先知道要填充的数组 values 的长度,然后预先生成一个对应长度的数组,之后只需要给对应的位置赋值。而第二种在 push 的时候,除了给对应位置赋值,还需要改变 values 数组的 length。所以,建议在已知长度的情况下,使用第一种,而不知道长度的情况下,使用第二种。适当的使用 return function当我们编写两个功能非常相近的函数时,例如,实现复制一个数组的功能,分别是正序和倒序,我们可能会这样子实现(这里只是为了举例子,复制数组推荐第二点提到的使用slice或concat):function copyArray(array, dir) { var copyArray = []; var i = dir > 0 ? 0 : array.length - 1; for (; i >= 0 && i < array.length; i += dir) { copyArray.push(array[i]); } return copyArray;}var copyDesc = function(array) { return copyArray(array, 1);};var copyAsce = function(array) { return copyArray(array, -1);};这样子实现会有什么问题呢?其实对copyDesc,copyAsce,来说,只有 dir 是不同的而已,但是,这种方式实现,却需要将 array 也作为参数传递给 `copyArray。而copyDesc,copyAsce其实只是一个转发的作用而已。我们可以继续优化:function copyArray(dir) { return function(array) { var copyArray = []; var i = dir > 0 ? 0 : array.length - 1; for (; i >= 0 && i < array.length; i += dir) { copyArray.push(array[i]); } return copyArray; };}var copyDesc = copyArray(1);var copyAsce = copyArray(-1);我觉得 return function 这种写法比较优雅一点,你觉得呢?类型判断,使用 Object.prototype.toString()来判断这里只举两个例子,isString,isArray,其他的例如 isArguments , isFunction , 由于有些浏览器兼容问题需要特殊处理,这里就不细说了。而像isNull,isUndefined,这些比较简单的,这里也不细说了:)我们知道:typeof 可能的返回值有:类型结果Undefined"undefined"Null"object"Boolean"boolean"Number"number"String"string"Symbol(ES6 新增)“symbol"宿主对象(由 JS 环境提供)Implementation-dependent函数对象( [[Call]])“function"任何其他对象"object"但是, typeof 却有下面这种问题typeof “test” —> “string"typeof new String(“test”) —> “object"typeof 123 —–> “number"typeof new Number(123) —>“object"跟我们的期望不太一样,Object.prototype.toString 则没有这问题。Object.prototype.toString.call(’test’); //"[object String]“Object.prototype.toString.call(new String(’test’)); //"[object String]“Object.prototype.toString.call(123); //"[object Number]“Object.prototype.toString.call(new Number(123)); //"[object Number]“所以,我们可以通过Object.prototype.toString来进行类型判断function isNumber(obj) { return Object.prototype.toString.call(obj) === ‘[object Number]’;}function isString(obj) { return Object.prototype.toString.call(obj) === ‘[object String]’;}待续。。。 ...

December 21, 2018 · 2 min · jiezi