小技巧：为 Eclipse 设置链式调用的代码格式化（Formatter）

你的名字 2021-05-10 11:33 556阅读 0赞

本篇主要分享一个小技巧：为 Eclipse 设置链式调用的代码格式化（Formatter）。

首先，我们要明白什么是链式调用，来看代码：

AccountParam.builder().uid(uid).url(AccountParam.hongbao_url).type("红包");

一个方法后面紧跟另外一个方法，之所以可以链式调用，是因为方法的返回类型是一致的。

明白了链式调用以后，你会发现一个问题，在 Eclipse 的默认代码格式化环境中，链式调用代码会挤在一行，看起来很痛苦。

另外，《阿里巴巴 Java 开发手册》中也明确规定：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9xaW5nbWlhb2d1LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70][]

也就是说，我们需要调整 Eclipse 默认的代码格式化——在按下「Ctrl + Shift + F」后，编辑器能够自动将链式调用代码换行。怎么办呢？

在 Eclipse 中按照以下顺序打开代码格式化的配置项：

Windows → Preferences → Java → Code Style → Formatter

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9xaW5nbWlhb2d1LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 1][]  
选择「New…」新建一个格式化的配置。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9xaW5nbWlhb2d1LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 2][]

关键的配置项如下：

1、Maximum line width：120「一行最大宽度，120」（超过 120 就自动换行）

2、Function Calls → Qualified Invocations「方法调用 → xxxxx」

其中 line wrapping policy 「换行策略」选择：

wrap all elements, except first element if not necessary「第一个元素可以不换行，其他都换行」

并且勾选复选框 force split, even if line shorter than maximum line width「强制换行，即使该行没有达到最大换行的宽度」

这样设置后，Eclipse 就能够为链式调用的代码自动换行了。效果如下图。  
![20190515142956593.png][]  
不过，这样的换行效果仍然不够理想，如果换行策略优化为：

wrap all elements, except second element if not necessary「前两个元素可以不换行，其他都换行」

这样就更好了。

--------------------

![format_png][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9xaW5nbWlhb2d1LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70]: /images/20210506/2c8a89241c044c2ca831a1d70587d3f3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9xaW5nbWlhb2d1LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 1]: /images/20210506/924aae857b3344e382d1ec30bfb401cf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9xaW5nbWlhb2d1LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 2]: /images/20210506/aa2dff458dce4893afab2be652e47b95.png
[20190515142956593.png]: /images/20210506/6d2aa67d5c2e4dc2ae13e0601e284668.png
[format_png]: /images/20210506/62b4268b6e6f47a49df12326ec34d725.png