在Java里如何实现命令行待办事项工具_JavaList实战解析

秋丽大大_7573

秋丽大大_7573

2026-01-16

530人浏览

原创

推荐用 picocli 解析命令行参数,它通过注解自动处理帮助页、类型转换和错误提示;ArrayList 存任务足够,退出时用 JSON 持久化;日期用自定义转换器支持多格式输入,存储统一为 ISO 格式;输出用 printf 保证对齐。

在java里如何实现命令行待办事项工具_javalist实战解析

命令行参数解析用 args 还是第三方库?

Java 原生 main(String[] args) 能跑,但一碰到 --add "买牛奶" 或 -l --due 2024-12-31 就容易写成一堆 if-else 和索引越界。硬解析不光难维护,还容易漏掉空值、引号嵌套、短选项合并(如 -al)等边界情况。

推荐直接用 picocli——它通过注解绑定参数,自动处理帮助页、类型转换、错误提示,且单文件可运行(无依赖冲突):

@Command(name = "todo", mixinStandardHelpOptions = true)
public class TodoApp implements Runnable {
  @Option(names = {"-a", "--add"}, description = "添加待办事项")
  String addText;

  @Option(names = {"-l", "--list"}, description = "列出所有事项")
  boolean list;

  @Option(names = {"--due"}, description = "按截止日期过滤,格式:yyyy-MM-dd")
  LocalDate dueDate;

  public void run() {
    if (addText != null) {
      addItem(addText);
    } else if (list) {
      listItems(dueDate);
    }
  }
}

启动时只需:

new CommandLine(new TodoApp()).execute(args);

ArrayList 存任务够用吗?要不要加线程安全或持久化?

纯命令行工具首次启动没状态,ArrayList 完全够用——增删查都是 O(1) 或 O(n),几十条任务毫无压力。别一上来就上 ConcurrentHashMap 或数据库,Java 启动慢、I/O 拖累体验。

但必须考虑两个现实问题:

  • TodoItem 类至少得有 id(自增)、text、done、createdAt、dueDate 字段,否则排序/过滤没法做
  • 退出前不保存,下次启动就丢数据——用 Files.write(Paths.get("todo.json"), jsonBytes) 写本地文件最轻量;避免用 ObjectOutputStream(二进制不兼容、不可读)

日期输入怎么校验和存储才不踩坑?

用户输 --due 2024/12/31 或 --due 31-12-2024 是常态,不能靠 LocalDate.parse() 硬扛。picocli 支持自定义类型转换器:

static class LocalDateConverter implements ITypeConverter<localdate> {
  public LocalDate convert(String value) throws Exception {
    for (String pattern : Arrays.asList("yyyy-MM-dd", "yyyy/MM/dd", "dd-MM-yyyy")) {
      try {
        return LocalDate.parse(value, DateTimeFormatter.ofPattern(pattern));
      } catch (DateTimeParseException ignored) {}
    }
    throw new IllegalArgumentException("无法解析日期: " + value);
  }
}</localdate>

然后在字段上声明:

Java开发手册免费版
Java开发手册免费版

Java 开发规约速查手册,覆盖命名、异常、并发、数据库等 7 大维度核心规范。

下载
@Option(names = "--due", converter = LocalDateConverter.class) LocalDate dueDate;

存储一律用 ISO 格式("2024-12-31"),避免时区和解析歧义;显示时再按用户习惯格式化。

为什么输出用 System.out.printf 而不是字符串拼接?

列表要对齐(ID、状态、文字、日期),比如:

 1 [ ] 买牛奶                 2024-12-31
 2 [x] 整理代码库             —

手动拼空格极易错位,尤其中文字符占位不一致。printf 的宽度控制可靠得多:

System.out.printf("%2d [%s] %-20s %s%n",
  item.getId(),
  item.isDone() ? "x" : " ",
  item.getText(),
  item.getDueDate() != null ? item.getDueDate() : "—");

注意:%-20s 左对齐占 20 位,%2d 右对齐占 2 位,%n 是跨平台换行符——别用 \n,Windows 下会显示异常。

真正麻烦的是中文对齐:Java 默认等宽字体下,一个中文 ≈ 两个英文宽度,但 printf 按字符数算。如果需求严格对齐,得先用 StringUtils.length()(Apache Commons)估算显示宽度,再动态补空格——多数 CLI 工具选择妥协,靠左对齐+固定缩进而非绝对列对齐。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java js json windows apache stream yy

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2375

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3922

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1296

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4559

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

7679

3

printf用法大全
printf用法大全

php中文网为大家提供printf用法大全,以及其他printf函数的相关文章、相关下载资源以及各种相关课程,供大家免费下载体验。

2023.06.20

968

5

fprintf和printf的区别
fprintf和printf的区别

fprintf和printf的区别在于输出的目标不同,printf输出到标准输出流,而fprintf输出到指定的文件流。根据需要选择合适的函数来进行输出操作。更多关于fprintf和printf的相关文章详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.28

1029

10

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1958

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3244

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习