官方文檔
https://picocli.info/
官方提供的快速入門教程
https://picocli.info/quick-guide.html

使用 Picocli 創(chuàng)建命令行應(yīng)用程序

Picocli 是一個(gè)用于構(gòu)建 Java 命令行應(yīng)用的強(qiáng)大框架，它簡化了參數(shù)解析和幫助消息生成的過程。
下面是如何使用 Picocli 構(gòu)建簡單命令行程序的方法。

安裝依賴項(xiàng)

對(duì)于 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); }
}

• 創(chuàng)建一個(gè)實(shí)現(xiàn) Runnable 或 callable 的類。這是您的命令。
• 為類添加 @command 注解并為其命名。mixinstandardHelpOptions 屬性將 --help 和 --version 選項(xiàng)添加到您的應(yīng)用程序中。
• 對(duì)于應(yīng)用程序中的每個(gè)選項(xiàng)，添加 @Option 注解。此示例顯示了如何為選項(xiàng)提供名稱和描述，還有許多其他屬性。
• 對(duì)于每個(gè)位置的參數(shù)，添加 @Parameters 注解。
• Picocli 會(huì)將命令行參數(shù)轉(zhuǎn)換為強(qiáng)類型值，并將這些值注入到帶注解的字段中。
• 在類的 run 或者 call 方法中定義業(yè)務(wù)邏輯。解析成功完成后，將調(diào)用該方法。
• 在類的main 方法中，使用方法CommandLine.execute 執(zhí)行程序。 這將解析命令行、處理錯(cuò)誤、處理使用和版本幫助請(qǐng)求，并調(diào)用業(yè)務(wù)邏輯。
• CommandLine.execute System.exit 方法返回退出代碼。您的應(yīng)用程序可以使用此退出代碼進(jìn)行調(diào)用，以向調(diào)用進(jìn)程發(fā)出成功或失敗的信號(hào)。