Effective Java! Consistently Use the Override Annotation

Effective Java Review (90 Part Series)

In our previous chapter we discussed creating annotations which was a lot of fun but not something that a lot of developers will find themselves doing on a day-to-day basis. Today we discuss something that you will interact with much more often. That is the @Override annotation. This annotation is quite simple but will help avoid some bugs and push detection of some of our defects to compile-time versus later in the process. To illustrate the point let us consider the following example:

public class Bigram {
  private final char first;
  private final char second;

  public Bigram(char first, char second) {
    this.first = first;
    this.second = second;
  }

  public boolean equals(Bigram b) {
    return b.first == first && b.second == second;
  }

  public hashcode() {
    return 31 * first + second;
  }

  public static void main(String[] args) {
    Set<Bigram> s = new HashSet<>();
    for (int i = 0; i < 10; i++) {
      for (char ch = 'a'; ch <= 'z'; ch++) {
        s.add(new Bigram(ch, ch));
      }
    }
    System.out.println(s.size());
  }
}

Enter fullscreen mode Exit fullscreen mode

This code loops through the lowercase alphabet and adds two of the same character as Bigram to a set. It repeats this operation ten times. Seeing as it’s doing the same thing over and over and putting the results in the set and duplicates can’t be put into a set you would likely expect the size to be 26 but it actually ends up with 260 elements. Can you spot why the duplicates were allowed to be inserted? The author of this code surely intended to override the base class Object‘s equals function but unfortunately messed up the signature. This is because the author ended up overriding the equals function not overriding it. To override it the function needs to take an Object not a Bigram.

This is where the @Override annotation can come in use. If the author of the code would have put this annotation on the method at compile time the compiler would have thrown an error saying there wasn’t a method to override.

During the initial compilation is where you do get most of the benefit of the @Override annotation; however, it still can be of use beyond that. Your IDE can also use this information to add information to your code and help you develop in a safe manner. Finally, it can be used as a matter of communication with future developers of what methods are being overriden and which ones are not.

In summary, when we override a function we should always annotate it with the @Override annotation. This will give you better safety and documentation of the classes you write.

Effective Java Review (90 Part Series)

原文链接：Effective Java! Consistently Use the Override Annotation

文章版权声明 1、本网站名称：拾光赋
2、本站永久网址：https://www.blogs.ink
3、本网站的文章部分内容可能来源于网络，仅供大家学习与参考，如有侵权，请联系站长QQ：805375623进行删除处理。
4、本站一切资源不代表本站立场，并不代表本站赞同其观点和对其真实性负责。
5、本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
6、本站资源大多存储在云盘，如发现链接失效，请联系我们我们会第一时间更新。

THE END