Zum Java Admin SDK v7 migrieren

Version 7.0.0 des Firebase Admin SDK für Java enthält einige wichtige Änderungen an der API. Die API-Änderungen in dieser Version sind hauptsächlich Ergänzungen und Verbesserungen bei der Fehlerbehandlung für Authentication und FCM.

Allgemeine Änderungen bei der Fehlerbehandlung

Die Basisklasse FirebaseException enthält jetzt mehrere neue Attribute:

• ErrorCode getErrorCode(): Gibt den Plattformfehlercode zurück, der mit der Ausnahme verknüpft ist. Jede Instanz von FirebaseException hat garantiert einen Plattformfehlercode, der nicht null ist. Mögliche Plattformfehlercodes sind als neuer Enum-Typ ErrorCode definiert.
• IncomingHttpResponse getHttpResponse(): Gibt die HTTP-Antwort zurück, die mit der Ausnahme verknüpft ist. Kann null sein, wenn die Ausnahme nicht durch eine HTTP-Antwort des Back-Ends verursacht wurde.

Wie bisher werden die meisten anderen im SDK definierten Ausnahmetypen (z. B. FirebaseAuthException, FirebaseMessagingException) von der Basisklasse FirebaseException abgeleitet.

Änderungen bei der Fehlerbehandlung für Authentication

Alle APIs in der Klasse FirebaseAuth können Instanzen von FirebaseAuthException auslösen. Asynchrone APIs (z. B. Methoden, die ein ApiFuture zurückgeben) können mit einer ExecutionException fehlschlagen, die eine FirebaseAuthException umschließt. Die Authentication-spezifischen Fehlercodes sind öffentlich im neuen Enum-Typ AuthErrorCode definiert.

Vorher (<= Version 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");
  }
}

Jetzt (>= Version 7.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");
  }
}

Der AuthErrorCode kommt zusätzlich zum ErrorCode hinzu, der vom Basis FirebaseException Typ übernommen wurde. Sie können eine Fehlerbehandlungslogik implementieren, die bei Bedarf beide Fehlercodes prüft.

Änderungen bei der Fehlerbehandlung für FCM

Alle APIs in der Klasse FirebaseMessaging können Instanzen von FirebaseMessagingException auslösen. Asynchrone APIs (z. B. Methoden, die ein ApiFuture zurückgeben) können mit einer ExecutionException fehlschlagen, die eine FirebaseMessagingException umschließt. Die Authentication-spezifischen Fehlercodes sind öffentlich im neuen Enum-Typ MessagingErrorCode definiert.

Vorher (<= Version 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");
  }
}

Jetzt (>= Version 7.0.0)

try {
  FirebaseMessaging.getInstance().send(message);
}