Release v0.18.0

Changes

belgif-rest-problem

• Add href property with documentation URL for belgif (e.g. https://www.belgif.be/specification/rest/api-guide/issues/schemaViolation.html) and belgif-ext (e.g. https://www.belgif.be/specification/rest/api-guide/issues/ext/invalidStructure.html) issue types
• Add Input parameter alternatives in InputValidationIssues for invalidSsin, unknownSsin, canceledSsin and replacedSsin

belgif-rest-problem-validator

• Add validator for Belgif openapi-employment-identifier EmployerId

belgif-rest-problem-java-ee

• Correctly determine input source for bean validation issues from properties in @BeanParam class
• Improve bean validation support for @FormParam, @MatrixParam and @CookieParam

belgif-rest-problem-spring

• Improve bean validation support for @MatrixVariable and @CookieValue

Documentation | Javadoc

Release v0.17.0

Changes

⚠️ This release contains potentially breaking changes

belgif-rest-problem-java

• Normalize *Id and *Code input names in 404 Resource Not Found detail message to id and code to account for updated [id-name] rule
• ⚠️ Renamed io.github.belgif.rest.problem.i18n property to io.github.belgif.rest.problem.i18n-enabled
• ⚠️ By default, replace specialized input validation issue types invalidStructure, invalidPeriod, outOfRange, rejectedInput, requiredInput and cross-parameter validation issue types by new general issue type urn:problem-type:belgif:input-validation:invalidInput.
  • io.github.belgif.rest.problem.ext.issue-types-enabled can be configured to keep using more specific issue types (from urn:problem-type:belgif-ext:input-validation:*) instead of urn:problem-type:belgif:input-validation:invalidInput.
• ⚠️ By default, don’t populate inputs[] array for issue types that relate to multiple inputs.
  • io.github.belgif.rest.problem.ext.inputs-array-enabled can be configured to keep populating the inputs[] array.

Documentation | Javadoc

Release v0.16.1

Changes

belgif-rest-problem

• Use English by default for I18N messages instead of fallback to system locale

Documentation | Javadoc

Release v0.15.0

Changes

belgif-rest-problem

• Align MismatchedInputException detail message with Bean Validation
• Fix input path for MismatchedInputException on array properties

belgif-rest-problem-quarkus

• Add experimental support for Quarkus in native mode

Documentation | Javadoc

Release v0.14.0

Changes

belgif-rest-problem

• Map Jackson MismatchedInputException (for missing required properties on request body) to BadRequestProblem

Documentation | Javadoc

Release v0.13.0

Changes

belgif-rest-problem-spring

• Extract ProblemResponseErrorHandler and ProblemRestTemplateCustomizer to belgif-rest-problem-spring-boot-2 and belgif-rest-problem-spring-boot-3 to fix NoSuchMethodError compatibility issue

Documentation | Javadoc

Release v0.12.0

Changes

belgif-rest-problem

• Add internationalization support for localized detail messages based on Accept-Language HTTP request header
• Don’t include null (issue) input values when serializing
• ⚠️ Replace urn:problem-type:cbss:input-validation:referencedResourceNotFound by standardized urn:problem-type:belgif:input-validation:referencedResourceNotFound
• Add fluent setter methods:
  • Problem: detail, href, instance, additionalProperties
  • InputValidationProblem: issues
  • RetryAfterProblem: retryAfter, retryAfterSec
• Improve WWW-Authenticate header for token-related problem types:
  • Support setting the "realm" attribute
  • Add "error_description" and "scope" attributes for missing_scope

belgif-rest-problem-spring:

• Fix compatibility issue with Spring Boot 3.4

belgif-rest-problem-quarkus:

• New module for Quarkus support (only in JVM mode)

belgif-rest-problem-bom:

• Added jakarta classifier artifacts

Documentation | Javadoc

Release v0.11.0

Changes

belgif-rest-problem

• Add in(Input<?> input) to InputValidationIssue for a fluent single input setter

belgif-rest-problem-spring

• Fix non-deterministic configuration for retrieving parameter names from Spring MVC annotations

Documentation | Javadoc

Release v0.10.0

Changes

belgif-rest-problem-java

• Remove @ApplicationException annotation on Problem, because it could potentially cause compilation errors when used in combination with annotation processors
• Disallow creation of InputValidationIssue with inputs[] of size 1
  ⚠️ Potentially breaking:
  • removed InputValidationIssue.setInputs(List<Input<?>> inputs)
  • removed InputValidationIssue.setInputs(Input<?>... inputs)
  • removed InputValidationIssue.input(Input<?> input)

belgif-rest-problem-java-ee

• Add EJBExceptionMapper that unwraps Problem cause, to address the removed @ApplicationException annotation

belgif-rest-problem-spring

• Added support for InvalidRequestException thrown by the Atlassian swagger-request-validator

Documentation | Javadoc

Release v0.9.0

Changes

belgif-rest-problem-bom

• Added Maven BOM (Bill of Materials) for dependency versions of belgif-rest-problem modules

belgif-rest-problem

• Add WWW-Authenticate HTTP response header to token-related problem types

belgif-rest-problem-java-ee

• Ensure ProblemClientResponseFilter gets registered for JAX-RS clients

Documentation | Javadoc