بسته های کتابخانه و کلاس های کلیدی

برای آشنایی با کلاس های متداول، به کلاس های کلیدی مراجعه کنید.

برای آشنایی با بسته های کتابخانه جاوا منبع داده پیوندهای زیر را دنبال کنید:

کلاس های کلیدی

کلاس های کلیدی عبارتند از DataSourceServlet , DataTable , Query و DataSourceHelper .

ساده‌ترین پیاده‌سازی کتابخانه شامل ارث بردن از 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 ابزاری برای فرار از رشته ها ارائه می دهد.

util

این بسته دو مجموعه از توابع کمکی را ارائه می دهد:

  • CsvDataSourceHelper و CsvDataSourceException توابع کمکی را برای استفاده از یک فایل CSV به عنوان ذخیره داده ارائه می دهند، آنها اجرای کامل یک منبع داده را ارائه نمی دهند. برای اجرای نمونه، به استفاده از یک فروشگاه داده خارجی مراجعه کنید.
  • SqlDataSourceHelper و SqlDatabaseDescription توابع کمکی را برای استفاده از پایگاه داده mySQL به عنوان یک ذخیره داده ارائه می دهند، آنها اجرای کامل یک منبع داده را ارائه نمی دهند. برای اجرای نمونه، SqlDataSourceServlet را در بسته examples ببینید.