Mention bean's order in Client-Level Exception Handlers

[glebshalyganov]

Mention that custom Client-Level Exception Handlers should implement Spring’s Ordered interface or contain the Order annotation to override handlers defined in the platform. Similar explanation presents here (in the last paragraph).

Every code sample of a class with the @Component annotation should be extended with the @Order annotation. For example:

package com.company.demo.web;

import com.haulmont.cuba.gui.Notifications;
import com.haulmont.cuba.gui.exception.AbstractUiExceptionHandler;
import org.springframework.stereotype.Component;
import javax.annotation.Nullable;

@Component("demo_ZeroBalanceExceptionHandler")
public class ZeroBalanceExceptionHandler extends AbstractUiExceptionHandler {

    public ZeroBalanceExceptionHandler() {
        super(ZeroBalanceException.class.getName());
    }
....

should be changed to:

package com.company.demo.web;

import com.haulmont.cuba.gui.Notifications;
import com.haulmont.cuba.gui.exception.AbstractUiExceptionHandler;
import org.springframework.stereotype.Component;
import org.springframework.core.annotation.Order;
import javax.annotation.Nullable;

@Component("demo_ZeroBalanceExceptionHandler")
@Order(UiExceptionHandler.HIGHEST_PLATFORM_PRECEDENCE - 10)
public class ZeroBalanceExceptionHandler extends AbstractUiExceptionHandler {

    public ZeroBalanceExceptionHandler() {
        super(ZeroBalanceException.class.getName());
    }
....

Environment

• Documentation version: from ? to latest
• Part of the documentation: Manual
• Existing page: https://doc.cuba-platform.com/manual-latest/exceptionHandlers.html