java – 返回这里有什么问题？

在我工作的公司,我有一个描述我们应该遵循 Java 的良好做法的文档.其中一个是避免返回此类的方法,例如：

class Properties {

  public Properties add(String k, String v) {
   //store (k,v) somewhere
     return this;
  }

}

我会有一个这样的课程,以便我能写：

properties.add("name", "john").add("role","swd"). ...

我已经看到这样的成语很多次,像在StringBuilder中,并没有发现任何错误.

他们的论证是：

… can be the source of synchronization problems or failed expectations about the states of target objects. 

我不能想到一个这样可能是真实的情况,你们能给我一个例子吗？

编辑该文档没有指定任何可变性,所以我没有看到链接通话和做的不同之处：

properties.add("name", "john");
properties.add("role", "swd");

我会尝试与发起者联系,但是我想用加载的枪支这样做,这就是为什么我发布了这个问题.

解决：我要和其中一位作者交谈,他的初衷是显然是为了避免发布尚未准备就绪的对象,就像在Builder模式中一样,并解释说如果调用之间发生上下文切换,那么对象可能在无效状态.我认为这与返回这无关,因为你可能会犯同样的错误,一个接一个地调用这些方法,并且与正确同步建筑过程有关.他承认文件可能更加明确,并将尽快修改.胜利是我/我们的！