本文介绍如何在 Spring Boot 应用中，从 Excel 单元格读取以英文分号（;）分隔的多个地点名称，并通过优化服务层与数据访问层，实现高效、安全的批量地点查询。
本文介绍如何在 spring boot 应用中，从 excel 单元格读取以英文分号（`;`）分隔的多个地点名称，并通过优化服务层与数据访问层，实现高效、安全的批量地点查询。
在实际业务场景中，Excel 导入常需支持单字段多值输入（如 北京;上海;深圳），而默认的 searchByName(String name) 方法仅能处理单一名称。为支持此类需求，需重构数据读取与查询逻辑，实现「字符串分割 → 批量查库 → 合并结果」的完整链路。
✅ 步骤一：扩展 Excel 数据解析逻辑
首先，在 Excel 读取器中新增 getLocations(...) 方法，负责解析分号分隔的字符串并转换为 List<Location>：
private List<Location> getLocations(Row rowData, int index, String prefix) {
String locationData = this.excelReaderService.getData(rowData, index);
if (StringUtils.isBlank(locationData)) {
return Collections.emptyList();
}
// 安全分割：去除首尾空格，过滤空项
String[] nomLocations = locationData.split(";");
List<String> names = Arrays.stream(nomLocations)
.map(String::trim)
.filter(StringUtils::isNotBlank)
.collect(Collectors.toList());
return this.locationService.searchByNames(names);
}⚠️ 注意：split(";") 不会自动去除空格或空白项，务必使用 trim() 和 filter(isNotBlank) 避免因 "北京; ;上海" 导致无效查询或空指针异常。
✅ 步骤二：增强 LocationService 的批量查询能力
在 LocationService 中新增 searchByNames(List<String>) 方法。具体实现取决于数据库类型：
▪ 若使用 JPA + 关系型数据库（如 MySQL、PostgreSQL）
推荐使用 Spring Data JPA 原生 In 查询，简洁高效：
// LocationService.java
@Override
public List<Location> searchByNames(List<String> names) {
if (names == null || names.isEmpty()) {
return Collections.emptyList();
}
return this.locationRepository.findByNameIn(names);
}对应在 LocationRepository 接口中声明方法（JPA 自动解析）：
// LocationRepository.java
public interface LocationRepository extends JpaRepository<Location, Long> {
List<Location> findByNameIn(List<String> names);
// ✅ 自动映射为 SQL: WHERE name IN (?, ?, ?)
}▪ 若使用 MongoDB 等 NoSQL 数据库
避免低效循环调用（N+1 查询），应改用 Criteria 或 Query 构建 $in 查询：
// LocationRepositoryImpl.java（MongoDB 示例）
@Override
public List<Location> searchByNames(List<String> names) {
if (names == null || names.isEmpty()) {
return Collections.emptyList();
}
Query query = new Query(Criteria.where("name").in(names));
return mongoTemplate.find(query, Location.class, "location");
}❗ 切勿在 NoSQL 场景下照搬“循环调用 findFirstByName”——这将导致 N 次网络往返，严重拖慢性能且易触发连接池耗尽。
✅ 步骤三：调用与整合（可选：返回非空结果集）
在业务逻辑中，可直接替换原单点调用：
// 替换原来的：
// Location location = getLocation(rowData, index, prefix);
// 改为：
List<Location> locations = getLocations(rowData, index, prefix);
// 后续可做去重、校验、关联绑定等操作
locations.forEach(loc -> log.info("Resolved location: {}", loc.getName()));✅ 总结与最佳实践
- ✅ 健壮性优先：始终校验输入是否为空、分割后是否含有效名称；
- ✅ 性能敏感：关系库用 IN，NoSQL 用原生 $in，杜绝循环查库；
- ✅ 可维护性：将字符串解析、清洗、查询职责分离，便于单元测试与复用；
- ✅ 扩展提示：若未来需支持逗号、顿号等多分隔符，可引入正则 split("[;,，、]+") 并统一标准化。
通过以上改造，系统即可无缝支持 Excel 中分号分隔的多地点导入，兼顾可读性、健壮性与生产级性能。
