Light, fluffy, and always free - The AWS Local Emulator alternative
docs: clarify service entry points and native JDK pin (#4004)
Trung Nguyenc02f3496dfb1
diff --git a/AGENTS.md b/AGENTS.mdindex 3bbeb64fb4..1b49600e21 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -80,10 +80,15 @@ Floci follows a layered design:Typical service structure:- `services/<svc>/`- - `*Controller.java`+ - `*Controller.java` (REST JSON / REST XML services, via JAX-RS)+ - `*QueryHandler.java` (AWS Query/XML protocol services)+ - `*JsonHandler.java` (AWS JSON 1.1 protocol services)- `*Service.java`- `model/`+The entry-point class name depends on the service's AWS protocol (see "AWS Protocol+Rules" below); `Controller` is not universal.+Rule:Copy an existing service pattern before introducing a new one.@@ -273,13 +278,14 @@ When adding functionality:## Adding a New AWS Service-1. Create a package under `services/<svc>/` with a Controller, a Service, and `model/`+1. Create a package under `services/<svc>/` with a Controller or protocol-specific handler,+ a Service, and `model/`2. Add a `<Svc>ServiceConfig` interface and its accessor on `ServicesConfig` in `EmulatorConfig`3. Add one `descriptor(...)` entry in `ResolvedServiceCatalog`. This is the registration point;`ServiceRegistry` only reads the catalog and has no registration API4. Add `floci.services.<key>.enabled` to both `src/main/resources/application.yml` and`src/test/resources/application.yml`-5. JSON 1.1 only: inject the handler in `AwsJson11Controller`+5. JSON 1.1 only: inject the `<Svc>JsonHandler` in `AwsJson11Controller`6. Obtain storage through `StorageFactory` and implement `Resettable`7. List any static `Random` or `SecureRandom` field under `--initialize-at-run-time` in`application.yml`diff --git a/pom.xml b/pom.xmlindex 6557db97eb..adbd0c11bd 100644--- a/pom.xml+++ b/pom.xml@@ -483,7 +483,7 @@<properties><skipITs>true</skipITs><quarkus.native.enabled>true</quarkus.native.enabled>- <maven.compiler.release>24</maven.compiler.release>+ <maven.compiler.release>25</maven.compiler.release></properties></profile></profiles>