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

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

المحتويات

  1. المتطلبات
  2. العناصر التابعة
  3. استخدام المكتبة كما هي مُقدَّمة
  4. تنفيذ الأمثلة
  5. تعديل المكتبة
  6. المساهمة في مشروع برنامج مفتوح المصدر

المتطلبات

يجب أن يكون لديك المكوّنات التالية حتى تتمكّن من استخدام مكتبة جافا للتمثيل البصري في Google:

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

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

البلدان التابعة

تحتوي مكتبة جافا مصدر البيانات على التبعيات التالية. تم اختبار المكتبة مع الإصدارات المدرجة، وقد تكون الإصدارات الأخرى مقبولة ولكن لم يتم اختبارها.

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

غير مدرَج في المصدر أو التنزيل:

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

استخدام المكتبة كما هي متوفرة

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

في حال استخدام Maven، يمكنك إعداد تبعية لمكتبة التمثيل البصري باستخدام الإعدادات التالية:

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

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

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

تنفيذ الأمثلة

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

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

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

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

  1. نزِّل رمز المصدر باستخدام SVN، كما هو موضّح في علامة التبويب المصدر > Checkout في صفحة المشروع المفتوح المصدر.
  2. إنشاء الرمز: في حالة البناء في Maven، استخدم ملف pom.xml المتوفر مع المصدر. في حال البناء باستخدام Apache Ant، اتّبِع التعليمات الواردة في ما يلي (تجدر الإشارة إلى أنّه تم اختبار الرمز باستخدام الإصدار Ant الإصدار 1.7.0، وإذا كان لديك إصدار سابق من 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-visibleization-api@googlegroups.com لطلب الإذن والتعليمات حول كيفية إرسال التغييرات.