$ show bytedeco/javacpp
JavaCPP is a mature, annotation-driven library that provides efficient Java-to-C++ interoperability via JNI. It is not an application but a core infrastructure library used by hundreds of downstream projects (e.g., OpenCV, FFmpeg, TensorFlow bindings) to bridge Java and native C++ code. The system consists of a code generation pipeline (Parser, Generator, Builder) that reads Java annotations and C++ headers to produce JNI wrapper classes, a runtime layer (Loader, Pointer hierarchy) that manages native memory and library loading, and a multidimensional data access layer (Indexer package) optimized for scientific computing. The architecture is modular: build-time code generation (Maven plugin and CLI), runtime library loading with caching and platform detection, and a uniform pointer API with automatic deallocation via PhantomReferences. Key entry points are the Builder class (for build-time code generation) and the Loader class (for runtime library loading). The codebase is largely well-crafted, with reusable patterns like the Indexer factory pattern, PointerScope for deterministic resource management, and annotation-driven configuration. Some core components (Generator, Parser) are acknowledged as complex and messy, reflecting organic growth to handle real-world C++ headers. The repository maintains an extensive test suite and supports a wide range of platforms (Linux, macOS, Windows, Android, iOS, FreeBSD, embedded architectures).
The LLM identified 5 files worth highlighting for reuse:
Abstract base class for all typed indexers, providing create() factory methods that return concrete subclasses (ArrayIndexer, BufferIndexer, RawIndexer) based on storage type. Demonstrates clean separation of concerns and is easily extended for new primitive types. The factory pattern allows switching between array, NIO buffer, and raw pointer backends without changing client code.
Implements scoped, deterministic native memory deallocation via try-with-resources. Attaches allocated Pointer objects to a scope and releases them en masse when the scope closes. This is a clean, reusable pattern for managing native resources in Java, applicable to any system that allocates native memory.
Base class for Java callbacks that can be passed to C function pointers. Uses a native trampoline to invoke a Java method from C. Demonstrates a reusable pattern for bridging Java callbacks to C APIs, with support for both C function pointers and C++ virtual function overrides via @Virtual.
Fluent builder that orchestrates the entire code generation pipeline: class scanning, parsing, generation, compilation, and packaging. Its command-line entry point (main()) and programmatic API are cleanly separated, and the pattern is reusable for any annotation-driven code generation tool. Supports custom build commands, cross-compilation, and GraalVM native-image config generation.
The primary annotation used to configure native build settings per platform (include paths, compiler flags, link libraries, preload libraries). Demonstrates a declarative approach to platform-specific build configuration that is reusable in any JNI-based project. The annotation supports multiple platform patterns, value exclusion, and inheritance via @Properties.