| # Static Weaving Configuration |
| |
| This document explains the static weaving setup for JPA entities in the Fineract project. |
| |
| ## Overview |
| |
| Static weaving is a process that enhances JPA entities at build time to improve runtime performance. This is done using the `org.eclipse.persistence.tools.weaving.jpa.StaticWeave` which processes the compiled classes and applies the necessary bytecode transformations. |
| |
| ## Configuration |
| |
| The static weaving is configured in `static-weaving.gradle` and applied to all Java projects that contain JPA entities. |
| |
| ## How It Works |
| |
| 1. **Compilation**: Java source files are compiled to the standard classes directory (`build/classes/java/main`). |
| 2. **Weaving**: Weaving happens as last step of **compileJava** task, which outputs them to the standard classes directory (`build/classes/java/main`). |
| |
| ## Adding Static Weaving to a Module |
| |
| 1. Add JPA entities to `src/main/java` |
| 2. Ensure there's a `persistence.xml` file in `src/main/resources/jpa/static-weaving/module/[module-name]/` |
| 3. The build will automatically detect and apply static weaving |
| |
| ## Troubleshooting |
| |
| If you encounter issues with static weaving: |
| |
| 1. Check that the `persistence.xml` file exists in the correct location |
| 2. Verify that the output directories are being created correctly |
| 3. Check the build logs for any weaving-related errors |
