feat: experimental utility methods to add finalizer

Signed-off-by: Attila Mészáros <a_meszaros@apple.com>

Author: csviri

operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/PrimaryUpdateAndCacheUtils.java

@@ -229,4 +229,62 @@ private static <P extends HasMetadata> P pollLocalCache(
       throw new OperatorException(e);
     }
   }
+
+  /**
+   * Experimental. Patches finalizer. For retry uses informer cache to get the fresh resources,
+   * therefore makes less Kubernetes API Calls.
+   */
+  @Experimental(
+          "Not used internally for now. Therefor we don't consider it well tested. But the intention is"
+                  + " to have it as default in the future.")
+  public static <P extends HasMetadata> P addFinalizer(
+          P resource, String finalizer, Context<P> context) {
+
+    if (resource.hasFinalizer(finalizer)) {
+      log.debug("Skipping adding finalizer, since already present.");
+      return resource;
+    }
+
+    return updateAndCacheResource(
+            resource,
+            context,
+            r -> r,
+            r ->
+                    context
+                            .getClient()
+                            .resource(r)
+                            .edit(
+                                    res -> {
+                                      res.addFinalizer(finalizer);
+                                      return res;
+                                    }));
+  }
+
+  /**
+   * Experimental. Removes finalizer, for retry uses informer cache to get the fresh resources,
+   * therefore makes less Kubernetes API Calls.
+   */
+  @Experimental(
+          "Not used internally for now. Therefor we don't consider it well tested. But the intention is"
+                  + " to have it as default in the future.")
+  public static <P extends HasMetadata> P removeFinalizer(
+          P resource, String finalizer, Context<P> context) {
+    if (!resource.hasFinalizer(finalizer)) {
+      log.debug("Skipping removing finalizer, since not present.");
+      return resource;
+    }
+    return updateAndCacheResource(
+            resource,
+            context,
+            r -> r,
+            r ->
+                    context
+                            .getClient()
+                            .resource(r)
+                            .edit(
+                                    res -> {
+                                      res.removeFinalizer(finalizer);
+                                      return res;
+                                    }));
+  }
 }