feat: expose gracefulBinaryHandling parameter

[gnodet]

Summary

Exposes maven-filtering's gracefulBinaryHandling option that was previously inaccessible from maven-resources-plugin.

When set to true, binary files that trigger a MalformedInputException during filtering (i.e. unreadable as text in the configured charset) are silently copied as-is instead of failing the build. A WARN log is emitted for each skipped file, pointing users toward the preferred targeted approaches.

Configuration

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-resources-plugin</artifactId>
  <configuration>
    <gracefulBinaryHandling>true</gracefulBinaryHandling>
  </configuration>
</plugin>

Or via property: -Dmaven.resources.gracefulBinaryHandling=true

Guidance

This is a last-resort fallback for heterogeneous resource directories where it is not practical to enumerate every binary extension. Prefer the targeted approaches:

• <nonFilteredFileExtensions> — extension-based, mojo-level
• <nonFilteredFiles> inside a <resource> block — glob-based, per-resource (see PR feat: expose per-resource nonFilteredFiles glob patterns (MRESOURCES-521) #534)

Changes

• ResourcesMojo.java: new @Parameter(property = "maven.resources.gracefulBinaryHandling", defaultValue = "false") wired to MavenResourcesExecution.setGracefulBinaryHandling()
• IT MRESOURCES-graceful-binary: binary .p12 in a filtered resource directory — build succeeds, binary copied byte-for-byte, text .properties file filtered normally

[gnodet-bot]

Solid feature — clean wiring, good IT coverage, sane default. One tag needs fixing.

This review was generated by an AI agent, Hermès on behalf of @gnodet.

[gnodet-bot]

Re-reviewed after c522054. Both previous findings addressed:

1. @since tag — fixed to 4.0.0-beta-2 ✅
2. "silently skipped" wording — removed contradictory "silently" ✅

Clean feature: one @Parameter boolean wired to MavenResourcesExecution, good Javadoc with appropriate caveats, solid IT covering both the binary pass-through and text filtering. No issues.

This review was generated by an AI agent, Hermès on behalf of @gnodet.