نصب کتابخانه جاوا منبع داده

این صفحه نحوه استفاده یا تغییر کتابخانه جاوای تجسم Google و نحوه مشارکت در کد منبع باز پروژه را شرح می دهد.

فهرست

الزامات

برای استفاده از کتابخانه جاوای Google Visualization باید اجزای زیر را داشته باشید:

  • یک ظرف servlet و Servlet API نسخه 2.4 یا بالاتر. یکی از پرکاربردترین کانتینرهای سرولت آپاچی تامکت است که شامل Servlet API می باشد. برای دانلود باینری نسخه 5.5 به http://tomcat.apache.org/download-55.cgi مراجعه کنید. فقط باید ماژول Core را نصب کنید. همچنین برای تکمیل بخش های آموزشی به Tomcat نیاز دارید: شروع به کار ، استفاده از فروشگاه داده های خارجی ، و تعریف قابلیت ها و جریان رویدادها .
  • کیت توسعه جاوا نسخه 6.0 یا بالاتر.

    توجه : امکان استفاده از JDK نسخه 5.0 نیز وجود دارد. با این حال، پس از آن باید @Override از هر روشی در کتابخانه که یک متد واسط را لغو می کند، حذف کنید. این به دلیل تغییر در رفتار حاشیه نویسی @Override در JDK نسخه 6.0 است.

وابستگی ها

کتابخانه منبع داده جاوا دارای وابستگی های زیر است. کتابخانه با نسخه های ذکر شده آزمایش شد. نسخه های دیگر ممکن است قابل قبول باشند، اما تست نشده اند.

موجود در منبع یا دانلود:

در منبع یا دانلود گنجانده نشده است:

  • برای استفاده از کلاس SqlDataSourceHelper با پایگاه داده mySQL، همچنین به mysql.jar در محیط زمان اجرا نیاز دارید. برای جزئیات و نسخه های قابل دانلود به http://www.mysql.com/products/connector/j/ مراجعه کنید.

استفاده از کتابخانه همانطور که ارائه شده است

این بخش نحوه استفاده از کتابخانه جاوای تجسم را در صورت عدم نیاز به تغییر آن توضیح می دهد. این فرآیند با سیستم ساخت شما متفاوت است:

اگر از Maven استفاده می کنید، یک وابستگی به کتابخانه تجسم با تنظیمات زیر تنظیم کنید:

  • شناسه گروه: com.google.visualization
  • شناسه مصنوع: تجسم-منبع داده
  • شماره نسخه: از آخرین شماره نسخه ذکر شده در صفحه پروژه استفاده کنید.

در صورت استفاده از هر سیستم ساخت دیگری :

اجرای نمونه ها

فایل‌های نمونه JAR همراه با JARهای کتابخانه در فایل ZIP قابل دانلود گنجانده شده‌اند. دستورالعمل‌های اجرای نمونه‌ها در صفحه شروع به کار آورده شده است.

اصلاح کتابخانه

اگر می خواهید کد کتابخانه را تغییر دهید، باید منبع را از سایت میزبان منبع باز دانلود کرده و آن را بسازید. قبل از انجام این کار، اطلاعات مجوز مرتبط با بخش "مجوز کد" را در صفحه پروژه بخوانید تا ببینید آیا مورد استفاده شما مجاز است یا خیر.

در اینجا مراحل دانلود و ساخت کتابخانه آمده است:

  1. همانطور که در برگه Source > Checkout در صفحه پروژه منبع باز توضیح داده شده است، کد منبع را با استفاده از SVN دانلود کنید .
  2. کد خود را بسازید در صورت ساخت در Maven، از فایل pom.xml ارائه شده با منبع استفاده کنید. اگر با Apache Ant می‌سازید، دستورالعمل‌های بعدی را دنبال کنید (توجه داشته باشید که کد با Ant نسخه 1.7.0 آزمایش شده است؛ اگر نسخه قبلی Ant دارید، ممکن است نیاز به ارتقا داشته باشید)

دستورالعمل ساخت مورچه

1. ویژگی های ساخت خود را اصلاح کنید:

  1. به زیر شاخه build-src دایرکتوری نصب انتخابی خود بروید.
  2. با استفاده از یک ویرایشگر متن، فایل 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

      توجه : از اسلش های جلو به جای اسلش های عقب در مسیر فایل استفاده کنید، حتی در هنگام استفاده از ویندوز

    • برای استفاده از کپی های خود از وابستگی های شرح داده شده در بالا، مسیرهای موجود در همان فایل build.properties را ویرایش کنید.

2. کتابخانه را بسازید:

زیر شاخه build-src را در فایل پیمایش کنید و یکی از موارد زیر را تایپ کنید:

  • ant datasource - کتابخانه منبع داده را می سازد
  • ant example - نمونه ها را می سازد
  • ant - هم منبع داده و هم نمونه ها را می سازد
  • ant test - تست های کتابخانه منبع داده را می سازد و اجرا می کند. زمانی که در حال تغییر کتابخانه هستید بسیار مفید است.

مشارکت در پروژه منبع باز

اگر می خواهید تغییراتی را در پروژه منبع باز ایجاد کنید، باید مجوزهای ارسال را برای پروژه دریافت کنید. یک ایمیل به google-visualization-api@googlegroups.com بفرستید و اجازه و دستورالعمل هایی در مورد نحوه ارسال تغییرات بخواهید.