当前位置：文江博客话题详情

Java methods naming-conventions

Java Base API 中最具误导性的方法是什么？

发布于 2024-08-01 23:32:32 字数 1581 浏览 4 评论 0 原文

我最近试图将字符串文字转换为布尔值，当方法 boolean Boolean.getBoolean(String name) 从自动完成窗口中弹出。还有另一种方法（boolean Boolean.parseBoolean(String s)) 紧随其后出现，这导致我搜索以找出这两者之间的区别，因为它们似乎都做了相同的。

事实证明，Boolean.getBoolean(String name) 真正做的是检查给定名称是否存在 System 属性 (!)，以及它是否存在值为true。我认为这是非常误导的，因为我绝对不希望 Boolean 的方法实际上调用 System.getProperty，只需查看方法签名，它看起来（至少对我来说）确实应该用于将 String 解析为 boolean。当然，javadoc 清楚地说明了这一点，但我仍然认为该方法的名称具有误导性，并且位置不正确。其他原始类型包装器，例如Integer，也有类似的方法。

另外，它似乎不是一个属于基础 API 的非常有用的方法，因为我认为像 -Darg=true 这样的东西并不常见。也许对于 Java 职位面试来说这是一个很好的问题：“Boolean.getBoolean("true") 的输出是什么？”。我相信这些方法更合适的位置是 System 类，例如getPropertyAsBoolean；但同样，我仍然认为没有必要在基础 API 中包含这些方法。将它们放在像 Properties 类中是有意义的，在该类中进行这种类型的转换非常常见。

您对这一切有何看法？此外，如果您还知道其他“尴尬”的方法，请发布。

NB 我知道我可以使用 Boolean.valueOf 或 Boolean.parseBoolean 将字符串文字转换为 boolean，但我只是想讨论 API 设计。

原文

分享到QQ

分享到微博

如果你对这篇内容有疑问，欢迎到本站社区发帖提问参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。

发布评论

需要登录才能够评论，你可以免费注册一个本站的账号。

拥抱我好吗 2024-08-08 23:32:32

Calendar 类的一个众所周知的问题是月份编号为 0 到 11，而不是 1 到 12。很容易犯这样的错误：

Calendar cal = Calendar.getInstance();

// Set date to August 18, 2009? WRONG! Sets the date to September 18, 2009!
cal.set(2009, 8, 18);

正确的方法是使用月份常量：

cal.set(2009, Calendar.AUGUST, 18);

但是该方法使得很容易犯使用正常月份数字 1 到 12 的错误。

我认为这是 Calendar 类设计中的一个错误。

One well-known problem with the Calendar class is that months are numbered 0 to 11 instead of 1 to 12. It's very easy to make a mistake like this:

Calendar cal = Calendar.getInstance();

// Set date to August 18, 2009? WRONG! Sets the date to September 18, 2009!
cal.set(2009, 8, 18);

The right way to do it is by using constants for the months:

cal.set(2009, Calendar.AUGUST, 18);

But the method makes it much too easy to make the mistake of using the normal month numbers 1 to 12.

I regard this as a mistake in the design of the Calendar class.

回复收藏 0 原文

无妨# 2024-08-08 23:32:32

刚刚从这里得到了这个，关于 List 的 add 和 remove 方法（当使用 Integer 参数化时）。例如：

List<Integer> l = new ArrayList<Integer>();
l.add(20);
l.remove(20); // throws ArrayIndexOutOfBoundsException, because it will try to access index 20
l.remove(new Integer(20)); // this works

Just got this one from here, regarding the add and remove methods of List (when parameterized with Integer). For instance:

List<Integer> l = new ArrayList<Integer>();
l.add(20);
l.remove(20); // throws ArrayIndexOutOfBoundsException, because it will try to access index 20
l.remove(new Integer(20)); // this works

回复收藏 0 原文

书信已泛黄 2024-08-08 23:32:32

URL equals() 方法比较 IP 地址，使用网络连接，并且是阻塞操作！

来自javadoc：

如果两个主机名可以是相同的，则两个主机被认为是等效的
解决
进入相同的IP地址；否则，如果任一主机名不能是
解决后，主机名必须相同，不考虑大小写；或两者
主机名等于 null。

由于主机比较需要名称解析，因此此操作是
阻塞操作。

注意：已知 equals 的定义行为
与 HTTP 中的虚拟主机不一致。

请改用 URI。

回复收藏 0 原文

夜吻♂芭芘 2024-08-08 23:32:32

String.getBytes()

通常是应用程序中出现许多愚蠢的字符编码问题的原因，因为它使用底层平台字符编码。

String.getBytes()

often the cause of lots of stupid character encoding problems in applications because it uses the underlying platform character encoding.

回复收藏 0 原文

过期以后 2024-08-08 23:32:32

这可能不是最差方法，但我从来不喜欢这个：

假设 x 是一个已知仅包含字符串的列表。以下代码可用于将列表转储到新分配的字符串数组中：

String[] y = x.toArray(new String[0]);

将大小为 0 的字符串数组传递给该方法对我来说似乎很疯狂且不直观。

It's probably not the worst method, but I never liked this one:

Suppose x is a list known to contain only strings. The following code can be used to dump the list into a newly allocated array of String:

String[] y = x.toArray(new String[0]);

Passing an String array of the size 0 to the method just seems crazy and unintuitive to me.

回复收藏 0 原文

少年亿悲伤 2024-08-08 23:32:32

刚刚发现有关方法 isInterrupted 和 Thread 类的中断。来自javadoc：

static boolean interrupted()
// Tests whether the current thread has been interrupted.
boolean isInterrupted()
// Tests whether this thread has been interrupted.

问题是interrupted除了进行测试之外实际上还清除中断状态，而isInterrupted只是测试状态。

Just found out about the methods isInterrupted and interrupted of class Thread. From javadoc:

static boolean interrupted()
// Tests whether the current thread has been interrupted.
boolean isInterrupted()
// Tests whether this thread has been interrupted.

The problem is that interrupted actually clears the interrupted status besides doing the test, while isInterrupted just tests the status.