chore: various non-functional refactors (#1066)

Signed-off-by: Todd Baert <todd.baert@dynatrace.com>

src/main/java/dev/openfeature/sdk/BooleanHook.java

@@ -1,7 +1,10 @@
 package dev.openfeature.sdk;
 
 /**
- * {@inheritDoc}
+ * An extension point which can run around flag resolution. They are intended to be used as a way to add custom logic
+ * to the lifecycle of flag evaluation.
+ * 
+ * @see Hook
  */
 public interface BooleanHook extends Hook<Boolean> {
 

src/main/java/dev/openfeature/sdk/DoubleHook.java

@@ -1,7 +1,10 @@
 package dev.openfeature.sdk;
 
 /**
- * {@inheritDoc}
+ * An extension point which can run around flag resolution. They are intended to be used as a way to add custom logic
+ * to the lifecycle of flag evaluation.
+ * 
+ * @see Hook
  */
 public interface DoubleHook extends Hook<Double> {
 

src/main/java/dev/openfeature/sdk/ImmutableContext.java

@@ -1,10 +1,11 @@
 package dev.openfeature.sdk;
 
-import lombok.ToString;
-import lombok.experimental.Delegate;
-
 import java.util.HashMap;
 import java.util.Map;
+import java.util.function.Function;
+import dev.openfeature.sdk.internal.ExcludeFromGeneratedCoverageReport;
+import lombok.ToString;
+import lombok.experimental.Delegate;
 
 /**
  * The EvaluationContext is a container for arbitrary contextual data
@@ -16,8 +17,8 @@
 @SuppressWarnings("PMD.BeanMembersShouldSerialize")
 public final class ImmutableContext implements EvaluationContext {
 
-    @Delegate
-    private final Structure structure;
+    @Delegate(excludes = DelegateExclusions.class)
+    private final ImmutableStructure structure;
 
     /**
      * Create an immutable context with an empty targeting_key and attributes provided.
@@ -84,4 +85,15 @@ public EvaluationContext merge(EvaluationContext overridingContext) {
         return new ImmutableContext(
                 this.merge(ImmutableStructure::new, this.asMap(), overridingContext.asMap()));
     }
+
+    @SuppressWarnings("all")
+    private static class DelegateExclusions {
+        @ExcludeFromGeneratedCoverageReport
+        public <T extends Structure> Map<String, Value> merge(Function<Map<String, Value>, Structure> newStructure, 
+                Map<String, Value> base,
+                Map<String, Value> overriding) {
+
+            return null;
+        }
+    }
 }

src/main/java/dev/openfeature/sdk/IntegerHook.java

@@ -1,7 +1,10 @@
 package dev.openfeature.sdk;
 
 /**
- * {@inheritDoc}
+ * An extension point which can run around flag resolution. They are intended to be used as a way to add custom logic
+ * to the lifecycle of flag evaluation.
+ * 
+ * @see Hook
  */
 public interface IntegerHook extends Hook<Integer> {
 

src/main/java/dev/openfeature/sdk/MutableContext.java

@@ -1,13 +1,14 @@
 package dev.openfeature.sdk;
 
-import lombok.EqualsAndHashCode;
-import lombok.ToString;
-import lombok.experimental.Delegate;
-
 import java.time.Instant;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.function.Function;
+import dev.openfeature.sdk.internal.ExcludeFromGeneratedCoverageReport;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import lombok.experimental.Delegate;
 
 /**
  * The EvaluationContext is a container for arbitrary contextual data
@@ -20,7 +21,8 @@
 @SuppressWarnings("PMD.BeanMembersShouldSerialize")
 public class MutableContext implements EvaluationContext {
 
-    @Delegate(excludes = HideDelegateAddMethods.class) private final MutableStructure structure;
+    @Delegate(excludes = DelegateExclusions.class)
+    private final MutableStructure structure;
 
     public MutableContext() {
         this(new HashMap<>());
@@ -124,11 +126,21 @@ public EvaluationContext merge(EvaluationContext overridingContext) {
     /**
      * Hidden class to tell Lombok not to copy these methods over via delegation.
      */
-    private static class HideDelegateAddMethods {
+    @SuppressWarnings("all")
+    private static class DelegateExclusions {
+
+        @ExcludeFromGeneratedCoverageReport
+        public <T extends Structure> Map<String, Value> merge(Function<Map<String, Value>, Structure> newStructure,
+                Map<String, Value> base,
+                Map<String, Value> overriding) {
+
+            return null;
+        }
+
         public MutableStructure add(String ignoredKey, Boolean ignoredValue) {
             return null;
         }
-        
+
         public MutableStructure add(String ignoredKey, Double ignoredValue) {
             return null;
         }

src/main/java/dev/openfeature/sdk/OpenFeatureClient.java

@@ -17,11 +17,17 @@
 import lombok.extern.slf4j.Slf4j;
 
 /**
- * {@inheritDoc}
+ * OpenFeature Client implementation.
+ * You should not instantiate this or reference this class.
+ * Use the dev.openfeature.sdk.Client interface instead.
+ * @see Client
+ * 
+ * @deprecated // TODO: eventually we will make this non-public. See issue #872
  */
 @Slf4j
 @SuppressWarnings({ "PMD.DataflowAnomalyAnalysis", "PMD.BeanMembersShouldSerialize",
                     "PMD.UnusedLocalVariable", "unchecked", "rawtypes" })
+@Deprecated() // TODO: eventually we will make this non-public. See issue #872
 public class OpenFeatureClient implements Client {
 
     private final OpenFeatureAPI openfeatureApi;

src/main/java/dev/openfeature/sdk/StringHook.java

@@ -1,7 +1,10 @@
 package dev.openfeature.sdk;
 
 /**
- * {@inheritDoc}
+ * An extension point which can run around flag resolution. They are intended to be used as a way to add custom logic
+ * to the lifecycle of flag evaluation.
+ * 
+ * @see Hook
  */
 public interface StringHook extends Hook<String> {
 

src/main/java/dev/openfeature/sdk/internal/ExcludeFromGeneratedCoverageReport.java

@@ -0,0 +1,14 @@
+package dev.openfeature.sdk.internal;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.ElementType;
+
+/**
+ * JaCoCo ignores coverage of methods annotated with any annotation with "generated" in the name.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface ExcludeFromGeneratedCoverageReport {
+}