This is the central governance and documentation repository for the Jackson project, the premier Java JSON processing library. It does not contain the core library source code (which lives in separate repos like `jackson-core`, `jackson-databind`, and `jackson-annotations`). Instead, it serves as the project's hub, containing all essential governance documents (CLAs, contributing guidelines, security policy, versioning strategy), a comprehensive API reference manual (`MANUAL.md`), and an exceptionally detailed migration guide from Jackson 2.x to 3.x. The repository is a masterclass in open-source project management and technical documentation, providing a clear, well-structured, and authoritative source of truth for the entire Jackson ecosystem. Its primary value lies not in executable code, but in the high-quality, reusable patterns it establishes for project governance, release engineering, and technical communication.
bson4jackson is a Java library that adds BSON (Binary JSON) support to the Jackson JSON processor. It enables seamless serialization and deserialization of data in BSON format using Jackson's familiar API, primarily targeting MongoDB integration since BSON is MongoDB's native format. The library follows Jackson's extension patterns through a custom BsonFactory, BsonGenerator for writing, and BsonParser for reading, complemented by specialized serializers/deserializers for BSON-specific types like ObjectId, Timestamp, and Decimal128. The architecture cleanly separates concerns with dedicated components for factory management, stream handling, type conversion, and buffering optimizations.
Methanol is an extensible HTTP client library built on Java's java.net.http package. It provides core HTTP functionality enhanced with features like automatic decompression (gzip, deflate, Brotli), pluggable body adapters for JSON/XML/Protobuf, HTTP caching with multiple backends (memory, disk, Redis), request/response interceptors, retry mechanisms, progress tracking, and Kotlin DSL support. The library follows a modular architecture with separate modules for core functionality, format adapters, extensions, and testing. Key entry points include Methanol.Builder for client creation, MutableRequest for request building, and BodyAdapter for encoding/decoding. Data flows involve request interception, body encoding, HTTP exchange via java.net.http, response interception, body decoding, and optional caching/progress tracking. External dependencies vary by module: core requires only JDK 11+, while adapters depend on libraries like Jackson/Gson/Moshi, extensions on Redis Lettuce or native Brotli, and testing on JUnit5/MockWebServer.