डेटा सोर्स की Java लाइब्रेरी इंस्टॉल करना

इस पेज पर, Google विज़ुअलाइज़ेशन Java लाइब्रेरी इस्तेमाल करने या उसमें बदलाव करने का तरीका और प्रोजेक्ट के ओपन सोर्स कोड में योगदान देने का तरीका बताया गया है.

विषय सूची

ज़रूरी शर्तें

Google विज़ुअलाइज़ेशन Java लाइब्रेरी का इस्तेमाल करने के लिए आपके पास ये कॉम्पोनेंट होने चाहिए:

• सर्वलेट कंटेनर और Servlet API वर्शन 2.4 या इसके बाद वाला वर्शन. सबसे ज़्यादा इस्तेमाल किए जाने वाले सर्वलेट कंटेनर में से एक Apache Tomcat है, जिसमें Servlet API शामिल है. वर्शन 5.5 की बाइनरी डाउनलोड करने के लिए, http://tomcat.apache.org/download-55.cgi देखें. आपको सिर्फ़ Core मॉड्यूल इंस्टॉल करना होगा. आपको ट्यूटोरियल सेक्शन पूरे करने के लिए, Tomcat की ज़रूरत भी होगी: शुरू करना, बाहरी डेटा स्टोर का इस्तेमाल करना, और क्षमताएं तय करना और इवेंट का फ़्लो.
• Java डेवलपमेंट किट का 6.0 या उसके बाद का वर्शन.

  ध्यान दें: जेडीके के वर्शन 5.0 का इस्तेमाल भी किया जा सकता है. हालांकि, इसके बाद आपको लाइब्रेरी में मौजूद हर उस तरीके से @Override को हटाना होगा जो किसी इंटरफ़ेस के तरीके को ओवरराइड करता है. ऐसा जेडीके के वर्शन 6.0 में, @Override से जुड़ी जानकारी के काम करने के तरीके में हुए बदलाव की वजह से हुआ है.

डिपेंडेंसी

डेटा सोर्स की Java लाइब्रेरी पर ये निर्भर करती हैं. लाइब्रेरी को सूची में दिए गए वर्शन के साथ टेस्ट किया गया. दूसरे वर्शन स्वीकार किए जा सकते हैं, लेकिन उनकी जांच नहीं की गई है.

सोर्स या डाउनलोड में शामिल:

• icu4j वर्शन 4.0.1.
• Jakarta Commons lang का वर्शन 2.4.
• Jakarta Commons लॉगिंग वर्शन 1.1.1.
• Google कलेक्शन लाइब्रेरी का 1.0 वर्शन.
• javacc वर्शन 4.2. यह सिर्फ़ तब ज़रूरी होता है, जब आपको लाइब्रेरी को इकट्ठा करना हो. उदाहरण के लिए, उनमें बदलाव करते समय नीचे बताया गया है.
• opencsv वर्शन 1.8. यह सिर्फ़ तब ज़रूरी होता है, जब आपको CSV डेटा सोर्स इस्तेमाल करना हो.

सोर्स या डाउनलोड में शामिल नहीं है:

• mySQL डेटाबेस के साथ SqlDataSourceHelper क्लास का इस्तेमाल करने के लिए, आपको अपने रनटाइम एनवायरमेंट में mysql.jar की भी ज़रूरत होती है. ज़्यादा जानकारी और डाउनलोड किए जा सकने वाले वर्शन के लिए, http://www.mysql.com/products/connector/j/ पर जाएं.

लाइब्रेरी का इस्तेमाल, दिए गए तरीके से करना

इस सेक्शन में यह बताया गया है कि अगर आपको विज़ुअलाइज़ेशन में Java लाइब्रेरी में बदलाव करने की ज़रूरत नहीं है, तो इसे इस्तेमाल करने का तरीका क्या है. यह प्रोसेस आपके बिल्ड सिस्टम के हिसाब से अलग-अलग होती है:

अगर Maven का इस्तेमाल किया जा रहा है, तो इन सेटिंग की मदद से विज़ुअलाइज़ेशन लाइब्रेरी पर डिपेंडेंसी सेट अप करें:

• ग्रुप आईडी: com.google.विज़ुअलाइज़ेशन
• आर्टफ़ैक्ट आईडी: विज़ुअलाइज़ेशन-डेटा सोर्स
• वर्शन नंबर: प्रोजेक्ट पेज पर दिए गए सबसे नए वर्शन नंबर का इस्तेमाल करें.

अगर किसी दूसरे बिल्ड सिस्टम का इस्तेमाल किया जा रहा है, तो:

• प्रोजेक्ट पेज से लाइब्रेरी की ZIP फ़ाइल डाउनलोड करें. इसके बाद, फ़ाइलों को अनज़िप करें और बिल्ड सिस्टम की ज़रूरत के हिसाब से उन्हें अपने प्रोजेक्ट में शामिल करें.

उदाहरण चलाना

JAR के उदाहरण वाली फ़ाइलों को, डाउनलोड की जा सकने वाली ZIP फ़ाइल में, लाइब्रेरी JAR के साथ शामिल किया जाता है. उदाहरण को चलाने के निर्देश, शुरू करना पेज पर दिए गए हैं.

लाइब्रेरी में बदलाव करना

अगर आपको लाइब्रेरी कोड में बदलाव करना है, तो आपको ओपन सोर्स होस्ट करने वाली साइट से सोर्स को डाउनलोड करना होगा और उसे बनाना होगा. ऐसा करने से पहले, प्रोजेक्ट पेज पर "कोड लाइसेंस" सेक्शन से लिंक की गई लाइसेंस से जुड़ी जानकारी पढ़ें और देखें कि आपके इस्तेमाल के उदाहरण की अनुमति है या नहीं.

लाइब्रेरी बनाने और डाउनलोड करने का तरीका यहां बताया गया है:

1. ओपन सोर्स प्रोजेक्ट पेज पर सोर्स > चेकआउट टैब में बताए गए तरीके के मुताबिक, एसवीएन का इस्तेमाल करके सोर्स कोड डाउनलोड करें.
2. अपना कोड बनाएं. अगर Maven में बिल्डिंग बनाना है, तो सोर्स के साथ दी गई pom.xml फ़ाइल का इस्तेमाल करें. अगर आपके पास Apache Ant का इस्तेमाल करना है, तो आगे दिए गए निर्देशों का पालन करें (ध्यान दें कि कोड की Ant के 1.7.0 वर्शन के साथ जांच की गई है. अगर आपके पास Ant का पुराना वर्शन है, तो आपको उसे अपग्रेड करना पड़ सकता है)

ओपन सोर्स प्रोजेक्ट में योगदान देना

अगर आपको ओपन सोर्स प्रोजेक्ट में बदलाव करना है, तो आपको प्रोजेक्ट सबमिट करने की अनुमतियां लेनी होंगी. बदलाव सबमिट करने के तरीके के बारे में अनुमति और निर्देश मांगने के लिए, google-visualization-api@googlegroups.com पर ईमेल भेजें.