Java-List-接口的核心-API
目录
Java List 接口的核心 API
1. 添加元素
方法：
boolean add(E e)：将元素添加到列表末尾。void add(int index, E element)：将元素插入到指定位置。boolean addAll(Collection<? extends E> c)：将集合中的所有元素添加到列表末尾。boolean addAll(int index, Collection<? extends E> c)：将集合中的所有元素插入到指定位置。
示例：
import java.util.ArrayList;
import java.util.List;
public class AddExample {
public static void main(String[] args) {
List<String> fruits = new ArrayList<>();
// 添加单个元素
fruits.add("Apple");
fruits.add("Banana");
System.out.println("After add: " + fruits); // [Apple, Banana]
// 在指定位置插入元素
fruits.add(1, "Orange");
System.out.println("After add at index 1: " + fruits); // [Apple, Orange, Banana]
// 添加另一个集合
List<String> moreFruits = new ArrayList<>();
moreFruits.add("Mango");
moreFruits.add("Pineapple");
fruits.addAll(moreFruits);
System.out.println("After addAll: " + fruits); // [Apple, Orange, Banana, Mango, Pineapple]
// 在指定位置插入另一个集合
fruits.addAll(2, moreFruits);
System.out.println("After addAll at index 2: " + fruits); // [Apple, Orange, Mango, Pineapple, Banana, Mango, Pineapple]
}
}2. 删除元素
方法：
boolean remove(Object o)：删除指定元素。E remove(int index)：删除指定位置的元素。boolean removeAll(Collection<?> c)：删除列表中包含在指定集合中的所有元素。boolean retainAll(Collection<?> c)：仅保留列表中包含在指定集合中的元素。void clear()：清空列表。
示例：
import java.util.ArrayList;
import java.util.List;
public class RemoveExample {
public static void main(String[] args) {
List<String> fruits = new ArrayList<>();
fruits.add("Apple");
fruits.add("Banana");
fruits.add("Orange");
fruits.add("Mango");
System.out.println("Original list: " + fruits); // [Apple, Banana, Orange, Mango]
// 删除指定元素
fruits.remove("Banana");
System.out.println("After remove 'Banana': " + fruits); // [Apple, Orange, Mango]
// 删除指定位置的元素
fruits.remove(1);
System.out.println("After remove index 1: " + fruits); // [Apple, Mango]
// 删除多个元素
List<String> toRemove = new ArrayList<>();
toRemove.add("Apple");
toRemove.add("Mango");
fruits.removeAll(toRemove);
System.out.println("After removeAll: " + fruits); // []
// 仅保留指定元素
fruits.add("Apple");
fruits.add("Banana");
fruits.add("Orange");
List<String> toRetain = new ArrayList<>();
toRetain.add("Apple");
fruits.retainAll(toRetain);
System.out.println("After retainAll: " + fruits); // [Apple]
// 清空列表
fruits.clear();
System.out.println("After clear: " + fruits); // []
}
}3. 获取和修改元素
方法：
E get(int index)：获取指定位置的元素。E set(int index, E element)：修改指定位置的元素。List<E> subList(int fromIndex, int toIndex)：获取子列表。
示例：
import java.util.ArrayList;
import java.util.List;
public class GetSetExample {
public static void main(String[] args) {
List<String> fruits = new ArrayList<>();
fruits.add("Apple");
fruits.add("Banana");
fruits.add("Orange");
// 获取元素
String fruit = fruits.get(1);
System.out.println("Element at index 1: " + fruit); // Banana
// 修改元素
fruits.set(1, "Blueberry");
System.out.println("After set: " + fruits); // [Apple, Blueberry, Orange]
// 获取子列表
List<String> subList = fruits.subList(1, 3);
System.out.println("SubList: " + subList); // [Blueberry, Orange]
}
}4. 查找元素
方法：
boolean contains(Object o)：判断列表是否包含指定元素。int indexOf(Object o)：返回指定元素首次出现的索引。int lastIndexOf(Object o)：返回指定元素最后一次出现的索引。
示例：
import java.util.ArrayList;
import java.util.List;
public class SearchExample {
public static void main(String[] args) {
List<String> fruits = new ArrayList<>();
fruits.add("Apple");
fruits.add("Banana");
fruits.add("Orange");
fruits.add("Banana");
// 判断是否包含元素
System.out.println("Contains 'Banana': " + fruits.contains("Banana")); // true
// 查找元素首次出现的索引
System.out.println("Index of 'Banana': " + fruits.indexOf("Banana")); // 1
// 查找元素最后一次出现的索引
System.out.println("Last index of 'Banana': " + fruits.lastIndexOf("Banana")); // 3
}
}5. 遍历列表
方法：
- 增强 for 循环。
Iterator<E> iterator()：返回一个迭代器。ListIterator<E> listIterator()：返回一个列表迭代器。ListIterator<E> listIterator(int index)：从指定位置开始返回一个列表迭代器。
示例：
import java.util.ArrayList;
import java.util.List;
import java.util.ListIterator;
public class IterationExample {
public static void main(String[] args) {
List<String> fruits = new ArrayList<>();
fruits.add("Apple");
fruits.add("Banana");
fruits.add("Orange");
// 使用增强 for 循环
System.out.println("Using for-each loop:");
for (String fruit : fruits) {
System.out.println(fruit);
}
// 使用迭代器
System.out.println("Using iterator:");
var iterator = fruits.iterator();
while (iterator.hasNext()) {
System.out.println(iterator.next());
}
// 使用列表迭代器（支持双向遍历）
System.out.println("Using listIterator:");
ListIterator<String> listIterator = fruits.listIterator();
while (listIterator.hasNext()) {
System.out.println(listIterator.next());
}
}
}6. 排序
方法：
void sort(Comparator<? super E> c)：根据比较器对列表排序。
示例：
import java.util.ArrayList;
import java.util.List;
public class SortExample {
public static void main(String[] args) {
List<String> fruits = new ArrayList<>();
fruits.add("Orange");
fruits.add("Apple");
fruits.add("Banana");
// 按自然顺序排序
fruits.sort(null);
System.out.println("After sorting: " + fruits); // [Apple, Banana, Orange]
}
}7. 转换为数组
方法：
Object[] toArray()：转换为数组。<T> T[] toArray(T[] a)：转换为指定类型的数组。
示例：
import java.util.ArrayList;
import java.util.List;
public class ToArrayExample {
public static void main(String[] args) {
List<String> fruits = new ArrayList<>();
fruits.add("Apple");
fruits.add("Banana");
fruits.add("Orange");
// 转换为数组
Object[] array = fruits.toArray();
System.out.println("Array: " + Arrays.toString(array)); // [Apple, Banana, Orange]
// 转换为指定类型的数组
String[] stringArray = fruits.toArray(new String[0]);
System.out.println("String Array: " + Arrays.toString(stringArray)); // [Apple, Banana, Orange]
}
}8. 其他方法
方法：
int size()：返回列表的大小。boolean isEmpty()：判断列表是否为空。boolean equals(Object o)：判断列表是否与指定对象相等。int hashCode()：返回列表的哈希码。
示例：
import java.util.ArrayList;
import java.util.List;
public class OtherMethodsExample {
public static void main(String[] args) {
List<String> fruits = new ArrayList<>();
fruits.add("Apple");
fruits.add("Banana");
// 获取列表大小
System.out.println("Size: " + fruits.size()); // 2
// 判断列表是否为空
System.out.println("Is empty: " + fruits.isEmpty()); // false
// 判断列表是否相等
List<String> anotherList = new ArrayList<>();
anotherList.add("Apple");
anotherList.add("Banana");
System.out.println("Equals: " + fruits.equals(anotherList)); // true
}
}