Skip to content

armgit / floci

Public Imported from GitHub
0

Light, fluffy, and always free - The AWS Local Emulator alternative

feat(floci-core): implement state reset and nuke endpoints (#1482)

Prakhar Kapoorf4c7a84de67c
diff --git a/src/main/java/io/github/hectorvent/floci/core/common/Resettable.java b/src/main/java/io/github/hectorvent/floci/core/common/Resettable.java
new file mode 100644
index 0000000000..4f12b6da82
--- /dev/null
+++ b/src/main/java/io/github/hectorvent/floci/core/common/Resettable.java
@@ -0,0 +1,9 @@
+package io.github.hectorvent.floci.core.common;
+
+/**
+ * Interface for services or components that hold in-memory state
+ * and need to be cleared when the emulator state is reset or nuked.
+ */
+public interface Resettable {
+ void clear();
+}
diff --git a/src/main/java/io/github/hectorvent/floci/core/storage/StorageFactory.java b/src/main/java/io/github/hectorvent/floci/core/storage/StorageFactory.java
index 715291747c..c2a04d7c29 100644
--- a/src/main/java/io/github/hectorvent/floci/core/storage/StorageFactory.java
+++ b/src/main/java/io/github/hectorvent/floci/core/storage/StorageFactory.java
@@ -100,6 +100,14 @@ public class StorageFactory {
}
}
+ /** Clear all storage backends. */
+ public void clearAll() {
+ for (StorageBackend<?, ?> backend : allBackends) {
+ backend.clear();
+ }
+ flushAll();
+ }
+
/** Shutdown all managed backends (stop schedulers, close connections). */
public void shutdownAll() {
for (HybridStorage<?, ?> hybrid : hybridBackends) {
diff --git a/src/main/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoController.java b/src/main/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoController.java
index 5eab37dd5d..c03f688c87 100644
--- a/src/main/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoController.java
+++ b/src/main/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoController.java
@@ -9,6 +9,11 @@ import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;
import jakarta.ws.rs.core.Response;
+import io.github.hectorvent.floci.core.storage.StorageFactory;
+import io.github.hectorvent.floci.core.common.Resettable;
+import jakarta.enterprise.inject.Instance;
+import jakarta.ws.rs.POST;
+
import java.util.LinkedHashMap;
import java.util.Map;
@@ -20,10 +25,18 @@ public class EmulatorInfoController {
private final InitLifecycleState initLifecycleState;
private final String version;
+ private final StorageFactory storageFactory;
+ private final Instance<Resettable> resettables;
+
@Inject
- public EmulatorInfoController(ServiceRegistry serviceRegistry, InitLifecycleState initLifecycleState) {
+ public EmulatorInfoController(ServiceRegistry serviceRegistry,
+ InitLifecycleState initLifecycleState,
+ StorageFactory storageFactory,
+ Instance<Resettable> resettables) {
this.serviceRegistry = serviceRegistry;
this.initLifecycleState = initLifecycleState;
+ this.storageFactory = storageFactory;
+ this.resettables = resettables;
this.version = resolveVersion();
}
@@ -77,6 +90,26 @@ public class EmulatorInfoController {
return Response.ok(Map.of()).build();
}
+ @POST
+ @Path("/state/reset")
+ public Response reset() {
+ performReset();
+ return Response.ok(Map.of("status", "OK")).build();
+ }
+
+ @POST
+ @Path("/state/nuke")
+ public Response nuke() {
+ return reset();
+ }
+
+ private void performReset() {
+ for (Resettable r : resettables) {
+ r.clear();
+ }
+ storageFactory.clearAll();
+ }
+
static String resolveVersion() {
String env = System.getenv("FLOCI_VERSION");
if (env != null && !env.isBlank()) {
diff --git a/src/main/java/io/github/hectorvent/floci/services/apigatewayv2/websocket/WebSocketConnectionManager.java b/src/main/java/io/github/hectorvent/floci/services/apigatewayv2/websocket/WebSocketConnectionManager.java
index 7af07d9470..33fcd20672 100644
--- a/src/main/java/io/github/hectorvent/floci/services/apigatewayv2/websocket/WebSocketConnectionManager.java
+++ b/src/main/java/io/github/hectorvent/floci/services/apigatewayv2/websocket/WebSocketConnectionManager.java
@@ -1,5 +1,6 @@
package io.github.hectorvent.floci.services.apigatewayv2.websocket;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.vertx.core.http.ServerWebSocket;
import jakarta.enterprise.context.ApplicationScoped;
import org.jboss.logging.Logger;
@@ -12,7 +13,7 @@ import java.util.concurrent.ConcurrentHashMap;
* Tracks connection metadata and live socket references.
*/
@ApplicationScoped
-public class WebSocketConnectionManager {
+public class WebSocketConnectionManager implements Resettable {
private static final Logger LOG = Logger.getLogger(WebSocketConnectionManager.class);
@@ -46,6 +47,17 @@ public class WebSocketConnectionManager {
LOG.debugv("Unregistered WebSocket connection {0}", connectionId);
}
+ public void clear() {
+ sockets.values().forEach(ws -> {
+ try {
+ ws.close();
+ } catch (Exception ignored) {}
+ });
+ connections.clear();
+ sockets.clear();
+ serverInitiatedCloses.clear();
+ }
+
/**
* Send a text message to the specified connection.
*
diff --git a/src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2HealthChecker.java b/src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2HealthChecker.java
index 9215c86ec1..e325eba88c 100644
--- a/src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2HealthChecker.java
+++ b/src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2HealthChecker.java
@@ -1,6 +1,7 @@
package io.github.hectorvent.floci.services.elbv2;
import io.github.hectorvent.floci.config.EmulatorConfig;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.services.ec2.Ec2Service;
import io.github.hectorvent.floci.services.elbv2.model.TargetDescription;
import io.github.hectorvent.floci.services.elbv2.model.TargetGroup;
@@ -18,7 +19,7 @@ import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
@ApplicationScoped
-public class ElbV2HealthChecker {
+public class ElbV2HealthChecker implements Resettable {
private static final Logger LOG = Logger.getLogger(ElbV2HealthChecker.class);
@@ -71,6 +72,12 @@ public class ElbV2HealthChecker {
states.remove(tgArn);
}
+ public void clear() {
+ timers.values().forEach(vertx::cancelTimer);
+ timers.clear();
+ states.clear();
+ }
+
public void addTargets(String tgArn, List<TargetDescription> targets, TargetGroup tg) {
if (config.services().elbv2().mock()) {
return;
diff --git a/src/main/java/io/github/hectorvent/floci/services/eventbridge/RuleScheduler.java b/src/main/java/io/github/hectorvent/floci/services/eventbridge/RuleScheduler.java
index 367f81fa45..db0150ddf2 100644
--- a/src/main/java/io/github/hectorvent/floci/services/eventbridge/RuleScheduler.java
+++ b/src/main/java/io/github/hectorvent/floci/services/eventbridge/RuleScheduler.java
@@ -3,6 +3,7 @@ package io.github.hectorvent.floci.services.eventbridge;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import io.github.hectorvent.floci.config.EmulatorConfig;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.services.eventbridge.model.Rule;
import io.github.hectorvent.floci.services.eventbridge.model.RuleState;
import io.github.hectorvent.floci.services.eventbridge.model.Target;
@@ -20,7 +21,7 @@ import java.util.concurrent.ConcurrentHashMap;
import java.util.function.Supplier;
@ApplicationScoped
-public class RuleScheduler {
+public class RuleScheduler implements Resettable {
private static final Logger LOG = Logger.getLogger(RuleScheduler.class);
@@ -48,6 +49,11 @@ public class RuleScheduler {
LOG.info("RuleScheduler shut down, all timers cancelled");
}
+ public void clear() {
+ scheduleContexts.values().forEach(ctx -> vertx.cancelTimer(ctx.timerId));
+ scheduleContexts.clear();
+ }
+
public void startScheduler(String ruleArn, String scheduleExpr,
Supplier<ScheduleData> dataSupplier) {
if (scheduleContexts.containsKey(ruleArn)) {
diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/DynamoDbStreamsEventSourcePoller.java b/src/main/java/io/github/hectorvent/floci/services/lambda/DynamoDbStreamsEventSourcePoller.java
index a0e3391e27..dc9c3ef36b 100644
--- a/src/main/java/io/github/hectorvent/floci/services/lambda/DynamoDbStreamsEventSourcePoller.java
+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/DynamoDbStreamsEventSourcePoller.java
@@ -2,6 +2,7 @@ package io.github.hectorvent.floci.services.lambda;
import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsException;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.services.dynamodb.DynamoDbStreamService;
import io.github.hectorvent.floci.services.dynamodb.model.DynamoDbStreamRecord;
import io.github.hectorvent.floci.services.lambda.model.EventSourceMapping;
@@ -23,7 +24,7 @@ import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
@ApplicationScoped
-public class DynamoDbStreamsEventSourcePoller {
+public class DynamoDbStreamsEventSourcePoller implements Resettable {
private static final Logger LOG = Logger.getLogger(DynamoDbStreamsEventSourcePoller.class);
@@ -74,6 +75,12 @@ public class DynamoDbStreamsEventSourcePoller {
timerIds.clear();
}
+ public void clear() {
+ timerIds.values().forEach(vertx::cancelTimer);
+ timerIds.clear();
+ activePolls.clear();
+ }
+
public void startPolling(EventSourceMapping esm) {
if (timerIds.containsKey(esm.getUuid())) {
return;
diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/KinesisEventSourcePoller.java b/src/main/java/io/github/hectorvent/floci/services/lambda/KinesisEventSourcePoller.java
index b594661175..b9d951ed35 100644
--- a/src/main/java/io/github/hectorvent/floci/services/lambda/KinesisEventSourcePoller.java
+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/KinesisEventSourcePoller.java
@@ -5,6 +5,7 @@ import com.fasterxml.jackson.databind.node.ObjectNode;
import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsArnUtils;
import io.github.hectorvent.floci.core.common.AwsException;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.services.kinesis.KinesisService;
import io.github.hectorvent.floci.services.kinesis.model.KinesisRecord;
import io.github.hectorvent.floci.services.kinesis.model.KinesisShard;
@@ -27,7 +28,7 @@ import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
@ApplicationScoped
-public class KinesisEventSourcePoller {
+public class KinesisEventSourcePoller implements Resettable {
private static final Logger LOG = Logger.getLogger(KinesisEventSourcePoller.class);
@@ -77,6 +78,12 @@ public class KinesisEventSourcePoller {
timerIds.clear();
}
+ public void clear() {
+ timerIds.values().forEach(vertx::cancelTimer);
+ timerIds.clear();
+ activePolls.clear();
+ }
+
public void startPolling(EventSourceMapping esm) {
if (timerIds.containsKey(esm.getUuid())) return;
String uuid = esm.getUuid();
diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaConcurrencyLimiter.java b/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaConcurrencyLimiter.java
index b8ecd1fdca..28fb82a12e 100644
--- a/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaConcurrencyLimiter.java
+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaConcurrencyLimiter.java
@@ -2,6 +2,7 @@ package io.github.hectorvent.floci.services.lambda;
import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsException;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.services.lambda.model.LambdaFunction;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
@@ -33,7 +34,7 @@ import java.util.concurrent.atomic.AtomicInteger;
* </ul>
*/
@ApplicationScoped
-public class LambdaConcurrencyLimiter {
+public class LambdaConcurrencyLimiter implements Resettable {
private static final Logger LOG = Logger.getLogger(LambdaConcurrencyLimiter.class);
/** Tracks malformed ARNs already logged so the warn fires once per unique input. */
@@ -238,6 +239,15 @@ public class LambdaConcurrencyLimiter {
}
}
+ public void clear() {
+ synchronized (reservedLock) {
+ inflight.clear();
+ reservedByRegion.clear();
+ regionReservedTotal.clear();
+ unreservedByRegion.clear();
+ }
+ }
+
public int totalReserved(String region) {
return regionTotal(region).get();
}
diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaFunctionStore.java b/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaFunctionStore.java
index c88af06b4f..8958f6cb05 100644
--- a/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaFunctionStore.java
+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaFunctionStore.java
@@ -1,5 +1,6 @@
package io.github.hectorvent.floci.services.lambda;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.core.storage.AccountAwareStorageBackend;
import io.github.hectorvent.floci.core.storage.StorageBackend;
import io.github.hectorvent.floci.core.storage.StorageFactory;
@@ -16,7 +17,7 @@ import java.util.concurrent.ConcurrentHashMap;
* Wraps the storage backend for Lambda functions with region-aware key logic.
*/
@ApplicationScoped
-public class LambdaFunctionStore {
+public class LambdaFunctionStore implements Resettable {
private final StorageBackend<String, LambdaFunction> backend;
private final ConcurrentHashMap<String, LambdaFunction> urlIdIndex = new ConcurrentHashMap<>();
@@ -41,6 +42,10 @@ public class LambdaFunctionStore {
all.forEach(this::indexFunction);
}
+ public void clear() {
+ urlIdIndex.clear();
+ }
+
private void indexFunction(LambdaFunction fn) {
if (fn.getUrlConfig() != null && fn.getUrlConfig().getFunctionUrl() != null) {
String urlId = extractUrlId(fn.getUrlConfig().getFunctionUrl());
diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/SqsEventSourcePoller.java b/src/main/java/io/github/hectorvent/floci/services/lambda/SqsEventSourcePoller.java
index 637113e401..894fea7a4b 100644
--- a/src/main/java/io/github/hectorvent/floci/services/lambda/SqsEventSourcePoller.java
+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/SqsEventSourcePoller.java
@@ -4,6 +4,7 @@ import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsArnUtils;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.core.common.AwsException;
import io.github.hectorvent.floci.services.lambda.model.EventSourceMapping;
import io.github.hectorvent.floci.services.lambda.model.InvocationType;
@@ -31,7 +32,7 @@ import java.util.concurrent.Executors;
* to avoid a circular CDI dependency.
*/
@ApplicationScoped
-public class SqsEventSourcePoller {
+public class SqsEventSourcePoller implements Resettable {
private static final Logger LOG = Logger.getLogger(SqsEventSourcePoller.class);
@@ -89,6 +90,12 @@ public class SqsEventSourcePoller {
LOG.info("SqsEventSourcePoller shut down, all timers cancelled");
}
+ public void clear() {
+ timerIds.values().forEach(vertx::cancelTimer);
+ timerIds.clear();
+ activePolls.clear();
+ }
+
public void startPolling(EventSourceMapping esm) {
if (timerIds.containsKey(esm.getUuid())) {
return; // already polling
diff --git a/src/main/java/io/github/hectorvent/floci/services/pipes/PipesPoller.java b/src/main/java/io/github/hectorvent/floci/services/pipes/PipesPoller.java
index e93a139e03..2ee48463ef 100644
--- a/src/main/java/io/github/hectorvent/floci/services/pipes/PipesPoller.java
+++ b/src/main/java/io/github/hectorvent/floci/services/pipes/PipesPoller.java
@@ -7,6 +7,7 @@ import com.fasterxml.jackson.databind.node.ObjectNode;
import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsArnUtils;
import io.github.hectorvent.floci.core.common.AwsException;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.services.dynamodb.DynamoDbStreamService;
import io.github.hectorvent.floci.services.kinesis.KinesisService;
import io.github.hectorvent.floci.services.pipes.model.DesiredState;
@@ -38,7 +39,7 @@ import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
@ApplicationScoped
-public class PipesPoller {
+public class PipesPoller implements Resettable {
private static final Logger LOG = Logger.getLogger(PipesPoller.class);
private static final long POLL_INTERVAL_MS = 1000;
@@ -92,6 +93,14 @@ public class PipesPoller {
LOG.info("PipesPoller shut down");
}
+ public void clear() {
+ timerIds.values().forEach(vertx::cancelTimer);
+ timerIds.clear();
+ activePolls.clear();
+ kinesisIterators.clear();
+ dynamoDbIterators.clear();
+ }
+
public void startPolling(Pipe pipe) {
String pipeKey = pipeKey(pipe);
if (timerIds.containsKey(pipeKey)) {
diff --git a/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java b/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java
index 22335ca458..47dabd2cce 100644
--- a/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java
@@ -26,6 +26,7 @@ import io.github.hectorvent.floci.services.rds.model.DbSubnetGroup;
import io.github.hectorvent.floci.services.rds.proxy.RdsProxyManager;
import io.github.hectorvent.floci.services.secretsmanager.SecretsManagerService;
import io.github.hectorvent.floci.services.secretsmanager.model.Secret;
+import io.github.hectorvent.floci.core.common.Resettable;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
import org.jboss.logging.Logger;
@@ -48,7 +49,7 @@ import java.util.regex.Pattern;
* Starts DB containers and auth proxies on creation.
*/
@ApplicationScoped
-public class RdsService {
+public class RdsService implements Resettable {
private static final Logger LOG = Logger.getLogger(RdsService.class);
private static final ObjectMapper JSON = new ObjectMapper();
@@ -143,6 +144,10 @@ public class RdsService {
restoreInstances();
}
+ public void clear() {
+ usedPorts.clear();
+ }
+
// ── DB Instances ──────────────────────────────────────────────────────────
public DbInstance createDbInstance(String id, String engineParam, String engineVersion,
diff --git a/src/main/java/io/github/hectorvent/floci/services/rdsdata/RdsDataService.java b/src/main/java/io/github/hectorvent/floci/services/rdsdata/RdsDataService.java
index 927fc16c84..24f015b67b 100644
--- a/src/main/java/io/github/hectorvent/floci/services/rdsdata/RdsDataService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/rdsdata/RdsDataService.java
@@ -8,6 +8,7 @@ import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsException;
import io.github.hectorvent.floci.services.secretsmanager.SecretsManagerService;
import io.github.hectorvent.floci.services.secretsmanager.model.SecretVersion;
+import io.github.hectorvent.floci.core.common.Resettable;
import jakarta.annotation.PostConstruct;
import jakarta.annotation.PreDestroy;
import jakarta.enterprise.context.ApplicationScoped;
@@ -29,7 +30,7 @@ import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;
@ApplicationScoped
-public class RdsDataService {
+public class RdsDataService implements Resettable {
private static final Logger LOG = Logger.getLogger(RdsDataService.class);
@@ -88,6 +89,18 @@ public class RdsDataService {
});
}
+ public void clear() {
+ transactions.forEach((id, tx) -> {
+ synchronized (tx) {
+ if (transactions.remove(id, tx)) {
+ rollbackQuietly(tx.connection);
+ closeQuietly(tx.connection);
+ }
+ }
+ });
+ transactions.clear();
+ }
+
public ObjectNode executeStatement(JsonNode request, String region) {
rejectUnsupportedOptions(request);
diff --git a/src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingService.java b/src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingService.java
index c4f47eb491..a7599ecb7a 100644
--- a/src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingService.java
@@ -1,6 +1,7 @@
package io.github.hectorvent.floci.services.resourcegroupstagging;
import io.github.hectorvent.floci.services.resourcegroupstagging.model.ResourceTagMapping;
+import io.github.hectorvent.floci.core.common.Resettable;
import jakarta.enterprise.context.ApplicationScoped;
import java.nio.charset.StandardCharsets;
@@ -9,7 +10,7 @@ import java.util.concurrent.ConcurrentHashMap;
import java.util.stream.Collectors;
@ApplicationScoped
-public class ResourceGroupsTaggingService {
+public class ResourceGroupsTaggingService implements Resettable {
// region::arn → ResourceTagMapping
private final Map<String, ResourceTagMapping> store = new ConcurrentHashMap<>();
@@ -44,6 +45,10 @@ public class ResourceGroupsTaggingService {
}
}
+ public void clear() {
+ store.clear();
+ }
+
// ─── GetResources ──────────────────────────────────────────────────────────
public record TagFilter(String key, List<String> values) {}
diff --git a/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java b/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java
index 0ed35e2b70..fb5e5d24c0 100644
--- a/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java
+++ b/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java
@@ -7,6 +7,7 @@ import io.github.hectorvent.floci.core.common.AwsNamespaces;
import io.github.hectorvent.floci.core.common.RegionResolver;
import io.github.hectorvent.floci.core.common.XmlBuilder;
import io.github.hectorvent.floci.core.common.XmlParser;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.core.storage.StorageBackend;
import io.github.hectorvent.floci.core.storage.StorageFactory;
import io.github.hectorvent.floci.services.lambda.LambdaService;
@@ -40,7 +41,7 @@ import java.util.*;
import java.util.concurrent.ConcurrentHashMap;
@ApplicationScoped
-public class S3Service {
+public class S3Service implements Resettable {
private String ownerId() { return regionResolver != null ? regionResolver.getAccountId() : "000000000000"; }
private static final String DEFAULT_OWNER_DISPLAY_NAME = "floci";
private static final String ALL_USERS_GROUP_URI = "http://acs.amazonaws.com/groups/global/AllUsers";
@@ -159,6 +160,12 @@ public class S3Service {
}
}
+ public void clear() {
+ memoryDataStore.clear();
+ memoryMultipartStore.clear();
+ multipartUploads.clear();
+ }
+
public Bucket createBucket(String bucketName, String region) {
var existing = bucketStore.get(bucketName);
if (existing.isPresent()) {
diff --git a/src/main/java/io/github/hectorvent/floci/services/scheduler/ScheduleDispatcher.java b/src/main/java/io/github/hectorvent/floci/services/scheduler/ScheduleDispatcher.java
index bb276a7101..7f6734670c 100644
--- a/src/main/java/io/github/hectorvent/floci/services/scheduler/ScheduleDispatcher.java
+++ b/src/main/java/io/github/hectorvent/floci/services/scheduler/ScheduleDispatcher.java
@@ -2,6 +2,7 @@ package io.github.hectorvent.floci.services.scheduler;
import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsArnUtils;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.services.scheduler.SchedulerExpressionParser.Kind;
import io.github.hectorvent.floci.services.scheduler.model.Schedule;
import io.quarkus.runtime.ShutdownEvent;
@@ -40,7 +41,7 @@ import java.util.concurrent.TimeUnit;
* </ul>
*/
@ApplicationScoped
-public class ScheduleDispatcher {
+public class ScheduleDispatcher implements Resettable {
private static final Logger LOG = Logger.getLogger(ScheduleDispatcher.class);
@@ -81,6 +82,11 @@ public class ScheduleDispatcher {
executor.shutdownNow();
}
+ public void clear() {
+ lastFireByArn.clear();
+ firedOnceByArn.clear();
+ }
+
void tickSafely() {
try {
tick(Instant.now());
diff --git a/src/main/java/io/github/hectorvent/floci/services/sns/SnsService.java b/src/main/java/io/github/hectorvent/floci/services/sns/SnsService.java
index 62f1c94fa1..fdb1ff1043 100644
--- a/src/main/java/io/github/hectorvent/floci/services/sns/SnsService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/sns/SnsService.java
@@ -4,6 +4,7 @@ import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsArnUtils;
import io.github.hectorvent.floci.core.common.AwsException;
import io.github.hectorvent.floci.core.common.RegionResolver;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.core.storage.StorageBackend;
import io.github.hectorvent.floci.core.storage.StorageFactory;
import io.github.hectorvent.floci.services.lambda.LambdaService;
@@ -50,7 +51,7 @@ import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentLinkedDeque;
@ApplicationScoped
-public class SnsService {
+public class SnsService implements Resettable {
private static final Logger LOG = Logger.getLogger(SnsService.class);
private static final Duration FIFO_DEDUP_WINDOW = Duration.ofMinutes(5);
@@ -159,6 +160,11 @@ public class SnsService {
this.httpClient = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(5)).build();
}
+ public void clear() {
+ pushCapture.clear();
+ fifoDeduplicationCache.clear();
+ }
+
public Topic createTopic(String name, Map<String, String> attributes,
Map<String, String> tags, String region) {
if (name == null || name.isBlank()) {
diff --git a/src/main/java/io/github/hectorvent/floci/services/sqs/SqsService.java b/src/main/java/io/github/hectorvent/floci/services/sqs/SqsService.java
index 489df886fe..ff0ff5327c 100644
--- a/src/main/java/io/github/hectorvent/floci/services/sqs/SqsService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/sqs/SqsService.java
@@ -4,6 +4,7 @@ import io.github.hectorvent.floci.config.EmulatorConfig;
import io.github.hectorvent.floci.core.common.AwsArnUtils;
import io.github.hectorvent.floci.core.common.AwsException;
import io.github.hectorvent.floci.core.common.RegionResolver;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.core.storage.AccountAwareStorageBackend;
import io.github.hectorvent.floci.core.storage.StorageBackend;
import io.github.hectorvent.floci.core.storage.StorageFactory;
@@ -26,7 +27,7 @@ import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.atomic.AtomicLong;
@ApplicationScoped
-public class SqsService {
+public class SqsService implements Resettable {
private static final Logger LOG = Logger.getLogger(SqsService.class);
private static final int DEDUP_WINDOW_SECONDS = 300; // 5 minutes
@@ -128,6 +129,17 @@ public class SqsService {
loadPersistedDedup();
}
+ public void clear() {
+ messagesByQueue.values().forEach(GuardedMessageQueue::close);
+ messagesByQueue.clear();
+ queueLocks.clear();
+ redrivePolicyCache.clear();
+ deduplicationCache.clear();
+ moveTaskCancellation.values().forEach(flag -> flag.set(true));
+ moveTaskCancellation.clear();
+ moveTasksByHandle.clear();
+ }
+
private void loadPersistedMessages() {
if (messageStore == null) {
return;
diff --git a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmCommandService.java b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmCommandService.java
index 37d648f345..f43abc68e7 100644
--- a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmCommandService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmCommandService.java
@@ -7,6 +7,7 @@ import com.fasterxml.jackson.databind.node.ArrayNode;
import com.fasterxml.jackson.databind.node.ObjectNode;
import io.github.hectorvent.floci.core.common.AwsException;
import io.github.hectorvent.floci.core.common.RegionResolver;
+import io.github.hectorvent.floci.core.common.Resettable;
import io.github.hectorvent.floci.core.storage.StorageBackend;
import io.github.hectorvent.floci.core.storage.StorageFactory;
import io.github.hectorvent.floci.services.ssm.model.Command;
@@ -37,7 +38,7 @@ import java.util.concurrent.Executors;
* - GetMessages / AcknowledgeMessage / SendReply / FailMessage / DeleteMessage (ec2messages, agent side)
*/
@ApplicationScoped
-public class SsmCommandService {
+public class SsmCommandService implements Resettable {
private static final Logger LOG = Logger.getLogger(SsmCommandService.class);
private static final int MIN_TIMEOUT_SECONDS = 30;
@@ -76,6 +77,11 @@ public class SsmCommandService {
});
}
+ public void clear() {
+ messageQueues.clear();
+ messageIndex.clear();
+ }
+
// ── Agent registration ──────────────────────────────────────────────────
public void updateInstanceInformation(JsonNode request, String region) {
diff --git a/src/main/java/io/github/hectorvent/floci/services/stepfunctions/StepFunctionsService.java b/src/main/java/io/github/hectorvent/floci/services/stepfunctions/StepFunctionsService.java
index d3034a3008..13c6845738 100644
--- a/src/main/java/io/github/hectorvent/floci/services/stepfunctions/StepFunctionsService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/stepfunctions/StepFunctionsService.java
@@ -12,6 +12,7 @@ import io.github.hectorvent.floci.services.stepfunctions.model.ActivityTask;
import io.github.hectorvent.floci.services.stepfunctions.model.Execution;
import io.github.hectorvent.floci.services.stepfunctions.model.HistoryEvent;
import io.github.hectorvent.floci.services.stepfunctions.model.StateMachine;
+import io.github.hectorvent.floci.core.common.Resettable;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
import org.jboss.logging.Logger;
@@ -29,7 +30,7 @@ import java.util.regex.Matcher;
import java.util.regex.Pattern;
@ApplicationScoped
-public class StepFunctionsService {
+public class StepFunctionsService implements Resettable {
private static final Logger LOG = Logger.getLogger(StepFunctionsService.class);
@@ -62,6 +63,13 @@ public class StepFunctionsService {
this.objectMapper = objectMapper;
}
+ public void clear() {
+ historyCache.clear();
+ activityQueues.clear();
+ pendingTaskTokens.values().forEach(f -> f.completeExceptionally(new RuntimeException("StepFunctionsService cleared")));
+ pendingTaskTokens.clear();
+ }
+
// ──────────────────────────── State Machines ────────────────────────────
public StateMachine createStateMachine(String name, String definition, String roleArn, String type, String region, Map<String, String> tags) {
diff --git a/src/main/java/io/github/hectorvent/floci/services/textract/TextractService.java b/src/main/java/io/github/hectorvent/floci/services/textract/TextractService.java
index 1f1841e83d..e01571746e 100644
--- a/src/main/java/io/github/hectorvent/floci/services/textract/TextractService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/textract/TextractService.java
@@ -3,6 +3,7 @@ import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ArrayNode;
import com.fasterxml.jackson.databind.node.ObjectNode;
import io.github.hectorvent.floci.core.common.AwsException;
+import io.github.hectorvent.floci.core.common.Resettable;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
import jakarta.ws.rs.core.Response;
@@ -17,7 +18,7 @@ import java.util.concurrent.ConcurrentHashMap;
* @see <a href="https://docs.aws.amazon.com/textract/latest/dg/API_Operations.html">Textract API Reference</a>
*/
@ApplicationScoped
-public class TextractService {
+public class TextractService implements Resettable {
static final String MODEL_VERSION = "1.0";
private final ObjectMapper objectMapper;
/** In-memory async job store: jobId to jobType ("TEXT_DETECTION" or "DOCUMENT_ANALYSIS"). */
@@ -26,6 +27,9 @@ public class TextractService {
public TextractService(ObjectMapper objectMapper) {
this.objectMapper = objectMapper;
}
+ public void clear() {
+ asyncJobs.clear();
+ }
/**
* DetectDocumentText — returns a stub PAGE + LINE + WORD block hierarchy.
* Response shape: https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html
diff --git a/src/main/java/io/github/hectorvent/floci/services/transcribe/TranscribeService.java b/src/main/java/io/github/hectorvent/floci/services/transcribe/TranscribeService.java
index fe9793fcc5..6269b09988 100644
--- a/src/main/java/io/github/hectorvent/floci/services/transcribe/TranscribeService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/transcribe/TranscribeService.java
@@ -7,6 +7,7 @@ import io.github.hectorvent.floci.core.storage.StorageFactory;
import io.github.hectorvent.floci.services.transcribe.model.TranscriptionJob;
import io.github.hectorvent.floci.services.transcribe.model.TranscriptionJobSummary;
import io.github.hectorvent.floci.services.transcribe.model.VocabularyInfo;
+import io.github.hectorvent.floci.core.common.Resettable;
import jakarta.annotation.PostConstruct;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
@@ -24,7 +25,7 @@ import java.util.concurrent.ConcurrentHashMap;
* @see <a href="https://docs.aws.amazon.com/transcribe/latest/APIReference/Welcome.html">Transcribe API</a>
*/
@ApplicationScoped
-public class TranscribeService {
+public class TranscribeService implements Resettable {
private final StorageFactory storageFactory;
@@ -46,6 +47,11 @@ public class TranscribeService {
"transcribe-vocabularies.json", new TypeReference<Map<String, VocabularyInfo>>() {}));
}
+ public void clear() {
+ transcriptionJobs.clear();
+ vocabularies.clear();
+ }
+
public TranscriptionJob startTranscriptionJob(String jobName, String mediaFileUri,
String languageCode, String mediaFormat) {
requireNonBlank(jobName, "TranscriptionJobName");
diff --git a/src/test/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoControllerIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoControllerIntegrationTest.java
index 3ef273dbf9..367e7340f8 100644
--- a/src/test/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoControllerIntegrationTest.java
+++ b/src/test/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoControllerIntegrationTest.java
@@ -1,8 +1,10 @@
package io.github.hectorvent.floci.lifecycle;
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
+import io.github.hectorvent.floci.testing.RestAssuredJsonUtils;
import io.quarkus.test.junit.QuarkusTest;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.JsonNode;
+import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import org.junit.jupiter.api.Test;
@@ -18,6 +20,11 @@ class EmulatorInfoControllerIntegrationTest {
private static final ObjectMapper MAPPER = new ObjectMapper();
+ @BeforeAll
+ static void configureRestAssured() {
+ RestAssuredJsonUtils.configureAwsContentTypes();
+ }
+
// Core services that must always be present and running.
// New services can be added to Floci without updating this list —
// the test verifies all known services are present, not an exact set.
@@ -97,4 +104,71 @@ class EmulatorInfoControllerIntegrationTest {
void config_returns200OnBothPaths(String path) {
given().when().get(path).then().statusCode(200).contentType("application/json");
}
+
+ @ParameterizedTest
+ @ValueSource(strings = {"/_floci/state/reset", "/_localstack/state/reset", "/_floci/state/nuke", "/_localstack/state/nuke"})
+ void stateReset_returnsOkOnAllPaths(String path) {
+ given()
+ .when().post(path)
+ .then()
+ .statusCode(200)
+ .contentType("application/json")
+ .body("status", equalTo("OK"));
+ }
+
+ @Test
+ void stateReset_clearsDatabaseState() {
+ // 1. Put SSM parameter
+ given()
+ .header("X-Amz-Target", "AmazonSSM.PutParameter")
+ .contentType("application/x-amz-json-1.1")
+ .body("""
+ {
+ "Name": "/test/parameter/to/be/reset",
+ "Value": "should-be-gone",
+ "Type": "String"
+ }
+ """)
+ .when()
+ .post("/")
+ .then()
+ .statusCode(200);
+
+ // 2. Verify parameter exists
+ given()
+ .header("X-Amz-Target", "AmazonSSM.GetParameter")
+ .contentType("application/x-amz-json-1.1")
+ .body("""
+ {
+ "Name": "/test/parameter/to/be/reset"
+ }
+ """)
+ .when()
+ .post("/")
+ .then()
+ .statusCode(200)
+ .body("Parameter.Value", equalTo("should-be-gone"));
+
+ // 3. Trigger state reset
+ given()
+ .when().post("/_floci/state/reset")
+ .then()
+ .statusCode(200)
+ .body("status", equalTo("OK"));
+
+ // 4. Verify parameter is deleted and no longer exists
+ given()
+ .header("X-Amz-Target", "AmazonSSM.GetParameter")
+ .contentType("application/x-amz-json-1.1")
+ .body("""
+ {
+ "Name": "/test/parameter/to/be/reset"
+ }
+ """)
+ .when()
+ .post("/")
+ .then()
+ .statusCode(400)
+ .body("__type", equalTo("ParameterNotFound"));
+ }
}