Java Admin SDK v7-এ মাইগ্রেট করা

Java-এর জন্য Firebase অ্যাডমিন SDK-এর 7.0.0 ভার্সন API-তে কিছু গুরুত্বপূর্ণ পরিবর্তন নিয়ে এসেছে। প্রাথমিকভাবে, এই রিলিজে API-তে করা পরিবর্তনগুলি হল Authentication এবং FCM-এর জন্য সমস্যা সমাধানের ক্ষেত্রে নতুন কিছু যোগ করা এবং উন্নতি করা।

সাধারণ সমস্যা ম্যানেজ করা সংক্রান্ত পরিবর্তন

FirebaseException মূল ক্লাস এখন বেশ কিছু নতুন অ্যাট্রিবিউট দেখায়:

  • ErrorCode getErrorCode(): ব্যতিক্রমের সাথে সম্পর্কিত প্ল্যাটফর্মের সমস্যার কোড রিটার্ন করে। FirebaseException-এর প্রতিটি ইনস্ট্যান্সে নন-নাল প্ল্যাটফর্ম এরর কোড থাকবেই। সম্ভাব্য প্ল্যাটফর্মের ত্রুটি কোডগুলি একটি নতুন enum টাইপ ErrorCode হিসাবে সংজ্ঞায়িত করা হয়েছে।
  • IncomingHttpResponse getHttpResponse(): ব্যতিক্রমের সাথে যুক্ত HTTP রেসপন্স ফিরিয়ে দেয়। ব্যতিক্রমটি ব্যাকএন্ড HTTP রেসপন্স ছাড়া অন্য কোনও কারণে হলে, এটি খালি থাকতে পারে।

আগের মতোই, SDK-তে উল্লেখ করা অন্যান্য বেশিরভাগ ব্যতিক্রমের ধরন (যেমন, FirebaseAuthException, FirebaseMessagingException) FirebaseException মূল ক্লাস থেকে নেওয়া হয়েছে।

যাচাইকরণ সংক্রান্ত সমস্যা ম্যানেজ করার ক্ষেত্রে পরিবর্তন

FirebaseAuth ক্লাসের সব API, FirebaseAuthException-এর ইনস্ট্যান্স থ্রো করতে পারে। Async API (যেমন, যেসব পদ্ধতি ApiFuture রিটার্ন করে) ExecutionException-এর সাথে কাজ নাও করতে পারে যা FirebaseAuthException-কে র‍্যাপ করে। Auth-নির্দিষ্ট ত্রুটি কোডগুলি নতুন enum টাইপ AuthErrorCode-এ সর্বজনীনভাবে সংজ্ঞায়িত করা হয়েছে।

আগে (<= v6.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 হল বেস FirebaseException টাইপ থেকে উত্তরাধিকার সূত্রে প্রাপ্ত ErrorCode-এর অতিরিক্ত। প্রয়োজন হলে, আপনি সমস্যা সমাধানের লজিক প্রয়োগ করতে পারেন যা দুটি এরর কোডই পরীক্ষা করে দেখে।

FCMটি সমস্যা ম্যানেজ করার পরিবর্তন

FirebaseMessaging ক্লাসের সব API, FirebaseMessagingException-এর ইনস্ট্যান্স থ্রো করতে পারে। Async API (যেমন, যেসব পদ্ধতি ApiFuture রিটার্ন করে) ExecutionException-এর সাথে কাজ নাও করতে পারে যা FirebaseMessagingException-কে র‍্যাপ করে। Authentication-নির্দিষ্ট ত্রুটি কোডগুলি নতুন enum টাইপ MessagingErrorCode-এ সর্বজনীনভাবে সংজ্ঞায়িত করা হয়েছে।

আগে (<= v6.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() ব্যবহার করুন।

আগে (<= v6.15.0)

FirebaseAuth.getInstance().setCustomClaims(uid, claims);

এখন (>= v7.0.0)

FirebaseAuth.getInstance().setCustomUserClaims(uid, claims);

FCMটি বিজ্ঞপ্তি কনস্ট্রাক্টর

Notification ক্লাসের ডেপ্রিকেটেড কনস্ট্রাক্টর সরিয়ে দেওয়া হয়েছে। নতুন ইনস্ট্যান্স তৈরি করতে Notification.Builder ক্লাস ব্যবহার করুন।

আগে (<= v6.15.0)

Notification notification = new Notification(title, body, url);

এখন (>= v7.0.0)

Notification notification = Notification.builder()
  .setTitle(title)
  .setBody(body)
  .setImage(url)
  .build();