بدء استخدام مصادر البيانات

يقدّم هذا القسم ترميز SimpleExampleServlet، وهو أبسط مثال على تنفيذ مصدر بيانات يتم توفيره مع المكتبة. يقدّم هذا القسم أيضًا تعليمات مفصّلة حول كيفية تشغيل SimpleExampleServlet واختباره.

نقدّم لك SimpleExampleServlet

توجد الفئة SimpleExampleServlet في الحزمة examples. تقدّم هذه الفئة مثالاً على أبسط تنفيذ لمصدر بيانات. SimpleExampleServlet يكتسَب من DataSourceServlet ويتم تنفيذه generateDataTable()، ويجب تشغيله ضمن حاوية موفّر.

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

// This example extends DataSourceServlet
public class SimpleExampleServlet extends DataSourceServlet {

  @Override
  public DataTable generateDataTable(Query query, HttpServletRequest request) {
    // Create a data table,
    DataTable data = new DataTable();
    ArrayList cd = new ArrayList();
    cd.add(new ColumnDescription("name", ValueType.TEXT, "Animal name"));
    cd.add(new ColumnDescription("link", ValueType.TEXT, "Link to wikipedia"));
    cd.add(new ColumnDescription("population", ValueType.NUMBER, "Population size"));
    cd.add(new ColumnDescription("vegeterian", ValueType.BOOLEAN, "Vegetarian?"));

    data.addColumns(cd);

    // Fill the data table.
    try {
      data.addRowFromValues("Aye-aye", "http://en.wikipedia.org/wiki/Aye-aye", 100, true);
      data.addRowFromValues("Sloth", "http://en.wikipedia.org/wiki/Sloth", 300, true);
      data.addRowFromValues("Leopard", "http://en.wikipedia.org/wiki/Leopard", 50, false);
      data.addRowFromValues("Tiger", "http://en.wikipedia.org/wiki/Tiger", 80, false);
    } catch (TypeMismatchException e) {
      System.out.println("Invalid type!");
    }
    return data;
  }
}

قيد التشغيل والاختبار SimpleExampleServlet

يقدّم هذا القسم تعليمات حول كيفية تشغيل واختبار SimpleExampleServlet.

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

لتشغيل SimpleExampleServlet واختباره، يمكنك إنشاء تطبيق ويب يشغّل مصدر بيانات SimpleExampleServlet، ثم شغِّل مثالاً على صفحة ويب بالتمثيل البصري الذي يعرض البيانات التي تم الاستعلام عنها من مصدر البيانات. يتم وصف هذا في الأقسام التالية:

إنشاء تطبيق ويب على Apache Tomcat

اتّبِع التعليمات التالية أو عدِّلها لإنشاء تطبيق ويب على Apache Tomcat. هذه التعليمات مخصّصة لنظام Apache Tomcat على نظام التشغيل Windows:

  1. انتقِل إلى الدليل الذي تم فيه تثبيت Tomcat. تمت كتابة هذا المحتوى في هذا المستند باسم <tomcat_home>.
     
  2. انتقِل إلى الدليل الفرعي webapps.
     
  3. أنشئ دليلًا فرعيًا باسم myWebApp.
     
  4. غيِّر إلى الدليل الفرعي الذي أنشأته للتو وأنشئ دليلاً فرعيًا آخر باسم WEB-INF.
     
  5. غيِّر إلى الدليل الفرعي WEB-INF وأنشئ دليلًا فرعيًا آخر باسم lib.
    يجب أن يكون المسار الكامل هو <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
     
  6. نسخ web.xml من <data_source_library_install>/examples/src/html إلى الدليل WEB-INF حيث يكون <data_source_library_install> هو الدليل الذي تم فيه تثبيت مكتبة مصدر البيانات. تحدّد الأسطر التالية في web.xml والخريطة SimpleExampleServlet:
    <servlet>
  <servlet-name>My Servlet</servlet-name>
  <description>My servlet description.</description>
  <servlet-class>SimpleExampleServlet</servlet-class>
</servlet>

<servlet-mapping>
  <servlet-name>My Servlet</servlet-name>
  <url-pattern>/simpleexample</url-pattern>
</servlet-mapping>
  7. انتقِل إلى الدليل الذي تم فيه تثبيت مكتبة مصدر البيانات. تمت كتابة هذا المستند في <data_source_library_install> باسم.
     
  8. انسخ جميع حزمات الاعتمادية إلى <tomcat_home>/webapps/myWebApp/WEB-INF/lib. يتم تثبيت الحِزم في <data_source_library_install>/lib، ما لم يتم وضعها في دليل مختلف.
     
  9. إذا كنت قد أنشأت المكتبة بنفسك، انسخ visualization-datasource-1.0.2.jar وvisualization-datasource-examples.jar
    من <data_source_library_install>/build
    إلى <tomcat_home>/webapps/myWebApp/WEB-INF/lib.

    في حال فكّ ضغط ملف ZIP، انسخ visualization-datasource-1.0.2.jar وvisualization-datasource-examples.jar
    من <data_source_library_install>
    إلى <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
    تجدر الإشارة إلى أن رقم الإصدار في اسم ملف Jar قد يختلف بناءً على أحدث إصدار.
  10. افتح Tomcat، أو أعِد تشغيل Tomcat إذا كان قيد التشغيل.
     
  11. انقر على الرابط التالي:

    http://localhost:8080/myWebApp/Simpleexample

    تعرض الشاشة نصًا مكوّنًا من 6 إلى 7 أسطر حسب عرض الشاشة.
    يبدأ النص بـ google.visualization.Query.setResponse
    وينتهي بـ /Tiger'},{v:80.0},{v:false}]}]}});

    هذه هي البيانات التي يعرضها مصدر بياناتك في تمثيل بصري لطلب البحث.

استخدام التمثيل البصري لعرض البيانات

يمكن استخدام الملف getting_started.html في الدليل <data_source_library_install>/examples/src/html لعرض تمثيل مرئي للبيانات. يحدد السطر التالي، المأخوذ من getting_started.html، سيرفل للاستخدام. تم إعداد عملية ربط سيرفل في الخطوة 8 من إنشاء تطبيق ويب على Apache Tomcat.

var query = new google.visualization.Query('simpleexample');

لمزيد من المعلومات حول كيفية تحديد التمثيل البصري واستخدام لغة طلب البحث، راجِع استخدام الرسوم البيانية ومرجع لغة طلبات البحث.

اتّبِع التعليمات التالية أو عدِّلها لعرض تمثيل مرئي للبيانات التي يوفّرها مصدر البيانات:

  1. انسخ ملف getting_started.html من الدليل <data_source_library_install>/examples/src/html
    إلى الدليل <tomcat_home>/webapps/myWebApp/.
     
  2. انقر على الرابط التالي http://localhost:8080/myWebApp/Get_begin.html، من المفترض أن يظهر لك ما يلي:



    That's إنه! تم إعداد مصدر البيانات الأول لك.

الخطوات التالية

يوضّح المثال التالي في قسم استخدام متجر بيانات خارجي. يمكنك بدلاً من ذلك الرجوع إلى المقدمة أو استكشاف الروابط التالية: