एक फ्रंट एंड डेवलपर के रूप में एपीआई के डिलीवर होने का इंतजार करना कष्टकारी है। क्या होगा यदि कोई चमत्कारिक डेटाबेस है जिसमें एपीआई अंतर्निहित है। खैर, यह अब कोई कल्पना नहीं है। इंजी एक डेटाबेस है जो फ्रंट एंड डेवलपर्स के लिए उपयोग के लिए तैयार सीआरयूडी एपीआई के साथ आता है। इस पृष्ठ को पढ़कर, आप सीखेंगे कि इंजी का उपयोग कैसे करें, इंजी में पुस्तकों का रिकॉर्ड कैसे बनाएं, और आप सीखेंगे कि डेटा में हेरफेर और खोज कैसे करें।

शुरू करना

जावा स्थापित करें

आपको ऐसा केवल एक बार करना होगा। अपनी मशीन के लिए जावा डाउनलोड करने के लिए https://java.com पर जाएं। एक बार आपके सीएमडी, या टर्मिनल प्रकार java --varsion पर इंस्टॉल हो जाए और इसे काम करना चाहिए।

इंजी डाउनलोड करें

आप यहां क्लिक करके इंजी डाउनलोड कर सकते हैं। या आपके टर्मिनल में उपयोग करें:

$ wget https://codeberg.org/injee/injee/releases/download/0.2.0/injee-0.2.0.jar

इंजी का प्रयोग करें

उस निर्देशिका पर नेविगेट करें जहां इंजी जार फ़ाइल डाउनलोड की गई है, और इसका उपयोग करके चलाएं:

$ java -jar injee-0.2.0.jar

स्वास्थ्य

आइए जांचें कि सर्वर चल रहा है या नहीं। हम एपीआई GET http://localhost:4125/ops/health का उपयोग करते हैं।

अपने टर्मिनल में प्रयास करें:

$ curl -X GET http://localhost:4125/ops/health

आउटपुट होना चाहिए

{
  "health": "ok"
}

किताबें बनाएँ

तो आइए किताबों का एक रेपो बनाएं, जादुई रूप से इंजी के पास किताब बनाने के लिए एपीआई पोस्ट http://localhost:4125/api/books है। यदि आप कारों का रेपो बनाना चाहते हैं, तो इंजी के पास एपीआई पोस्ट http://localhost:4125/api/cars API है। तो आइए एक किताब बनाएं और उसे इंजी में संग्रहित करें:

$ curl -X POST http://localhost:4125/api/books \
       -H "Content-Type: application/json" \
       -d '{"title": "Treasure Island", "author": "Robert Louis Stevenson"}'

आउटपुट

{
  "title": "Treasure Island",
  "author": "Robert Louis Stevenson",
  "id": "722e2b57-59cc-4254-85b5-562858264f75"
}

इसलिए इंजी पुस्तक को संग्रहीत करता है, और एक JSON देता है जिसमें आपके द्वारा इंजी को भेजे गए सभी मान होते हैं, साथ ही एक यूयूआईडी भी होता है, जिसे आईडी नामक एक एनवाई को सौंपा जाता है।

अब एक और किताब बनाते हैं:

$ curl -X POST http://localhost:4125/api/books \
       -H "Content-Type: application/json" \
       -d '{"title": "Adventures of Huckleberry Finn", "author": "Mark Twain"}'

आउटपुट

{
  "title": "Adventures of Huckleberry Finn",
  "author": "Mark Twain",
  "id": "689976e3-082e-4943-9525-a21b47cba325"
}

और यह काम करता है!

सभी पुस्तकों की सूची बनाएं

अब सभी पुस्तकों को सूचीबद्ध करने के लिए हम GET http://localhost:4125/api/books का उपयोग करते हैं:

$ curl -X GET http://localhost:4125/api/books

आउटपुट

[
  {
    "title": "Treasure Island",
    "author": "Robert Louis Stevenson",
    "id": "722e2b57-59cc-4254-85b5-562858264f75"
  },
  {
    "title": "Adventures of Huckleberry Finn",
    "author": "Mark Twain",
    "id": "689976e3-082e-4943-9525-a21b47cba325"
  }
]

हमें हमारे द्वारा संग्रहीत पुस्तकों की एक अच्छी श्रृंखला मिलती है।

एक किताब लाओ

अब केवल एक किताब लाते हैं, उसके लिए हम एपीआई GET http://localhost:4125/api/books/:id:
का उपयोग करते हैं

$ curl -X GET http://localhost:4125/api/books/689976e3-082e-4943-9525-a21b47cba325

आउटपुट

{
  "title": "Adventures of Huckleberry Finn",
  "author": "Mark Twain",
  "id": "689976e3-082e-4943-9525-a21b47cba325"
}

इसलिए यदि मैं आईडी को आगे जोड़ता हूं तो http://localhost:4125/api/books/ प्राप्त करता हूं, मुझे एक पुस्तक का विवरण मिलता है।

किसी पुस्तक को अद्यतन करें

किसी पुस्तक को अद्यतन करने के लिए http://localhost:4125/api/books/:id के साथ PUT का उपयोग करें, उसके बाद पुस्तक के लिए पैरामीटर का उपयोग करें:

$ curl -X PUT http://localhost:4125/api/books/689976e3-082e-4943-9525-a21b47cba325 \
       -H "Content-Type: application/json" \
       -d '{"title": "Adventures of Tom Sawyer"}'

आउटपुट

{
  "title": "Adventures of Tom Sawyer",
  "author": "Mark Twain",
  "id": "689976e3-082e-4943-9525-a21b47cba325"
}

तो जैसा कि आप ऊपर देख सकते हैं, पुस्तक का शीर्षक एडवेंचर्स ऑफ हकलबेरी फिन से बदलकर एडवेंचर्स ऑफ टॉम सॉयर कर दिया गया है।

अब सभी पुस्तकों की सूची बनाएं:

$ curl -X GET http://localhost:4125/api/books

आउटपुट

[
  {
    "title": "Treasure Island",
    "author": "Robert Louis Stevenson",
    "id": "722e2b57-59cc-4254-85b5-562858264f75"
  },
  {
    "title": "Adventures of Tom Sawyer",
    "author": "Mark Twain",
    "id": "689976e3-082e-4943-9525-a21b47cba325"
  }
]

हमारे अपडेट की पुष्टि करने के लिए।

एक किताब हटाएँ

अब एक किताब हटाते हैं। इसके लिए http://localhost:4125/api/books/:id:
के साथ DELETE का उपयोग करें।

$ curl -X DELETE http://localhost:4125/api/books/689976e3-082e-4943-9525-a21b47cba325

आउटपुट

कोई आउटपुट नहीं होगा, यदि आप इसे कोड में आज़मा रहे हैं और प्रतिक्रिया ऑब्जेक्ट प्राप्त करते हैं, तो आपको स्थिति 204 मिलनी चाहिए।

अब सभी पुस्तकों की सूची बनाएं और पुष्टि करें कि एडवेंचर्स ऑफ टॉम सॉयर को हटा दिया गया है:

$ curl -X GET http://localhost:4125/api/books

आउटपुट

[
  {
    "title": "Treasure Island",
    "author": "Robert Louis Stevenson",
    "id": "722e2b57-59cc-4254-85b5-562858264f75"
  }
]

लिस्टिंग टेबल्स

अब एक उपयोगकर्ता बनाएं:

$ curl -X POST http://localhost:4125/api/users \
       -H "Content-Type: application/json" \
       -d '{"name": "Karthik"}'

आउटपुट

{
  "name": "Karthik",
  "created_at": "2024-07-22T11:18:42Z",
  "updated_at": "2024-07-22T11:18:42Z",
  "id": "ad100ab0-7893-421d-9233-353cc8899aa9"
}

तो अब हमारे डीबी में पुस्तकें और उपयोगकर्ता नाम की दो तालिकाएँ होनी चाहिए, आइए निम्नलिखित एपीआई का उपयोग करके उन्हें सूचीबद्ध करें:

$ curl -X GET http://localhost:4125/ops/tables

आउटपुट

[
  "books",
  "users"
]

अभिलेख खोज रहे हैं

आइए उपयोगकर्ता तालिका में एक और उपयोगकर्ता रिकॉर्ड जोड़ें:

$ curl -X POST http://localhost:4125/api/users \
       -H "Content-Type: application/json" \
       -d '{"name": "Pari"}'

आइए अब सभी उपयोगकर्ताओं को लाएं और हमारे जुड़ने की पुष्टि करें

$ curl -X GET http://localhost:4125/api/users

[
  {
    "name": "Karthik",
    "created_at": "2024-07-22T11:18:42Z",
    "updated_at": "2024-07-22T11:18:42Z",
    "id": "ad100ab0-7893-421d-9233-353cc8899aa9"
  },
  {
    "name": "Pari",
    "created_at": "2024-07-22T11:23:27Z",
    "updated_at": "2024-07-22T11:23:27Z",
    "id": "1f06bb65-1f2d-4980-9cfc-cf3d38c9db7e"
  }
]

अब उपयोगकर्ताओं में एक स्ट्रिंग खोजें:

$ curl -X GET http://localhost:4125/api/users?q=Pari

[
  {
    "name": "Pari",
    "created_at": "2024-07-22T11:23:27Z",
    "updated_at": "2024-07-22T11:23:27Z",
    "id": "1f06bb65-1f2d-4980-9cfc-cf3d38c9db7e"
  }
]

इंजी का समर्थन

अब हमारे DB को बैकअप.json नाम की फ़ाइल में बैकअप करने दें:

$ curl -X GET http://localhost:4125/ops/save?file=backup.json

आउटपुट

{
  "message": "saved to file backup.json"
}

इंजी को रोकना

अंत में, इंजी को रोकने के लिए, टर्मिनल में जहां इंजी चल रही है उसे रोकने के लिए उस टर्मिनल में Ctrl c दबाएं जहां इंजी चल रही है।

बैकअप लोड हो रहा है

आइए फिर से इंजी शुरू करें:

$ java -jar injee-0.2.0.jar

$ curl -X GET http://localhost:4125/ops/load?file=backup.json

आउटपुट

{
  "message": "loaded from file backup.json"
}

तो आपको अपना मूल डीबी वापस मिल गया है और वह चल रहा है। बधाई।

तारीख तक रखना

इंजी के साथ अपडेट रहने का सबसे अच्छा तरीका यह है कि इसके पेज को यहां फॉलो करें https://injee.codeberg.page/, या यहां इसके आरएसएस को फॉलो करें https://codeberg.org/injee.rss