📐 🚼 🎣 C ++ (Qt) में कॉन्फ़िगरेशन फ़ाइलों के साथ काम करने के तरीकों में से एक 🎩 🔊 🛸

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

परिचय

Qt में बहुत सुविधाजनक QSettings क्लास है। सिद्धांत रूप में, इसका उपयोग करना बहुत आसान है:

/* main.cpp */ int main(int argc, char *argv[]){ //    ()  QSettgins  //      QCoreApplication::setOrganizationName("org"); QCoreApplication::setApplicationName("app"); ... return 0; }

 /* some.cpp */ void func(){ QSettings conf; ... //    conf.setValue("section1/key1", someData); //    section1 conf.setValue("key2", someData2); //    General ... //    QString strData = conf.value("section1/key1").toString(); }

उपरोक्त उदाहरण से, QSettings का सामान्य उपयोग, आप तुरंत एक्स्टेंसिबिलिटी और कोड समर्थन मुद्दों को देखते हैं:

यदि कोड में मुख्य नाम स्पष्ट रूप से लिखे गए हैं, तो भविष्य में हम एक ऐसी स्थिति का सामना कर सकते हैं, जहां अन्य कॉन्फ़िगरेशन कुंजियों को हटाना / जोड़ना मुश्किल होगा। यानी इस दृष्टिकोण के साथ, यहां समस्या यह है कि संकलन चरण पर अमान्य कुंजियों को पकड़ना असंभव है।
# 1 समस्या से बचने के लिए, हम सभी कुंजियों को एक अलग हेडर फ़ाइल में लिख सकते हैं, और उन्हें स्ट्रिंग स्थिरांक के माध्यम से एक्सेस कर सकते हैं। कोड की प्रतिरूपकता में सुधार लाने और वैश्विक दायरे को साफ करने के लिए, सभी चाबियों को अलग नामस्थान में रखना भी उचित होगा।
```
 namespace Settings{ const char * const key1 = "key1"; const char * const section1_key1 = "section1/key1"; const char * const section1_key2 = "section1/key2"; } 
```
लेकिन यहाँ हमारे पास एक और सुखद विवरण नहीं है:
* सबसे पहले बहुत अधिक क्रिया, अर्थात्। जानकारी डुप्लिकेट है (की 1 -> "की 1", आदि)। सिद्धांत रूप में, यह आश्चर्य की बात नहीं है, क्योंकि हमें किसी तरह प्रमुख नामों के क्रमांकन का वर्णन करना है। हां, हम एक मैक्रो लिख सकते हैं, लेकिन अच्छी तरह से ज्ञात कारणों के लिए, मैक्रोज़ से बचा जाना चाहिए, खासकर अगर वैकल्पिक विकल्प हैं।
* दूसरे, पर्याप्त संख्या में कुंजियों और वर्गों के साथ, यह संभावना है कि आपको सभी संयोजनों के लिए स्थिरांक पंजीकृत करना होगा, जो बहुत सुविधाजनक नहीं है। बेशक, हम कुंजी और अलग-अलग वर्गों के लिए स्थिरांक प्राप्त कर सकते हैं, लेकिन फिर, QSettings के लिए प्रत्येक कॉल के साथ, हमें स्ट्रिंग्स को संयोजित करना होगा।

यदि आप उपरोक्त सभी समस्याओं की सावधानीपूर्वक समीक्षा करते हैं, तो हम निष्कर्ष निकाल सकते हैं: कुंजी को एक स्ट्रिंग द्वारा दर्शाया गया है - यह मुख्य समस्या है। दरअसल, अगर हम कुंजी के रूप में एनम ( enum s) का उपयोग करते हैं, तो उपरोक्त सभी एक ही बार में गायब हो जाते हैं।

Enumerations बेशक सुविधाजनक हैं, लेकिन QSettings को एक प्रमुख पैरामीटर, एक स्ट्रिंग के रूप में आवश्यक है। यानी हमें कुछ ऐसे तंत्र की आवश्यकता है जो हमें एन्यूमरेशंस के मूल्यों को स्ट्रिंग्स में अनुवाद करने में सक्षम करें (एन्यूमरेशन्स के तत्वों के स्ट्रिंग मानों को निकालने के लिए)। उदाहरण के लिए, निम्न गणना से:

 enum Key{ One, Two, Three };

आपको किसी तरह 3 पंक्तियों को निकालने की आवश्यकता है: "एक", "दो", "तीन"।
दुर्भाग्य से, मानक C ++ टूल का उपयोग करना, यह संभव नहीं है। लेकिन क्या करें?
यहाँ Qt अपने मेटा-ऑब्जेक्ट मॉडल या QMetaEnum के साथ बचाव में आता है। मैं QMetaEnum के बारे में नहीं लिखूंगा , क्योंकि यह एक अलग विषय है। मैं केवल लिंक दे सकता हूं: एक , दो ।

कार्यान्वयन

सेवा में QMetaEnum के साथ, हम अब सेटिंग्स वर्ग को लागू कर सकते हैं, उपरोक्त सभी नुकसानों से रहित, साथ ही साथ डिफ़ॉल्ट सेटिंग्स निर्दिष्ट करने की क्षमता प्रदान करते हैं। सेटिंग्स क्लास एक सिंगलटन मेयर्स है, इससे हमें कॉन्फ़िगरेशन और इसके उपयोग में आसानी होती है:

settings.h (स्पॉइलर का विस्तार करें)

 /* settings.h */ #ifndef SETTINGS_H #define SETTINGS_H #include <QVariant> #include <QSettings> #include <QMetaEnum> /** @brief      Usage: @code ... ... //  (  -  main) QApplication::setOrganizationName("Organization name"); QApplication::setApplicationName("App name"); ... ... //    (   ) Settings::setDefaults("SomeKey: value1; SomeSection/SomeKey: value2"); //  QFile f(":/defaults/config"); f.open(QIODevice::ReadOnly); Settings::setDefaults(f.readAll()); ... ... void fun(){ ... QVariant val1 = Settings::get(Settings::SomeKey); Settings::set(Settings::SomeKey) = "new val1"; ... QVariant val2 = Settings::get(Settings::SomeKey, Settings::SomeSection); Settings::set(Settings::SomeKey, Settings::SomeSection) = "new val2"; ... } @endcode */ class Settings{ Q_GADGET Q_ENUMS(Section) Q_ENUMS(Key) public: enum Section{ General, Network, Proxy }; enum Key{ URI, Port, User, Password }; class ValueRef{ public: ValueRef(Settings &st, const QString &kp) : parent(st), keyPath(kp){} ValueRef & operator = (const QVariant &d); private: Settings &parent; const QString keyPath; }; static void setDefaults(const QString &str); static QVariant get(Key, Section /*s*/ = General); static ValueRef set(Key, Section /*s*/ = General); private: QString keyPath(Section, Key); static Settings & instance(); QMetaEnum keys; QMetaEnum sections; QMap<QString, QVariant> defaults; QSettings conf; Settings(); Settings(const Settings &); Settings & operator = (const Settings &); }; #endif // SETTINGS_H

settings.cpp (स्पॉइलर का विस्तार करें)

 /* settings.cpp */ #include "settings.h" #include <QSettings> #include <QMetaEnum> #include <QRegExp> #include <QStringList> Settings::Settings(){ const QMetaObject &mo = staticMetaObject; int idx = mo.indexOfEnumerator("Key"); keys = mo.enumerator(idx); idx = mo.indexOfEnumerator("Section"); sections = mo.enumerator(idx); } QVariant Settings::get(Key k, Section s){ Settings &self = instance(); QString key = self.keyPath(s, k); return self.conf.value(key, self.defaults[key]); } Settings::ValueRef Settings::set(Key k, Section s){ Settings &self = instance(); return ValueRef(self, self.keyPath(s, k)); } void Settings::setDefaults(const QString &str){ Settings &self = instance(); //section/key : value //section - optional QRegExp rxRecord("^\\s*(((\\w+)/)?(\\w+))\\s*:\\s*([^\\s].{0,})\\b\\s*$"); auto kvs = str.split(QRegExp(";\\W*"), QString::SkipEmptyParts); //key-values for(auto kv : kvs){ if(rxRecord.indexIn(kv) != -1){ QString section = rxRecord.cap(3); QString key = rxRecord.cap(4); QString value = rxRecord.cap(5); int iKey = self.keys.keyToValue(key.toLocal8Bit().data()); if(iKey != -1){ int iSection = self.sections.keyToValue(section.toLocal8Bit().data()); if(section.isEmpty() || iSection != -1){ self.defaults[rxRecord.cap(1)] = value; } } } } } //Settings::ValueRef----------------------------------------------------------- Settings::ValueRef & Settings::ValueRef::operator = (const QVariant &data){ parent.conf.setValue(keyPath, data); return *this; } //PRIVATE METHODS-------------------------------------------------------------- QString Settings::keyPath(Section s, Key k){ auto szSection = sections.valueToKey(s); auto szKey = keys.valueToKey(k); return QString(s == General ? "%1" : "%2/%1").arg(szKey).arg(szSection); } Settings & Settings::instance(){ static Settings singleton; return singleton; }

इस कार्यान्वयन में, QSettings वर्ग का उपयोग विशेष रूप से सेटिंग्स के लिए क्रॉस-प्लेटफॉर्म एक्सेस के लिए किया जाता है। बेशक, यदि वांछित है, तो QSettgins को किसी अन्य तंत्र, जैसे कि SQLite द्वारा प्रतिस्थापित किया जा सकता है।

उदाहरण का उपयोग करें

सेटिंग्स वर्ग केवल तीन स्थिर तरीकों से मिलकर एक बहुत ही सरल और सुविधाजनक इंटरफ़ेस प्रदान करता है:
void setDefaults(const QString &str); - डिफ़ॉल्ट पैरामीटर सेट करना
QVariant get(Key, Section); - मान पढ़ना (अनुभाग छोड़ा जा सकता है)
ValueRef set(Key, Section); - मूल्य का रिकॉर्ड (अनुभाग छोड़ा जा सकता है)

 /* main.cpp */ #include <QtCore/QCoreApplication> #include <QUrl> #include <QFile> #include "settings.h" void doSome(){ //   General QString login = Settings::get(Settings::User).toString(); // login == "unixod" QUrl proxyUrl = Settings::get(Settings::URI, Settings::Proxy).toUrl(); // http://proxy_uri QString generalUrl = Settings::get(Settings::URI).toString(); //  if(generalUrl.isEmpty()) Settings::set(Settings::URI) = "http://some_uri"; } int main(int argc, char *argv[]){ //   QSettings      QCoreApplication::setOrganizationName("unixod"); QCoreApplication::setApplicationName("app"); //     : QFile cfgDefaults(":/config/default.cfg"); //        cfgDefaults.open(QIODevice::ReadOnly); Settings::setDefaults(cfgDefaults.readAll()); //... doSome(); //... return 0; }

यहां डिफ़ॉल्ट सेटिंग्स विवरण सिंटैक्स का एक उदाहरण दिया गया है:

default.cfg (स्पॉयलर का विस्तार करें)

 Proxy/URI: http://proxy_uri; User: unixod;

जैसा कि आप देख सकते हैं प्रारूप सरल है:
[section name]/key : value;

निष्कर्ष

यह ध्यान देने योग्य है कि यह सेटिंग्स वर्ग आसानी से विस्तार योग्य है। यानी यदि वांछित है, तो किसी भी कुंजी या अनुभाग को जोड़ें / हटाएं / नाम बदलें , बस संबंधित एनम को बदल दें !

पाठक यह पूछ सकता है कि क्या सामान्य तर्क "कोष्ठक से बाहर" रखना संभव है।
उत्तर: यह संभव है लेकिन बेहतर नहीं है। चूंकि क्यूटी मेटा-ऑब्जेक्ट मॉडल टेम्पलेट्स के साथ काम नहीं करता है, इसलिए आपको मैक्रोज़ का उपयोग करना होगा, जो कि ज्ञात समस्याओं को उलझाता है:

डिबगिंग जटिलता
आईडीई के लिए कठिनाई कोड विश्लेषण
पढ़ने में कठिनाई, कोड
आदि

निर्माण करते समय, C ++ 11 समर्थन को सक्षम करने के लिए मत भूलना:

जीसीसी:
-std = c ++ 0x
Qt प्रोजेक्ट फ़ाइल:
QMAKE_CXXFLAGS + = -std = c ++ 0x

आपका ध्यान देने के लिए धन्यवाद। )

C ++ (Qt) में कॉन्फ़िगरेशन फ़ाइलों के साथ काम करने के तरीकों में से एक

परिचय

कार्यान्वयन

उदाहरण का उपयोग करें

निष्कर्ष

More articles: