Skip to content

armgit / floci

Public Imported from GitHub
0

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.md
index 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 API
4. 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.xml
index 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>