com.philiprehberger:graceful-shutdown
v0.1.5680 downloadsMIT
Graceful application shutdown with signal handling and ordered teardown
$
implementation com.philiprehberger:graceful-shutdownREADME
graceful-shutdown
Graceful application shutdown with signal handling and ordered teardown.
Installation
Gradle (Kotlin DSL)
implementation("com.philiprehberger:graceful-shutdown:0.1.4")
Maven
<dependency>
<groupId>com.philiprehberger</groupId>
<artifactId>graceful-shutdown</artifactId>
<version>0.1.4</version>
</dependency>
Usage
import com.philiprehberger.gracefulshutdown.*
val shutdown = gracefulShutdown {
timeout(30.seconds)
onShutdown("http", priority = 10) { server.stop() }
onShutdown("db", priority = 5) { dataSource.close() }
onError { name, err -> logger.error("$name failed: $err") }
}
shutdown.installShutdownHook()
val tracker = RequestTracker()
// In request handler:
tracker.track { handleRequest(req) }
API
| Function / Class | Description |
|---|---|
gracefulShutdown { } | Build a shutdown manager |
onShutdown(name, priority) { } | Register a shutdown handler |
ShutdownManager.trigger() | Trigger shutdown (idempotent) |
ShutdownManager.installShutdownHook() | Install JVM shutdown hook |
ShutdownManager.isShuttingDown() | Check if shutdown triggered |
RequestTracker | Track in-flight work |
RequestTracker.track { } | Track a block of work |
RequestTracker.awaitDrained(timeout) | Wait for all work to complete |
Development
./gradlew test
./gradlew build
Support
If you find this project useful: