🏫 👨🏽‍💻 🏷️ क्रैम्प एसिंक्रोनस रूबी फ्रेमवर्क: आर्किटेक्चर एंड यूसेज 🕴🏿 ✌🏽 🔎

क्रैम्प एक पूरी तरह से अतुल्यकालिक वास्तविक समय की रूपरेखा है, जिसे प्रतीक नाइक द्वारा लिखा गया है, जो 37signals में एक डेवलपर और रेल कोर-टीम का सदस्य है। यह फ्रेमवर्क मुख्य रूप से क्लाइंट और सर्वर के बीच द्विदिश संचार के आयोजन के लिए है और इसमें WebSockets और सर्वर-सेंटेड इवेंट्स के लिए अंतर्निहित समर्थन है। इस लेख में, हम इस उपकरण के उपयोग से संबंधित मुख्य बातों का विश्लेषण करेंगे, और इसकी वास्तुकला को समझने और यह समझने की कोशिश करेंगे कि यह कैसे काम करता है।

शायद फ्रेमवर्क का मुख्य दोष लेखों और उदाहरणों की एक छोटी संख्या है, आधिकारिक वेबसाइट पर केवल दस्तावेज का एक छोटा पृष्ठ है और जीथब पर वास्तविक परियोजना कोड है । वहां से, मूल रूप से, नीचे लिखा गया सब कुछ लिया गया था।

आर्किटेक्चर

क्रैम्प EventMachine, ActiveSupport, और Thor पर आधारित है और एक Thin या Rainbows सर्वर पर चलता है।

एप्लिकेशन को उत्पन्न करने के लिए थोर का उपयोग किया जाता है - क्रैम्प :: जेनरेटर :: Application.start को बाइनरी में कहा जाता है, जो क्रमिक रूप से एप्लिकेशन क्लास के सभी सार्वजनिक तरीकों को निष्पादित करता है, जिनके नाम: create_root, create_config, create_stodels खुद के लिए बोलते हैं।

अगला, जब सर्वर शुरू होता है, EventMachine चक्र शुरू होता है, जो सभी घटनाओं को पकड़ता है, उनसे जुड़ी कॉलबैक लॉन्च करता है। यही कारण है कि क्रैम्प केवल रेनबो या थिन (डिफ़ॉल्ट रूप से) पर काम करता है, जो ईएम पर बने होते हैं।

क्रैम्प दर्शन की कुंजी एक्शन (क्लास एक्शन और एब्सट्रैक्ट) की अवधारणा है। कार्रवाई एक नियंत्रक और रेल के बीच एक क्रॉस है (यदि यह अतुल्यकालिक और तुल्यकालिक रूपरेखाओं की तुलना करना उचित है)। प्रत्येक क्रिया एक अनुरोध या, अधिक सही ढंग से, एक प्रविष्टि बिंदु को संसाधित करती है, क्योंकि उदाहरण के लिए एक वेब सॉकेट के माध्यम से एक कनेक्शन को एक अनुरोध नहीं कहा जा सकता है।

एक नियमित अनुरोध सशर्त रूप से 4 चरणों में विभाजित है:

अनुरोध का प्रारंभ - पहले_स्टार्ट कॉलबैक कहलाते हैं।
इस स्तर पर, हेडर अभी तक नहीं भेजे गए हैं, आप उपयोगकर्ता को कहीं भी पुनर्निर्देशित कर सकते हैं या अनुरोध के प्रसंस्करण को बाधित कर सकते हैं। प्रलेखन का कहना है कि अनुरोध या उपयोगकर्ता की अनुमति की जांच करने के लिए पहले_स्टार्ट का उपयोग करने की सिफारिश की गई है। कई तरीकों को पहले_स्टार्ट पर लटका दिया जा सकता है, जिन्हें क्रमिक रूप से निष्पादित किया जाएगा, लेकिन उनमें से प्रत्येक को क्रमशः अनुरोध प्रसंस्करण जारी रखने या बाधित करने के लिए उपज या पड़ाव को कॉल करना होगा।
प्रतिक्रिया का प्रारंभ - response_with फ़ंक्शन से मेल खाती है।
इसका उपयोग शीर्षकों को बनाने के लिए किया जाता है और आमतौर पर कोड 200 के साथ मानक शीर्षक का उपयोग किया जाता है:
```
def build_headers status, headers = respond_to?(:respond_with, true) ? respond_with.dup : [200, {'Content-Type' => 'text/html'}] headers['Connection'] ||= 'keep-alive' [status, headers] end 
```
अनुरोध शुरू हुआ - on_start चल रहा है।
यह वह जगह है जहां उत्तर का गठन होना चाहिए। आप on_start पर कई कॉलबैक भी लटका सकते हैं, जिन्हें एक ही समय में निष्पादित किया जाएगा, और उनमें से प्रत्येक रेंडर विधि को एक से अधिक बार कॉल कर सकता है।
अनुरोध पूरा हो गया है - on_finish कहा जाता है।
प्रतिक्रिया के बनने के बाद इसे निष्पादित किया जाता है और कुछ को साफ करने, खुले कनेक्शन को बंद करने आदि के लिए कार्य करता है।

इस ढांचे की खूनी विशेषताएं WebSockets हैं। वे बॉक्स से बाहर समर्थित हैं और उन्हें एक अलग सर्वर की आवश्यकता नहीं है। वेब सॉकेट्स का उपयोग करने के लिए, यह आपके एक्शन में on_data हैंडलर विधि बनाने के लिए पर्याप्त है, अन्य सभी मुद्दों को सर्वर द्वारा हल किया जाएगा जो get_data EM विधि को लागू करता है, जो कनेक्शन से संदेश प्राप्त होने पर काम करता है और उपयोगकर्ता द्वारा परिभाषित हैंडलर को कॉल करता है:

पतला

 callback = @request.env[Thin::Request::WEBSOCKET_RECEIVE_CALLBACK] callback.call(data) if callback

इंद्रधनुष

 callback = @env[WEBSOCKET_RECEIVE_CALLBACK] callback.call(data) if callback

हम वास्तुकला के साथ खत्म करेंगे और इसका उपयोग करने के लिए आगे बढ़ेंगे।

के उपयोग

क्रैम्प के साथ काम करने के लिए, फाइबर का उपयोग करने के लिए रूबी शाखाओं 1.9 का उपयोग करने की सिफारिश की जाती है, जो कि अगर आपके पास आरवीएम या रेंबव जैसे उपकरण हैं, तो आपको 1.8.7 पर बैठे होने पर भी कोई समस्या नहीं होनी चाहिए।

क्रैम्प को स्थापित करने से कोई कठिनाई नहीं होनी चाहिए:

 gem install cramp

अगला, भागो

 cramp new project_name

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

हमने निम्नलिखित सामग्री के साथ पहले से ही एक कार्रवाई - एप्लिकेशन / क्रियाएं / home_action.rb बनाई है:

 class HomeAction < Cramp::Action def start render "Hello World!" finish end end

जैसा कि इस कोड से समझना आसान है, स्टार्ट हैंडलर "हैलो वर्ल्ड!" लाइन के रूप में एक प्रतिक्रिया उत्पन्न करता है और अनुरोध प्रसंस्करण को समाप्त करता है। हम सर्वर को शुरू करके इस धारणा को सत्यापित करते हैं:

 bundle exec thin start

और वास्तव में, सब कुछ उम्मीद के मुताबिक काम करता है। जहां तक मैं समझता हूं, थिन प्रोजेक्ट फ़ोल्डर में config.ru फाइल को स्वयं उठाता है, लेकिन निष्ठा के लिए, आप इस रूप में इस कमांड को चला सकते हैं:

 bundle exec thin --max-persistent-conns 1024 --timeout 0 -R config.ru start

या

 bundle exec thin --max-persistent-conns 1024 --timeout 0 -V -R config.ru start

क्रिया मोड में डिबगिंग के लिए।

स्वाभाविक रूप से, हमें सीधे स्थिर पाठ और HTML मार्कअप को प्रस्तुत करने की आवश्यकता नहीं है, इसके लिए हमें अलग-अलग फ़ाइलों में स्थित विचारों का उपयोग करने की आवश्यकता है। हम एप्लिकेशन / विचार फ़ोल्डर बनाते हैं और उसमें निम्न सरल सामग्री के साथ index.erb फ़ाइल:

 <!doctype html> <html> <head> <meta charset="UTF-8"> <title>Hello World!</title> <link rel="stylesheet" type="text/css" href="stylesheets/styles.css" /> </head> <body> <h1>Hello World!</h1> </body> </html>

और सार्वजनिक / स्टाइलशीट फ़ोल्डर में, केवल एक पंक्ति के साथ style.css फ़ाइल बनाएँ:

 h1{color:red}

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

Erb फ़ाइल से सामग्री रेंडर करने की कार्रवाई के लिए, पहले हम इंजन को स्वयं कनेक्ट करेंगे:

 require 'erb'

आप इस लाइन को स्वयं कार्रवाई में जोड़ सकते हैं, लेकिन पूरे प्रोजेक्ट में Erb का उपयोग करने के लिए इसे एप्लिकेशन.rb से कनेक्ट करना अधिक सुविधाजनक है।

अगला, home_action.rb बदलें:

 class HomeAction < Cramp::Action def start page = ERB.new(File.read(ExampleProject::Application.root('app/views/index.erb'))) render page.result(binding) finish end end

यहाँ ExampleProject प्रोजेक्ट का नाम है। लेकिन हमारी सीएसएस कहां है? सीएसएस फ़ाइलों के उपलब्ध होने के लिए, आपको config.ru फ़ाइल में उन्हें युक्त फ़ोल्डर से स्थिर सामग्री के वितरण को सक्षम करने की आवश्यकता है:

 use Rack::Static, :urls => ["/javascripts", "/stylesheets"], :root => CrampArticle::Application.root(:public)

खैर, शीर्षक उम्मीद के मुताबिक लाल हो गया।
अब आगे बढ़ते हैं और एक नया एक्शन WsAction बनाते हैं, जो वेब सॉकेट्स के माध्यम से क्लाइंट के साथ संवाद करेगा। सबसे पहले, आइए जानें कि वेब सॉकेट किस सर्वर पर काम करेगा:

 Cramp::Websocket.backend = :thin

फिर से, रेनबो का उपयोग थिन के बजाय किया जा सकता है, व्यक्तिगत रूप से मैं थिन को केवल इसलिए पसंद करता हूं क्योंकि यह गितूब पर स्थित है और इस पर अधिक डॉक हैं।
अगला, ऐप / एक्शन फ़ोल्डर में, ws_action.rb फ़ाइल बनाएं और इसमें निम्न कोड जोड़ें:

 class WsAction < Cramp::Action self.transport = :websocket on_data :process_data def process_data(data) render "Hello" if /^hello/i =~ data end end

यह लाइन सेल्फ ट्रान्सपोर्ट को जोड़ने के लिए पर्याप्त है। = websocket to the text फिर हम एक संदेश हैंडलर स्थापित करते हैं और एक संदेश भेजते हैं यदि एक संदेश "हैलो" के साथ शुरू हुआ है।

इस क्रिया में प्रयास करने के लिए, पहले आपको WsAction वर्ग के लिए एक मार्ग जोड़ना होगा (फ़ाइल कॉन्फ़िगर / path.rb):

 get('socket/').to(WsAction)

और दूसरी बात, हम निम्न प्रकार के क्लाइंट कोड को index.erb में जोड़ते हैं:

 <script type="text/javascript"> var ws = new WebSocket("ws://localhost:3000/socket/"); ws.onopen = function() { ws.send("Hello!"); }; ws.onmessage = function(e) { alert(e.data); }; ws.onclose = function() { alert("closed"); }; </script>

फ़ायरफ़ॉक्स के लिए, WebSocket के नवीनतम संस्करण MozWebSocket द्वारा प्रतिस्थापित किए गए हैं। क्लाइंट कोड बहुत सरल है और केवल प्रदर्शन (सर्वर के रूप में) के लिए प्रस्तुत किया गया है, इसलिए फ्लैश पर वेब सॉकेट क्लास या पृष्ठभूमि के लिए शर्त इसमें प्रवेश नहीं करती है, इसे स्वयं करें।

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

क्रैम्प एसिंक्रोनस रूबी फ्रेमवर्क: आर्किटेक्चर एंड यूसेज

आर्किटेक्चर

के उपयोग

संबंधित लिंक

More articles: