我刚刚发现在 Java 5 里声明的一个方法：Integer.getInteger(String)：

http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Integer.html#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)。这是我刚发明的术语。它说的是人们使用非常相似的术语表达完全不同的东西。看一下 x 和 y 这两个词，一种情况下它们用做 gm(x) 和 gm(y)，(译者注：gm是重量单位’克‘)，而另一种上下文中它们用做 cm(x) 和 cm(y)(译者注：cm是长度单位’厘米‘)。如果你这样使用

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

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

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

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

【编辑推荐】

1. Java EE进阶之Spring事务深入浅出
2. 深度探讨Java字节代码的操纵方法
3. PHP与Java在Web开发方面的比较
4. 2010年,Java怀念它 2011年,Java期待它
5. Java EE 7将于2012年发布 基于云操作平台