时间戳

首页 > 解决方案 > 让 picocli 解析本地日期格式

localdate - 让 picocli 解析本地日期格式

问题描述

picocli 接受 2019-04-26 作为 Localdate 变量的输入，但它不接受德语日期格式 26.04.2019。
为此，您需要：

SimpleDateFormat 格式 = new SimpleDateFormat("dd.MM.yyyy",Locale.GERMANY);

你如何告诉 picocli 使用这个格式化程序而不依赖于美国日期输入？

标签： localdatepicocli

解决方案

您可以为特定选项定义自定义类型转换器，也可以为特定类型的所有选项和位置参数全局定义。

注册自定义转换器的最简洁方式通常是使用 lambda 表达式：

new CommandLine(new DateFormatDemo())
      .registerConverter(Date.class,
                         s -> new SimpleDateFormat("dd.MM.yyyy", Locale.GERMANY).parse(s))
      .execute(args);

如果您需要为特定选项设置转换器，则需要定义一个类并在@Option(converter = X.class)该选项的注释中指定该类。

ITypeConverter.convert请注意，如果用户输入无效，则可以从方法中引发异常。Picocli 将捕获此异常并向最终用户显示错误消息。

例如：

class StrictGermanDateConverter implements ITypeConverter<Date> {
    @Override
    public Date convert(String value) throws Exception {
        Date result = new SimpleDateFormat("dd.MM.yyyy", Locale.GERMANY).parse(value);
        if (result.getYear() < 0) {
            throw new IllegalArgumentException("year should be after 1900");
        }
        return result;
    }
}

这是一个使用这个更严格的转换器来演示的示例：

  • 错误检查
  • java.util.Date为所有选项注册一个全局类型转换器
  • 无效输入导致 picocli 显示错误消息，后跟使用帮助消息
import picocli.CommandLine;
import picocli.CommandLine.Command;
import picocli.CommandLine.ITypeConverter;
import picocli.CommandLine.Model.CommandSpec;
import picocli.CommandLine.Option;
import picocli.CommandLine.Spec;

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.List;
import java.util.Locale;

@Command(name = "demo")
public class DateFormatDemo implements Runnable {

    @Option(names = {"-d", "--date"}, description = "Date in German format `dd.MM.yyyy`",
            converter = StrictGermanDateConverter.class, paramLabel = "dd.MM.yyyy")
    Date specialDate;

    @Option(names = {"-x", "--default"}, paramLabel = "yyyy-MM-dd",
            description = "This option uses the default converter")
    Date defaultDate;

    @Spec CommandSpec spec;

    public void run() {
        List<String> args = spec.commandLine().getParseResult().originalArgs();
        System.out.printf("%s -> %s; %s%n", args, specialDate, defaultDate);
    }

    public static void main(String[] args) {

        // invalid input: shows error message and usage help
        new CommandLine(new DateFormatDemo()).execute("-d=55.55.55");

        // alternatively, register a global converter
        // for _all_ Date options
        new CommandLine(new DateFormatDemo())
              .registerConverter(Date.class,
                   s -> new SimpleDateFormat("MMM.dd.yyyy", Locale.ITALIAN).parse(s))
              .execute("-d=31.07.1969", "--default=Gennaio.01.2020");
    }
}

输入无效的第一次调用-d=55.55.55会打印以下输出：

Invalid value for option '--date': cannot convert '55.55.55' to Date (java.lang.IllegalArgumentException: year should be after 1900)
Usage: demo [-d=dd.MM.yyyy] [-x=yyyy-MM-dd]
  -d, --date=dd.MM.yyyy      Date in German format `dd.MM.yyyy`
  -x, --default=yyyy-MM-dd   This option uses the default converter

第二次调用，我们通过其中--default=Gennaio.01.2020确认全局类型转换器现在以我们的自定义意大利语格式处理日期，给出以下输出：

[-d=31.07.1969, --default=Gennaio.01.2020] -> Thu Jul 31 00:00:00 JST 1969; Wed Jan 01 00:00:00 JST 2020

推荐阅读