refactor(tenant): Review multitenancy APIs

Signed-off-by: Thomas Vitale <ThomasVitale@users.noreply.github.com>

Author: ThomasVitale

arconia-multitenancy/arconia-multitenancy-core/build.gradle

@@ -6,6 +6,8 @@ plugins {
 }
 
 dependencies {
+    implementation project(":arconia-core")
+    
     implementation "org.jspecify:jspecify:${jSpecifyVersion}"
     implementation "org.slf4j:slf4j-api"
     implementation "org.springframework:spring-context"

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/cache/DefaultTenantKeyGenerator.java

@@ -2,6 +2,8 @@
 
 import java.lang.reflect.Method;
 
+import io.arconia.core.support.Incubating;
+
 import org.springframework.cache.interceptor.SimpleKeyGenerator;
 
 import io.arconia.multitenancy.core.context.TenantContextHolder;
@@ -10,6 +12,7 @@
  * An implementation of {@link TenantKeyGenerator} that generates cache keys combining the
  * current tenant identifier with the given method and parameters.
  */
+@Incubating
 public final class DefaultTenantKeyGenerator implements TenantKeyGenerator {
 
     @Override

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/context/TenantContextHolder.java

@@ -1,5 +1,7 @@
 package io.arconia.multitenancy.core.context;
 
+import io.arconia.core.support.Incubating;
+
 import org.jspecify.annotations.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -11,14 +13,14 @@
 /**
  * A shared, thread-local store for the current tenant.
  */
+@Incubating
 public final class TenantContextHolder {
 
     private static final Logger logger = LoggerFactory.getLogger(TenantContextHolder.class);
 
     private static final ThreadLocal<String> tenantIdentifier = new ThreadLocal<>();
 
-    private TenantContextHolder() {
-    }
+    private TenantContextHolder() {}
 
     public static void setTenantIdentifier(String tenant) {
         Assert.hasText(tenant, "tenant cannot be null or empty");

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/context/events/HolderTenantContextEventListener.java

@@ -1,5 +1,6 @@
 package io.arconia.multitenancy.core.context.events;
 
+import io.arconia.core.support.Incubating;
 import io.arconia.multitenancy.core.context.TenantContextHolder;
 import io.arconia.multitenancy.core.events.TenantEvent;
 import io.arconia.multitenancy.core.events.TenantEventListener;
@@ -8,6 +9,7 @@
  * A {@link TenantEventListener} that sets/clears the tenant identifier from the current
  * context on the {@link TenantContextHolder}.
  */
+@Incubating
 public final class HolderTenantContextEventListener implements TenantEventListener {
 
     @Override

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/context/events/MdcTenantContextEventListener.java

@@ -1,5 +1,7 @@
 package io.arconia.multitenancy.core.context.events;
 
+import io.arconia.core.support.Incubating;
+
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.slf4j.MDC;
@@ -12,6 +14,7 @@
  * A {@link TenantEventListener} that sets/clears the tenant identifier from the current
  * context on the SLF4J's {@link MDC}.
  */
+@Incubating
 public final class MdcTenantContextEventListener implements TenantEventListener {
 
     private static final Logger logger = LoggerFactory.getLogger(MdcTenantContextEventListener.class);

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/context/events/ObservationTenantContextEventListener.java

@@ -1,5 +1,7 @@
 package io.arconia.multitenancy.core.context.events;
 
+import io.arconia.core.support.Incubating;
+
 import io.micrometer.common.KeyValue;
 import io.micrometer.observation.Observation;
 
@@ -14,6 +16,7 @@
  * A {@link TenantEventListener} that sets the tenant identifier from the current context
  * on an existing {@link Observation}.
  */
+@Incubating
 public final class ObservationTenantContextEventListener implements TenantEventListener {
 
     private static final Logger logger = LoggerFactory.getLogger(ObservationTenantContextEventListener.class);

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/context/events/TenantContextAttachedEvent.java

@@ -1,5 +1,7 @@
 package io.arconia.multitenancy.core.context.events;
 
+import io.arconia.core.support.Incubating;
+
 import io.micrometer.observation.Observation.Context;
 
 import org.jspecify.annotations.Nullable;
@@ -11,6 +13,7 @@
  * A {@link TenantEvent} which indicates a tenant has been attached to the current
  * context.
  */
+@Incubating
 public final class TenantContextAttachedEvent extends TenantEvent {
 
     @Nullable

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/context/events/TenantContextClosedEvent.java

@@ -1,11 +1,13 @@
 package io.arconia.multitenancy.core.context.events;
 
+import io.arconia.core.support.Incubating;
 import io.arconia.multitenancy.core.events.TenantEvent;
 
 /**
  * A {@link TenantEvent} which indicates the context for the current tenant has been
  * closed.
  */
+@Incubating
 public final class TenantContextClosedEvent extends TenantEvent {
 
     public TenantContextClosedEvent(String tenantIdentifier, Object object) {

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/context/events/ValidatingTenantContextEventListener.java

@@ -1,5 +1,7 @@
 package io.arconia.multitenancy.core.context.events;
 
+import io.arconia.core.support.Incubating;
+
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -11,6 +13,7 @@
 /**
  * A {@link TenantEventListener} that validates the tenant for the current context.
  */
+@Incubating
 public final class ValidatingTenantContextEventListener implements TenantEventListener {
 
     private static final Logger logger = LoggerFactory.getLogger(ValidatingTenantContextEventListener.class);

arconia-multitenancy/arconia-multitenancy-core/src/main/java/io/arconia/multitenancy/core/context/resolvers/FixedTenantResolver.java

@@ -1,11 +1,14 @@
 package io.arconia.multitenancy.core.context.resolvers;
 
+import io.arconia.core.support.Incubating;
+
 import org.jspecify.annotations.NonNull;
 import org.springframework.util.Assert;
 
 /**
  * Strategy to use a fixed value as the current tenant, regardless of the source context.
  */
+@Incubating
 public final class FixedTenantResolver implements TenantResolver<Object> {
 
     public static final String DEFAULT_FIXED_TENANT_IDENTIFIER = "default";