इस पेज का अनुवाद Cloud Translation API से किया गया है.

शेड में कोडिंग: Google Data API के साथ Eclipse का इस्तेमाल करना

जेफ़ फ़िशर, Google डेटा API टीम
अप्रैल 2008

शुरुआती जानकारी
Eclipse सेट अप करना
ज़रूरी लाइब्रेरी इंस्टॉल करना
नया ऐप्लिकेशन बनाना
निष्कर्ष

^नया 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 प्रोजेक्ट" चुनना.

अब 'आगे बढ़ें' पर क्लिक करके लाइब्रेरी टैब चुनें. बाहरी JAR जोड़ें पर क्लिक करके, डाउनलोड की गई सभी JAR फ़ाइलें जोड़ें.

आपको Java क्लाइंट लाइब्रेरी से JAR फ़ाइलें भी जोड़नी होंगी. ये java/lib उस सबडायरेक्ट्री में होती हैं जहां आपने क्लाइंट लाइब्रेरी निकाली थी. आपको हमेशा ये JAR फ़ाइलें शामिल करनी होंगी: gdata-client, gdata-client-meta, gdata-core, और gdata-media.

अब चुनें कि आपको किस एपीआई का इस्तेमाल करना है. इस उदाहरण में Google दस्तावेज़ सूची API का इस्तेमाल किया गया है. इसके लिए, सही JAR फ़ाइलें जोड़ने की ज़रूरत होती है: gdata-docs और gdata-docs-meta.

आखिर में, "खत्म करें" पर क्लिक करें और अपना नया प्रोजेक्ट बनाएं.

कोई आसान टेस्ट ऐप्लिकेशन बनाने के लिए, फ़ाइल मेन्यू से "नया > क्लास" चुनकर मुख्य तरीके से एक नई क्लास बनाएं.

अब मैं दस्तावेज़ की सूची वाले एपीआई के लिए डेवलपर की गाइड में कुछ कोड पेस्ट करने जा रहा/रही हूं.

आपको तब तक कई गड़बड़ियां दिखेंगी, जब तक कि आप सही इंपोर्ट स्टेटमेंट नहीं जोड़ते. ग्रहण आसान हो जाता है, आपको बस बाईं ओर दिए गए गड़बड़ी मार्कर पर क्लिक करके एक उपयोगी मेन्यू पाना होता है, ताकि आप इंपोर्ट जोड़ सकें.

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

अब, यह मानते हुए कि आपने उपयोगकर्ता नाम और पासवर्ड को अपने बनाए गए किसी मान्य परीक्षण खाते के साथ बदल दिया है, रन मेन्यू से "चलाएं" चुनने पर आपको उस परीक्षण खाते के स्वामित्व वाले दस्तावेज़ों की सूची दिखाई देगी.

बहुत बढ़िया!

नतीजा

अब आपके पास Eclipse का उदाहरण है और सभी ज़रूरी JAR फ़ाइलें मौजूद हैं. अब आप एक शानदार Java ऐप्लिकेशन बना सकते हैं, जो Google डेटा एपीआई में से किसी एक के साथ काम करता है.

यहां से कहां जाना है? कुछ लिंक ये हैं जो आपके काम आ सकते हैं:

Java, अमेरिका और अन्य देशों में Sun Microsystems, Inc. का ट्रेडमार्क है.