在Java的集合框架中,Collections工具类提供了很多操作集合的静态方法,其中swap()方法可以快速交换列表中指定索引位置的两个元素对象,不需要开发者手动编写交换逻辑,能够简化代码编写流程。

Collections.swap() 方法基本语法
Collections.swap()是java.util.Collections类中的静态方法,其方法签名如下:
public static void swap(List<?> list, int i, int j)
该方法接收三个参数,各参数的含义如下:
- list:需要操作的目标列表,必须是
List接口的实现类实例,比如ArrayList、LinkedList等 - i:第一个要交换元素的索引位置,索引从0开始计数
- j:第二个要交换元素的索引位置,索引从0开始计数
方法执行后,列表中索引i和索引j位置的元素会互换位置,其他位置的元素保持不变。需要注意的是,该方法没有返回值,直接修改原列表的内容。
使用示例演示
下面通过一个完整的示例演示如何使用Collections.swap()交换列表中的元素:
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
public class SwapDemo {
public static void main(String[] args) {
// 创建包含字符串元素的列表
List<String> fruitList = new ArrayList<>();
fruitList.add("苹果");
fruitList.add("香蕉");
fruitList.add("橙子");
fruitList.add("葡萄");
fruitList.add("西瓜");
System.out.println("交换前的列表:" + fruitList);
// 交换索引1和索引3位置的元素,也就是香蕉和葡萄互换
Collections.swap(fruitList, 1, 3);
System.out.println("交换后的列表:" + fruitList);
// 交换自定义对象列表的元素
List<User> userList = new ArrayList<>();
userList.add(new User("张三", 20));
userList.add(new User("李四", 25));
userList.add(new User("王五", 22));
System.out.println("交换前用户列表:" + userList);
// 交换第一个和第二个用户对象
Collections.swap(userList, 0, 1);
System.out.println("交换后用户列表:" + userList);
}
}
class User {
private String name;
private int age;
public User(String name, int age) {
this.name = name;
this.age = age;
}
@Override
public String toString() {
return "User{name='" + name + "', age=" + age + "}";
}
}
上述代码的执行结果如下:
交换前的列表:[苹果, 香蕉, 橙子, 葡萄, 西瓜]
交换后的列表:[苹果, 葡萄, 橙子, 香蕉, 西瓜]
交换前用户列表:[User{name='张三', age=20}, User{name='李四', age=25}, User{name='王五', age=22}]
交换后用户列表:[User{name='李四', age=25}, User{name='张三', age=20}, User{name='王五', age=22}]
注意事项
使用Collections.swap()方法时,需要注意以下几点,避免出现错误:
1. 索引不能越界
参数i和j的取值必须在列表的有效索引范围内,也就是大于等于0且小于列表的size()。如果传入的索引超出范围,会抛出IndexOutOfBoundsException异常。
List<Integer> numList = new ArrayList<>(Arrays.asList(1,2,3)); // 错误示例:索引3超出列表大小,会抛出异常 Collections.swap(numList, 1, 3);
2. 列表必须支持修改操作
如果传入的列表是不可修改的列表,比如通过Collections.unmodifiableList()创建的列表,调用swap()方法会抛出UnsupportedOperationException异常。
3. i和j可以相等
当传入的两个索引i和j相等时,方法不会做任何操作,列表内容保持不变,不会抛出异常。
4. 列表元素为对象时交换的是引用
如果列表存储的是对象元素,swap()方法交换的是两个索引位置的对象引用,不会修改对象本身的属性内容。
手动实现交换逻辑对比
如果不使用Collections.swap()方法,手动实现列表元素交换的逻辑如下:
public static <T> void manualSwap(List<T> list, int i, int j) {
// 校验索引合法性
if (i < 0 || i >= list.size() || j < 0 || j >= list.size()) {
throw new IndexOutOfBoundsException("索引超出范围");
}
T temp = list.get(i);
list.set(i, list.get(j));
list.set(j, temp);
}
可以看到手动实现需要自己处理索引校验和临时变量存储,而Collections.swap()已经封装了这些逻辑,使用起来更加简洁,也不容易出错。
Collections.swapJava_list元素交换集合操作修改时间:2026-06-29 04:12:24