@Matches and @NotMatches annotations used by Refaster-based recip…

…es (#3488)

* `@Matches` and `@NotMatches` annotations used by Refaster-based recipes

* Add `@Incubating`

rewrite-java/src/main/java/org/openrewrite/java/template/Matcher.java

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2023 the original author or authors.
+ * <p>
+ * 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
+ * <p>
+ * https://www.apache.org/licenses/LICENSE-2.0
+ * <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.template;
+
+import org.openrewrite.Incubating;
+import org.openrewrite.java.tree.J;
+
+@Incubating(since = "8.3.0")
+@FunctionalInterface
+public interface Matcher<T extends J> {
+    boolean matches(T t);
+}

rewrite-java/src/main/java/org/openrewrite/java/template/Matches.java

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2023 the original author or authors.
+ * <p>
+ * 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
+ * <p>
+ * https://www.apache.org/licenses/LICENSE-2.0
+ * <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.template;
+
+import org.openrewrite.Incubating;
+import org.openrewrite.java.tree.Expression;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Target;
+
+@Incubating(since = "8.3.0")
+@Target(ElementType.PARAMETER)
+public @interface Matches {
+    Class<? extends Matcher<? super Expression>> value();
+}

rewrite-java/src/main/java/org/openrewrite/java/template/NotMatches.java

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2023 the original author or authors.
+ * <p>
+ * 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
+ * <p>
+ * https://www.apache.org/licenses/LICENSE-2.0
+ * <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.template;
+
+import org.openrewrite.Incubating;
+import org.openrewrite.java.tree.Expression;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Target;
+
+@Incubating(since = "8.3.0")
+@Target(ElementType.PARAMETER)
+public @interface NotMatches {
+    Class<? extends Matcher<? super Expression>> value();
+}