Add MigrateToKafkaNative recipe for Testcontainers (#568) (#967)

* Add MigrateToKafkaNative recipe for Testcontainers (#568)

* Address review feedback on ReplaceContainerImageName

- Use @requiredargsconstructor with @Getter final fields for displayName/description
- Make MethodMatcher a static field
- Use UsesMethod precondition instead of UsesType
- Also handle new DockerImageName(String) constructor calls

* Regenerate recipes.csv for new recipes

* Use @value instead of @requiredargsconstructor in ReplaceContainerImageName

* Replace gvenzl/oracle-xe image in MigrateToOracleFree recipe

* Update apache/kafka-native image to 4.0.2

* Add image replacements for ClickHouse, Toxiproxy, and Vault

Replace deprecated Docker image names with their current equivalents:
- yandex/clickhouse-server -> clickhouse/clickhouse-server
- shopify/toxiproxy -> ghcr.io/shopify/toxiproxy
- vault -> hashicorp/vault

When newImage has no tag, the original tag is preserved.

Author: timtebeek

src/main/java/org/openrewrite/java/testing/testcontainers/ReplaceContainerImageName.java

@@ -0,0 +1,101 @@
+/*
+ * Copyright 2024 the original author or authors.
+ * <p>
+ * Licensed under the Moderne Source Available License (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * <p>
+ * https://docs.moderne.io/licensing/moderne-source-available-license
+ * <p>
+ * 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 org.openrewrite.java.testing.testcontainers;
+
+import lombok.EqualsAndHashCode;
+import lombok.Value;
+import org.openrewrite.*;
+import org.openrewrite.java.JavaIsoVisitor;
+import org.openrewrite.java.MethodMatcher;
+import org.openrewrite.java.search.UsesMethod;
+import org.openrewrite.java.tree.J;
+import org.openrewrite.java.tree.JavaType;
+
+@Value
+@EqualsAndHashCode(callSuper = false)
+public class ReplaceContainerImageName extends Recipe {
+
+    private static final MethodMatcher DOCKER_IMAGE_NAME_PARSE = new MethodMatcher(
+            "org.testcontainers.utility.DockerImageName parse(String)");
+    private static final MethodMatcher DOCKER_IMAGE_NAME_CONSTRUCTOR = new MethodMatcher(
+            "org.testcontainers.utility.DockerImageName <constructor>(String)");
+
+    @Option(displayName = "Container class",
+            description = "The fully qualified name of the container class to match.",
+            example = "org.testcontainers.containers.KafkaContainer")
+    String containerClass;
+
+    @Option(displayName = "Image prefix to match",
+            description = "The Docker image prefix to match (e.g. `confluentinc/cp-kafka`).",
+            example = "confluentinc/cp-kafka")
+    String imagePrefix;
+
+    @Option(displayName = "New image",
+            description = "The new Docker image to use. When a tag is included (e.g. `apache/kafka-native:4.0.2`), " +
+                          "the entire image string is replaced. When no tag is included (e.g. `clickhouse/clickhouse-server`), " +
+                          "only the image name prefix is replaced and the original tag is preserved.",
+            example = "apache/kafka-native:4.0.2")
+    String newImage;
+
+    @Override
+    public String getDisplayName() {
+        return "Replace container image name";
+    }
+
+    @Override
+    public String getDescription() {
+        return "Replace a Docker image name in `DockerImageName.parse(image)` or " +
+               "`new DockerImageName(image)` constructor arguments for a specific container class.";
+    }
+
+    @Override
+    public TreeVisitor<?, ExecutionContext> getVisitor() {
+        MethodMatcher containerConstructor = new MethodMatcher(containerClass + " <constructor>(..)");
+        return Preconditions.check(new UsesMethod<>(containerConstructor), new JavaIsoVisitor<ExecutionContext>() {
+            @Override
+            public J.Literal visitLiteral(J.Literal literal, ExecutionContext ctx) {
+                J.Literal l = super.visitLiteral(literal, ctx);
+                if (l.getType() != JavaType.Primitive.String || l.getValue() == null) {
+                    return l;
+                }
+                String value = (String) l.getValue();
+                if (!value.startsWith(imagePrefix)) {
+                    return l;
+                }
+                // Verify this literal is inside DockerImageName.parse(...) or new DockerImageName(...)
+                Cursor parent = getCursor().getParentTreeCursor();
+                if (parent.getValue() instanceof J.MethodInvocation) {
+                    J.MethodInvocation mi = parent.getValue();
+                    if (!DOCKER_IMAGE_NAME_PARSE.matches(mi)) {
+                        return l;
+                    }
+                } else if (parent.getValue() instanceof J.NewClass) {
+                    J.NewClass nc = parent.getValue();
+                    if (!DOCKER_IMAGE_NAME_CONSTRUCTOR.matches(nc)) {
+                        return l;
+                    }
+                } else {
+                    return l;
+                }
+                // When newImage has no tag, preserve the original tag
+                String replacement = newImage.contains(":") ?
+                        newImage : newImage + value.substring(imagePrefix.length());
+                return l.withValue(replacement)
+                        .withValueSource("\"" + replacement + "\"");
+            }
+        });
+    }
+}