短格式

ChatGPT-4o-mini 中英对照 Short Format

短格式 POSIX 选项通常只是长格式的同义词。如下所示，选项 --arg 等同于 -a。

Programmatic

CommandRegistration stringWithShortOption() {
	return CommandRegistration.builder()
		.command("example")
		.withTarget()
			.function(ctx -> {
				String arg = ctx.hasMappedOption("arg") ? ctx.getOptionValue("arg") : null;
				return String.format("Hi arg='%s'", arg);
			})
			.and()
		.withOption()
			.longNames("arg")
			.shortNames('a')
			.required()
			.and()
		.build();
}

java

Annotation

@Command(command = "example")
String stringWithShortOption(
		@Option(longNames = "arg", shortNames = 'a', required = true) String arg) {
	return String.format("Hi '%s'", arg);
}

java

Legacy Annotation

@ShellMethod(key = "example")
String stringWithShortOption(
		@ShellOption(value = { "--arg", "-a" }) String arg)		{
	return String.format("Hi '%s'", arg);
}

java

短选项与组合格式非常强大，如果类型被定义为标志，这意味着类型是一个 布尔值。这样你可以定义标志的存在为 -abc、-abc true 或 -abc false。

Programmatic

CommandRegistration multipleBooleans() {
	return CommandRegistration.builder()
		.command("example")
		.withTarget()
			.function(ctx -> {
				Boolean a = ctx.hasMappedOption("a") ? ctx.getOptionValue("a") : null;
				Boolean b = ctx.hasMappedOption("b") ? ctx.getOptionValue("b") : null;
				Boolean c = ctx.hasMappedOption("c") ? ctx.getOptionValue("c") : null;
				return String.format("Hi a='%s' b='%s' c='%s'", a, b, c);
			})
			.and()
		.withOption()
			.shortNames('a')
			.type(boolean.class)
			.defaultValue("false")
			.and()
		.withOption()
			.shortNames('b')
			.type(boolean.class)
			.defaultValue("false")
			.and()
		.withOption()
			.shortNames('c')
			.type(boolean.class)
			.defaultValue("false")
			.and()
		.build();
}

java

Annotation

@Command(command = "example")
public String multipleBooleans(
		@Option(shortNames = 'a') boolean a,
		@Option(shortNames = 'b') boolean b,
		@Option(shortNames = 'c') boolean c) {
	return String.format("Hi a='%s' b='%s' c='%s'", a, b, c);
}

java

Legacy Annotation

@ShellMethod(key = "example")
public String multipleBooleans(
		@ShellOption(value = "-a") boolean a,
		@ShellOption(value = "-b") boolean b,
		@ShellOption(value = "-c") boolean c)
{
	return String.format("Hi a='%s' b='%s' c='%s'", a, b, c);
}

java