2024年12月24日
Java 中的 AbstractCollection (Java SE 23 & JDK 23) 及其示例。
您将找到大多数 AbstractCollection<E> 方法的代码示例。
注解 :
- 本文可能使用了翻译软件以方便阅读。 另请查看英文原文。
简介
此类提供了 Collection 接口的骨架实现，以尽量减少实现该接口所需的工作量。 (机器翻译)
class MyCollection extends AbstractCollection<String> {
private final String[] values;
MyCollection(String[] values) {
this.values = Objects.requireNonNull(values);
}
@Override
public Iterator<String> iterator() {
return new Iterator<>() {
private int index;
@Override
public boolean hasNext() {
return values.length != index;
}
@Override
public String next() {
final var value = values[index];
index++;
return value;
}
};
}
@Override
public int size() {
return values.length;
}
}
final var collection = new MyCollection(new String[]{"aaa", "bbb", "ccc"});
System.out.println(collection); // [aaa, bbb, ccc]
System.out.println(collection.size()); // 3
System.out.println(collection.isEmpty()); // false
System.out.println("-- values --");
for (final var value : collection) {
System.out.println(value);
}
// Result
// ↓
//-- values --
//aaa
//bbb
//ccc
Constructors
AbstractCollection ()
唯一建造者。 (机器翻译)
class MyCollection extends AbstractCollection<String> {
private final String[] values;
MyCollection(String[] values) {
this.values = Objects.requireNonNull(values);
}
@Override
public Iterator<String> iterator() {
return new Iterator<>() {
private int index;
@Override
public boolean hasNext() {
return values.length != index;
}
@Override
public String next() {
final var value = values[index];
index++;
return value;
}
};
}
@Override
public int size() {
return values.length;
}
}
final var collection = new MyCollection(new String[]{"aaa", "bbb", "ccc"});
System.out.println(collection); // [aaa, bbb, ccc]
System.out.println(collection.size()); // 3
System.out.println(collection.isEmpty()); // false
System.out.println("-- values --");
for (final var value : collection) {
System.out.println(value);
}
// Result
// ↓
//-- values --
//aaa
//bbb
//ccc
Methods
boolean add (E e)
确保此集合包含指定元素（可选操作）。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
System.out.println(collection.add("aaa")); // true
System.out.println(collection.add("bbb")); // true
System.out.println(collection.add("bbb")); // true
System.out.println(collection); // [aaa, bbb, bbb]
final AbstractCollection<String> collection = new HashSet<>();
System.out.println(collection.add("aaa")); // true
System.out.println(collection.add("bbb")); // true
System.out.println(collection.add("bbb")); // false
System.out.println(collection); // [aaa, bbb]
boolean addAll (Collection<? extends E> c)
将指定集合中的所有元素添加到此集合（可选操作）。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
final var list1 = List.of("aaa", "bbb");
final var list2 = List.of("bbb", "ccc");
final var list3 = List.of("ccc");
System.out.println(collection.addAll(list1)); // true
System.out.println(collection); // [aaa, bbb]
System.out.println(collection.addAll(list2)); // true
System.out.println(collection); // [aaa, bbb, bbb, ccc]
System.out.println(collection.addAll(list3)); // true
System.out.println(collection); // [aaa, bbb, bbb, ccc, ccc]
final AbstractCollection<String> collection = new HashSet<>();
final var set1 = Set.of("aaa", "bbb");
final var set2 = Set.of("bbb", "ccc");
final var set3 = Set.of("ccc");
System.out.println(collection.addAll(set1)); // true
System.out.println(collection); // [aaa, bbb]
System.out.println(collection.addAll(set2)); // true
System.out.println(collection); // [aaa, ccc, bbb]
System.out.println(collection.addAll(set3)); // false
System.out.println(collection); // [aaa, ccc, bbb]
void clear ()
从此集合中删除所有元素（可选操作）。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
collection.add("aaa");
collection.add("bbb");
collection.add("ccc");
System.out.println(collection); // [aaa, bbb, ccc]
collection.clear();
System.out.println(collection); // []
System.out.println(collection.isEmpty()); // true
boolean contains (Object o)
如果此集合包含指定元素，则返回 true。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
Collections.addAll(collection, "aaa", "bbb", "ccc");
System.out.println(collection); // [aaa, bbb, ccc]
System.out.println(collection.contains("aaa")); // true
System.out.println(collection.contains("bbb")); // true
System.out.println(collection.contains("XXX")); // false
boolean containsAll (Collection<?> c)
如果此集合包含指定集合中的所有元素，则返回 true。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
Collections.addAll(collection, "aaa", "bbb", "ccc");
System.out.println(collection); // [aaa, bbb, ccc]
final var list1 = List.of("aaa", "bbb");
System.out.println(collection.containsAll(list1)); // true
final var list2 = List.of("bbb", "XXX");
System.out.println(collection.containsAll(list2)); // false
final var list3 = List.of("XXX", "YYY");
System.out.println(collection.containsAll(list3)); // false
boolean isEmpty ()
如果此集合不包含任何元素，则返回 true。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
System.out.println(collection); // []
System.out.println(collection.size()); // 0
System.out.println(collection.isEmpty()); // true
collection.add("aaa");
System.out.println(collection); // [aaa]
System.out.println(collection.size()); // 1
System.out.println(collection.isEmpty()); // false
collection.add("bbb");
System.out.println(collection); // [aaa, bbb]
System.out.println(collection.size()); // 2
System.out.println(collection.isEmpty()); // false
abstract Iterator<E> iterator ()
返回此集合中包含的元素的迭代器。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
Collections.addAll(collection, "aaa", "bbb", "ccc");
System.out.println(collection); // [aaa, bbb, ccc]
final var iterator = collection.iterator();
iterator.forEachRemaining(System.out::println);
// Result
// ↓
//aaa
//bbb
//ccc
boolean remove (Object o)
如果存在，则从此集合中删除指定元素的单个实例（可选操作）。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
collection.add("aaa");
collection.add("bbb");
collection.add("ccc");
System.out.println(collection); // [aaa, bbb, ccc]
System.out.println(collection.remove("aaa")); // true
System.out.println(collection); // [bbb, ccc]
System.out.println(collection.remove("bbb")); // true
System.out.println(collection); // [ccc]
System.out.println(collection.remove("XXX")); // false
System.out.println(collection); // [ccc]
boolean removeAll (Collection<?> c)
删除此集合中所有包含在指定集合中的元素（可选操作）。 (机器翻译)
final var src = List.of("aaa", "bbb", "ccc");
{
final AbstractCollection<String> collection = new ArrayList<>(src);
System.out.println(collection); // [aaa, bbb, ccc]
final var list = List.of("aaa", "bbb");
System.out.println(collection.removeAll(list)); // true
System.out.println(collection); // [ccc]
}
{
final AbstractCollection<String> collection = new ArrayList<>(src);
System.out.println(collection); // [aaa, bbb, ccc]
final var list = List.of("XXX", "YYY");
System.out.println(collection.removeAll(list)); // false
System.out.println(collection); // [aaa, bbb, ccc]
}
{
final AbstractCollection<String> collection = new ArrayList<>(src);
System.out.println(collection); // [aaa, bbb, ccc]
final var list = List.of("aaa", "bbb", "ccc", "XXX");
System.out.println(collection.removeAll(list)); // true
System.out.println(collection); // []
}
boolean retainAll (Collection<?> c)
仅保留此集合中包含在指定集合中的元素（可选操作）。 (机器翻译)
final var src = List.of("aaa", "bbb", "ccc");
{
final AbstractCollection<String> collection = new ArrayList<>(src);
System.out.println(collection); // [aaa, bbb, ccc]
final var list = List.of("aaa", "bbb");
System.out.println(collection.retainAll(list)); // true
System.out.println(collection); // [aaa, bbb]
}
{
final AbstractCollection<String> collection = new ArrayList<>(src);
System.out.println(collection); // [aaa, bbb, ccc]
final var list = List.of("XXX", "YYY");
System.out.println(collection.retainAll(list)); // true
System.out.println(collection); // []
}
{
final AbstractCollection<String> collection = new ArrayList<>(src);
System.out.println(collection); // [aaa, bbb, ccc]
final var list = List.of("aaa", "bbb", "ccc", "XXX");
System.out.println(collection.retainAll(list)); // false
System.out.println(collection); // [aaa, bbb, ccc]
}
Object[] toArray ()
返回包含此集合中所有元素的数组。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
Collections.addAll(collection, "aaa", "bbb", "ccc");
System.out.println(collection); // [aaa, bbb, ccc]
final Object[] ret = collection.toArray();
System.out.println(Arrays.toString(ret)); // [aaa, bbb, ccc]
<T> T[] toArray (T[] a)
返回包含此集合中所有元素的数组；返回数组的运行时类型是指定数组的类型。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
Collections.addAll(collection, "aaa", "bbb", "ccc");
System.out.println(collection); // [aaa, bbb, ccc]
{
final String[] ret = collection.toArray(new String[0]);
System.out.println(Arrays.toString(ret)); // [aaa, bbb, ccc]
}
{
final String[] array = new String[collection.size()];
System.out.println(Arrays.toString(array)); // [null, null, null]
final var ret = collection.toArray(array);
System.out.println(Arrays.toString(ret)); // [aaa, bbb, ccc]
System.out.println(Arrays.toString(array)); // [aaa, bbb, ccc]
}
String toString ()
返回此集合的字符串表示形式。 (机器翻译)
final AbstractCollection<String> collection = new ArrayList<>();
final var str1 = collection.toString();
System.out.println(str1); // []
collection.add("aaa");
final var str2 = collection.toString();
System.out.println(str2); // [aaa]
collection.add("bbb");
collection.add("ccc");
final var str3 = collection.toString();
System.out.println(str3); // [aaa, bbb, ccc]
Methods declared in Collection
equals, hashCode, parallelStream, removeIf, size, spliterator, stream, toArray
请参阅下面的链接。