Evalon4J Java接口文檔生成工具

Evalon4J 是一個 Java 接口文檔生成工具，直接通過命令行使用，支持Spring-MVC，JAX-RS，Swagger 2.0 等多種框架注解。同時它是付費產品?RabiAPI?使用的底層框架，通過靜態(tài)分析源代碼，直接生成相對應的接口文檔。

和大多數開源框架不同，Evalon4J 使用 JavaParser 直接分析源代碼，不需要使用任何 Gradle 或者 Maven 插件，所以使用者不會遇到任何和插件有關的煩人問題，更不會有任何版本沖突。

功能特色

• 純命令行工具，與項目本身零耦合，使用方便
• 純靜態(tài)分析，無需事先編譯，構建項目，極速生成
• 支持Java泛型，遞歸，繼承等寫法
• 支持不同框架的混合使用
• 完全支持標準Javadoc注釋
• 完全支持枚舉類型

參數說明

• -p，指定需要生成文檔的Java項目根目錄，文檔默認會生成在項目文件夾內
• -o，指定導出的文檔格式，目前已支持?markdown
• -c，指定?evalon4j.json?配置文件位置，通常用不著

配置文件

你可以在項目根目錄下提供一份?evalon4j.json?配置文件，運行時會自動讀取。

{
  "name": "", // 項目名稱
  
  "author": "whitecoms0s_", // 項目維護者
  
  "version": "1.0", // 文檔版本，默認為1.0
  
  "includedServices": [], // 需要導出的服務名稱或全名，白名單
  
  "excludedServices": [], // 需要過濾的服務名稱或全名，黑名單
  
  "dependencies": [], // 項目依賴的源碼包路徑列表，(規(guī)劃中)
  
  "onlyHttpApi": false, // 僅導出HTTP接口
  
  "onlyJavaApi": false, // 僅導出RPC接口
  
  "locale": "zh", // en 或 zh，會覆蓋系統(tǒng)語言設置，沒有該字段默認使用系統(tǒng)語言設置
}