Add logbook-jdkhttpclient module for JDK HttpClient (#2006)

[Vinu2111]

Description

Implements Phase 1 of the logbook-jdkhttpclient module providing request and response logging support for JDK 11+'s built-in java.net.http.HttpClient:

• LogbookHttpClient: Decorator extending java.net.http.HttpClient that wraps the synchronous send() method with Logbook's two-stage request/response logging lifecycle. All abstract HttpClient getter/delegator methods are passed through to the delegate. Both sendAsync() overloads are stubbed throwing UnsupportedOperationException (planned for follow-up).
• JdkRequest: Implements org.zalando.logbook.HttpRequest wrapping java.net.http.HttpRequest with a lazy body-buffering state machine (Unbuffered -> Offering -> Buffering / Ignoring / Passing). Drains the BodyPublisher on-demand via reactive streams and reconstructs the HttpRequest with all original attributes (headers, method, URI, timeout, version, expectContinue) intact for transport.
• TeeingBodySubscriber: Decorates the response HttpResponse.BodySubscriber<T> and tees incoming ByteBuffers into a cache without mutating buffer positions or limits for the delegate subscriber.
• RemoteResponse: Implements org.zalando.logbook.HttpResponse wrapping HttpResponse<?> and cached response bytes with state machine transitions.
• Resilience: Pre-send request logging and post-send response logging are isolated in try/catch blocks to ensure logging failures never break the underlying HTTP invocation.
• Documentation: Registered in pom.xml, logbook-bom/pom.xml, and added configuration instructions in README.md.
• Test Suite: Comprehensive WireMock test suite covering single-chunk, multi-chunk, chunked, and non-chunked transfer encoding, inactive writer short-circuits, delegator methods, and failure scenarios. JaCoCo 100% line and branch coverage enforced.

Motivation and Context

Closes #2006.

Provides first-class, zero-dependency logging support for applications using Java's standard java.net.http.HttpClient without requiring third-party HTTP client libraries (such as Apache HttpClient or OkHttp).

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• All commits are signed

[kasmarian]

is it a duplicate of #2383?

[Vinu2111]

Hi @kasmarian, thanks for flagging! #2386 targets the same issue (#2006) but takes a different technical approach from #2383:

• Works within the project's current Java 17+ baseline; Add Support For Native JDK HttpClient #2383 requires JDK 21+, which would raise the minimum Java version project-wide
• Decorator-based (LogbookHttpClient wrapping java.net.http.HttpClient), following the existing logbook-httpclient5 pattern, rather than a Spring autoconfiguration-first approach
• Sync send() is fully implemented and tested (WireMock suite, 100% JaCoCo line/branch coverage); sendAsync() is stubbed for a Phase 2 follow-up
• Build is currently green

Happy to align with @ChristianLohmann on scope, or consolidate into one PR, if that's what the maintainers would prefer, just let me know which direction keeps things cleanest.

[kasmarian]

@ChristianLohmann what do you think?