feat：入口类增加新方法及增加注释

Author: AzirZsk

src/main/java/org/github/azirzsk/fcp/FCP.java

@@ -6,9 +6,13 @@
 import org.github.azirzsk.fcp.invoke.FunctionCall;
 import org.github.azirzsk.fcp.parser.ToolParser;
 
+import java.util.ArrayList;
 import java.util.List;
 
 /**
+ * FunctionCall入口类
+ * 生成JSON格式的工具调用以及回调对应方法
+ *
  * @author zhangshukun
  * @since 2024/11/25
  */
@@ -19,6 +23,8 @@ public class FCP {
 
     private final FunctionCall functionCall = new FunctionCall();
 
+    private final List<ToolEntity> toolEntityList = new ArrayList<>();
+
     public static FCP create() {
         return new FCP();
     }
@@ -33,20 +39,38 @@ private FCP() {
      * @param function 对象
      * @return FunctionCall
      */
-    public String functionCall(Object function) {
-        List<ToolEntity> toolEntityList = toolParser.parse(function.getClass());
-        if (toolEntityList.isEmpty()) {
-            throw new NullPointerException("传入的对应没有Function注解");
+    public String parse(Object function) {
+        List<ToolEntity> parseResult = toolParser.parse(function.getClass());
+        if (parseResult.isEmpty()) {
+            log.warn("传入的对象中没有标注@Function注解的方法");
+            throw new NullPointerException("传入的对象中没有标注@Function注解的方法");
         }
         // 构造函数名和实际方法的映射关系
-        for (ToolEntity toolEntity : toolEntityList) {
+        for (ToolEntity toolEntity : parseResult) {
             String name = toolEntity.getFunction().getName();
             functionCall.getMethodMap().put(name, toolEntity.getFunction());
         }
         functionCall.getObjectMap().put(function.getClass(), function);
+        this.toolEntityList.addAll(parseResult);
+        return JSON.toJSONString(parseResult);
+    }
+
+    /**
+     * 获取当前已解析的FunctionCall
+     *
+     * @return FunctionCall
+     */
+    public String getAllFunctionCall() {
         return JSON.toJSONString(toolEntityList);
     }
 
+    /**
+     * 回调对应方法
+     *
+     * @param name         方法名称
+     * @param argumentsStr 调用参数
+     * @return 调用结果
+     */
     public Object functionCall(String name, String argumentsStr) {
         return functionCall.functionCall(name, argumentsStr);
     }

src/test/java/org/github/azirzsk/fcp/invoke/FunctionCallTest.java

@@ -18,7 +18,7 @@ public class FunctionCallTest {
     public void testInvoke() {
         SingleReturnMethod toolTestClass = new SingleReturnMethod();
         FCP fcp = FCP.create();
-        fcp.functionCall(toolTestClass);
+        fcp.parse(toolTestClass);
 
         String invokeStr1 = "{\"a\":25,\"b\":230}";
         Assertions.assertEquals(5, fcp.functionCall("gcd", invokeStr1));
@@ -30,7 +30,7 @@ public void testInvoke() {
     public void testInvokeException() {
         SingleReturnMethod toolTestClass = new SingleReturnMethod();
         FCP fcp = FCP.create();
-        fcp.functionCall(toolTestClass);
+        fcp.parse(toolTestClass);
         String invokeStr = "{\"b\":25,\"b\":230}";
         Assertions.assertThrows(NullPointerException.class, () -> fcp.functionCall("gcd", invokeStr), "没有找到对应的方法：gcd.a");
     }
@@ -39,7 +39,7 @@ public void testInvokeException() {
     public void testVoidReturn() {
         SingleNoReturnMethod singleNoReturnMethod = new SingleNoReturnMethod();
         FCP fcp = FCP.create();
-        fcp.functionCall(singleNoReturnMethod);
+        fcp.parse(singleNoReturnMethod);
 
         String invokeStr = "{\"message\":\"hello world\"}";
         Assertions.assertNull(fcp.functionCall("printArg", invokeStr));
@@ -49,7 +49,7 @@ public void testVoidReturn() {
     public void testNoArg() {
         SingleNoArgMethod singleNoArgMethod = new SingleNoArgMethod();
         FCP fcp = FCP.create();
-        fcp.functionCall(singleNoArgMethod);
+        fcp.parse(singleNoArgMethod);
 
         String invokeStr = "{}";
         Assertions.assertEquals(123, fcp.functionCall("noArg", invokeStr));
@@ -59,7 +59,7 @@ public void testNoArg() {
     public void testCustomObject() {
         SingleReturnMethod singleReturnMethod = new SingleReturnMethod();
         FCP fcp = FCP.create();
-        fcp.functionCall(singleReturnMethod);
+        fcp.parse(singleReturnMethod);
 
         String invokeStr = "{\"user\":{\"name\":\"azirzsk\",\"age\":25}}";
         Assertions.assertEquals("姓名：azirzsk，年龄：25", fcp.functionCall("print", invokeStr));
@@ -69,7 +69,7 @@ public void testCustomObject() {
     public void testNestCustomObject() {
         SingleReturnMethod singleReturnMethod = new SingleReturnMethod();
         FCP fcp = FCP.create();
-        fcp.functionCall(singleReturnMethod);
+        fcp.parse(singleReturnMethod);
 
         String invokeStr = "{\"home\":{\"address\":\"北京市朝阳区\",\"userInfo\":{\"name\":\"azirzsk\",\"age\":25}}}";
         Assertions.assertEquals("地址：北京市朝阳区，用户信息：姓名：azirzsk，年龄：25", fcp.functionCall("printHome", invokeStr));
@@ -79,7 +79,7 @@ public void testNestCustomObject() {
     public void testRepeatMethod() {
         RepeatMethod repeatMethod = new RepeatMethod();
         FCP fcp = FCP.create();
-        fcp.functionCall(repeatMethod);
+        fcp.parse(repeatMethod);
 
         String invokeStr = "{\"str\":\"hello world\",\"repeat\":3}";
         Assertions.assertEquals("hello worldhello worldhello world", fcp.functionCall("print(String, int)", invokeStr));