今天可得来好好聊聊那个让人又爱又恨的 java.lang.UnsupportedOperationException ，它呀，可是 Java 世界里的 “常客”，属于那种经常冒出来的运行时异常呢。就好比你兴致勃勃地准备大展身手，去执行某个操作，结果呢，就像撞上了一堵隐形的墙，在特定的那些个情况里，人家压根就不支持你这么干呀，嘿，这时候它就闪亮登场啦！
而且呀，这异常出现的 “老巢” 咱也得知道，大多时候呢，都是咱们在和集合框架打交道，或者去调用某些接口方法的时候，它就冷不丁地冒出来刷存在感了。
咱今儿这篇文章可有大用处哦，会仔仔细细地把这异常产生的原因给大家扒拉个清清楚楚，就像侦探破案一样，一点儿细节都不放过呢。不仅如此，还会给各位大侠呈上多种多样超管用的解决方案，就像是给大家送上了一堆应对这异常的 “法宝” 呀。最最重要的是，咱还准备了一堆示例代码呢，这些代码就好比是一个个小向导，带着大家在理解和预防这个异常的道路上一路畅通，让它以后都不敢轻易来捣乱啦！
1. 问题描述
咱再来说说这 UnsupportedOperationException 具体是咋回事哈。它呀，就是那种你在调用某些方法的时候，突然就被抛出来的异常，为啥呢？因为那些方法的实现呀，就跟个特别有原则的 “老顽固” 似的，明明白白地跟你说：“哼，你这当前的操作呀，我可不支持呢，别白费力气啦！”
那它经常出没的常见场景都有啥呢？这可太有意思啦，比如说呀，你可能想着去修改一下那个由 Arrays.asList() 方法弄出来的固定大小的列表，这就好比你看着一个已经做好了、定型了的雕塑，非得要上去给它改改造型，人家能乐意嘛，肯定不干呀，直接就给你来个异常啦。还有哦，你要是去打那些不可变集合的主意，想着去改改它们，那就更像是去挑战一座坚不可摧的城堡，人家稳稳当当的，压根儿不会让你得逞，然后 “嗖” 的一下，这个 UnsupportedOperationException 就冒出来啦，哈哈！
分享
示例错误信息：
Exception in thread “main” java.lang.UnsupportedOperationException
at java.util.AbstractList.add(AbstractList.java:148)
at java.util.AbstractList.add(AbstractList.java:108)
at java.util.Arrays$ArrayList.add(Arrays.java:4230)
at com.example.Main.main(Main.java:10)
场景描述：
假设我们有以下代码，试图向由Arrays.asList()返回的列表中添加元素：
import java.util.Arrays;
import java.util.List;
public class Main {
public static void main(String[] args) {
List list = Arrays.asList(“apple”, “banana”, “orange”);
list.add(“pear”); // 试图修改不可变列表
}
}
执行上述代码时，会抛出 UnsupportedOperationException。
2. 问题分析
UnsupportedOperationException 的根本原因是代码尝试执行当前对象不支持的操作。常见的情况包括：
2.1 修改不可变的集合
某些集合实现（如Arrays.asList()返回的ArrayList）不支持添加、删除或修改操作。这类集合是固定大小的，任何试图改变其大小的操作都会抛出 UnsupportedOperationException。
2.2 使用默认的接口方法实现
在自定义类中继承接口或抽象类时，如果未重写某些方法并直接调用父类或接口的默认实现，这些方法可能会抛出 UnsupportedOperationException，表明该操作未被支持或实现。
2.3 误用某些 API
有些 Java API 的设计本意是提供只读视图或不可修改的集合。对这些集合的修改操作都会导致 UnsupportedOperationException。
3. 解决方案
3.1 使用支持修改的集合实现
如果需要对列表进行添加或删除操作，确保使用支持修改的集合实现，如 ArrayList、HashMap 等。
示例代码：
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
public class Main {
public static void main(String[] args) {
List list = new ArrayList<>(Arrays.asList(“apple”, “banana”, “orange”));
list.add(“pear”); // 成功添加元素
System.out.println(list); // 输出: [apple, banana, orange, pear]
}
}
3.2 替换不可变集合
如果操作不可变集合时抛出异常，可以使用 Collections.unmodifiableList() 来创建不可变集合，以确保集合不会被无意修改。
示例代码：
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
public class Main {
public static void main(String[] args) {
List mutableList = new ArrayList<>();
mutableList.add(“apple”);
mutableList.add(“banana”);
List unmodifiableList = Collections.unmodifiableList(mutableList);
// 下面的行将抛出 UnsupportedOperationException
// unmodifiableList.add("orange");
System.out.println(unmodifiableList); // 输出: [apple, banana]
}
}
3.3 自定义类中正确实现接口方法
在实现接口或继承抽象类时，确保所有必须的方法都已正确实现，并且不要直接调用父类或接口中的默认方法，除非你确定这些方法支持当前操作。
示例代码：
import java.util.AbstractList;
import java.util.List;
public class CustomList extends AbstractList {
private final List internalList;
public CustomList(List<String> list) {
this.internalList = list;
}
@Override
public String get(int index) {
return internalList.get(index);
}
@Override
public int size() {
return internalList.size();
}
@Override
public boolean add(String s) {
return internalList.add(s);
}
// 可根据需要实现其他方法
}
3.4 使用工具类创建可变集合
对于需要从数组或不可变集合生成可变集合的情况，可以使用 new ArrayList<>(…) 或类似构造方法来创建新的可变集合。
示例代码：
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List immutableList = List.of(“apple”, “banana”, “orange”); // Java 9+
List mutableList = new ArrayList<>(immutableList);
mutableList.add(“pear”); // 成功添加元素
System.out.println(mutableList); // 输出: [apple, banana, orange, pear]
}
}
4. 预防措施
理解集合的特性：在使用集合时，理解它们的特性，特别是哪些集合是不可变的，哪些是可修改的。
慎用Arrays.asList()：在需要可修改的列表时，尽量不要直接使用Arrays.asList()返回的列表，转而使用new ArrayList<>(Arrays.asList(…))。
避免调用不支持的操作：在自定义类中实现接口或继承抽象类时，避免调用父类或接口中的默认实现，确保所有方法都按照预期工作。
使用单元测试：通过单元测试验证代码的正确性，特别是在涉及集合操作时，确保不会抛出意外的UnsupportedOperationException。
5. 总结
在 Java 编程环境中，java.lang.UnsupportedOperationException 属于一种异常类型，其产生根源在于试图去执行那些当前对象并不支持的操作，进而导致该异常被触发。
为了有效解决以及避免 UnsupportedOperationException 的出现，开发者有必要深入理解集合相关的各类特性，选用恰当的集合实现方式，同时在自定义类里要确保正确无误地实现接口方法，并且要开展充分且全面的测试工作。
本文精心梳理并提供了多种具备针对性的解决方案以及实用的建议，旨在助力开发者能够迅速且精准地定位 UnsupportedOperationException 问题，并妥善予以解决。
期望本文能够为您在相关开发工作中提供有益的参考与帮助，若您存在其他疑问或者想要进一步探讨的问题，欢迎随时展开讨论交流。