За какво е необходима анотацията @CallSuper?

Забележката @CallSuper се използва, за да се посочи, че презаписаният метод (в подклас) трябва задължително да извика реализацията на метода от суперкласа.

Това е полезно в следните случаи:

• Състояние на суперкласа: Суперкласът може да инициализира или управлява важни състояния в своя метод. Извикването на @CallSuper гарантира, че това състояние ще бъде правилно обработено във всяка реализация в подкласите.
• Ресурси/Почистване: Суперкласът може да управлява ресурси или да извършва действия по почистване в своя метод. @CallSuper гарантира, че тези действия ще бъдат изпълнени дори при презаписване на метода.
• Договор за поведение: Анотацията указва договор, че реализацията на суперкласа е част от общото поведение, което трябва да бъде запазено в подкласите.

Пример за използване:

public class BaseActivity extends AppCompatActivity {

    @Override
    @CallSuper // Посочва, че onCreate() на суперкласа трябва да бъде извикан
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // Инициализация на основните компоненти
    }
}

public class MyActivity extends BaseActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState); // Задължителен извикване на метода на суперкласа
        // Допълнителна инициализация за MyActivity
    }
}

Важно е да се отбележи, че @CallSuper е инструкция за инструментите за анализ на код (като Lint), а не задължително изискване на ниво компилация. Инструментите ще издадат предупреждение, ако метод, маркиран с @CallSuper, бъде презаписан без да се извика super().