नमस्कार सभी को! इस लेख में हम सीखेंगे कि iOS ऐप में Realm डेटाबेस कैसे जोड़ें।
हम एक साधारण ToDo ऐप बनाएंगे ताकि आप सीख सकें कि Realm डेटाबेस में CRUD (बनाएं, पढ़ें, अपडेट करें, हटाएं) ऑपरेशन कैसे करें।
Realm क्या है?
Realm एक ओपन-सोर्स मोबाइल डेटाबेस है जो डेवलपर-फ्रेंडली और उपयोग में आसान है। आप इसे iOS ऐप्स में Core Data के विकल्प के रूप में भी उपयोग कर सकते हैं।
Realm एक क्रॉस-प्लेटफॉर्म मोबाइल डेटाबेस है, जिसका अर्थ है कि आप इसे नेटिव Android और iOS ऐप्स में और साथ ही React Native का उपयोग करके बनाए गए क्रॉस-प्लेटफॉर्म ऐप्स में उपयोग कर सकते हैं। यह Objective-C, Swift, Java, Kotlin, C#, और JavaScript को सपोर्ट करता है।
अपने iOS प्रोजेक्ट में Realm कैसे सेट करें
हम SPM (Swift Package Manager), CocoaPods, या Carthage का उपयोग करके अपने iOS प्रोजेक्ट में Realm जोड़ सकते हैं। यहां, हम अपने iOS प्रोजेक्ट में Realm Pod जोड़ने के लिए CocoaPods का उपयोग करने जा रहे हैं।
- Xcode खोलें और UIKit और Swift के साथ एक ब्लैंक iOS ऐप प्रोजेक्ट बनाएं बिना Core Data का उपयोग किए।
- अब Xcode बंद करें और टर्मिनल खोलें। टर्मिनल का उपयोग करके अपने प्रोजेक्ट डायरेक्टरी में नेविगेट करें।
- PodFile बनाने के लिए निम्न कमांड चलाएं।
pod init
4. अब जब आप डायरेक्टरी की सामग्री सूचीबद्ध करते हैं तो आप देख सकते हैं कि एक नया Podfile है। किसी भी टेक्स्ट एडिटर का उपयोग करके फ़ाइल खोलें (यहां मैंने Vim का उपयोग किया है)। अपने Podfile को नीचे दी गई छवि के समान दिखने के लिए संपादित करें। सेव करें और Podfile बंद करें।
अब जब हमने Realm DB के लिए निर्भरता निर्दिष्ट कर दी है, तो हम नीचे दी गई कमांड चलाकर निर्भरताओं को इंस्टॉल कर सकते हैं:
pod install
जैसा कि आप देख सकते हैं, हमने अपने iOS प्रोजेक्ट में Realm DB निर्भरता को सफलतापूर्वक जोड़ लिया है। अब Xcode में अपना प्रोजेक्ट खोलने के लिए नीचे दी गई कमांड चलाएं।
open YOUR_APP_NAME.xcworkspace
नोट: Xcode खोलने के बाद, Command+B दबाकर अपना प्रोजेक्ट बिल्ड करना सुनिश्चित करें।
Realm में अपना यूजर इंटरफेस कैसे डिज़ाइन करें
हम अपने ऐप के UI को सरल रखने जा रहे हैं। Main.storyboard खोलें और नीचे दिखाए अनुसार एक साधारण UI बनाएं एक प्रोटोटाइप सेल के साथ एक टेबल व्यू जोड़कर। फिर एक नेविगेशन कंट्रोलर एम्बेड करें और ViewController.swift फ़ाइल में टेबल व्यू के लिए IBOutlets बनाएं:
Realm में डेटा मॉडल कैसे बनाएं
हमारे ToDo ऐप में, प्रत्येक टास्क का एक टास्क नाम और एक टास्क आईडी होता है। हम टूडू टास्क को दर्शाने के लिए एक मॉडल क्लास बनाने जा रहे हैं। प्रोजेक्ट नेविगेटर में राइट-क्लिक करें और एक नई Swift फ़ाइल बनाएं, और नीचे दिया गया कोड जोड़ें।
import Foundation
import RealmSwift
class ToDoTask: Object {
@objc dynamic var taskNote: String?
@objc dynamic var taskId: String?
}
यहां हमने ToDoTask नामक अपनी मॉडल क्लास बनाई। यह Object क्लास को इनहेरिट करती है जो RealmDB के साथ आती है। यह क्लास इस मॉडल क्लास का उपयोग करके बनाए गए डेटा को डेटाबेस में सहेजने की सभी अंडर-द-हुड प्रक्रियाओं को संभालती है।
हमने दो प्रॉपर्टीज भी जोड़ीं: taskNote, जो करने का कार्य है, और taskId - दोनों स्ट्रिंग प्रकार के। @objc का अर्थ है कि आपका Swift कोड Objective-C को विजिबल है और dynamic का अर्थ है कि आप Objective-C डायनामिक डिस्पैच का उपयोग करना चाहते हैं।
मूल CRUD ऐप फ़ंक्शन
हमारा ऐप निम्नलिखित फ़ंक्शन करेगा:
- AlertViewController का उपयोग करके उपयोगकर्ता से इनपुट प्राप्त करें।
- इनपुट को डेटाबेस में और टेबल व्यू में भी जोड़ें।
- उपयोगकर्ता को अपना इनपुट संपादित करने की अनुमति दें।
- डेटा को टेबल व्यू और डेटाबेस दोनों से हटाने के लिए पंक्ति पर स्वाइप करें।
- डेटाबेस से सभी डेटा (यदि मौजूद है) प्राप्त करें और इसे टेबल व्यू में प्रदर्शित करें।
AlertViewController का उपयोग करके उपयोगकर्ता से इनपुट कैसे प्राप्त करें
ViewController.swift खोलें और viewDidLoad() मेथड के अंदर नीचे दिया गया कोड जोड़ें। और addTask() नामक एक नया फ़ंक्शन बनाएं और टेक्स्ट बॉक्स के साथ अलर्ट व्यू कंट्रोलर को प्रदर्शित करने के लिए कोड जोड़ें ताकि उपयोगकर्ता से इनपुट प्राप्त किया जा सके।
अब जब राइट बार बटन दबाया जाता है तो यह addTask() फ़ंक्शन को कॉल करेगा जो एक टेक्स्ट फील्ड के साथ alertViewController प्रदर्शित करेगा ताकि उपयोगकर्ता इनपुट प्राप्त किया जा सके।
navigationItem.rightBarButtonItem = UIBarButtonItem(image: .add, style: .done, target: self, action: #selector(addTask))
navigationController?.navigationBar.prefersLargeTitles = true
title = "RealmDB"
@objc func addTask() {
let ac = UIAlertController(title: "नोट जोड़ें", message: nil, preferredStyle: .alert)
ac.addTextField(configurationHandler: nil)
ac.addAction(UIAlertAction(title: "जोड़ें", style: .default, handler: { (UIAlertAction) in
if let text = ac.textFields?.first?.text {
print(text)
}
}))
ac.addAction(UIAlertAction(title: "रद्द करें", style: .cancel, handler: nil))
present(ac, animated: true, completion: nil)
}
इनपुट को डेटाबेस और टेबल व्यू में कैसे जोड़ें
Realm में डेटा सेव करने के लिए, पहले हमें Realm के लिए एक इंस्टेंस प्राप्त करने की आवश्यकता है जिसके माध्यम से हम CRUD ऑपरेशन के लिए आवश्यक सभी मेथड्स तक पहुंच सकते हैं। ViewController.swift फ़ाइल में Realm प्रकार की एक प्रॉपर्टी बनाएं और इसे viewDidLoad() मेथड में इनिशियलाइज़ करें।
var realmDB: Realm!
override func viewDidLoad() {
super.viewDidLoad()
navigationItem.rightBarButtonItem = UIBarButtonItem(image: .add, style: .done, target: self, action: #selector(addTask))
navigationController?.navigationBar.prefersLargeTitles = true
title = "RealmDB"
realmDB = try! Realm()
}
हमारे डेटा मॉडल (ToDoTask) के प्रकार की एक खाली सरणी बनाएं। यह सरणी उन सभी टास्क को रखेगी जिन्हें टेबल व्यू और डेटाबेस में जोड़ने की आवश्यकता है।
अब addTask() फ़ंक्शन के अंदर Add एक्शन क्लोजर को संशोधित करें ताकि यह उपयोगकर्ता इनपुट प्राप्त करे और उस इनपुट के लिए एक रैंडम आईडी बनाए। फिर इसे हमारी सरणी में जोड़ें और डेटाबेस में सेव करें।
var tasks = [ToDoTask]()
if let text = ac.textFields?.first?.text {
// डेटा मॉडल सरणी में डेटा जोड़ें
let t = ToDoTask()
t.taskId = UUID().uuidString
t.taskNote = text
self.tasks.append(t)
// डेटाबेस में डेटा जोड़ें
try! self.realmDB.write {
self.realmDB.add(t)
}
// टेबल व्यू UI अपडेट करें
self.taskTV.reloadData()
}
अब जब आप ऐप चलाते हैं, तो डेटा डेटाबेस में सेव हो जाएगा। लेकिन यह टेबल व्यू में नहीं दिखेगा क्योंकि हमने डेलीगेट मेथड्स लागू नहीं किए हैं।
ViewController क्लास को UITableViewDelegate और UITableViewDataSource प्रोटोकॉल लागू करने के लिए बनाएं और प्रोटोकॉल स्टब्स जोड़ें।
अब numberOfRowsInSection मेथड के अंदर, हमारी टास्क सरणी की गिनती लौटाएं जो टेबल व्यू में जोड़ी जाने वाली पंक्तियों की संख्या देती है। यह टास्क सरणी में तत्वों की संख्या के बराबर है।
func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
return tasks.count
}
अगली चीज जो हमें करने की आवश्यकता है वह है प्रत्येक पंक्ति में सामग्री निर्दिष्ट करना। हम इसे cellForRowAt डेलीगेट मेथड का उपयोग करके कर सकते हैं। यहां हम स्टोरीबोर्ड में उल्लिखित पहचानकर्ता का उपयोग करके एक सेल को डीक्यू करते हैं और लेबल टेक्स्ट को टास्क सरणी तत्व की taskNote प्रॉपर्टी के रूप में निर्दिष्ट करते हैं।
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
if let cell = tableView.dequeueReusableCell(withIdentifier: "cell") {
cell.textLabel?.text = tasks[indexPath.row].taskNote
return cell
}
return UITableViewCell()
}
उपयोगकर्ताओं को अपना इनपुट संपादित करने की अनुमति कैसे दें
अब हमें उपयोगकर्ता को उनके दर्ज टास्क को संपादित करने और डेटाबेस और UI दोनों में परिवर्तनों को अपडेट करने की अनुमति देनी होगी। हम इसे उपयोगकर्ता से इनपुट प्राप्त करने के समान तरीकों का उपयोग करके कर सकते हैं। didSelectRowAt डेलीगेट मेथड को लागू करें जिसे तब कॉल किया जाएगा जब उपयोगकर्ता टेबल व्यू पंक्ति पर टैप करेगा।
नीचे दिया गया कोड जोड़ें जो एक टेक्स्ट व्यू के साथ AlertViewController प्रदर्शित करता है। फिर सेल की सामग्री को दर्ज टेक्स्ट के साथ अपडेट करें, और साथ ही डेटाबेस सामग्री को अपडेट करें।
func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
let taskToModify = tasks[indexPath.row]
let ac = UIAlertController(title: "टास्क अपडेट करें", message: nil, preferredStyle: .alert)
ac.addTextField(configurationHandler: nil)
ac.addAction(UIAlertAction(title: "OK", style: .default, handler: { (UIAlertAction) in
if let text = ac.textFields?.first?.text {
if !text.isEmpty {
try! self.realmDB.write {
taskToModify.taskNote = text
}
self.taskTV.reloadData()
}
}
}))
present(ac, animated: true, completion: nil)
}
पंक्ति पर स्वाइप करके हटाएं और डेटा को टेबल व्यू और डेटाबेस दोनों से हटाएं
यहां हम अपने टेबल व्यू में स्वाइप टू डिलीट फीचर लागू करने जा रहे हैं ताकि उपयोगकर्ता अपने टास्क हटा सकें। लेकिन अंदर से जब उपयोगकर्ता टेबल व्यू पंक्ति पर स्वाइप डिलीट करता है तो उसे डेटाबेस से डेटा, डेटा मॉडल सरणी से हटाना चाहिए, और टेबल व्यू के UI को अपडेट करना चाहिए।
हम इसे commit editingStyle डेलीगेट मेथड को लागू करके और निम्न कोड जोड़कर कर सकते हैं:
func tableView(_ tableView: UITableView, commit editingStyle: UITableViewCell.EditingStyle, forRowAt indexPath: IndexPath) {
if editingStyle == .delete {
let taskToDelete = tasks[indexPath.row]
try! realmDB.write {
realmDB.delete(taskToDelete)
self.tasks.remove(at: indexPath.row)
self.taskTV.deleteRows(at: [indexPath], with: .fade)
}
}
}
डेटाबेस से सभी डेटा (यदि मौजूद है) प्राप्त करें और इसे टेबल व्यू में प्रदर्शित करें
अब हम अपना अंतिम ऑपरेशन, Read, लागू करने जा रहे हैं। जब भी उपयोगकर्ता ऐप लॉन्च करता है, तो उसे डेटाबेस से डेटा प्राप्त करना चाहिए (यदि डेटा मौजूद है) और इसे टेबल व्यू में प्रदर्शित करना चाहिए।
हम इसे व्यू कंट्रोलर स्विफ्ट फ़ाइल में getTodos फ़ंक्शन बनाकर और उसमें निम्न कोड जोड़कर कर सकते हैं:
func getTodos() {
// डेटाबेस से सभी डेटा प्राप्त करें
let notes = realmDB.objects(ToDoTask.self)
// डुप्लिकेट को रोकने के लिए मॉडल डेटा सरणी को साफ़ करें
self.tasks.removeAll()
/* यदि प्राप्त डेटा खाली नहीं है तो इसे मॉडल डेटा सरणी में जोड़ें और UI अपडेट करें */
if !notes.isEmpty {
for n in notes {
self.tasks.append(n)
}
self.taskTV.reloadData()
}
}
बोनस टिप: iOS सिम्युलेटर में अपने डेटाबेस कंटेंट को कैसे देखें
अब जब आप अपना ऐप चलाते हैं, तो आप देख सकते हैं कि यह उम्मीद के मुताबिक काम करता है। लेकिन हम कैसे जांच सकते हैं कि डेटा वास्तव में डेटाबेस में संग्रहीत है? हम MongoDB Realm Studio नामक एक ऐप का उपयोग कर सकते हैं जिसके माध्यम से हम सिम्युलेटर के Realm डेटाबेस में संग्रहीत अपने डेटा को देख सकते हैं।
ध्यान दें कि यह विधि केवल तभी काम करती है जब आप iOS सिम्युलेटर का उपयोग करके ऐप का परीक्षण करते हैं
viewDidLoad() मेथड में, नीचे दी गई कोड लाइन जोड़ें जो हमारे ऐप का वास्तविक फ़ाइल पथ प्रिंट करेगी:
print(realmDB.configuration.fileURL!)
अब कंसोल में प्रिंट किए गए फ़ाइल पथ को कॉपी करें, टर्मिनल खोलें, और निम्न कमांड चलाएं:
open REALM_FILE_PATH_HERE
उपरोक्त कमांड चलाने से पहले सुनिश्चित करें कि आपने ब्राउज़र से MongoDB Realm Studio डाउनलोड कर लिया है।
अब यह MongoDB Realm Studio में ऐप की RealmFile खोलेगा। यह डेटाबेस में संग्रहीत डेटा को टेबल फॉर्मेट में प्रदर्शित करेगा।
यदि आप अपने डेटा में संपादन या टास्क हटाकर परिवर्तन करते हैं, तो परिवर्तन MongoDB Realm Studio ऐप में परिलक्षित होंगे:
बधाई हो! आपने एक साधारण ऐप बनाया है जो iOS ऐप्स में CRUD ऑपरेशन लागू करता है।