构建器模式的 Eclipse 格式化程序设置

Question

我对一系列合格调用的 Eclipse 格式规则（即 Builder 模式样式）感到非常沮丧。例如，对于一些创建新的 Apache Commons CLI Options 对象的代码，这是我的首选格式：

  Options options = new Options()
      .addOption(OPTION_HELP_SHORT, OPTION_HELP, false, "print usage information")
      .addOption(OPTION_VERSION_SHORT, OPTION_VERSION, false,
          "print version and exit")
      .addOption(OptionBuilder.withLongOpt(OPTION_PROPERTIES)
                     .hasArg()
                     .withArgName("FILE")
                     .withType(File.class)
                     .withDescription("specify a user properties file")
                     .create());

即，如果需要，参数将被包装和缩进，并且除第一个之外的所有合格调用，除非必要，如果有多个，则被包装和缩进。如果参数列表包装在合格的调用中，则调用应首先包装。

Eclipse 中的默认格式（“仅在必要时包装”参数和调用）会产生以下混乱：

  Options options = new Options().addOption(
      OPTION_HELP_SHORT, OPTION_HELP, false, "print usage information")
      .addOption(OPTION_VERSION_SHORT, OPTION_VERSION, false,
          "print version and exit").addOption(
          OptionBuilder.withLongOpt(OPTION_PROPERTIES).hasArg().withArgName(
              "FILE").withType(File.class).withDescription(
              "specify a user properties file").create());

进入“Java 代码样式 -> 格式化程序 -> 换行”并将换行设置为“换行所有元素，如果不需要，则除第一个元素之外”以进行调用：

  Options options = new Options().addOption(
      OPTION_HELP_SHORT, OPTION_HELP, false, "print usage information")
      .addOption(OPTION_VERSION_SHORT, OPTION_VERSION, false,
          "print version and exit")
      .addOption(
          OptionBuilder.withLongOpt(OPTION_PROPERTIES).hasArg().withArgName(
              "FILE").withType(File.class).withDescription(
              "specify a user properties file").create());

我不喜欢 OptionBuilder 表达式没有被包装，或者 "FILE" 被包装而没有包装 withArgName。

将缩进更改为“列上缩进”会产生：

  Options options = new Options().addOption(OPTION_HELP_SHORT, OPTION_HELP,
                                     false, "print usage information")
                                 .addOption(OPTION_VERSION_SHORT,
                                     OPTION_VERSION, false,
                                     "print version and exit")
                                 .addOption(
                                     OptionBuilder.withLongOpt(
                                                      OPTION_PROPERTIES)
                                                  .hasArg()
                                                  .withArgName("FILE")
                                                  .withType(File.class)
                                                  .withDescription(
                                                      "specify a user properties file")
                                                  .create());

这打破了我更喜欢的界限，但把事情推到了右边太远了。

有什么方法可以说服 Eclipse 应用我喜欢的格式样式或比上述任何方法更接近它的格式？

Answer 1

用 cmets 关闭格式化，或者插入行 cmets 太繁琐了。

最好的方法描述here：

...或者您可以选择“换行>从不加入已换行 行”全局。然后，您可以手动打破它和格式化程序 只会在行内格式化（或添加额外的换行符，如果 必要）。

使用此设置，Eclipse 格式化程序将停止破坏您的构建器语句。

Answer 2

使用 cmets：

   Object o = foo() //
      .bar() //
      .toString();

Answer 3

在 Eclipse 3.6 中，可以关闭代码区域的格式设置。查看我对

的回答

How to turn off the Eclipse code formatter for certain sections of Java code?

Answer 4

AFAIK，这是 Eclipse 格式化程序的已知问题： https://bugs.eclipse.org/bugs/show_bug.cgi?id=59891

Answer 5

2021 年更新。 可以更改，导航至：代码样式 -> 格式化程序 -> 换行 -> 换行设置 -> 函数调用 -> 合格调用 并将值更改为“包装所有元素，如果不需要，第一个元素除外”

Answer 6

在菜单上选择 Window -> Preferences 当窗口打开时选择 Java -> Code Style -> Formatter，然后您可以通过选择新建或编辑选项创建自己的格式样式以使用。编辑格式配置文件时，会打开一个新窗口，其中提供了许多不同的选项供您使用。