अप्रैल 2008
नया Google Data API Java Client Eclipse प्लग-इन : प्रोजेक्ट कुछ ही सेकंड में बनाएं
इस लेख के साथ एक और लिंक, Eclipse प्लग-इन उपलब्ध कराया गया है. इससे, Google डेटा डिपेंडेंसी सेट अप करने में लगने वाले ओवरहेड को कम किया जा सकता है. यह आपकी पसंद के एपीआई से इंटरैक्ट करने के लिए, बॉयलरप्लेट कोड भी बनाता है. इससे, Google Data API का इस्तेमाल आसानी से शुरू किया जा सकता है.
सुविधा के बारे में जानकारी
ग्रहण बहुत आसान है (और मुफ़्त है!) आईडीई, जो कई Java प्रोग्रामर के दिलों में खास जगह है. हमें इस बात से कोई हैरानी नहीं होती कि शायद आप इसका इस्तेमाल Java क्लाइंट लाइब्रेरी के साथ करना चाहें, ताकि ऐसा हत्यारा Java ऐप्लिकेशन बनाया जा सके जो किसी Google डेटा एपीआई के साथ काम करता हो.
इक्लिप्स सेट अप करना
अगर आपने अब तक Eclipse इंस्टॉल नहीं किया है, तो इसके बारे में आपको नहीं पता. ग्रहण, सुधार के सुझाव देने, अनुपलब्ध आयातों को खोजने, और ऑटोकंप्लीट तरीकों की वजह से Java के विकास को ज़्यादा आसान बना सकता है. अपने ऑपरेटिंग सिस्टम के लिए इंस्टॉलर पाने के लिए Eclipse.org डाउनलोड पेज पर जाएं. Eclipse चलाने के लिए, आपको एक JRE इंस्टॉल करना होगा, जो Eclipse डाउनलोड पेज से लिंक होता है. Eclipse इंस्टॉल करने के बाद, आपको फ़ाइल फ़ोल्डर बनाना होगा. इन उदाहरणों में /usr/local/eclipse/workspace
का इस्तेमाल किया गया है.
ज़रूरी लाइब्रेरी इंस्टॉल करना
Eclipse कई Java फ़ंक्शन शानदार तरीके से उपलब्ध कराता है, इसलिए यह आसान होना चाहिए. सबसे पहले, प्रोजेक्ट डाउनलोड पेज से Java क्लाइंट लाइब्रेरी का नया वर्शन पाएं. ध्यान दें कि दो अलग-अलग डाउनलोड होते हैं: एक नमूने के लिए और एक सोर्स कोड के लिए. नमूने के फ़ॉर्मैट वाली ZIP फ़ाइल डाउनलोड करें, क्योंकि इसमें आपके प्रोग्राम बनाने के लिए ज़रूरी, Java क्लाइंट लाइब्रेरी की कंपाइल की गई JAR फ़ाइलें शामिल होती हैं. अगर आपको यह जानना है कि क्लाइंट लाइब्रेरी अपने-आप कैसे काम करती है, तो सोर्स ज़िप डाउनलोड करके देखें. हालांकि, यह लेख इस दायरे से बाहर का है. सैंपल डाउनलोड करने के बाद, फ़ाइल को किसी ऐसी सुविधाजनक डायरेक्ट्री पर ले जाएं जहां से फ़ाइलें ढूंढी जा सकें. उदाहरणों में /usr/local/eclipse
का इस्तेमाल किया गया है. इसका मतलब है कि अब /usr/local/eclipse/gdata/java/lib
के तहत, प्रोजेक्ट की JAR फ़ाइलें ऐक्सेस की जा सकेंगी.
अब आप क्लाइंट लाइब्रेरी इंस्टॉल कर चुके हैं. इसलिए, हम कुछ बाहरी डिपेंडेंसी डाउनलोड करते हैं, ताकि उन्हें प्रोजेक्ट बिल्ड पाथ में शामिल किया जा सके. इस INSTALL-samples.txt
फ़ाइल में उन जार की सूची है जहां से आपको डाउनलोड करना होगा. मौजूदा सूची:
फ़ाइल का नाम | जगह |
---|---|
मेल.जैर | Sun's JavaMail API |
भेजी जा रही है | Sun's JavaBeans ऐक्टिवेशन फ़्रेमवर्क |
सर्वलेट-एपीआई | Apache टॉमकैट |
इस उदाहरण में, इन JAR फ़ाइलों को डाउनलोड करके, /usr/local/eclipse/gdata/third_party
में कॉपी कर दिया गया है.
शुक्र है! अब आपके पास एक ऐसा Java ऐप्लिकेशन डेवलप करने के लिए सभी आवश्यक घटक हैं जो किसी एक Google डेटा API का उपयोग करते हैं. आगे पढ़ें!
नया ऐप्लिकेशन बनाना
पहला चरण है, इक्लिप्स को खोलना और फ़ाइल मेन्यू से "नया > Java प्रोजेक्ट" चुनना.
![नई प्रोजेक्ट विंडो को पूरा करें](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=6&hl=hi)
अब 'आगे बढ़ें' पर क्लिक करके लाइब्रेरी टैब चुनें. बाहरी JAR जोड़ें पर क्लिक करके, डाउनलोड की गई सभी JAR फ़ाइलें जोड़ें.
![डिपेंडेंसी JARs जोड़ना](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=6&hl=hi)
आपको Java क्लाइंट लाइब्रेरी से JAR फ़ाइलें भी जोड़नी होंगी. ये java/lib
उस सबडायरेक्ट्री में होती हैं जहां आपने क्लाइंट लाइब्रेरी निकाली थी. आपको हमेशा ये JAR फ़ाइलें शामिल करनी होंगी: gdata-client, gdata-client-meta, gdata-core, और gdata-media.
![GData JARs जोड़ना](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=6&hl=hi)
अब चुनें कि आपको किस एपीआई का इस्तेमाल करना है. इस उदाहरण में Google दस्तावेज़ सूची API का इस्तेमाल किया गया है. इसके लिए, सही JAR फ़ाइलें जोड़ने की ज़रूरत होती है: gdata-docs और gdata-docs-meta.
![DocList JARs को जोड़ा जा रहा है](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=6&hl=hi)
आखिर में, "खत्म करें" पर क्लिक करें और अपना नया प्रोजेक्ट बनाएं.
![नया प्रोजेक्ट](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=6&hl=hi)
कोई आसान टेस्ट ऐप्लिकेशन बनाने के लिए, फ़ाइल मेन्यू से "नया > क्लास" चुनकर मुख्य तरीके से एक नई क्लास बनाएं.
![कक्षा बनाना](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=6&hl=hi)
अब मैं दस्तावेज़ की सूची वाले एपीआई के लिए डेवलपर की गाइड में कुछ कोड पेस्ट करने जा रहा/रही हूं.
![गड़बड़ियों के साथ सैंपल कोड](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=6&hl=hi)
आपको तब तक कई गड़बड़ियां दिखेंगी, जब तक कि आप सही इंपोर्ट स्टेटमेंट नहीं जोड़ते. ग्रहण आसान हो जाता है, आपको बस बाईं ओर दिए गए गड़बड़ी मार्कर पर क्लिक करके एक उपयोगी मेन्यू पाना होता है, ताकि आप इंपोर्ट जोड़ सकें.
![क्विकफ़िक्स मेन्यू](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=6&hl=hi)
इंपोर्ट साफ़ करने के बाद, आपको उन अपवादों को भी हैंडल करना होगा जिन्हें हमारे कोड से फेंका जा सकता है. यह उदाहरण, पूरे सैंपल कोड को अल्टिमेटरी अपवाद हैंडलर के साथ कवर करने का विकल्प चुनता है.
![काम करने वाले नमूना कोड](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=6&hl=hi)
अब, यह मानते हुए कि आपने उपयोगकर्ता नाम और पासवर्ड को अपने बनाए गए किसी मान्य परीक्षण खाते के साथ बदल दिया है, रन मेन्यू से "चलाएं" चुनने पर आपको उस परीक्षण खाते के स्वामित्व वाले दस्तावेज़ों की सूची दिखाई देगी.
![प्रोग्राम आउटपुट](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=6&hl=hi)
बहुत बढ़िया!
नतीजा
अब आपके पास Eclipse का उदाहरण है और सभी ज़रूरी JAR फ़ाइलें मौजूद हैं. अब आप एक शानदार Java ऐप्लिकेशन बना सकते हैं, जो Google डेटा एपीआई में से किसी एक के साथ काम करता है.
यहां से कहां जाना है? कुछ लिंक ये हैं जो आपके काम आ सकते हैं:
- Google डेटा एपीआई Java क्लाइंट Eclipse प्लग-इन
- code.google.com पर Google डेटा प्रोटोकॉल दस्तावेज़
- Google डेटा Java क्लाइंट लाइब्रेरी प्रोजेक्ट
- Java क्लाइंट लाइब्रेरी के लिए शुरुआती निर्देश
- JavaDoc दस्तावेज़
Java, अमेरिका और अन्य देशों में Sun Microsystems, Inc. का ट्रेडमार्क है.