Add basic unit and YAML REST tests

Author: tlfeng

README.md

@@ -94,6 +94,30 @@ src/main/java/org/easysearch/plugin/hello/
    }
    ```
 
+## 测试
+
+模板现在包含最基础的两类测试：
+
+- 单元测试：`src/test/java/org/easysearch/plugin/hello/rest/RestHelloActionTest.java`
+- YAML REST 套件入口：`src/yamlRestTest/java/org/easysearch/plugin/hello/HelloClientYamlTestSuiteIT.java`
+- YAML REST API 定义：`src/yamlRestTest/resources/rest-api-spec/api/hello.json`
+- YAML REST 测试：`src/yamlRestTest/resources/rest-api-spec/test/hello/10_basic.yml`
+
+常用命令：
+
+```bash
+./gradlew test
+./gradlew yamlRestTest
+./gradlew check
+```
+
+说明：
+
+- `test` 运行普通单元测试（类名需要匹配 `*Test`）
+- 单元测试基于 `EasySearchTestCase`（推荐沿用 `testXxx` 方法命名）
+- `yamlRestTest` 会启动测试集群并执行 REST 用例（需要 `src/yamlRestTest/java` 下有 suite 类）
+- `check` 已配置为同时触发 `integTest` 与 `yamlRestTest`
+
 ## 版本兼容
 
 | 组件 | 版本 |

build.gradle

@@ -1,17 +1,4 @@
-apply plugin: 'easysearch.esplugin'
-
-esplugin {
-    name 'hello-plugin'
-    description 'A simple hello plugin for Easysearch'
-    classname "org.easysearch.plugin.hello.HelloPlugin"
-    licenseFile rootProject.file('LICENSE.txt')
-    noticeFile rootProject.file('NOTICE.txt')
-}
-
-// Skip POM validation - this plugin is not published to maven.
-tasks.named('validateNebulaPom') {
-    enabled = false
-}
+import org.easysearch.gradle.test.RestIntegTestTask
 
 buildscript {
     ext {
@@ -28,9 +15,35 @@ buildscript {
     }
 }
 
+apply plugin: 'easysearch.esplugin'
+apply plugin: 'easysearch.yaml-rest-test'
+
+esplugin {
+    name 'hello-plugin'
+    description 'A simple hello plugin for Easysearch'
+    classname "org.easysearch.plugin.hello.HelloPlugin"
+    licenseFile rootProject.file('LICENSE.txt')
+    noticeFile rootProject.file('NOTICE.txt')
+}
+
+// Skip POM validation - this plugin is not published to maven.
+tasks.named('validateNebulaPom') { enabled = false }
+
 repositories {
     mavenCentral()
     gradlePluginPortal()
     maven { url "https://maven.aliyun.com/repository/central" }
     maven { url "https://maven.aliyun.com/repository/gradle-plugin" }
 }
+
+test {
+    include "**/*Test.class"
+}
+
+task integTest(type: RestIntegTestTask) {
+    description = "Run integration tests against an Easysearch test cluster"
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+}
+
+tasks.named('check') { dependsOn integTest }

src/test/java/org/easysearch/plugin/hello/rest/RestHelloActionTest.java

@@ -0,0 +1,30 @@
+/* Copyright © INFINI Ltd. All rights reserved.
+ * Web: https://infinilabs.com
+ * Email: hello#infini.ltd
+ * SPDX-License-Identifier: Apache-2.0 */
+
+package org.easysearch.plugin.hello.rest;
+
+import org.easysearch.rest.RestRequest;
+import org.easysearch.test.EasySearchTestCase;
+
+import java.util.List;
+
+public class RestHelloActionTest extends EasySearchTestCase {
+
+    public void testGetName() {
+        RestHelloAction action = new RestHelloAction();
+
+        assertEquals("hello_action", action.getName());
+    }
+
+    public void testRoutes() {
+        RestHelloAction action = new RestHelloAction();
+        List<org.easysearch.rest.BaseRestHandler.Route> routes = action.routes();
+
+        assertEquals(1, routes.size());
+        assertEquals(RestRequest.Method.GET, routes.get(0).getMethod());
+        assertEquals("/_hello", routes.get(0).getPath());
+    }
+}
+

src/yamlRestTest/java/org/easysearch/plugin/hello/HelloClientYamlTestSuiteIT.java

@@ -0,0 +1,27 @@
+/* Copyright © INFINI Ltd. All rights reserved.
+ * Web: https://infinilabs.com
+ * Email: hello#infini.ltd
+ * SPDX-License-Identifier: Apache-2.0 */
+
+package org.easysearch.plugin.hello;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+import org.easysearch.test.rest.yaml.ClientYamlTestCandidate;
+import org.easysearch.test.rest.yaml.ESClientYamlSuiteTestCase;
+
+/**
+ * Minimal YAML REST test suite entry for plugin REST tests.
+ */
+public class HelloClientYamlTestSuiteIT extends ESClientYamlSuiteTestCase {
+
+    public HelloClientYamlTestSuiteIT(@Name("yaml") ClientYamlTestCandidate testCandidate) {
+        super(testCandidate);
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() throws Exception {
+        return createParameters();
+    }
+}
+

src/yamlRestTest/resources/rest-api-spec/api/hello.json

@@ -0,0 +1,27 @@
+{
+  "hello": {
+    "documentation": {
+      "url": "https://github.com/infinilabs/easysearch-plugin-template",
+      "description": "Returns a hello message from the example plugin"
+    },
+    "stability": "stable",
+    "url": {
+      "paths": [
+        {
+          "path": "/_hello",
+          "methods": [
+            "GET"
+          ]
+        }
+      ]
+    },
+    "params": {
+      "name": {
+        "type": "string",
+        "description": "Optional name to include in the greeting"
+      }
+    },
+    "body": null
+  }
+}
+

src/yamlRestTest/resources/rest-api-spec/test/hello/10_basic.yml

@@ -0,0 +1,17 @@
+---
+"hello endpoint returns greeting with explicit name":
+  - do:
+      hello:
+        name: "tom"
+
+  - match: { message: "Hello tom" }
+  - is_true: cluster_name
+  - is_true: node_name
+
+---
+"hello endpoint uses default name":
+  - do:
+      hello: {}
+
+  - match: { message: "Hello World" }
+