Java için Firebase Admin SDK'sının 7.0.0 sürümü, API'de bazı önemli değişiklikler içerir. Bu sürümdeki API değişiklikleri, temel olarak Authentication ve FCM için hata işleme ile ilgili eklemeler ve iyileştirmelerdir.
Hata işleme ile ilgili genel değişiklikler
FirebaseException temel sınıfı artık birkaç yeni özellik sunuyor:
ErrorCode getErrorCode(): İstisnayla ilişkili platform hata kodunu döndürür. HerFirebaseExceptionörneğinin boş olmayan bir platform hata kodu içereceği garanti edilir. Olası platform hata kodları, yeni bir enum türüErrorCodeolarak tanımlanır.IncomingHttpResponse getHttpResponse(): İstisnayla ilişkili HTTP yanıtını döndürür. İstisna, arka uç HTTP yanıtı dışında bir nedenden kaynaklanıyorsa boş olabilir.
Daha önce olduğu gibi, SDK'da tanımlanan diğer çoğu istisna türü (ör. FirebaseAuthException, FirebaseMessagingException) FirebaseException temel sınıfından türetilir.
Kimlik doğrulama hatası işleme değişiklikleri
FirebaseAuth sınıfındaki tüm API'ler FirebaseAuthException örnekleri oluşturabilir. Eşzamansız API'ler (örneğin, ApiFuture döndüren yöntemler), FirebaseAuthException sarmalayan bir ExecutionException ile başarısız olabilir. Auth'a özgü hata kodları, yeni enum türü AuthErrorCode içinde herkese açık olarak tanımlanır.
Önce (<= 6.15.0 sürümü)
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");
}
}
Şimdi (>= 7.0.0 sürümü)
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, temel FirebaseException türünden devralınan ErrorCode öğesine ek olarak sunulur. Gerekirse her iki hata kodunu da inceleyen bir hata işleme mantığı uygulayabilirsiniz.
FCM hata işleme değişikliği
FirebaseMessaging sınıfındaki tüm API'ler FirebaseMessagingException örnekleri oluşturabilir. Eşzamansız API'ler (örneğin, ApiFuture döndüren yöntemler), FirebaseMessagingException sarmalayan bir ExecutionException ile başarısız olabilir. Authentication ile ilgili hata kodları, yeni enum türü MessagingErrorCode içinde herkese açık olarak tanımlanmıştır.
Önce (<= 6.15.0 sürümü)
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");
}
}
Şimdi (>= 7.0.0 sürümü)
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, temel FirebaseException türünden devralınan ErrorCode öğesine ek olarak sunulur. Gerekirse her iki hata kodunu da inceleyen bir hata işleme mantığı uygulayabilirsiniz.
Authentication özel hak talebi
Desteği sonlandırılan FirebaseAuth.setCustomClaims() yöntemi kaldırıldı. Bunun yerine FirebaseAuth.setCustomUserClaims() politikasını kullanın.
Önce (<= 6.15.0 sürümü)
FirebaseAuth.getInstance().setCustomClaims(uid, claims);
Şimdi (>= 7.0.0 sürümü)
FirebaseAuth.getInstance().setCustomUserClaims(uid, claims);
FCM bildirim oluşturucu
Notification sınıfının desteği sonlandırılan kurucuları kaldırıldı. Yeni örnekler oluşturmak için Notification.Builder sınıfını kullanın.
Önce (<= 6.15.0 sürümü)
Notification notification = new Notification(title, body, url);
Şimdi (>= 7.0.0 sürümü)
Notification notification = Notification.builder()
.setTitle(title)
.setBody(body)
.setImage(url)
.build();