Java里的愚蠢 API 设计

本文翻译自 Integer.getInteger. Are you kidding me?

不知道你是否发现过,在Java里有这样一个方法声明:

Integer.getInteger(String)

你可以下面这个地址看到它的详细介绍:

http://java.sun.com/j2se/ … #getInteger(java.lang.String)

根据指定的名称得到系统属性的整数值。
第一个参数将被认为是系统属性的名称。系统属性可以通过 System.getProperty(java.lang.String)方法访问得到。属性值字符串将被解释成一个整数,并且以表示这个值的Integer对象形式返回。可能出现的数字格式的详细说明可以在 getProperty 的定义说明里找到。

那么就让我来看看是否理解了:

  • Integer.valueOf(String) 通过假设 String 表达的是一个数值而把 String 转化成数字。也就是说, Integer.valueOf("12345") 得到数字 12345
  • Integer.getInteger(String) 通过假设 String 是一个系统属性数值的名称而把 String 转换成一个数字。也就是说, Integer.getInteger("12345") 应该是得到 null

有谁会认为这两者之间有足够清晰的区别?有多少bug是因为本来想使用valueOf但却使用了getInteger而导致的?

这种形式的方法重载就是所谓的谐音重载(near-phrase overloading)。这是我刚发明的术语。它说的是人们使用非常相似的术语表达完全不同的东西。看一下 xy 这两个词,一种情况下它们用做 gm(x)gm(y),(译者注:gm是重量单位’克‘),而另一种上下文中它们用做 cm(x)cm(y)(译者注:cm是长度单位’厘米‘)。如果你这样使用

distance(gm(x), gm(y))< distance(cm(x), cm(y))

那么这就是一种错误的对 xy 用法!你应该在这个上下文中使用 xy 之外的变量名。事实上,那个方法应该被叫做 getIntegerProperty

这是我在Java中看到的绝对会产生歧义一个最糟糕的案例。他们应该把事情做得漂亮些。

Update:结果我又发现了更糟糕的一个: Boolean.getBoolean("true") 得出的结果会等于 Boolean.FALSE

加载余下内容▼

相关文章:

;