В версии 7.0.0 Firebase Admin SDK для Java внесены некоторые важные изменения в API. В основном изменения в API в этом выпуске – это дополнения и улучшения в обработке ошибок для Authentication и FCM.
Общие изменения в обработке ошибок
В базовом классе FirebaseException теперь есть несколько новых атрибутов:
ErrorCode getErrorCode()– возвращает код ошибки платформы, связанный с исключением. Каждый экземплярFirebaseExceptionгарантированно имеет ненулевой код ошибки платформы. Возможные коды ошибок платформы определяются как новый тип перечисленияErrorCode.IncomingHttpResponse getHttpResponse()– возвращает HTTP-ответ, связанный с исключением. Может быть нулевым, если исключение было вызвано не HTTP-ответом от сервера.
Как и раньше, большинство других типов исключений, определенных в SDK (например, FirebaseAuthException, FirebaseMessagingException), являются производными от базового класса FirebaseException.
Изменения в обработке ошибок аутентификации
Все API в классе FirebaseAuth могут вызывать экземпляры FirebaseAuthException. Асинхронные API (например, методы, возвращающие ApiFuture) могут завершаться ошибкой ExecutionException, которая содержит FirebaseAuthException. Коды ошибок, связанные с аутентификацией, общедоступны и определены в новом типе перечисления AuthErrorCode.
До (версия 6.15.0 и более ранние)
try {
FirebaseAuth.getInstance().verifyIdToken(idToken, true);
} catch (FirebaseAuthException ex) {
if (ex.getErrorCode().equals("id-token-revoked")) {
System.err.println("ID token has been revoked");
} else {
System.err.println("ID token is invalid");
}
}
Сейчас (>= v7.0.0)
try {
FirebaseAuth.getInstance().verifyIdToken(idToken, true);
} catch (FirebaseAuthException ex) {
if (ex.getAuthErrorCode() == AuthErrorCode.REVOKED_ID_TOKEN) {
System.err.println("ID token has been revoked");
} else {
System.err.println("ID token is invalid");
}
}
AuthErrorCode дополняет ErrorCode, унаследованный от базового типа FirebaseException. При необходимости вы можете реализовать логику обработки ошибок, которая проверяет оба кода ошибки.
Изменения в обработке ошибок: FCM
Все API в классе FirebaseMessaging могут вызывать экземпляры FirebaseMessagingException. Асинхронные API (например, методы, возвращающие ApiFuture) могут завершаться ошибкой ExecutionException, которая содержит FirebaseMessagingException. Коды ошибок, относящиеся к Authentication, публично определены в новом типе перечисления MessagingErrorCode.
До (версия 6.15.0 и более ранние)
try {
FirebaseMessaging.getInstance().send(message);
} catch (FirebaseMessagingException ex) {
if (ex.getErrorCode().equals("registration-token-not-registered")) {
System.err.println("Device token has been unregistered");
} else {
System.err.println("Failed to send the notification");
}
}
Сейчас (>= v7.0.0)
try {
FirebaseMessaging.getInstance().send(message);
} catch (FirebaseMessagingException ex) {
if (ex.getMessagingErrorCode() == MessagingErrorCode.UNREGISTERED) {
System.err.println("Device token has been unregistered");
} else {
System.err.println("Failed to send the notification");
}
}
MessagingErrorCode дополняет ErrorCode, унаследованный от базового типа FirebaseException. При необходимости вы можете реализовать логику обработки ошибок, которая проверяет оба кода ошибки.
Authentication настраиваемых утверждений
Удален устаревший метод FirebaseAuth.setCustomClaims(). Используйте вместо него FirebaseAuth.setCustomUserClaims().
До (версия 6.15.0 и более ранние)
FirebaseAuth.getInstance().setCustomClaims(uid, claims);
Сейчас (>= v7.0.0)
FirebaseAuth.getInstance().setCustomUserClaims(uid, claims);
FCM конструктор уведомлений
Удалены устаревшие конструкторы класса Notification. Для создания новых экземпляров используйте класс Notification.Builder.
До (версия 6.15.0 и более ранние)
Notification notification = new Notification(title, body, url);
Сейчас (>= v7.0.0)
Notification notification = Notification.builder()
.setTitle(title)
.setBody(body)
.setImage(url)
.build();