为什么List.add（E）返回布尔值，而List.Add（int，E）返回void？

Question

查看javadoc，我看到ArrayList有一个重载的add方法：

public boolean add（E e）

将指定的元素追加到此列表的末尾。

和

public void add（int index，E元素）

将指定的元素插入此列表中的指定位置。将当前在该位置的元素（如果有）和任何后续元素右移（将其索引添加一个）。

我注意到第一个返回了一个，boolean而第二个返回了一个void。事实证明，第一个addHAS返回a的boolean原因是：

返回：true（由Collection.add（E）指定）

所以我去了Collection.add（E）：

布尔值add（E e）

确保此集合包含指定的元素（可选操作）。如果此集合由于调用而更改，则返回true。（如果此集合不允许重复并且已经包含指定的元素，则返回false。）

所以我的问题是，为什么add指定要返回布尔值而不是空值？当我add做某事时，我希望只做一个手术。

我知道，与ArrayList相比，还有其他数据结构不允许重复（例如集合）。但是即使那样，也无法通过以下方式解决问题：

public void add(E e){
    if(e is not in set){
        add e;
    }
}

这样，如果eIS在集合中，则不采取任何措施。为什么最好返回a boolean而不是void方法？

Answer 1

Collection.add是一种非常通用的方法（就Java通用而言，不是广泛应用的意义）。因此，他们想要一个通常适用的返回值。

有些类（如ArrayList）总是接受元素，因此总是会返回true。您是对的，在这种情况下，返回类型也是void一样的。

但是其他类似Set的元素有时会不允许添加元素。在Set的情况下，如果已经存在相等的元素，则会发生这种情况。知道这一点通常很有帮助。另一个示例是有界集合（只能容纳一定数量的元素）。

您可能会问：“编写代码是否只能手动进行检查？” 例如，带有一组：

if (!set.contains(item)) {
    set.add(item);
    itemWasAdded(item);
}

这比您现在可以做的要冗长得多，但不是很多：

if (set.add(item)) {
    itemWasAdded(item);
}

但是，这种先检查后行动的行为不是线程安全的，这在多线程应用程序中可能至关重要。例如，可能是另一个线程在您检查set.contains(item)和set.add(item)第一个代码段中的之间添加了相等的项。在多线程方案中，这两个动作实际上需要是一个单独的原子动作。boolean从方法返回使之成为可能。