✅ 创建grace测试示例项目

Author: hengboy

api-boot-samples/api-boot-sample-grace/pom.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>api-boot-samples</artifactId>
+        <groupId>org.minbox.framework</groupId>
+        <version>${revision}</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>api-boot-sample-grace</artifactId>
+
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.minbox.framework</groupId>
+            <artifactId>api-boot-starter-grace</artifactId>
+        </dependency>
+    </dependencies>
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.minbox.framework</groupId>
+                <artifactId>api-boot-dependencies</artifactId>
+                <version>${api-boot.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+</project>

api-boot-samples/api-boot-sample-grace/src/main/java/org/minbox/framework/sample/grace/ApiBootSampleGraceApplication.java

@@ -0,0 +1,22 @@
+package org.minbox.framework.sample.grace;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * @author 恒宇少年
+ */
+@SpringBootApplication
+public class ApiBootSampleGraceApplication {
+    /**
+     * logger instance
+     */
+    static Logger logger = LoggerFactory.getLogger(ApiBootSampleGraceApplication.class);
+
+    public static void main(String[] args) {
+        SpringApplication.run(ApiBootSampleGraceApplication.class, args);
+        logger.info("Grace测试服务启动成功.");
+    }
+}

api-boot-samples/api-boot-sample-grace/src/main/java/org/minbox/framework/sample/grace/ApiBootSampleGraceLogStorageProcessor.java

@@ -0,0 +1,21 @@
+package org.minbox.framework.sample.grace;
+
+import lombok.extern.slf4j.Slf4j;
+import org.minbox.framework.grace.processor.GraceLogObject;
+import org.minbox.framework.grace.processor.GraceLogStorageProcessor;
+import org.springframework.stereotype.Service;
+
+/**
+ * 日志持久化处理类
+ *
+ * @author 恒宇少年
+ */
+@Service
+@Slf4j
+public class ApiBootSampleGraceLogStorageProcessor implements GraceLogStorageProcessor {
+    @Override
+    public void storage(GraceLogObject graceLogObject) {
+        log.info("位置：{}，日志内容：{}.", graceLogObject.getGeneratedLocation(), graceLogObject.getContent());
+        // 更多字段参考GraceLogObject
+    }
+}

api-boot-samples/api-boot-sample-grace/src/main/java/org/minbox/framework/sample/grace/IndexController.java

@@ -0,0 +1,26 @@
+package org.minbox.framework.sample.grace;
+
+import org.minbox.framework.grace.expression.annotation.GraceRecorder;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * @author 恒宇少年
+ */
+@RestController
+public class IndexController {
+    /**
+     * 测试记录日志
+     * 注意：jdk1.8及之前的版本使用"#p?"的方式来获取值,?为参数索引，从0开始，jdk1.8以上版本可以使用"#参数名"获取值
+     * <p>
+     * "#reverseString()"方法定义在{@link StringUtils#reverseString}
+     *
+     * @param name
+     * @return
+     */
+    @GetMapping
+    @GraceRecorder(category = "测试分组", success = "名称：{#p0}，返回值：{#result}，反转后：{#reverseString(#p0)}")
+    public String index(String name) {
+        return "Hello," + name;
+    }
+}

api-boot-samples/api-boot-sample-grace/src/main/java/org/minbox/framework/sample/grace/StringUtils.java

@@ -0,0 +1,19 @@
+package org.minbox.framework.sample.grace;
+
+import org.minbox.framework.grace.expression.annotation.GraceFunction;
+import org.minbox.framework.grace.expression.annotation.GraceFunctionDefiner;
+
+/**
+ * @author 恒宇少年
+ */
+@GraceFunctionDefiner
+public class StringUtils {
+    @GraceFunction
+    public static String reverseString(String input) {
+        StringBuilder backwards = new StringBuilder();
+        for (int i = 0; i < input.length(); i++) {
+            backwards.append(input.charAt(input.length() - 1 - i));
+        }
+        return backwards.toString();
+    }
+}

api-boot-samples/api-boot-sample-grace/src/main/resources/application.yml

@@ -0,0 +1,6 @@
+api:
+    boot:
+        grace:
+            # 如果不配置则使用SpringBoot项目默认package
+            function-scan-base-packages:
+                - org.minbox.framework.sample.grace

api-boot-samples/pom.xml

@@ -46,5 +46,6 @@
         <module>api-boot-sample-message-pipe-client</module>
         <module>api-boot-sample-message-pipe-server</module>
         <module>api-boot-sample-ssh-agent</module>
+        <module>api-boot-sample-grace</module>
     </modules>
 </project>