
本文详解如何在 arraylist 存储的自定义对象中,安全、准确地实现对字段(如 organizationname)的忽略大小写部分匹配搜索,避免空指针异常和逻辑错误。
在使用 ArrayList
进行模糊搜索时,常见的需求是:根据用户输入的关键词(如 "anth"),查找所有 organizationName 字段中包含该关键词(不区分大小写) 的地址对象。但直接调用 String.contains() 会导致大小写敏感问题,而错误的 toLowerCase() 调用顺序还可能引发 NullPointerException。? 核心问题分析
原始代码存在两个关键缺陷:
- 空指针风险:d.getOrganizationName().toLowerCase() != null 先调用了 toLowerCase(),若 getOrganizationName() 返回 null,会立即抛出 NullPointerException,根本无法进入判空逻辑;
- 大小写未统一:contains() 前未将 d.getOrganizationName() 转为小写,导致 "Anth".contains("anth") 返回 false(因为 contains 是严格字符匹配)。
✅ 正确实现方式
应先判空,再统一转小写后执行 contains:
@Override
public List searchAddress(String search) {
// 若 search 为空或空白,可选择返回空列表或全部数据(按业务需求)
if (search == null || search.trim().isEmpty()) {
return new ArrayList<>(list); // 返回副本,避免外部修改原列表
}
List result = new ArrayList<>();
String searchTerm = search.trim().toLowerCase(); // 预处理搜索词
for (Address address : list) {
String orgName = address.getOrganizationName();
// 安全判空 + 统一小写匹配
if (orgName != null && orgName.toLowerCase().contains(searchTerm)) {
result.add(address);
}
}
return result;
}? 进阶建议(提升健壮性与性能)
- 避免重复调用 toLowerCase():若 organizationName 字段值固定且查询频繁,可考虑在 Address 类中增加一个 getOrganizationNameIgnoreCase() 方法,或在构造时缓存小写版本(权衡内存与 CPU);
-
使用 Java 8+ Stream 提升可读性:
public List searchAddress(String search) { if (search == null || search.trim().isEmpty()) return new ArrayList<>(list); String term = search.trim().toLowerCase(); return list.stream() .filter(addr -> addr.getOrganizationName() != null && addr.getOrganizationName().toLowerCase().contains(term)) .collect(Collectors.toList()); } - 增强匹配能力(可选):如需支持更灵活的搜索(如分词、前缀匹配、正则),可引入 Apache Commons Lang 的 StringUtils.containsIgnoreCase() 或集成 Lucene/Elasticsearch。
⚠️ 注意事项总结
- ✅ 始终先检查 getOrganizationName() != null,再调用任何字符串方法;
- ✅ search 参数也应判空/去空格,防止 " " 导致意外行为;
- ❌ 禁止在 null 对象上调用 toLowerCase()、contains() 等实例方法;
- ? String.toLowerCase() 在某些 Locale 下可能产生非预期结果(如土耳其语),如需国际化强一致性,建议显式指定 Locale.ENGLISH:
orgName.toLowerCase(Locale.ENGLISH).contains(searchTerm.toLowerCase(Locale.ENGLISH))
通过以上修正,searchAddress("Anth") 和 searchAddress("anth") 将均能正确匹配到 organizationName = "Anth" 的对象,真正实现大小写不敏感的子串搜索。
立即学习“Java免费学习笔记(深入)”;










