Spring Data Rest中如何实现请求输入参数的自定义Projections？

这个问题确实说到了Spring Data Rest（SDR）的一个典型痛点——它在输出投影上的表现堪称完美，但输入参数的自定义控制确实没那么直观。毕竟SDR帮我们省掉了写控制器的麻烦，但也意味着我们不能直接用常规的DTO或@JsonView思路。不过别担心，这里有几个不需要手动编写完整控制器就能实现的方案，按需选就行：

方案1：用@JsonView结合SDR配置做字段权限控制 #

如果只是想简单控制哪些字段允许在创建/更新时被传入，这个方案最直接。SDR支持通过配置绑定JsonView，实现不同请求类型（POST/PUT）对应不同的字段可见性：

1. 先定义视图标记接口，区分创建和更新场景：

public class InputViews {
    // 创建用户时允许的字段标记
    public interface Create {}
    // 更新用户时允许的字段标记
    public interface Update {}
}

2. 在实体类的字段上绑定对应的视图：

@Entity
public class User {
    @Id
    @GeneratedValue
    private Long id;

    // 创建和更新都允许修改
    @JsonView({InputViews.Create.class, InputViews.Update.class})
    private String username;

    // 仅创建时允许设置，更新时忽略
    @JsonView(InputViews.Create.class)
    private String password;

    // 仅更新时允许设置，创建时忽略
    @JsonView(InputViews.Update.class)
    private String email;

    // Getters & Setters
}

3. 配置SDR启用JsonView并绑定请求类型：

@Configuration
public class RestConfig implements RepositoryRestConfigurer {
    @Override
    public void configureJacksonObjectMapper(ObjectMapper objectMapper) {
        // 禁用默认视图包含，只保留我们指定的视图字段
        objectMapper.disable(MapperFeature.DEFAULT_VIEW_INCLUSION);
    }

    @Override
    public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config) {
        // 为POST（创建）绑定Create视图，PUT（更新）绑定Update视图
        config.getMetadataConfiguration()
              .setJsonViewConfig(JsonViewConfig.forCreates(InputViews.Create.class)
                                                .forUpdates(InputViews.Update.class));
    }
}

这样一来，POST请求创建用户时，只有username和password会被反序列化；PUT更新时，只有username和email生效，其他字段会被自动忽略。

方案2：使用Input Projection实现输入输出解耦 #

如果想把输入参数的结构和实体完全解耦（比如输入字段名和实体不一致，或者需要聚合多个实体的字段），可以用SDR的@InputProjection：

1. 定义输入投影接口，只包含你需要的输入字段：

@InputProjection
public interface UserCreateInput {
    // 可以映射不同的字段名，比如请求里的"user_name"对应实体的"username"
    @JsonProperty("user_name")
    String getUsername();

    String getPassword();
}

2. 在Repository的save方法上关联这个投影（可选，也可以通过请求参数指定）：

public interface UserRepository extends JpaRepository<User, Long> {
    @Override
    // 指定使用create投影处理输入
    @Projection(name = "create", types = User.class)
    User save(@RequestBody UserCreateInput input);
}

发送请求时，只需要传入投影定义的字段结构即可，SDR会自动将请求体转换为投影对象，再映射到实体上。如果需要动态切换，也可以通过请求参数?projection=create指定使用的输入投影。

方案3：用Converter实现DTO到实体的转换 #

如果需要对输入参数做复杂的转换逻辑（比如字段加密、格式转换），可以自定义DTO+Converter，Spring会自动识别并使用这个Converter处理请求：

1. 创建输入DTO：

public class UserUpdateDTO {
    private String username;
    private String newEmail;

    // Getters & Setters
}

2. 编写Converter，将DTO转换为实体：

@Component
public class UserUpdateDTOToUserConverter implements Converter<UserUpdateDTO, User> {
    @Autowired
    private UserRepository userRepository;

    @Override
    public User convert(UserUpdateDTO source) {
        // 这里可以根据业务逻辑获取原有实体，只更新需要的字段
        User existingUser = userRepository.findById(source.getId()).orElseThrow();
        existingUser.setUsername(source.getUsername());
        // 比如对邮箱做格式校验或转换
        existingUser.setEmail(source.getNewEmail().toLowerCase());
        return existingUser;
    }
}

当发送PUT请求到/users/{id}时，SDR会自动将请求体转换为UserUpdateDTO，再通过Converter生成实体进行更新，完全无需手动写控制器。

方案4：利用SDR事件监听做自定义输入处理 #

如果需要更灵活的业务逻辑（比如验证输入合法性、关联其他数据处理），可以监听SDR的实体生命周期事件，在实体保存前做自定义处理：

@Component
public class UserInputHandler {
    @Autowired
    private UserRepository userRepository;

    // 创建实体前触发
    @EventListener
    public void handleBeforeCreate(BeforeCreateEvent<User> event) {
        User user = event.getSource();
        // 比如加密密码
        user.setPassword(BCrypt.hashpw(user.getPassword(), BCrypt.gensalt()));
        // 强制清空不允许创建时设置的字段
        user.setEmail(null);
    }

    // 更新实体前触发
    @EventListener
    public void handleBeforeSave(BeforeSaveEvent<User> event) {
        User user = event.getSource();
        // 更新时不允许修改密码，重置为数据库中的原有值
        User existingUser = userRepository.findById(user.getId()).orElseThrow();
        user.setPassword(existingUser.getPassword());
    }
}

这种方式可以处理任何复杂的业务逻辑，从字段过滤到数据验证、关联操作都能覆盖。

方案选择总结 #

• 简单字段权限控制：优先选**@JsonView+SDR配置**
• 输入输出结构解耦：选Input Projection或Converter+DTO
• 复杂业务逻辑处理：选事件监听

内容的提问来源于stack exchange，提问作者erotsppa