PHP में ऑब्जेक्ट कलेक्शन

पिछले 5 वर्षों में मैं PHP के साथ काम कर रहा हूँ। उसके पास कुछ अलग समस्याएं हैं, लेकिन यह पूरी तरह से काम करने वाले उत्पादों को बनाने के लिए कभी नहीं रुका।

इसके बावजूद, कई चीजें हैं जो काफी "कुटिल" के अंदर की जाती हैं। एक प्रश्न जो मेरी नसों को लगातार बर्बाद कर रहा था, वह डेटा की एक सरणी का उपयोग करके वस्तुओं के सेट के साथ काम करने का मुद्दा था।

मेरी राय में, PHP में सरणियों की काफी व्यापक कार्यक्षमता है, जो, वस्तुओं के सेट के साथ काम करते समय समस्याओं में से एक है।

आपको क्या पसंद नहीं आया?

• ऐतिहासिक रूप से विकसित फ़ंक्शन नाम और OO इंटरफ़ेस की कमी ।
• एक साहचर्य सरणी बनाने में असमर्थता जहां चाबियाँ ऑब्जेक्ट हैं।
• सरणी में वस्तुओं के प्रकार का स्वतंत्र नियंत्रण।
• सूची में सूचकांक के अनुक्रम का स्वतंत्र नियंत्रण।

नतीजतन, यह एक पैकेज बनाने का फैसला किया गया था जो एक ही प्रकार (संग्रह) की वस्तुओं के सेट के साथ काम करना चाहिए।

और इसलिए, मैं आपको Rmk \ Collection पैकेज पेश करता हूं।

इंटरफेस

संग्रह इंटरफेस का उद्देश्य संग्रह प्रकारों की कार्यक्षमता और वर्गीकरण का वर्णन करना है।

संग्रह के लिए आधार इंटरफ़ेस संग्रह इंटरफ़ेस है।

मानचित्र, सेट, सूची, कतार, और Deque इंटरफेस संग्रह इंटरफ़ेस को इनहेरिट करते हैं और अपनी कार्यक्षमता जोड़ते हैं।

Iterable इंटरफ़ेस संग्रह वस्तुओं को पार करने के लिए डिज़ाइन किया गया है। यह सभी संग्रह इंटरफेस द्वारा समर्थित है।



iterable
यह इंटरफ़ेस संग्रह वस्तुओं को पार करने और प्रत्येक ऑब्जेक्ट के लिए एक कस्टम फ़ंक्शन को लागू करने की क्षमता प्रदान करता है।

संग्रह
यह इंटरफ़ेस कई वस्तुओं के साथ काम करने के बुनियादी कार्यों का वर्णन करने के लिए डिज़ाइन किया गया है। यह गणनीय और Iterable इंटरफ़ेस को विरासत में मिला है, जो आपको संग्रह में ऑब्जेक्ट की संख्या प्राप्त करने और संग्रह में प्रत्येक ऑब्जेक्ट के लिए उपयोगकर्ता-परिभाषित फ़ंक्शन को लागू करने की अनुमति देता है। संग्रह इंटरफ़ेस का अर्थ है कि संग्रह में एक ही प्रकार की वस्तुएं हैं।

नक्शा
इस इंटरफ़ेस का उद्देश्य वस्तुओं के मानचित्र की कार्यक्षमता का वर्णन करना है। ऑब्जेक्ट मैप ऑब्जेक्ट के बीच साहचर्य संबंध बनाने के लिए डिज़ाइन किया गया है, जहां वस्तुओं में से एक कुंजी है और दूसरा मूल्य है। ऑब्जेक्ट मैप का इंटरफ़ेस बताता है कि मैप में एक ही प्रकार की चाबियाँ हैं। ऑब्जेक्ट मैप इंटरफ़ेस मानता है कि मैप में एक ही प्रकार के मान हैं। ऑब्जेक्ट इंटरफ़ेस इंटरफ़ेस संग्रह इंटरफ़ेस से विरासत में मिला है।

सेट
इस इंटरफ़ेस का उद्देश्य वस्तुओं के एक सेट की कार्यक्षमता का वर्णन करना है जहाँ ऑब्जेक्ट संग्रह में अद्वितीय हैं। ऑब्जेक्ट की विशिष्टता getIdentity () पद्धति का उपयोग करके की जाती है। ऑब्जेक्ट सेट इंटरफ़ेस संग्रह इंटरफ़ेस से विरासत में मिला है।

कतार
इस इंटरफ़ेस का उद्देश्य ऑब्जेक्ट कतार की कार्यक्षमता का वर्णन करना है। ऑब्जेक्ट कतार का उद्देश्य डेटा संरचना का वर्णन करना है जब ऑब्जेक्ट्स को कतार के अंत में जोड़ा जाता है और कतार की शुरुआत से लिया जाता है। ऑब्जेक्ट कतार इंटरफ़ेस संग्रह इंटरफ़ेस को इनहेरिट करता है।

Deque
इस इंटरफ़ेस का उद्देश्य वस्तुओं की एक द्विदिश कतार की कार्यक्षमता का वर्णन करना है। द्विदिश वस्तु कतार कतार इंटरफ़ेस कतार वस्तु कतार इंटरफ़ेस को इनहेरिट करता है और अतिरिक्त कार्यक्षमता जोड़ता है। वस्तुओं की एक द्विदिश कतार की कार्यक्षमता का अर्थ है कि दोनों तरफ कतार के साथ काम करना।

SequentialList
इस इंटरफ़ेस का उद्देश्य वस्तुओं की सूची की कार्यक्षमता का वर्णन करना है। वस्तुओं की एक सूची वस्तुओं का एक क्रम है जहां वस्तुओं को लगातार पूर्णांक सूचकांकों के तहत संग्रहीत किया जाता है। ऑब्जेक्ट्स की सूची की सामान्य कार्यक्षमता के अलावा, यह इंटरफ़ेस Iterable :: प्रत्येक () के समान एक रिवर्स ईच () विधि को परिभाषित करता है, सिवाय इसके कि रिवर्स ईयर () विधि रिवर्स ऑर्डर में सूची का पता लगाती है। ऑब्जेक्ट सूची इंटरफ़ेस संग्रह इंटरफ़ेस से विरासत में मिला है।

कार्ड कार्यान्वयन

मैप्स को HashMap और HashStore के कार्यान्वयन द्वारा दर्शाया जाता है।

HashMap और HashStore की कार्यक्षमता का हिस्सा AbstractCollection और AbstractMap अमूर्त वर्गों से विरासत में मिला है।

HashMap और HashStore नक्शे की आंतरिक संरचना सहयोगी लिंक के एक नेटवर्क पर आधारित है। यह साहचर्य नमूनों का उपयोग करके सभी कार्ड संचालन को लागू करना संभव बनाता है, जिससे उनकी गति बढ़ जाती है। मानचित्र एल्गोरिदम के काम की जटिलता हे (1) है, जिसका अर्थ है कि वस्तुओं के स्थापना / पुनर्प्राप्ति समय कार्ड के आकार के आधार पर नहीं बदलता है।

HashMap और HashStore कार्ड कुंजियों और मूल्यों के लिए किसी भी प्रकार के डेटा का समर्थन करते हैं। यह मानक Php सरणियों पर एक कार्यात्मक लाभ है।

HashMap कार्ड कुंजियाँ अद्वितीय हैं। HashMap मानचित्र मान अद्वितीय नहीं हैं, जो आपको कई कुंजियों के साथ एकल मान संबद्ध करने की अनुमति देता है।

हैशस्टोर मानचित्र की कुंजी और मूल्य अद्वितीय हैं, जो आपको अद्वितीय संबद्ध वस्तुओं के भंडारण को व्यवस्थित करने की अनुमति देता है।

एक HashStore कार्ड, HashMap कार्ड की तुलना में औसतन 20% तेजी से चलता है। यह लाभ HashStore में वस्तुओं की विशिष्टता के कारण प्राप्त होता है, जिसके लिए कम सहयोगी लिंक की आवश्यकता होती है।

कार्यान्वयन सेट करें

किट्स का प्रतिनिधित्व यूनिकस्टोर के अद्वितीय कार्यान्वयन द्वारा किया जाता है।

UniqueStore स्टोरेज में ऑब्जेक्ट। वस्तुओं की विशिष्टता को गेटइंडिटी () विधि द्वारा सुनिश्चित किया जाता है, जो वस्तुओं के पहचानकर्ताओं को वापस लौटाता है। UniqueStore रिपॉजिटरी में समान पहचानकर्ताओं के साथ कई ऑब्जेक्ट नहीं हो सकते।

अद्वितीय वस्तुओं के भण्डार की आंतरिक संरचना UniqueStore को वस्तुओं और उनके पहचानकर्ताओं के बीच संबंध के आधार पर बनाया गया है। यह साहचर्य नमूनों का उपयोग करके सभी भंडारण संचालन को लागू करना संभव बनाता है, जिससे इसकी गति बढ़ जाती है। अद्वितीय वस्तुओं के भंडारण के लिए एल्गोरिदम के संचालन की जटिलता हे (1) है, जिसका अर्थ है कि वस्तुओं के स्थापना / पुनर्प्राप्ति समय भंडारण के आकार के आधार पर नहीं बदलता है।

UniqueStore मूल्यों के लिए सभी प्रकार के डेटा का समर्थन करता है।

सूची कार्यान्वयन

सूचियाँ ArrayList और LinkedList कार्यान्वयन द्वारा प्रस्तुत की जाती हैं।

ArrayList और LinkedList ऑब्जेक्ट सूचियाँ अनुक्रमिक अनुक्रम क्रम बनाए रखती हैं जब उनकी संरचना बदलती है।

ArrayList और LinkedList ऑब्जेक्ट सूचियों का प्रदर्शन उनकी संरचना में परिवर्तन की संख्या पर निर्भर करता है। इसके आधार पर, सूची के अंत में सबसे "सस्ते" ऑपरेशन हैं (जोड़ें / हटाएं), और सबसे "महंगी" सूची की शुरुआत में ऑपरेशन (जोड़ / हटाएं) हैं। ऑब्जेक्ट सूची एल्गोरिदम के संचालन की जटिलता हे (एन * (गणना - सूचकांक)), जहां एन ऑपरेशन है; गिनती - सूची का आकार; सूचकांक - वह सूचकांक जिस पर ऑपरेशन किया जाता है।

ArrayList और LinkedList ऑब्जेक्ट सूची मूल्यों के लिए किसी भी डेटा प्रकार का समर्थन करती है।

लिंक्डलिस्ट ऑब्जेक्ट्स की लिंक की गई सूची, Deque ऑब्जेक्ट्स के द्विदिश क्यू को लागू करती है और ArrayList से कार्यक्षमता प्राप्त करती है।

कतार कार्यान्वयन

लिंक्डलिस्ट लिंक्ड लिस्ट पूरी तरह से अपनी कार्यक्षमता को कवर करने के बाद से कोई विशिष्ट कतार कार्यान्वयन नहीं हैं।

कुछ उपयोग के मामले

कार्ड का उपयोग करने के उदाहरण:

<?php namespace Rmk\Collection; use \UnexpectedValueException as UnexpectedValueException; use \InvalidArgumentException as InvalidArgumentException; use \stdClass as stdClass; include '../../bootstrap.php'; $map = new HashMap('stdClass', 'string'); $obj1 = new stdClass(); $obj2 = new stdClass(); $obj3 = new stdClass(); //    / . $map->set('k1', $obj1); $map->set('k2', $obj2); $map->set('k3', $obj3); try { $map->set(27, $obj1); } catch (InvalidArgumentException $exc) { echo '    .'; } try { $map->set('k4', new UnexpectedValueException); } catch (InvalidArgumentException $exc) { echo '    .'; } //  . $map->each(function($value, $key, $thisMap) { /** * @TODO:  . */ } ); //   . $map->remove($obj1); $map->remove($obj2); //   . $map->removeKey('k3'); if ($map->isEmpty()) { /** * @TODO:  ,   ? */ } //   . $array = $map->toArray(); // !     ,    //  . $objectMap = new HashMap('stdClass', 'stdClass'); try { $objectArray = $objectMap->toArray(); } catch (UnexpectedValueException $exc) { echo '     .'; } 

सेट का उपयोग करने के उदाहरण:

 <?php namespace Rmk\Collection; use \UnexpectedValueException as UnexpectedValueException; use \InvalidArgumentException as InvalidArgumentException; use \stdClass as stdClass; include '../../bootstrap.php'; $set = new UniqueStore('stdClass'); $obj1 = new stdClass(); $obj2 = new stdClass(); $obj3 = new stdClass(); //    . $set->add($obj1); $set->add($obj2); $set->add($obj3); //       . $set->add($obj3); try { $set->add(new UnexpectedValueException); } catch (InvalidArgumentException $exc) { echo '    .'; } //  . $set->each(function($value, $thisSet) { /** * @TODO:  . */ } ); //    . $set->remove($obj1); $set->remove($obj2); $set->remove($obj3); //   . $array = $set->toArray(); 

सूची का उपयोग करने के उदाहरण:

 <?php namespace Rmk\Collection; use \UnexpectedValueException as UnexpectedValueException; use \InvalidArgumentException as InvalidArgumentException; use \OutOfRangeException as OutOfRangeException; use \stdClass as stdClass; include '../../bootstrap.php'; $list = new LinkedList('stdClass'); $obj1 = new stdClass(); $obj2 = new stdClass(); $obj3 = new stdClass(); //    . $list->add(0, $obj1); $list->add(1, $obj2); $list->add(2, $obj3); try { $list->add(4, $obj1); } catch (OutOfRangeException $exc) { echo '     ,   .'; } //  . $list->each(function($value, $index, $thisList) { /** * @TODO:  . */ } ); //     . $list->reverseEach(function($value, $index, $thisList) { /** * @TODO:  . */ } ); //   . $list->remove($obj1); $list->removeIndex(0); $list->removeFirst(); if ($list->isEmpty()) { echo ' .'; } 

फायदे और नुकसान

• +
  • संग्रह में वस्तुओं के प्रकार में आत्मविश्वास।
  • "सरणी फ़ंक्शंस" के बजाय OO इंटरफ़ेस (इस पैकेज को लिखने का मुख्य कारण)।
  • अनुक्रमिक प्रकार के संग्रह में अनुक्रमित के अनुक्रम में आत्मविश्वास।
  
  
• -
  • सशर्त रूप से कम प्रदर्शन। PHP के कार्यान्वयन से क्या निचोड़ा जा सकता है, मैंने निचोड़ने की कोशिश की। लेकिन अगर इस पैकेज को C में PECL मॉड्यूल के रूप में लागू किया गया था, तो यह बहुत तेजी से काम करेगा।

स्रोत कोड

https://github.com/rmk135/Rmk-Framework