https://github.com/nullumie/corexie
A high-performance, predictable lifecycle framework for Java.
https://github.com/nullumie/corexie
application framework java
Last synced: about 3 hours ago
JSON representation
A high-performance, predictable lifecycle framework for Java.
- Host: GitHub
- URL: https://github.com/nullumie/corexie
- Owner: nullumie
- License: other
- Created: 2026-04-18T18:42:25.000Z (3 months ago)
- Default Branch: develop
- Last Pushed: 2026-07-03T06:43:58.000Z (about 3 hours ago)
- Last Synced: 2026-07-03T07:00:14.731Z (about 3 hours ago)
- Topics: application, framework, java
- Language: Java
- Homepage:
- Size: 90.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Corexie
**A high-performance, predictable lifecycle framework for Java.**
Corexie is a lightweight foundation designed for building manageable services and applications driven by a highly structured state machine.
By extending a single abstract class, Corexie eliminates application boilerplate and organizes your execution logic into precise, sequential phases running on a dedicated thread. It gives developers total control over threading behavior, real-time cycle throttling, and fallback exception handling without sacrificing simplicity.
---
## Features
* **Rigid Lifecycle Hooks:** Built-in orchestration for initialization (`onStartup`), processing cycles (`onExecute`), suspensions (`onPause`/`onResume`), pacing loops (`onIdle`), and graceful resource extraction (`onShutdown`).
* **Dual Execution Flavors:** Spin up your application asynchronously in a managed thread (`start()`) or block the caller context synchronously (`run()`).
* **Conscious Concurrency Assertions:** Built-in execution checks (`ensureOnThread()` and `ensureOffThread()`) that immediately detect hazardous, multi-threaded interactions early in development.
* **Self-Healing Exception Fallbacks:** Includes an unhandled exception interceptor (`onException`) that mitigates crashes by automatically dropping the application into a safe, structured shutdown routine if an execution step fails.
---
## License
This project uses a split-licensing strategy:
* **Core Module (`corexie-core`):** Licensed under **LGPL-3.0-only**. You can link this library (via Maven, Gradle, etc.) into proprietary applications without being required to release your application's source code. Any modifications to the library itself must be shared under the same license.
* **Examples & Snippets (`corexie-example`):** Licensed under **MIT**. All code in the `example` module and documentation snippets can be used, copied, and modified without restriction.
See the [LICENSE](LICENSE.md) file for full details and legal texts.
---
*Copyright © 2026 Nullumie*