30 मिनट में Java पर REST API कैसे लिखें: शुरुआती लोगों के लिए

30 मिनट में Java पर REST API कैसे लिखें: शुरुआती लोगों के लिए

REST API बनाना आधुनिक डेवलपर के प्रमुख कौशलों में से एक है। यदि आप अभी Java सीखना शुरू कर रहे हैं और जल्दी से अपनी पहली वेब सेवा बनाना चाहते हैं, तो यह मार्गदर्शिका आपके लिए है। हम टूल्स इंस्टॉल करने से लेकर एक कार्यशील API तक का सफर तय करेंगे, जिसे ब्राउज़र या Postman में परीक्षण किया जा सकता है। पूरी प्रक्रिया में 30 मिनट से अधिक नहीं लगेगा।

इस लेख में हम Spring Boot का उपयोग करेंगे - जो Java में वेब एप्लिकेशन बनाने के लिए सबसे लोकप्रिय फ्रेमवर्क है। यह सभी नियमित सेटअप का ध्यान रखता है, जिससे आप तर्क पर ध्यान केंद्रित कर सकते हैं। परिणामस्वरूप, आपको कार्य सूची (Todo List) के प्रबंधन के लिए एक सरल API मिलेगा।

REST API क्या है और इसकी आवश्यकता क्यों है?

REST (Representational State Transfer) वेब सेवाओं के निर्माण के लिए एक आर्किटेक्चरल शैली है। REST API HTTP प्रोटोकॉल पर काम करता है और मानक विधियों का उपयोग करता है:

\n
• GET — डेटा प्राप्त करना
\n
• POST — नया रिकॉर्ड बनाना
\n
• PUT — मौजूदा रिकॉर्ड को अपडेट करना
\n
• DELETE — रिकॉर्ड हटाना
\n

डेटा आमतौर पर JSON प्रारूप में प्रेषित किया जाता है। REST API का उपयोग सर्वव्यापी है: मोबाइल एप्लिकेशन से लेकर माइक्रोसर्विस आर्किटेक्चर तक। इसमें महारत हासिल करके, आप किसी भी क्लाइंट के लिए सर्वर-साइड बना सकते हैं।

चरण 1: वातावरण तैयार करना

काम करने के लिए हमें तीन चीजों की आवश्यकता है। सुनिश्चित करें कि वे आपके कंप्यूटर पर स्थापित हैं।

1.1. JDK (Java Development Kit)

Oracle की आधिकारिक वेबसाइट से JDK 17 या उससे नया डाउनलोड और इंस्टॉल करें, या OpenJDK का उपयोग करें। टर्मिनल में कमांड से इंस्टॉलेशन की जाँच करें:

java -version

1.2. IntelliJ IDEA (Community Edition)

यह एक मुफ्त विकास वातावरण है, जो Java के लिए आदर्श है। इसे आधिकारिक वेबसाइट से डाउनलोड करें।

1.3. Postman (वैकल्पिक)

API परीक्षण के लिए उपकरण। postman.com से डाउनलोड किया जा सकता है। शुरुआत में ब्राउज़र से भी काम चल सकता है।

चरण 2: Spring Boot प्रोजेक्ट बनाना

सबसे तेज़ तरीका Spring Initializr का उपयोग करना है। यह एक वेब टूल है जो प्रोजेक्ट का खाका तैयार करता है।

\n
1. start.spring.io पर जाएं।
\n
2. चुनें: Project: Maven, Language: Java, Spring Boot: 3.x.x।
\n
3. Group फ़ील्ड में com.example दर्ज करें, Artifact में todoapi दर्ज करें।
\n
4. Add Dependencies पर क्लिक करें और Spring Web जोड़ें।
\n
5. Generate पर क्लिक करें - प्रोजेक्ट के साथ एक ZIP आर्काइव डाउनलोड होगा।
\n
6. आर्काइव को अनज़िप करें और फ़ोल्डर को IntelliJ IDEA में खोलें।
\n

प्रोजेक्ट की संरचना इस प्रकार होगी:

\n
• src/main/java/com/example/todoapi/ — मुख्य कोड
\n
• src/main/resources/application.properties — सेटिंग्स
\n
• pom.xml — Maven बिल्ड फ़ाइल
\n

चरण 3: डेटा मॉडल और कंट्रोलर बनाना

अब हम कोड लिखेंगे। पहले एक सरल मॉडल बनाएं - TodoItem क्लास।

3.1. मॉडल क्लास

com.example.todoapi पैकेज में TodoItem.java नाम से एक नया Java क्लास बनाएं:

package com.example.todoapi;\n\npublic class TodoItem {\n    private Long id;\n    private String title;\n    private boolean completed;\n\n    // डिफ़ॉल्ट कंस्ट्रक्टर\n    public TodoItem() {}\n\n    // पैरामीटर वाला कंस्ट्रक्टर\n    public TodoItem(Long id, String title, boolean completed) {\n        this.id = id;\n        this.title = title;\n        this.completed = completed;\n    }\n\n    // गेटर्स और सेटर्स\n    public L