Changelog

3.11.0

(feat): Add support for three-state nullable fields in PATCH requests via collapse-optional-nullable config. When enabled, optional nullable fields use OptionalNullable<T> to distinguish between omitted fields, explicit null values, and actual values. This enables proper PATCH request semantics for APIs that need to differentiate between “not specified” and “set to null”.

1
customConfig:
2
  collapse-optional-nullable: true

Generated usage:

1
UpdateRequest.builder()
2
    .fieldName(OptionalNullable.absent())    // Omit field
3
    .anotherField(OptionalNullable.ofNull()) // Clear field
4
    .valueField(OptionalNullable.of("value")) // Set value
5
    .build();