مكتبة Java لمصدر البيانات - حول هذا الدليل
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يصف هذا الدليل كيفية استخدام مكتبة مصدر بيانات مؤثرات عرض التصور من Google لتنفيذ مصدر بيانات.
يوفر هذا الدليل قسم البرنامج التعليمي البدء
بعد المفاهيم الواردة في المقدمة.
يتيح لك هذا النهج إنشاء مصدر بيانات بسيط واختباره باستخدام التصور. الأقسام الأخرى للبرنامج التعليمي هي استخدام مخزن بيانات خارجي وتحديد الإمكانيات وتدفق الأحداث، واللذين يتناولان عمليات تنفيذ أكثر تعقيدًا. واستنادًا إلى متطلباتك، قد لا تحتاج إلى إكمال البرامج التعليمية الثلاثة جميعها، ولكن يُنصح بإكمال قسم البدء على الأقل.
وتساعدك الأقسام الأخرى من الدليل في تعزيز معرفتك.
المحتويات
الجمهور
يجب أن تكون على دراية بـ Java وتكنولوجيا Java
serlet لاستخدام المكتبة.
تحتاج أيضًا إلى فهم كيفية استخدام الرسوم البيانية، ومع ذلك، من المفيد أن تكون على دراية بالبروتوكول السلكي الخاص بواجهة برمجة التطبيقات Google Visualization API ولغة طلب البحث.
نظرة عامة على الدليل
يحتوي هذا الدليل على الأقسام التالية:
- المقدمة
يقدم المكتبة، ويوفر نظرة عامة على كيفية عمل
مصدر البيانات.
- التركيب
تصف المتطلبات الأساسية والتبعيات للمكتبة وكيفية تنزيل التعليمات البرمجية المصدر وإنشائها.
- البدء
يقدم SimpleExampleServlet. يُعد SimpleExampleServlet أبسط مثال على التنفيذ الذي يتم توفيره مع المكتبة.
يوفّر هذا القسم أيضًا تعليمات مفصّلة حول كيفية تشغيل واختبار SimpleExampleServlet.
- استخدام مخزن بيانات خارجي
يقدم CsvDataSourceServlet. CsvDataSourceServlet هو مثال على عملية تنفيذ تستخدم ملف CSV كمخزن بيانات خارجي.
يوفّر هذا القسم أيضًا تعليمات مفصّلة حول كيفية تشغيل واختبار CsvDataSourceServlet.
- تحديد الإمكانات وتدفق الأحداث
يقدم AdvancedExampleServlet2. يُعد AdvancedExampleServlet2
مثالاً على تنفيذ يحدد الإمكانات وتدفق
الأحداث. يوفّر هذا القسم أيضًا تعليمات مفصّلة حول كيفية تشغيل واختبار AdvancedExampleServlet2.
- التعامل مع الأمان والأخطاء والتحذيرات والتسجيل
يصف كيفية تأمين مصدر البيانات الخاص بك
وكيفية التعامل مع الأخطاء والتحذيرات والتسجيل.
- نصائح التنفيذ
توفر معلومات ستساعدك في كتابة عمليات تنفيذ أكثر
تعقيدًا للمكتبة.
- حِزم
المكتبة والفئات الرئيسية
توفر مقدمة عالية المستوى لحزم المكتبة وفئاتها
الرئيسية.
أمثلة على المراجع السريعة
يتم تزويد المكتبة بستة أمثلة لعمليات التنفيذ. يتم وصف ثلاثة منها في هذا الدليل، بينما لم يتم وصفها الأخرى. سيساعدك
الجدول التالي في العثور على
مثال لنوع السلوك الذي تريد تنفيذه.
للحصول على معلومات حول مشروع مكتبة مصدر البيانات، يُرجى الاطّلاع على الصفحة
الرئيسية.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-07-10 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-07-10 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide explains how to use the Google Visualization Data Source Library to create custom data sources for interactive charts using Java and Java Servlet technology.\u003c/p\u003e\n"],["\u003cp\u003eIt includes tutorials on basic setup, using external data stores like CSV files, and defining advanced capabilities like custom event flows.\u003c/p\u003e\n"],["\u003cp\u003eThe guide assumes familiarity with Java, Java Servlets, Google Charts and optionally, the Google Visualization API wire protocol and query language.\u003c/p\u003e\n"],["\u003cp\u003eSeveral example implementations are provided, including \u003ccode\u003eSimpleExampleServlet\u003c/code\u003e, \u003ccode\u003eCsvDataSourceServlet\u003c/code\u003e, and \u003ccode\u003eAdvancedExampleServlet2\u003c/code\u003e, each demonstrating different features of the library.\u003c/p\u003e\n"],["\u003cp\u003eFor more details on the project and its source code, refer to the project's home page.\u003c/p\u003e\n"]]],[],null,["# Data Source Java Library - About This Guide\n\nThis Guide describes how to use the Google Visualization Data Source\nLibrary to implement a data source.\n\nThis guide provides a [Getting Started](/chart/interactive/docs/dev/dsl_get_started) tutorial\nsection after the concepts in the [Introduction](/chart/interactive/docs/dev/dsl_intro).\nThis approach lets you create a simple data source and test it using a\nvisualization. The other tutorial sections are [Using\nan External Data Store](/chart/interactive/docs/dev/dsl_csv) and [Defining\nCapabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet), which cover more complex\nimplementations. Depending on your requirements, you might not need to\ncomplete all three tutorials, though it is recommended that you at least\ncomplete the [Getting Started](/chart/interactive/docs/dev/dsl_get_started) section.\nThe other sections of the guide help you to build on your knowledge.\n\nContents\n--------\n\n- [Audience](#audience)\n- [Guide Overview](#overview)\n- [Examples Quick Reference](#quick)\n- [More Information](#more)\n\nAudience\n--------\n\nYou need to be familiar with [Java](http://www.java.com/) and [Java\nservlet technology](http://java.sun.com/products/servlet/overview.html) to use the library.\n\nYou also need to understand [how to\nuse charts](/chart/interactive/docs), and though not essential, it is helpful to be familiar\nwith the Google Visualization API [wire\nprotocol](/chart/interactive/docs/dev/implementing_data_source#requestformat), and the [query\nlanguage](/chart/interactive/docs/querylanguage).\n\nGuide Overview\n--------------\n\nThis guide contains the following sections:\n\n- [Introduction](/chart/interactive/docs/dev/dsl_intro)\n\n\n Introduces the library, providing an overview of how a data source\n works.\n- [Installation](/chart/interactive/docs/dev/dsl_install)\n\n\n Describes the library's prerequisites and dependencies, and how to download\n and build the source code.\n- [Getting Started](/chart/interactive/docs/dev/dsl_get_started)\n\n Introduces `SimpleExampleServlet`. `SimpleExampleServlet` is\n the simplest example implementation that is provided with the library.\n This section also provides step-by-step instructions on how to run and\n test `SimpleExampleServlet`.\n- [Using an External Data Store](/chart/interactive/docs/dev/dsl_csv)\n\n Introduces `CsvDataSourceServlet`. `CsvDataSourceServlet` is\n an example implementation that uses a CSV file as an external data store.\n This section also provides step-by-step instructions on how to run and\n test `CsvDataSourceServlet`.\n- [Defining Capabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet)\n\n Introduces `AdvancedExampleServlet2`. `AdvancedExampleServlet2` is\n an example implementation that defines capabilities and flow\n of events. This section also provides step-by-step instructions on how\n to run and test `AdvancedExampleServlet2`.\n- [Handling Security, Errors, Warnings,\n and Logging](/chart/interactive/docs/dev/dsl_errors_and_logging)\n\n Describes how to make your data source secure,\n and how to handle errors, warnings, and logging.\n- [Implementation Tips](/chart/interactive/docs/dev/dsl_key_concepts)\n\n Provides information that will help you write more complex implementations\n of the library.\n- [Library\n Packages and Key Classes](/chart/interactive/docs/dev/dsl_packages)\n\n Provides a high level introduction to the library's packages and key\n classes.\n\nExamples Quick Reference\n------------------------\n\nThe library is provided with six example implementations. Three of these\nare described in this Guide, the others are not. The following\ntable will help\nyou find an example of the type of behavior you want to implement.\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------|------------------|--------------------|--------------------|\n| **Example** | **Servlet extended** | **Capabilities** | **Flow of events** | **Source of data** |\n| [`SimpleExampleServlet`](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/SimpleExampleServlet.java) Described in [Getting Started](/chart/interactive/docs/dev/dsl_get_started) | `DataSourceServlet` | `NONE` | Default | Within class |\n| [CsvDataSourceServlet](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/CsvDataSourceServlet.java) Described in [Using an External Data Store](/chart/interactive/docs/dev/dsl_csv) | `DataSourceServlet` | `NONE` | Default | CSV file |\n| [`AdvancedExampleServlet2`](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/AdvancedExampleServlet2.java) Described in [Defining Capabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet) | `HttpServlet` | `SELECT` | Custom | Within class |\n| [SimpleExampleServlet2](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/SimpleExampleServlet2.java) Not described in this Guide | `HttpServlet` ` ` | `NONE` | Custom | Within class |\n| [AdvancedExampleServlet](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/AdvancedExampleServlet.java) Not described in this Guide | `DataSourceServlet` | `SELECT` | Default | Within class |\n| [SqlDataSourceServlet](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/SqlDataSourceServlet.java) Not described in this Guide | `DataSourceServlet` | `SQL` | Default | SQL database |\n\nMore Information\n----------------\n\nFor information on the Data Source Library project, see the [home\npage](http://code.google.com/p/google-visualization-java/)."]]
