تثبيت مكتبة جافا مصدر البيانات

توضّح هذه الصفحة كيفية استخدام أو تعديل مكتبة Java لمؤثرات عرض التصور من Google، وكيفية المساهمة في الرمز البرمجي مفتوح المصدر للمشروع.

المحتويات

المتطلبات

يجب أن تتوفر لديك المكونات التالية لاستخدام مكتبة Java لمؤثرات عرض التصور من Google:

  • حاوية serlet والإصدار 2.4 من واجهة برمجة تطبيقات مهنتيف أو أحدث. وتُعد Apache Tomcat إحدى حاويات Servicelet الأكثر استخدامًا، والتي تشمل واجهة برمجة التطبيقات Servicelet API. راجِع http://tomcat.apache.org/download-55.cgi لتنزيل البرنامج الثنائي للإصدار 5.5. يجب تثبيت الوحدة الأساسية فقط. عليك أيضًا الانتقال إلى Tomcat لإكمال الأقسام التعليمية التالية: البدء واستخدام مخزن البيانات الخارجية وتحديد الإمكانات وتدفق الأحداث.
  • الإصدار 6.0 من مجموعة أدوات تطوير Java أو الإصدارات الأحدث.

    ملاحظة: من الممكن أيضًا استخدام الإصدار 5.0 من JDK. ومع ذلك، يجب بعد ذلك إزالة @Override من كل طريقة في المكتبة تلغي إحدى طرق الواجهة. ويرجع ذلك إلى التغيير في سلوك التعليق التوضيحي @Override في الإصدار 6.0 من JDK.

التبعيات

تحتوي مكتبة Java لمصدر البيانات على التبعيات التالية. تم اختبار المكتبة باستخدام النُسخ المدرَجة، ومن الممكن أن تكون النُسخ الأخرى مقبولة ولكن لم يتم اختبارها.

مضمّنة في المصدر أو عملية التنزيل:

غير مضمّنة في المصدر أو عملية التنزيل:

  • لاستخدام فئة SqlDataSourceHelper مع قاعدة بيانات mySQL، ستحتاج أيضًا إلى mysql.jar في بيئة التشغيل. يمكنك الانتقال إلى http://www.mysql.com/products/connector/j/ للحصول على التفاصيل والإصدارات القابلة للتنزيل.

استخدام المكتبة على النحو المقدَّم

يصف هذا القسم كيفية استخدام مكتبة Java للمرئيات إذا لم تكن بحاجة إلى تعديلها. تختلف هذه العملية باختلاف نظام التصميم:

في حال استخدام Maven، يمكنك إعداد اعتمادية على مكتبة العروض المرئية باستخدام الإعدادات التالية:

  • رقم تعريف المجموعة: com.google.visualization
  • رقم تعريف العنصر: مصدر بيانات التصور
  • رقم الإصدار: استخدِم أحدث رقم إصدار مُدرَج في صفحة المشروع.

في حال استخدام أي نظام إصدار آخر:

  • نزِّل ملف ZIP للمكتبة من صفحة المشروع، وفُكّ ضغط الملفات، ثم ضمِّنها في مشروعك حسب ما يتطلبه نظام التصميم.

عرض الأمثلة

يتم تضمين أمثلة ملفات JAR مع ملفات JAR للمكتبة في ملف ZIP القابل للتنزيل. تتوفر تعليمات حول عرض الأمثلة في صفحة البدء.

تعديل المكتبة

إذا أردت تعديل رمز المكتبة، عليك تنزيل المصدر من الموقع الإلكتروني المفتوح المصدر المضيف وإنشاءه. قبل إجراء ذلك، يُرجى الاطّلاع على معلومات الترخيص المرتبطة بقسم "ترخيص الرمز" في صفحة المشروع لمعرفة ما إذا كانت حالة الاستخدام مسموحًا بها.

في ما يلي خطوات تنزيل المكتبة وإنشاؤها:

  1. نزِّل رمز المصدر باستخدام SVN، كما هو موضَّح في علامة التبويب المصدر > الدفع في صفحة المشروع المفتوح المصدر.
  2. إنشاء الرمز الخاص بك: في حال إنشاء ملف في Maven، استخدِم ملف pom.xml المقدَّم مع المصدر. عند إنشاء الرمز باستخدام Apache Ant، يُرجى اتّباع التعليمات الواردة في ما يلي (يُرجى العلم أنّه تم اختبار الرمز باستخدام الإصدار 1.7.0 من Ant، وإذا كان لديك إصدار سابق من Ant، قد تحتاج إلى ترقيته).

تعليمات بناء النمل

‫1. تعديل خصائص الإصدار:

  1. انتقِل إلى الدليل الفرعي build-src في دليل التثبيت الذي اخترته.
  2. باستخدام محرِّر نصوص، افتح ملف build.properties وأدخِل التغييرات التالية:
    • عدِّل السمة servlet-api.jar للإشارة إلى ملف servlet-api.jar. على سبيل المثال، في حال تثبيت Tomcat في محرك الأقراص c: في الدليل tomcat_home، عليك تحديد السمة servlet-api.jar على النحو التالي:
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      ملاحظة: استخدِم الشرطات المائلة للأمام بدلاً من الشرطات المائلة للخلف في مسار الملف، حتى عند استخدام نظام التشغيل Windows

    • لاستخدام نُسخك الخاصة من الموارد الاعتمادية الموضّحة أعلاه، عدِّل المسارات في ملف Build.properties نفسه.

2. إنشاء المكتبة:

انتقِل إلى الدليل الفرعي build-src في الملف واكتب أحد ما يلي:

  • ant datasource - إنشاء مكتبة مصادر البيانات
  • ant example - إنشاء الأمثلة
  • ant - ينشئ مصدر البيانات والأمثلة على حدّ سواء
  • ant test: إنشاء اختبارات مكتبة مصادر البيانات وتنفيذها وهو مفيد جدًا عند تعديل المكتبة.

المساهمة في مشروع البرامج المفتوحة المصدر

إذا كنت تريد المساهمة بإجراء تغييرات على المشروع المفتوح المصدر، يجب الحصول على أذونات إرسال المشروع. إرسال رسالة إلكترونية إلى google-visualization-api@googlegroups.com لطلب الإذن والاطّلاع على تعليمات حول كيفية إرسال التغييرات.