# Online Java增強 http-api [TOC] >[info] version`2.4.7+` 20210820 ## 配置 配置方式與原版增強保持一致，只不過在選擇類型時需要選擇`http-api`， 內容輸入框里填寫請求地址，可以填寫`http(s)`開頭的絕對地址，也可以填寫項目相對地址。 > 注意：請求方式為`post`  ## 使用 以項目相對地址為例，在項目里定義一個`PostMapping`，接收一個 `RequestBody` 參數，類型為`JSONObject` 列表 http-api示例 ``` /** * online api增強 列表 * @param params * @return */ @PostMapping("/enhanceJavaListHttp") public Result enhanceJavaListHttp(@RequestBody JSONObject params) { log.info(" =========================================================== "); log.info("params: " + params.toJSONString()); log.info("params.tableName: " + params.getString("tableName")); log.info("params.dataList: " + params.getJSONArray("dataList").toJSONString()); log.info(" =========================================================== "); return Result.OK(); } ``` 表單 http-api示例 ~~~ /** * online api增強 表單 * @param params * @return */ @PostMapping("/enhanceJavaFormHttp") public Result enhanceJavaFormHttp(@RequestBody JSONObject params) { log.info(" =========================================================== "); log.info("params: " + params.toJSONString()); log.info("params.tableName: " + params.getString("tableName")); log.info("params.record: " + params.getJSONObject("record").toJSONString()); log.info(" =========================================================== "); return Result.OK("1"); } ~~~ ### 參數詳情 * `params.tableName` 當前執行增強的 online表單表名 * `params.record` 當前單條數據 * 僅 **新增**、**編輯**、**刪除**、**導入** 時傳遞該參數 * `params.dataList` 所有數據列表 * 僅 **導出**、**查詢** 時傳遞該參數。 ### 返回值 * `查詢` 如果修改了列表數據，那么就需要將修改的數據整體返回，反之不需要返回值。  * `新增` 默認無返回值，如果需要對數據做校驗，可以校驗失敗后直接返回錯誤。如果修改了數據，需要將修改的數據原樣返回。  * `編輯` （同新增） * `導入` 返回一個0-2的數字 * `0` 丟棄該條數據 * `1` 新增該條數據 * `2` 修改該條數據 * `導出` （同查詢） ### 參考示例代碼 `jeecg-boot-module-demo/org.jeecg.modules.demo.online.OnlCgformDemoController`