帮助选项

Spring Shell 有一个内置的 help 命令,但并非所有人都喜欢从中获取命令帮助,因为您始终需要使用目标命令的参数来调用它。 在许多 cli 框架中,每个命令都带有 --help-h 选项来打印命令帮助是很常见的。

默认功能是每个命令都将修改为具有 --help-h 选项,如果给定命令中存在这些选项,无论键入了哪些其他命令行选项,它都会自动将命令执行短路到现有 help 命令。

下面的示例显示了其默认设置。

@Bean
CommandRegistration commandRegistration() {
	return CommandRegistration.builder()
		.command("mycommand")
		.withHelpOptions()
			.enabled(true)
			.longNames("help")
			.shortNames('h')
			.command("help")
			.and()
		.build();
}

可以通过配置选项更改默认行为。

spring:
  shell:
    help:
      enabled: true
      long-names: help
      short-names: h
      command: help
以编程方式或通过注解定义的命令将自动添加帮助选项。 使用注解模型,您只能全局关闭这些选项,编程模型提供了修改每个命令的设置的选项。