官方文檔
https://picocli.info/
官方提供的快速入門教程
https://picocli.info/quick-guide.html
使用 Picocli 創建命令行應用程序
Picocli 是一個用于構建 Java 命令行應用的強大框架，它簡化了參數解析和幫助消息生成的過程。
下面是如何使用 Picocli 構建簡單命令行程序的方法。
安裝依賴項
對于 Maven 用戶來說，可以在 pom.xml 文件里加入如下配置
<!-- https://picocli.info -->
<dependency><groupId>info.picocli</groupId><artifactId>picocli</artifactId><version>4.7.5</version>
</dependency>
編寫主類
import picocli.CommandLine;
import picocli.CommandLine.Command;
import picocli.CommandLine.Option;
import picocli.CommandLine.Parameters;
// some exports omitted for the sake of brevity@Command(name = "ASCIIArt", version = "ASCIIArt 1.0", mixinStandardHelpOptions = true)
public class ASCIIArt implements Runnable { @Option(names = { "-s", "--font-size" }, description = "Font size") int fontSize = 19;@Parameters(paramLabel = "<word>", defaultValue = "Hello, picocli", description = "Words to be translated into ASCII art.")private String[] words = { "Hello,", "picocli" }; @Overridepublic void run() { // The business logic of the command goes here...// In this case, code for generation of ASCII art graphics// (omitted for the sake of brevity).}public static void main(String[] args) {int exitCode = new CommandLine(new ASCIIArt()).execute(args); System.exit(exitCode); }
}
- 創建一個實現 Runnable 或 callable 的類。這是您的命令。
- 為類添加 @command 注解并為其命名。mixinstandardHelpOptions 屬性將 --help 和 --version 選項添加到您的應用程序中。
- 對于應用程序中的每個選項，添加 @Option 注解。此示例顯示了如何為選項提供名稱和描述，還有許多其他屬性。
- 對于每個位置的參數，添加 @Parameters 注解。
- Picocli 會將命令行參數轉換為強類型值，并將這些值注入到帶注解的字段中。
- 在類的 run 或者 call 方法中定義業務邏輯。解析成功完成后，將調用該方法。
- 在類的main 方法中，使用方法CommandLine.execute 執行程序。 這將解析命令行、處理錯誤、處理使用和版本幫助請求，并調用業務邏輯。
- CommandLine.execute System.exit 方法返回退出代碼。您的應用程序可以使用此退出代碼進行調用，以向調用進程發出成功或失敗的信號。
)
