fix: add a back door to modify the schema

closes: #7355

Signed-off-by: Steve Hawkins <[email protected]>

Author: shawkins

crd-generator/api-v2/src/main/java/io/fabric8/crdv2/generator/AbstractJsonSchema.java

@@ -41,6 +41,8 @@
 import io.fabric8.crd.generator.annotation.SelectableField;
 import io.fabric8.crdv2.generator.InternalSchemaSwaps.SwapResult;
 import io.fabric8.crdv2.generator.ResolvingContext.GeneratorObjectSchema;
+import io.fabric8.crdv2.generator.v1.JsonSchema.V1JSONSchemaProps;
+import io.fabric8.crdv2.generator.v1.SchemaCustomizer;
 import io.fabric8.generator.annotation.Default;
 import io.fabric8.generator.annotation.Max;
 import io.fabric8.generator.annotation.Min;
@@ -54,6 +56,7 @@
 import io.fabric8.kubernetes.api.model.HasMetadata;
 import io.fabric8.kubernetes.api.model.IntOrString;
 import io.fabric8.kubernetes.api.model.Quantity;
+import io.fabric8.kubernetes.api.model.apiextensions.v1.JSONSchemaProps;
 import io.fabric8.kubernetes.api.model.runtime.RawExtension;
 import io.fabric8.kubernetes.client.utils.Utils;
 import io.fabric8.kubernetes.model.annotation.LabelSelector;
@@ -412,7 +415,7 @@ private T resolveObject(LinkedHashMap<String, String> visited, InternalSchemaSwa
       String... ignore) {
     Set<String> ignores = ignore.length > 0 ? new LinkedHashSet<>(Arrays.asList(ignore)) : Collections.emptySet();
 
-    final T objectSchema = singleProperty("object");
+    T objectSchema = singleProperty("object");
 
     schemaSwaps = schemaSwaps.branchAnnotations();
     final InternalSchemaSwaps swaps = schemaSwaps;
@@ -505,6 +508,27 @@ private T resolveObject(LinkedHashMap<String, String> visited, InternalSchemaSwa
     consumeRepeatingAnnotation(rawClass, ValidationRule.class,
         v -> validationRules.add(from(v)));
     addToValidationRules(objectSchema, validationRules);
+    return handleSchemaCustomizer(objectSchema, rawClass);
+  }
+
+  private T handleSchemaCustomizer(T objectSchema, Class<?> rawClass) {
+    if (objectSchema instanceof JSONSchemaProps) {
+      JSONSchemaProps[] props = new JSONSchemaProps[] { (JSONSchemaProps) objectSchema };
+      consumeRepeatingAnnotation(rawClass, SchemaCustomizer.class, sc -> {
+        try {
+          props[0] = sc.value().getConstructor().newInstance().apply(props[0], sc.input());
+        } catch (Exception e) {
+          if (!(e instanceof RuntimeException)) {
+            e = new RuntimeException(e);
+          }
+          throw (RuntimeException) e;
+        }
+      });
+      if (props[0] != objectSchema) {
+        // hack to convert back to V1JSONSchemaProps
+        objectSchema = (T) resolvingContext.kubernetesSerialization.convertValue(props[0], V1JSONSchemaProps.class);
+      }
+    }
     return objectSchema;
   }
 

crd-generator/api-v2/src/main/java/io/fabric8/crdv2/generator/v1/SchemaCustomizer.java

@@ -0,0 +1,46 @@
+/*
+ * Copyright (C) 2015 Red Hat, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *         http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.fabric8.crdv2.generator.v1;
+
+import io.fabric8.kubernetes.api.model.apiextensions.v1.JSONSchemaProps;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target({ ElementType.TYPE })
+@Retention(RetentionPolicy.RUNTIME)
+public @interface SchemaCustomizer {
+
+  public interface Customizer {
+
+    /**
+     * Customizes the given {@link JSONSchemaProps}
+     * 
+     * @param props the {@link JSONSchemaProps} to customize
+     * @param input the input String from the {@link SchemaCustomizer} annotation
+     * @return the customized {@link JSONSchemaProps}
+     */
+    JSONSchemaProps apply(JSONSchemaProps props, String input);
+
+  }
+
+  Class<? extends Customizer> value();
+
+  String input() default "";
+
+}

crd-generator/api-v2/src/test/java/io/fabric8/crdv2/example/customized/Customized.java

@@ -0,0 +1,10 @@
+package io.fabric8.crdv2.example.customized;
+
+import io.fabric8.crdv2.generator.v1.SchemaCustomizer;
+
+@SchemaCustomizer(input = "my description", value = DescriptionCustomizer.class)
+public class Customized {
+
+  public int field;
+
+}

crd-generator/api-v2/src/test/java/io/fabric8/crdv2/example/customized/DescriptionCustomizer.java

@@ -0,0 +1,14 @@
+package io.fabric8.crdv2.example.customized;
+
+import io.fabric8.crdv2.generator.v1.SchemaCustomizer;
+import io.fabric8.kubernetes.api.model.apiextensions.v1.JSONSchemaProps;
+
+public class DescriptionCustomizer implements SchemaCustomizer.Customizer {
+
+  @Override
+  public JSONSchemaProps apply(JSONSchemaProps props, String input) {
+    props.setDescription(input);
+    return props;
+  }
+
+}

crd-generator/api-v2/src/test/java/io/fabric8/crdv2/generator/v1/SchemaCustomizerTest.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright (C) 2015 Red Hat, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *         http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.fabric8.crdv2.generator.v1;
+
+import io.fabric8.crdv2.example.customized.Customized;
+import io.fabric8.kubernetes.api.model.apiextensions.v1.JSONSchemaProps;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+class SchemaCustomizerTest {
+
+  @Test
+  void applyCustomizer() {
+    JSONSchemaProps schema = JsonSchema.from(Customized.class);
+    assertEquals("my description", schema.getDescription());
+
+  }
+
+}