यह पेज बताता है कि 'Google विज़ुअलाइज़ेशन Java लाइब्रेरी' का इस्तेमाल या उसमें बदलाव कैसे करें. साथ ही, यह भी बताएं कि प्रोजेक्ट के लिए ओपन सोर्स कोड में कैसे योगदान दिया जा सकता है.
कॉन्टेंट
ज़रूरी शर्तें
Google विज़ुअलाइज़ेशन Java लाइब्रेरी इस्तेमाल करने के लिए, आपके पास नीचे दिए गए कॉम्पोनेंट होने चाहिए:
- सर्वलेट कंटेनर और सर्वलेट एपीआई वर्शन 2.4 या इसके बाद का वर्शन. आम तौर पर, इस्तेमाल किए जाने वाले सर्वलेट कंटेनर में से एक ApacheTocat है, जिसमें सर्वलेट एपीआई शामिल है. वर्शन 5.5 की बाइनरी डाउनलोड करने के लिए, http://tomcat.apache.org/download-55.cgi देखें. आपको सिर्फ़ कोर मॉड्यूल इंस्टॉल करना होगा. आपको ट्यूटोरियल सेक्शन को पूरा करने के लिए भी टॉमकैट की ज़रूरत होगी: शुरू करना, बाहरी डेटा स्टोर का इस्तेमाल करना, और अधिकार तय करना और इवेंट का फ़्लो.
- Java डेवलपमेंट किट 6.0 या इसके बाद का वर्शन.
ध्यान दें: JDK वर्शन 5.0 का इस्तेमाल भी किया जा सकता है. हालांकि, इसके बाद आपको लाइब्रेरी में मौजूद हर उस तरीके से
@Override
हटाना होगा जो किसी इंटरफ़ेस वाले तरीके को बदलता है. ऐसा JDK वर्शन 6.0 में@Override
एनोटेशन के व्यवहार में बदलाव की वजह से होता है.
डिपेंडेंसी
डेटा सोर्स Java लाइब्रेरी में, ये डिपेंडेंसी शामिल हैं. इस सूची में शामिल वर्शन की जांच की गई थी. हो सकता है कि अन्य वर्शन सही हों, लेकिन उनकी जांच न की गई हो.
सोर्स या डाउनलोड में शामिल करें:
- icu4j वर्शन 4.0.1.
- जकार्ता कॉमन्स लैंग वर्शन 2.4.
- जकार्ता कॉमन्स लॉगिंग वर्शन 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 उदाहरण वाली फ़ाइलें, JAR लाइब्रेरी के साथ डाउनलोड की जा सकने वाली ZIP फ़ाइल में शामिल की जाती हैं. उदाहरण शुरू करने के निर्देश शुरू करें पेज पर दिए गए हैं.
लाइब्रेरी में बदलाव करना
अगर आपको लाइब्रेरी कोड में बदलाव करना है, तो आपको ओपन सोर्स होस्टिंग साइट से सोर्स डाउनलोड करना होगा. ऐसा करने से पहले, प्रोजेक्ट पेज के "कोड लाइसेंस" सेक्शन से जुड़े लाइसेंस की जानकारी पढ़ें, ताकि आप जान सकें कि आपके इस्तेमाल के उदाहरण की अनुमति है या नहीं.
यहां लाइब्रेरी डाउनलोड करने और बनाने के चरण दिए गए हैं:
- ओपन सोर्स प्रोजेक्ट पेज पर सोर्स > चेकआउट टैब में, एसवीएन का इस्तेमाल करके सोर्स कोड डाउनलोड करें.
- अपना कोड बनाएं. अगर Maven में बिल्डिंग बनाई जा रही है, तो स्रोत के साथ दी गई pom.xml फ़ाइल का इस्तेमाल करें. अगर Apache Ant के साथ बनाया जा रहा है, तो आगे दिए गए निर्देशों का पालन करें (ध्यान दें कि कोड को Ant वर्शन 1.7.0 के साथ टेस्ट किया गया है; अगर आपके पास Ant का पुराना वर्शन है, तो आपको अपग्रेड करना पड़ सकता है)
चींटी बनाने के निर्देश
1. अपनी बिल्ड प्रॉपर्टी में बदलाव करना:
- चुनी गई इंस्टॉलेशन डायरेक्ट्री की
build-src
सबडायरेक्ट्री पर जाएं. - टेक्स्ट एडिटर का इस्तेमाल करके,
build.properties
फ़ाइल खोलें और ये बदलाव करें:servlet-api.jar
फ़ाइल पर ले जाने के लिए,servlet-api.jar
प्रॉपर्टी में बदलाव करें. उदाहरण के लिए, अगर आपनेtomcat_home
डायरेक्ट्री मेंc:
को Chromebook ड्राइव पर इंस्टॉल किया है, तो आपको इस तरह सेservlet-api.jar
प्रॉपर्टी के बारे में बताना होगा:servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar
ध्यान दें: फ़ाइल पाथ में बैकस्लैश के बजाय, स्लैश का इस्तेमाल करें
- ऊपर बताई गई डिपेंडेंसी की अपनी कॉपी का इस्तेमाल करने के लिए, एक ही build.property फ़ाइल में पाथ में बदलाव करें.
2. लाइब्रेरी बनाएं:
फ़ाइल में build-src
सबडायरेक्ट्री पर जाएं और इनमें से कोई एक टाइप करें:
ant datasource
- डेटा सोर्स लाइब्रेरी बनाता हैant example
- उदाहरण बनाता हैant
- डेटा सोर्स और उदाहरण, दोनों बनाता हैant test
- यह डेटा सोर्स लाइब्रेरी की जांच करता है और उसे चलाता है. लाइब्रेरी में बदलाव करते समय बहुत काम आता है.
ओपन सोर्स प्रोजेक्ट में योगदान देना
अगर आपको ओपन सोर्स प्रोजेक्ट में कुछ बदलाव करने हैं, तो आपको प्रोजेक्ट को सबमिट करने की अनुमतियां लेनी होंगी. बदलावों को सबमिट करने के तरीके के बारे में अनुमति और निर्देश मांगने के लिए, google-visualization-api@googlegroups.com पर ईमेल भेजें.