توضّح هذه الصفحة كيفية استخدام أو تعديل مكتبة 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 لمصدر البيانات على التبعيات التالية. تم اختبار المكتبة باستخدام النُسخ المدرَجة، ومن الممكن أن تكون النُسخ الأخرى مقبولة ولكن لم يتم اختبارها.
مضمّنة في المصدر أو عملية التنزيل:
- icu4j الإصدار 4.0.1.
- Jakarta Commons lang الإصدار 2.4.
- الإصدار 1.1.1 من تسجيل Jakarta المشترك
- الإصدار 1.0 من مكتبة مجموعات Google.
- javacc الإصدار 4.2. يُرجى العلم أنّ هذا الإجراء مطلوب فقط إذا كنت تريد تجميع المكتبات، مثلاً عند تعديلها على النحو الموضّح أدناه.
- opencsv الإصدار 1.8. هذا الإجراء مطلوب فقط إذا كنت تنوي استخدام مصدر بيانات بتنسيق CSV.
غير مضمّنة في المصدر أو عملية التنزيل:
- لاستخدام فئة
SqlDataSourceHelper
مع قاعدة بيانات mySQL، ستحتاج أيضًا إلىmysql.jar
في بيئة التشغيل. يمكنك الانتقال إلى http://www.mysql.com/products/connector/j/ للحصول على التفاصيل والإصدارات القابلة للتنزيل.
استخدام المكتبة على النحو المقدَّم
يصف هذا القسم كيفية استخدام مكتبة Java للمرئيات إذا لم تكن بحاجة إلى تعديلها. تختلف هذه العملية باختلاف نظام التصميم:
في حال استخدام Maven، يمكنك إعداد اعتمادية على مكتبة العروض المرئية باستخدام الإعدادات التالية:
- رقم تعريف المجموعة: com.google.visualization
- رقم تعريف العنصر: مصدر بيانات التصور
- رقم الإصدار: استخدِم أحدث رقم إصدار مُدرَج في صفحة المشروع.
في حال استخدام أي نظام إصدار آخر:
- نزِّل ملف ZIP للمكتبة من صفحة المشروع، وفُكّ ضغط الملفات، ثم ضمِّنها في مشروعك حسب ما يتطلبه نظام التصميم.
عرض الأمثلة
يتم تضمين أمثلة ملفات JAR مع ملفات JAR للمكتبة في ملف ZIP القابل للتنزيل. تتوفر تعليمات حول عرض الأمثلة في صفحة البدء.
تعديل المكتبة
إذا أردت تعديل رمز المكتبة، عليك تنزيل المصدر من الموقع الإلكتروني المفتوح المصدر المضيف وإنشاءه. قبل إجراء ذلك، يُرجى الاطّلاع على معلومات الترخيص المرتبطة بقسم "ترخيص الرمز" في صفحة المشروع لمعرفة ما إذا كانت حالة الاستخدام مسموحًا بها.
في ما يلي خطوات تنزيل المكتبة وإنشاؤها:
- نزِّل رمز المصدر باستخدام SVN، كما هو موضَّح في علامة التبويب المصدر > الدفع في صفحة المشروع المفتوح المصدر.
- إنشاء الرمز الخاص بك: في حال إنشاء ملف في Maven، استخدِم ملف pom.xml المقدَّم مع المصدر. عند إنشاء الرمز باستخدام Apache Ant، يُرجى اتّباع التعليمات الواردة في ما يلي (يُرجى العلم أنّه تم اختبار الرمز باستخدام الإصدار 1.7.0 من Ant، وإذا كان لديك إصدار سابق من Ant، قد تحتاج إلى ترقيته).
تعليمات بناء النمل
1. تعديل خصائص الإصدار:
- انتقِل إلى الدليل الفرعي
build-src
في دليل التثبيت الذي اخترته. - باستخدام محرِّر نصوص، افتح ملف
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 لطلب الإذن والاطّلاع على تعليمات حول كيفية إرسال التغييرات.