ساده‌ترین پیاده‌سازی کتابخانه شامل ارث بردن از DataSourceServlet ، نوشتن پیاده‌سازی generateDataTable() خودتان و سپس اجرای آن در یک servlet است. این نوع پیاده سازی در قسمت Getting Started توضیح داده شده است.
کلاس DataTable ستون ها، انواع ستون ها، برچسب ها، شناسه ها و خصوصیات سفارشی جدول داده را تعریف می کند.
کلاس Query کلاس پایه برای پرس و جوهای داده است، یک پرس و جو ایجاد شده توسط تجسم را مدیریت می کند.
برای موارد استفاده پیچیده تر، کلاس کمکی DataSourceHelper مجموعه ای از توابع کمکی را ارائه می دهد. این نوع پیاده سازی در تعریف قابلیت ها و جریان رویدادها توضیح داده شده است.
datasource
این بسته سطح بالا است و شامل کلاس های API است که اکثر توسعه دهندگان منبع داده با آنها تعامل دارند.
همچنین در این سطح بالا، Capabilities قرار دارد که برای تعریف قابلیت‌های جستجوی منبع داده استفاده می‌شود.
base
این بسته شامل تمام کلاس هایی است که توسط بیش از یک بسته برای جلوگیری از وابستگی دایره ای بین بسته ها استفاده می شود. قابل توجه ترین موارد پیام های خطا در محلی پیش فرض انگلیسی ایالات متحده است. برای بین المللی کردن پیاده سازی خود، باید این پیام ها را ترجمه کنید.
datatable
این بسته شامل کلاس هایی است که ساختار جدول داده ها (ستون ها، ردیف ها، سلول ها) و عملکرد (درج، افزودن) را مدیریت می کند.
این بسته همچنین حاوی بسته value است که مقادیر و انواع ارزش های پشتیبانی شده توسط کتابخانه را مدیریت می کند. انواع مقادیر موجود در شمارش ValueType تعریف می شوند و عبارتند از: بولی، تاریخ، زمان روز، تاریخ و زمان، تهی، عدد و متن.
query
این بسته شامل کلاس هایی است که پرس و جوها را مدیریت می کنند، کلاس پایه Query است. این بسته شامل بسته های زیر نیز می باشد:
parser - کلاس هایی که تجزیه پرس و جو را مدیریت می کنند.
engine - کلاس هایی که اجرای پرس و جو را مدیریت می کنند.
scalarfunction - کلاس هایی که توابع اسکالر مورد استفاده در یک پرس و جو را مدیریت می کنند.
render
این بسته شامل کلاس هایی است که یک پاسخ را فرمت می کنند. مثلا:
CsvRenderer یک جدول داده را به صورت CSV ارائه می کند.
HtmlRenderer یک جدول داده را به صورت HTML ارائه می کند.
JsonRenderer یک جدول داده را به صورت JSON ارائه می کند.
EscapeUtil ابزاری برای فرار از رشته ها ارائه می دهد.
CsvDataSourceHelper و CsvDataSourceException توابع کمکی را برای استفاده از یک فایل CSV به عنوان ذخیره داده ارائه می دهند، آنها اجرای کامل یک منبع داده را ارائه نمی دهند. برای اجرای نمونه، به استفاده از یک فروشگاه داده خارجی مراجعه کنید.
SqlDataSourceHelper و SqlDatabaseDescription توابع کمکی را برای استفاده از پایگاه داده mySQL به عنوان یک ذخیره داده ارائه می دهند، آنها اجرای کامل یک منبع داده را ارائه نمی دهند. برای اجرای نمونه، SqlDataSourceServlet را در بسته examples ببینید.
تاریخ آخرین بهروزرسانی 2024-07-10 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2024-07-10 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis library enables developers to connect their data to Google Visualization charts using Java.\u003c/p\u003e\n"],["\u003cp\u003eKey classes include \u003ccode\u003eDataSourceServlet\u003c/code\u003e, \u003ccode\u003eDataTable\u003c/code\u003e, \u003ccode\u003eQuery\u003c/code\u003e, and \u003ccode\u003eDataSourceHelper\u003c/code\u003e for building data source implementations.\u003c/p\u003e\n"],["\u003cp\u003eThe library provides packages for data source management (\u003ccode\u003edatasource\u003c/code\u003e), base functionalities (\u003ccode\u003ebase\u003c/code\u003e), data table structure (\u003ccode\u003edatatable\u003c/code\u003e), query handling (\u003ccode\u003equery\u003c/code\u003e), response formatting (\u003ccode\u003erender\u003c/code\u003e), and utility functions (\u003ccode\u003eutil\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage helper functions for CSV and SQL data stores through \u003ccode\u003eCsvDataSourceHelper\u003c/code\u003e and \u003ccode\u003eSqlDataSourceHelper\u003c/code\u003e, respectively.\u003c/p\u003e\n"],["\u003cp\u003eFor simple implementations, inherit from \u003ccode\u003eDataSourceServlet\u003c/code\u003e and implement \u003ccode\u003egenerateDataTable()\u003c/code\u003e; for complex cases, use \u003ccode\u003eDataSourceHelper\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Library Packages and Key Classes\n\nFor an introduction to the most commonly used classes, see [key\nclasses](#keyclasses).\n\nFor an introduction to the data source Java library packages follow\nthe links below:\n\n- [datasource](#datasource \"datasource\")\n- [datasource.base](#base)\n- [datasource.datatable](#datatable)\n- [datasource.query](#query)\n- [datasource.render](#render)\n- [datasource.util](#util)\n\nKey Classes\n-----------\n\nThe key classes are [DataSourceServlet](https://code.google.com/p/google-visualization-java/source/browse/trunk/src/main/java/com/google/visualization/datasource/DataSourceServlet.java), [DataTable](https://code.google.com/p/google-visualization-java/source/browse/trunk/src/main/java/com/google/visualization/datasource/datatable/DataTable.java),\n[Query](https://code.google.com/p/google-visualization-java/source/browse/trunk/src/main/java/com/google/visualization/datasource/query/Query.java) and [DataSourceHelper](https://code.google.com/p/google-visualization-java/source/browse/trunk/src/main/java/com/google/visualization/datasource/DataSourceHelper.java).\n\nThe simplest implementation of the library involves inheriting from `DataSourceServlet`,\nwriting your own implementation of `generateDataTable()` and\nthen running the implementation within a servlet. This type of implementation\nis described in the [Getting\nStarted](/chart/interactive/docs/dev/dsl_get_started) section.\n\nThe `DataTable` class defines the columns, column types,\nlabels, ids, and custom properties for a data table.\n\nThe `Query` class is the base class for data queries, it\nhandles a visualization-generated query.\n\nFor more complex\nuse cases, the helper class `DataSourceHelper` provides\na set of helper functions. This type of implementation\nis described in [Defining Capabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet).\n\n`datasource`\n------------\n\nThis is the [top\nlevel package](http://code.google.com/p/google-visualization-java/source/browse/#svn/trunk/src/java/com/google/chart/interactive/datasource%3Fstate%3Dclosed) and contains the API classes with which\nmost data source developers interact.\n\nAlso at this top level is `Capabilities`, which is\nused to define the data source's query [capabilities](/chart/interactive/docs/dev/dsl_key_concepts#capabilities).\n\n\n`base`\n------\n\n[This\npackage](http://code.google.com/p/google-visualization-java/source/browse/#svn/trunk/src/java/com/google/chart/interactive/datasource/base) contains all classes that are used by more than one package\nto prevent circular dependencies between the packages. The most notable\nitems are error messages in the default locale of US English. To internationalize\nyour implementation, you will need to translate these messages.\n\n`datatable`\n-----------\n\n[This\npackage](http://code.google.com/p/google-visualization-java/source/browse/#svn/trunk/src/java/com/google/chart/interactive/datasource/datatable) contains classes that handle data table structure (columns,\nrows, cells) and functionality (insert, add).\n\nThis package also contains the `value` package that handles\nvalues and value types supported by the library. Available value types\nare defined in the `ValueType` enumeration and include: boolean,\ndate, time of day, date and time, null, number, and text.\n\n`query`\n-------\n\n[This\npackage](http://code.google.com/p/google-visualization-java/source/browse/#svn/trunk/src/java/com/google/chart/interactive/datasource/query) contains classes that handle queries, the base class is `Query`.\nThis package also contains the following packages:\n\n- `parser` - classes that handle query parsing. \n- `engine` - classes that handle query execution.\n- `scalarfunction` - classes that handle scalar functions used in a query.\n\n`render`\n--------\n\n[This\npackage](http://code.google.com/p/google-visualization-java/source/browse/#svn/trunk/src/java/com/google/chart/interactive/datasource/render) contains the classes that format a response. For example:\n\n- `CsvRenderer` renders a data table as CSV.\n- `HtmlRenderer` renders a data table as HTML.\n- `JsonRenderer` renders a data table as JSON.\n- `EscapeUtil` provides a utility to escape strings.\n\n`util`\n------\n\n[This\npackage](http://code.google.com/p/google-visualization-java/source/browse/#svn/trunk/src/java/com/google/chart/interactive/datasource/util) provides two sets of helper functions:\n\n- `CsvDataSourceHelper` and `CsvDataSourceException` provide helper functions for using a CSV file as a data store, they do not provide a complete implementation of a data source. For an example implementation, see [Using an External Data Store](/chart/interactive/docs/dev/dsl_csv).\n- `SqlDataSourceHelper` and `SqlDatabaseDescription` provide helper functions for using a mySQL database as a data store, they do not provide a complete implementation of a data source. For an example implementation, see `SqlDataSourceServlet` in the `examples` package."]]
