springboot 通讯录

<think>好的，我现在要解决用户的问题：在Spring Boot中实现通讯录列表按字段排序的示例代码。首先，我需要理解用户的需求。用户提到了通讯录列表，可能涉及部门列表或成员列表，需要根据某个字段进行排序，比如姓名、部门名称或入职时间等。用户还希望看到示例代码，所以需要结合Spring Boot的常用技术栈，比如MyBatis Plus或JPA，以及可能的接口实现步骤。 首先，考虑通讯录的数据结构。假设通讯录实体类有字段如name、department、position等。用户需要根据这些字段排序，通常在后端处理排序逻辑，或者让前端传递排序参数。后端处理的话，可以通过接收排序参数（如字段名和排序方式），然后在查询数据库时应用排序。 接下来，数据库查询部分。如果使用MyBatis Plus，可以利用其Wrapper条件构造器来添加排序条件。例如，使用QueryWrapper的orderBy方法，根据前端传入的字段名和排序方向（ASC或DESC）动态构建排序条件。此外，需要确保实体类的字段名与数据库列名正确映射，避免因命名不一致导致排序失效。 然后，接口设计方面。需要提供一个GET接口，接收排序参数，如sortField和sortOrder。在Controller层解析这些参数，传递给Service层处理，最后执行数据库查询并返回排序后的列表。 另外，考虑到安全性，需要对传入的排序字段进行校验，防止SQL注入。例如，只允许特定的字段名进行排序，比如name、department等，其他字段则拒绝处理。同时，排序方向只能是ASC或DESC，否则设置默认值。 可能还需要处理分页，但用户主要关注排序，所以示例可能不需要分页，但可以提一下如何结合分页使用。此外，缓存方面，如果通讯录数据不常变化，可以考虑将排序后的结果缓存到Redis中，但用户的问题中没有提到缓存需求，所以示例可能不需要涉及，但可以作为一个优化点提及。 现在，编写示例代码。假设有一个Contact实体类，对应数据库表，包含id、name、department等字段。创建对应的Mapper接口继承MyBatis Plus的BaseMapper。在Service层，编写根据排序参数查询列表的方法，使用QueryWrapper动态添加排序条件。Controller层接收参数，调用Service方法返回结果。 还需要考虑异常处理，比如无效的排序字段或方向，应返回适当的错误信息或默认排序。此外，单元测试也是重要的一环，但用户可能只需要示例代码，所以暂时可以不写测试部分。 最后，根据用户提供的引用内容，引用[1]提到通过企业微信获取通讯录，可能需要先获取token，但用户的问题是关于排序，所以主要关注排序实现部分。引用[2]提到通讯录的增删改操作，但排序是另一个功能，可以独立实现。引用[3]涉及微服务架构，可能和当前问题关联不大，但如果有分布式系统的考虑，可能需要调整，但用户示例中可能不需要。 总结步骤： 1. 定义实体类，对应数据库表。 2. 创建Mapper接口，使用MyBatis Plus的方法。 3. Service层处理排序逻辑，动态构建查询条件。 4. Controller层接收参数，调用Service。 5. 参数校验，防止无效字段或排序方向。 6. 返回排序后的列表数据。 现在需要将这些步骤转化为具体的代码示例，并确保符合Spring Boot的常见实践，同时保持代码简洁易懂。</think>在Spring Boot中实现通讯录列表按字段排序，可以通过以下步骤完成（以部门列表为例）： ### 一、实体类定义 ```java // 通讯录成员实体 @Data @TableName("contact") public class Contact { @TableId(type = IdType.AUTO) private Long id; private String name; private String department; private String position; private LocalDateTime createTime; } ``` ### 二、Mapper接口 ```java public interface ContactMapper extends BaseMapper<Contact> { } ``` ### 三、Service实现 ```java @Service @RequiredArgsConstructor public class ContactService { private final ContactMapper contactMapper; public List<Contact> getSortedContacts(String sortField, String sortOrder) { QueryWrapper<Contact> wrapper = new QueryWrapper<>(); // 安全校验允许排序的字段 Set<String> validFields = Set.of("name", "department", "create_time"); if (!validFields.contains(sortField)) { sortField = "create_time"; // 默认排序字段 } // 处理排序方向 boolean isAsc = "asc".equalsIgnoreCase(sortOrder); wrapper.orderBy(true, isAsc, sortField); return contactMapper.selectList(wrapper); } } ``` ### 四、Controller接口 ```java @RestController @RequestMapping("/contacts") @RequiredArgsConstructor public class ContactController { private final ContactService contactService; @GetMapping("/sorted") public ResponseEntity<List<Contact>> getSortedContacts( @RequestParam(defaultValue = "create_time") String sortField, @RequestParam(defaultValue = "asc") String sortOrder) { return ResponseEntity.ok( contactService.getSortedContacts(sortField, sortOrder) ); } } ``` ### 五、补充说明 1. **安全校验**：通过白名单机制限制可排序字段，防止SQL注入 2. **字段映射**：若使用数据库字段命名规范（如蛇形命名），需注意实体类`@TableField`注解配置 3. **扩展排序**：支持多字段排序可改造为： ```java wrapper.orderByAsc("department").orderByDesc("create_time"); ```