class 方法的名称，特别是他们的方法

Question

我有一个 class 实现了几个接口。我在其他地方看到注释被用来指示哪个方法块属于哪个接口，例如：

public class MagicalAnimal implements InterfaceBark,
                                      InterfaceFly {
    // InterfaceBark
    public void barkQuietly() { }
    public void barkLoudly() { }

    // InterfaceFly
    public void moveWings() { }
    public void land() { }

    // ???
    public void shootLasers() {  }
    public void teleport() {  }
}

在列出未从任何接口实现但特定于 MyClass（在代码中表示为 // ???）的方法之前，我应该发表什么评论？

Answer 1

想放什么就放什么。我建议什么都不放。

这里最大的问题是 obsoletion of comments，假设你输入：

// Other

然后你决定有一个接口

public interface MagicPowers {
  public void shootLasers();
  public void teleport();
}

现在，除了添加界面（可以由 IDE).

大多数 IDE 能够轻松查看评论来自哪个界面；这些评论是没有必要的。

class 方法的名称，特别是他们的方法

Name for the methods of a class which are specifically theirs

oop

interface

conventions