llms.txt

# Java Embedded Compiler

> A library for compiling Java source code at runtime with pluggable compiler backends (JDK javac and Eclipse ECJ), supporting both in-memory and file-based output in standard Java and OSGi environments.

Key facts:
- Java 11 (source and target compatibility)
- Maven 3.9.4 multi-module build, 6 modules
- OSGi bundles with Declarative Services (Felix maven-bundle-plugin)
- Pluggable compiler backends: JDK system compiler (javac) and Eclipse ECJ
- In-memory and file-based compilation with flexible classloading
- ServiceLoader discovery in standard Java, OSGi DS in containers
- Apache License 2.0

## Docs

- [README.md](README.md): Project overview with architecture diagrams and quick start guide
- [AGENTS.md](AGENTS.md): Developer guide with build commands, module details, and coding conventions
- [CONTRIBUTING.md](CONTRIBUTING.md): Development setup and submission guidelines
- [.github/CIFLOW.md](.github/CIFLOW.md): CI/CD pipeline and GitFlow branching details

## Modules — Core API

- [java-embedded-compiler/pom.xml](java-embedded-compiler/pom.xml): Core API with CompilerContext (builder), CompilerFactory (strategy interface), CompilerUtil (static compilation entry point), file managers, classloaders, and file objects

## Modules — Compiler Implementations

- [java-embedded-compiler-jdt/pom.xml](java-embedded-compiler-jdt/pom.xml): JdtCompilerFactory — wraps the JDK system compiler (ToolProvider.getSystemJavaCompiler()), requires a full JDK at runtime
- [java-embedded-compiler-ecj/pom.xml](java-embedded-compiler-ecj/pom.xml): EclipseCompilerFactory — wraps the Eclipse ECJ compiler with two-pass compilation (module-info first, then sources), works with just a JRE

## Modules — Runtime & Integration

- [java-embedded-compiler-osgi/pom.xml](java-embedded-compiler-osgi/pom.xml): CompilerService OSGi DS component that dynamically discovers and ranks CompilerFactory services
- [java-embedded-compiler-itest/pom.xml](java-embedded-compiler-itest/pom.xml): Karaf 4.4.7 + Pax Exam integration tests covering all compilation modes for both compiler backends
- [java-embedded-compiler-reports/pom.xml](java-embedded-compiler-reports/pom.xml): JaCoCo aggregate coverage report across all modules

## Used by

- [judo-platform](../../runtime/judo-platform): Model-driven OSGi runtime platform with REST APIs and Karaf deployment
- [judo-runtime-core-esm-itest](../../runtime/judo-runtime-core-esm-itest): Integration tests for ESM-to-RDBMS transformation pipeline
- [judo-services](../../runtime/judo-services): OSGi runtime services enabling multiple data models in a single Karaf container
- [judo-tatami](../../runtime/judo-tatami): Model transformation pipeline — ESM/PSM to deployable application artifacts
- [judo-tatami-base](../../runtime/judo-tatami-base): PSM transformation pipeline — models to schemas, expressions, and configurations

## Optional

- [.github/workflows/build.yml](.github/workflows/build.yml): GitHub Actions CI/CD pipeline (build, test, deploy, tag, release)
- [LICENSE.txt](LICENSE.txt): Apache License 2.0