स्पंदन में निर्भरता इंजेक्शन

वर्तमान में हम सहयोगियों के साथ कदम चुनौतियों के लिए हमारे पक्ष परियोजना को विकसित करते हुए स्पंदन के साथ प्रयोग कर रहे हैं। इस साइड प्रोजेक्ट को एक खेल का मैदान भी माना जाना चाहिए, जहां हम जांच सकते हैं कि क्या हम फ्लटर का उपयोग अधिक गंभीर परियोजनाओं में कर सकते हैं। इसलिए हम वहां कुछ दृष्टिकोणों का उपयोग करना चाहते हैं जो इस तरह की एक छोटी परियोजना के लिए एक ओवर-इंजीनियरिंग की तरह दिख सकते हैं।

तो पहला सवाल यह था कि हम निर्भरता इंजेक्शन के लिए क्या उपयोग कर सकते हैं। इंटरनेट में एक त्वरित खोज ने सकारात्मक समीक्षा के साथ 2 पुस्तकालयों का पता लगाया: get_it और कीवी । जैसा कि get_it एक सेवा लोकेटर निकला (और मैं इस पैटर्न का प्रशंसक नहीं हूं), मैं कीवी के साथ खेलने जा रहा था, जो अधिक आशाजनक लग रहा था, लेकिन फिर मुझे एक और पुस्तकालय मिला है: inject.dart । यह डैगर लाइब्रेरी से काफी प्रेरित है, और जैसा कि हम अपने अन्य एंड्रॉइड प्रोजेक्ट्स में नवीनतम एक का उपयोग करते हैं, मैंने इसे खोदने का फैसला किया है।

यह कहने योग्य है कि यद्यपि यह लाइब्रेरी Google GitHub रिपॉजिटरी में स्थित है, यह Google की आधिकारिक लाइब्रेरी नहीं है और वर्तमान में कोई सहायता प्रदान नहीं की गई है:

इस लाइब्रेरी को वर्तमान में (डेवलपर पूर्वावलोकन) के रूप में पेश किया गया है क्योंकि यह Google के अंदर एक आंतरिक भंडार से खुली-खट्टी है। जैसे हम इस समय बग्स या फ़ीचर अनुरोधों पर कार्रवाई करने में सक्षम नहीं हैं।

फिर भी ऐसा लगता है कि पुस्तकालय वह सब कुछ करता है जिसकी हमें अभी आवश्यकता है, इसलिए मैं कुछ जानकारी साझा करना चाहता हूं कि आप अपने प्रोजेक्ट में इस पुस्तकालय का उपयोग कैसे कर सकते हैं।

स्थापना

जैसा कि आधिकारिक रिपॉजिटरी में कोई पैकेज नहीं है , हमें इसे मैन्युअल रूप से इंस्टॉल करना होगा। मैं इसे git सबमॉड्यूल के रूप में करना पसंद करता हूं, इसलिए मैं अपने प्रोजेक्ट स्रोत निर्देशिका में फ़ोल्डर vendor बना रहा हूं और इस निर्देशिका से निम्नलिखित कमांड चला रहा हूं:

 git submodule add https://github.com/google/inject.dart 

और अब हम इसे निम्नलिखित पंक्तियों को pubspec.yaml में जोड़कर सेट कर सकते हैं:

 dependencies: // other dependencies here inject: path: ./vendor/inject.dart/package/inject dev_dependencies: // other dev_dependencies here build_runner: ^1.0.0 inject_generator: path: ./vendor/inject.dart/package/inject_generator 

प्रयोग

डीआई लाइब्रेरी से हम आमतौर पर क्या कार्यक्षमता की उम्मीद करते हैं? चलो कुछ सामान्य उपयोग के मामलों से गुजरते हैं:

ठोस वर्ग इंजेक्शन

यह इस तरह सरल हो सकता है:

 import 'package:inject/inject.dart'; @provide class StepService { // implementation } 

हम इसका उपयोग इस तरह से स्पंदन विगेट्स के साथ कर सकते हैं:

 @provide class SomeWidget extends StatelessWidget { final StepService _service; SomeWidget(this._service); } 

इंटरफ़ेस इंजेक्शन

सबसे पहले हमें कुछ कार्यान्वयन वर्ग के साथ एक सार वर्ग को परिभाषित करने की आवश्यकता है, जैसे:

 abstract class UserRepository { Future<List<User>> allUsers(); } class FirestoreUserRepository implements UserRepository { @override Future<List<User>> allUsers() { // implementation } } 

और अब हम अपने मॉड्यूल में निर्भरता प्रदान कर सकते हैं:

 import 'package:inject/inject.dart'; @module class UsersServices { @provide UserRepository userRepository() => FirestoreUserRepository(); } 

प्रदाताओं

यदि हमें इंजेक्शन के लिए कुछ वर्ग के उदाहरण की आवश्यकता नहीं है, तो क्या करें, बल्कि एक प्रदाता, जो हमें हर बार इस वर्ग का एक नया उदाहरण देगा? या अगर हमें कंस्ट्रक्टर में ठोस उदाहरण प्राप्त करने के बजाय निर्भरता को हल करने की आवश्यकता है? मैंने इसे न तो दस्तावेज़ीकरण में पाया (अच्छी तरह से, क्योंकि इसमें कोई प्रलेखन नहीं है) और न ही प्रदान किए गए उदाहरणों में, लेकिन यह वास्तव में इस तरह से काम करता है कि आप आवश्यक आवृत्ति को वापस करने वाले फ़ंक्शन का अनुरोध कर सकते हैं और इसे ठीक से इंजेक्ट किया जाएगा।

हम भी इस तरह एक सहायक प्रकार को परिभाषित कर सकते हैं:

 typedef Provider<T> = T Function(); 

और इसे हमारी कक्षाओं में उपयोग करें:

 @provide class SomeWidget extends StatelessWidget { final Provider<StepService> _service; SomeWidget(this._service); void _someFunction() { final service = _service(); // use service } } 

असिस्टेड इंजेक्शन

केवल रनटाइम पर ज्ञात तर्कों की आवश्यकता वाले ऑब्जेक्ट को इंजेक्ट करने के लिए कोई कार्यक्षमता नहीं बनाई गई है, इसलिए हम इस मामले में कारखानों के साथ सामान्य पैटर्न का उपयोग कर सकते हैं: एक कारखाना वर्ग बनाएं जो निर्माण में सभी संकलन-समय की निर्भरता लेता है और इसे इंजेक्ट करता है, और एक प्रदान करता है रनटाइम तर्क के साथ कारखाना विधि जो एक आवश्यक उदाहरण बनाएगी।

सिंगलटन, क्वालिफायर और एसिंक्रोनस इंजेक्शन

हाँ, पुस्तकालय इस सब का समर्थन करता है। आधिकारिक उदाहरण में वास्तव में एक अच्छी व्याख्या है।

इसे पहनना

सब कुछ काम करने के लिए अंतिम चरण एक इंजेक्टर (डैगर से उर्फ ​​घटक) बनाना है, जैसे:

 import 'main.inject.dart' as g; @Injector(const [UsersServices, DateResultsServices]) abstract class Main { @provide MyApp get app; static Future<Main> create( UsersServices usersModule, DateResultsServices dateResultsModule, ) async { return await g.Main$Injector.create( usersModule, dateResultsModule, ); } } 

यहां UserServices और DateResultsServices पहले से परिभाषित मॉड्यूल हैं, MyApp हमारे आवेदन का मूल विजेट है, और main.inject.dart एक ऑटो-जेनरेट की गई फ़ाइल है (इस पर बाद में अधिक)।

अब हम अपने मुख्य कार्य को इस तरह परिभाषित कर सकते हैं:

 void main() async { var container = await Main.create( UsersServices(), DateResultsServices(), ); runApp(container.app); } 

चल रहा है

जैसे ही कोड पीढ़ी के साथ काम करता है, हमें आवश्यक कोड उत्पन्न करने के लिए बिल्ड रनर का उपयोग करना होगा। हम इस कमांड का उपयोग कर सकते हैं:

 flutter packages pub run build_runner build 

या स्वचालित रूप से सिंक किए गए स्रोत कोड को रखने के लिए आदेश देखें:

 flutter packages pub run build_runner watch 

लेकिन यहां एक महत्वपूर्ण क्षण है: डिफ़ॉल्ट रूप से कोड cache फ़ोल्डर में उत्पन्न हो जाएगा और फ़्लटर वर्तमान में इसका समर्थन नहीं करता है (हालांकि इस समस्या को हल करने के लिए प्रगति में एक काम है)। तो हम निम्नलिखित सामग्री के साथ inject_generator.build.yaml फ़ाइल जोड़ने की जरूरत है:

 builders: inject_generator: target: ":inject_generator" import: "package:inject_generator/inject_generator.dart" builder_factories: - "summarizeBuilder" - "generateBuilder" build_extensions: ".dart": - ".inject.summary" - ".inject.dart" auto_apply: dependents build_to: source 

यह वास्तव में एक ही सामग्री है जैसे कि फ़ाइल vendor/inject.dart/package/inject_generator/build.yaml एक लाइन को छोड़कर: build_to: cache को build_to: source साथ बदल दिया गया है।

अब हम build_runner को चला सकते हैं, यह आवश्यक कोड उत्पन्न करेगा (और यदि कुछ निर्भरताएं हल नहीं की जा सकती हैं तो त्रुटि संदेश प्रदान करता है) और उसके बाद हम फ़्लटर बिल्ड को हमेशा की तरह चला सकते हैं।

लाभ

बस इतना ही। आपको स्वयं लाइब्रेरी के साथ दिए गए उदाहरणों की भी जांच करनी चाहिए, और यदि आपके पास डैगर लाइब्रेरी के साथ कुछ अनुभव है, तो inject वास्तव में आपके लिए बहुत परिचित होगा।