المهلات والأخطاء

يصف هذا المستند كيفية تعيين المُهلات والتعامل مع أخطاء HTTP التي قد يتلقاها الرمز الخاص بك عند استخدام مكتبة برامج Google API للغة Java.

الفهرس

ضبط المُهلات

في المثال التالي الذي يستخدم واجهة برمجة تطبيقات "إحصاءات Google"، يتم استخدام الطريقتَين setConnectTimeout وsetReadTimeout لضبط مهلات الاتصال والقراءة على ثلاث دقائق (بالمللي ثانية) لجميع الطلبات:

private HttpRequestInitializer setHttpTimeout(final HttpRequestInitializer requestInitializer) {
  return new HttpRequestInitializer() {
    @Override
    public void initialize(HttpRequest httpRequest) throws IOException {
      requestInitializer.initialize(httpRequest);
      httpRequest.setConnectTimeout(3 * 60000);  // 3 minutes connect timeout
      httpRequest.setReadTimeout(3 * 60000);  // 3 minutes read timeout
    }
  };

GoogleCredential credential = ....

final Analytics analytics = Analytics.builder(new NetHttpTransport(), jsonFactory, setHttpTimeout(credential)).build();

التعامل مع استجابات خطأ HTTP من Google APIs

عندما يتم رصد رمز حالة خطأ في استجابة HTTP لواجهة برمجة تطبيقات من Google تستخدم تنسيق JSON، تعرض المكتبات التي تم إنشاؤها الخطأ GoogleJsonResponseException.

تستخدم الأخطاء التنسيق المحدّد في الردود على الأخطاء.

يوضّح المثال التالي إحدى الطرق التي يمكنك من خلالها التعامل مع هذه الاستثناءات:

Drive.Files.List listFiles = drive.files.list();
try {
  FileList response = listFiles.execute();
  ...
} catch (GoogleJsonResponseException e) {
  System.err.println(e.getDetails());
}