این صفحه نحوه استفاده یا تغییر کتابخانه جاوای تجسم 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 است.
وابستگی ها
کتابخانه منبع داده جاوا دارای وابستگی های زیر است. کتابخانه با نسخه های ذکر شده آزمایش شد. نسخه های دیگر ممکن است قابل قبول باشند، اما تست نشده اند.
موجود در منبع یا دانلود:
- icu4j نسخه 4.0.1.
- جاکارتا زبان مشترک نسخه 2.4.
- جاکارتا عوام ورود به سیستم نسخه 1.1.1.
- نسخه 1.0 کتابخانه مجموعه های گوگل .
- javacc نسخه 4.2. این فقط در صورتی لازم است که شما قصد دارید کتابخانه ها را کامپایل کنید، به عنوان مثال هنگام تغییر آنها همانطور که در زیر توضیح داده شده است.
- opencsv نسخه 1.8. این فقط در صورتی لازم است که قصد استفاده از منبع داده CSV را دارید.
در منبع یا دانلود گنجانده نشده است:
- برای استفاده از کلاس
SqlDataSourceHelper
با پایگاه داده mySQL، همچنین بهmysql.jar
در محیط زمان اجرا نیاز دارید. برای جزئیات و نسخه های قابل دانلود به http://www.mysql.com/products/connector/j/ مراجعه کنید.
استفاده از کتابخانه همانطور که ارائه شده است
این بخش نحوه استفاده از کتابخانه جاوای تجسم را در صورت عدم نیاز به تغییر آن توضیح می دهد. این فرآیند با سیستم ساخت شما متفاوت است:
اگر از Maven استفاده می کنید، یک وابستگی به کتابخانه تجسم با تنظیمات زیر تنظیم کنید:
- شناسه گروه: com.google.visualization
- شناسه مصنوع: تجسم-منبع داده
- شماره نسخه: از آخرین شماره نسخه ذکر شده در صفحه پروژه استفاده کنید.
در صورت استفاده از هر سیستم ساخت دیگری :
- فایل ZIP کتابخانه را از صفحه پروژه دانلود کنید ، فایل ها را از حالت فشرده خارج کنید و آن ها را همانطور که سیستم ساخت شما نیاز دارد در پروژه خود قرار دهید.
اجرای نمونه ها
فایلهای نمونه JAR همراه با JARهای کتابخانه در فایل ZIP قابل دانلود گنجانده شدهاند. دستورالعملهای اجرای نمونهها در صفحه شروع به کار آورده شده است.
اصلاح کتابخانه
اگر می خواهید کد کتابخانه را تغییر دهید، باید منبع را از سایت میزبان منبع باز دانلود کرده و آن را بسازید. قبل از انجام این کار، اطلاعات مجوز مرتبط با بخش "مجوز کد" را در صفحه پروژه بخوانید تا ببینید آیا مورد استفاده شما مجاز است یا خیر.
در اینجا مراحل دانلود و ساخت کتابخانه آمده است:
- همانطور که در برگه Source > Checkout در صفحه پروژه منبع باز توضیح داده شده است، کد منبع را با استفاده از SVN دانلود کنید .
- کد خود را بسازید در صورت ساخت در Maven، از فایل pom.xml ارائه شده با منبع استفاده کنید. اگر با Apache Ant میسازید، دستورالعملهای بعدی را دنبال کنید (توجه داشته باشید که کد با Ant نسخه 1.7.0 آزمایش شده است؛ اگر نسخه قبلی Ant دارید، ممکن است نیاز به ارتقا داشته باشید)
دستورالعمل ساخت مورچه
1. ویژگی های ساخت خود را اصلاح کنید:
- به زیر شاخه
build-src
دایرکتوری نصب انتخابی خود بروید. - با استفاده از یک ویرایشگر متن، فایل
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 بفرستید و اجازه و دستورالعمل هایی در مورد نحوه ارسال تغییرات بخواهید.