SQLite में पैरामीटरयुक्त CRUD कैसे करें

उद्देश्य. INSERT/UPDATE/DELETE और SELECT को पोज़िशनल पैरामीटर (?) के साथ निष्पादित करना, स्ट्रिंग जोड़ने (जो SQL injection और उद्धरण चिह्न त्रुटियाँ पैदा करता है) से बचते हुए। CrossFly की दो इंडेक्स परंपराओं पर ध्यान दें।

⚠️ इंडेक्स. पैरामीटरों को bind करते समय, इंडेक्स 1-based होते हैं (? नं. 1, 2, …)। cursor से कॉलम पढ़ते समय, इंडेक्स 0-based होते हैं (getString(0) = पहला कॉलम)। यह जानबूझकर है और SQLite के नेटिव API को प्रतिबिंबित करता है।

उपयोग किए गए APIs

• SqliteDb.execute(String sql, Object... params) — तैयार करता है, bindAll(params) करता है (bind 1-based), एक एकल INSERT/UPDATE/DELETE निष्पादित करता है और प्रभावित पंक्तियों की संख्या (int) लौटाता है। प्रकार अनुमानित किए जाते हैं: Integer/Long/Short/Byte→पूर्णांक, Float/Double→वास्तविक, Boolean→0/1, byte[]→BLOB, null→NULL, अन्यथा toString()→TEXT।
• SqliteDb.query(String sql, Object... params) — एक खुला SqliteCursor लौटाता है (bind 1-based)। कॉलर को इसे बंद करना चाहिए (try-with-resources उपयोग करें)।
• SqliteCursor.next() — अगली पंक्ति पर आगे बढ़ता है; यदि पंक्ति हो तो true लौटाता है।
• SqliteCursor.getInt(col)/getLong/getDouble/getString/getBlob/isNull(col) — टाइप किए गए getters, कॉलम 0-based।
• SqliteDb.queryLong(sql, defaultValue, params) — शॉर्टकट: पहली पंक्ति का पहला कॉलम long के रूप में, या यदि कोई पंक्ति न हो तो defaultValue।
• SqliteDb.queryString(sql, params) — शॉर्टकट: पहली पंक्ति का पहला कॉलम String के रूप में, या यदि कोई पंक्ति न हो तो null।
• SqliteDb.lastInsertRowid() — अंतिम INSERT का rowid (long)। SqliteDb.changes() — अंतिम निर्देश द्वारा बदली गई पंक्तियाँ।

पूरा उदाहरण (कॉपी करें, पेस्ट करें और चलाएँ)

package com.exemplo;

import dev.crossfly.ui.*;                     // Window
import dev.crossfly.ui.layout.*;             // VerticalLayout
import dev.crossfly.sqlite.*;                // SqliteDb, SqliteCursor

/** चलाने योग्य मुख्य स्क्रीन। launcher (classname) की ओर संकेत करें और चलाएँ: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      try (SqliteDb db = SqliteDb.open("app.db"))
      {
         db.exec("CREATE TABLE IF NOT EXISTS person(id INTEGER PRIMARY KEY, name TEXT, age INTEGER)");

         // CREATE — स्थितीय पैरामीटर (? क्रमांक 1 = name, ? क्रमांक 2 = age)
         int inserted = db.execute("INSERT INTO person(name, age) VALUES(?, ?)", "Alice", 30);
         long id = db.lastInsertRowid();            // उत्पन्न rowid
         System.out.println(inserted + " linha(s), id=" + id);

         // READ — cursor: कॉलम 0-based
         try (SqliteCursor c = db.query("SELECT name, age FROM person WHERE age > ?", 18))
         {
            while (c.next())
               System.out.println(c.getString(0) + " = " + c.getInt(1));   // col 0 = name, col 1 = age
         }

         // READ scalar — शॉर्टकट
         long total = db.queryLong("SELECT count(*) FROM person", 0);
         String nome = db.queryString("SELECT name FROM person WHERE id = ?", id);

         // UPDATE — प्रभावित पंक्तियों की संख्या लौटाता है
         int updated = db.execute("UPDATE person SET age = ? WHERE id = ?", 31, id);

         // DELETE
         int deleted = db.execute("DELETE FROM person WHERE id = ?", id);
      }
   }
}

नीचे दिया गया अंश केवल मुख्य भाग दिखाता है। इसे चलाने के लिए, इसे ऊपर दिए गए MainWindow कंकाल में रखें।

न्यूनतम अंश

// स्रोत में सत्यापित: execute (bind 1-based), query + cursor (getters 0-based), queryLong/queryString
import dev.crossfly.sqlite.*;

try (SqliteDb db = SqliteDb.open("app.db"))
{
   db.exec("CREATE TABLE IF NOT EXISTS person(id INTEGER PRIMARY KEY, name TEXT, age INTEGER)");

   // CREATE — स्थितीय पैरामीटर (? क्रमांक 1 = name, ? क्रमांक 2 = age)
   int inserted = db.execute("INSERT INTO person(name, age) VALUES(?, ?)", "Alice", 30);
   long id = db.lastInsertRowid();            // उत्पन्न rowid
   System.out.println(inserted + " linha(s), id=" + id);

   // READ — cursor: कॉलम 0-based
   try (SqliteCursor c = db.query("SELECT name, age FROM person WHERE age > ?", 18))
   {
      while (c.next())
         System.out.println(c.getString(0) + " = " + c.getInt(1));   // col 0 = name, col 1 = age
   }

   // READ scalar — शॉर्टकट
   long total = db.queryLong("SELECT count(*) FROM person", 0);
   String nome = db.queryString("SELECT name FROM person WHERE id = ?", id);

   // UPDATE — प्रभावित पंक्तियों की संख्या लौटाता है
   int updated = db.execute("UPDATE person SET age = ? WHERE id = ?", 31, id);

   // DELETE
   int deleted = db.execute("DELETE FROM person WHERE id = ?", id);
}

और गहराई से जानें

• SQLite storage गाइड · विकास गाइड
• संबंधित रेसिपी: डेटाबेस खोलना/बनाना · ट्रांज़ैक्शन और बल्क लेखन · paint thread के बाहर उपयोग