🐰 🍽️ 👇🏿 टेलीग्राफ: टेलीग्राम के लिए कोटलिन डी.एस.एल. 👉🏼 👍🏾 🤶

लोगो

अलग-अलग प्रोग्रामिंग भाषाओं और प्लेटफार्मों के लिए टेलीग्राम बॉट बनाने के बारे में हजारों लेखों पर। विषय नए से बहुत दूर है।

लेकिन टेलीग्राम, टेलीग्राम बॉट्स को लागू करने के लिए सबसे अच्छा ढांचा है और मैं इसे कट के तहत साबित करूंगा।

प्रस्तावना

2015 में, रूसी रूबल बुखार में था। मेरे पास डॉलर में बचत थी और मैंने हर पांच मिनट में मुद्रा को मेरी ज़रूरत की दर पर बेचने के लिए चेक किया। बुखार घसीटा, मैं थक गया और एक टेलीग्राम बॉट ( @TinkoffRatesBot ) लिखा, जो आपको सूचित करता है कि विनिमय दर थ्रेशोल्ड (अपेक्षित) मूल्य तक पहुंचती है या नहीं।
मैं इस कार्य से बहुत प्रभावित हुआ। बोथा ने बहुत जल्दी लिखा, लेकिन उन्हें संतुष्टि नहीं मिली।

टेलीग्राम के साथ एकीकरण नहीं है और कोई समस्या नहीं थी। यह समस्या कुछ घंटों में हल हो जाती है। और मुझे यह भी आश्चर्य है कि टेलीग्राम के साथ एकीकरण के लिए जावा में पूरे पुस्तकालय हैं (विषय में, कोड में गुणवत्ता के साथ घृणित), जिसने जीथब पर एक हजार से अधिक सितारे अर्जित किए हैं।

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

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

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

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

इसका उपयोग कैसे करें?

पर निर्भर करता है

पहला कदम निर्भरता के लिए एक अतिरिक्त भंडार निर्दिष्ट करना है। शायद किसी समय मैं टेलीग्राफ को मावेन सेंट्रल या जेसेन्टेर में प्रकाशित करूंगा, लेकिन अभी के लिए।

Gradle

repositories { maven { url "https://dl.bintray.com/ruslanys/maven" } }

Maven

 <repositories> <repository> <snapshots> <enabled>false</enabled> </snapshots> <id>bintray-ruslanys-maven</id> <name>bintray</name> <url>https://dl.bintray.com/ruslanys/maven</url> </repository> </repositories>

यह छोटे के लिए मामला है। टेलीग्राफ का उपयोग करने के लिए, आपको केवल एक स्प्रिंग-बूट-स्टार्टर निर्भरता निर्दिष्ट करने की आवश्यकता है:

Gradle

 compile("me.ruslanys.telegraff:telegraff-starter:1.0.0")

Maven

 <dependency> <groupId>me.ruslanys.telegraff</groupId> <artifactId>telegraff-starter</artifactId> <version>1.0.0</version> </dependency>

विन्यास

प्रोजेक्ट कॉन्फ़िगरेशन सरल है और पहले दो या तीन मापदंडों तक सीमित हो सकता है:

application.properties

 telegram.access-key=123 # ① telegram.mode=webhook # ② telegram.webhook-base-url=https://ruslanys.me # ③ telegram.webhook-endpoint-url=/telegram # ④ telegram.handlers-path=handlers # ⑤ telegram.unresolved-filter.enabled=false # ⑥

टेलीग्राम एपीआई के लिए आपकी कुंजी।
टेलीग्राम से संदेश (अपडेट) प्राप्त करने का तरीका। यह या तो मतदान हो सकता है या वेबहुक।
यदि अपडेट प्राप्त करने की विधि "वेबहुक" द्वारा इंगित की गई है, तो आपको अपने आवेदन का पथ निर्दिष्ट करना होगा।
यदि आप चाहें, तो आप समापन के लिए अपना रास्ता निर्दिष्ट कर सकते हैं। यदि इस पैरामीटर को पुनर्परिभाषित नहीं किया जाता है, तो निम्नलिखित फ़ॉर्म का एक पथ उत्पन्न होगा: /telegram/${UUID} । आवेदन शुरू करने से पहले, निर्दिष्ट पता वेब हुक पते के रूप में सेट किया गया है। काम के अंत में, वेब हुक पता अगली बार शुरू होने पर मतदान पर स्विच करने में सक्षम होने के लिए ओवरराइट किया जाता है।
यदि वांछित है, तो आप उस फ़ोल्डर को बदल सकते हैं जिसमें हैंडलर की स्क्रिप्ट स्थित होगी। डिफ़ॉल्ट रूप से, यह handlers फ़ोल्डर है।
UnresolvedFilter "वितरण" में शामिल है और यह डिफ़ॉल्ट रूप से सक्षम है। इस घटना में कि उपयोगकर्ता के संदेश पर कोई हैंडलर नहीं पाया गया था, UnresolvedFilter "सॉरी, मुझे समझ नहीं आता: \ UnresolvedFilter " जैसी किसी चीज के साथ प्रतिक्रिया करता है।

यह स्क्रिप्ट लिखने का समय है!

संचालकों

हैंडलर (स्क्रिप्ट) टेलीग्राफ का एक महत्वपूर्ण हिस्सा हैं। यह वह जगह है जहाँ उपयोगकर्ता इंटरैक्शन चेन सेट है। लब्बोलुआब यह है कि प्रत्येक कमांड, जैसे "/ प्रारंभ", "/ टैक्सी", "/ सहायता", एक अलग स्क्रिप्ट / स्क्रिप्ट / हैंडलर / हैंडलर है।

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

क्या मुझे यह समझाने की ज़रूरत है कि उपयोगकर्ता प्रतिक्रियाओं को मान्य करने की आवश्यकता है? पहली बात यह है कि उपयोगकर्ता यह करेगा कि वह आपकी अपेक्षा से अलग प्रतिक्रिया देगा।

खैर, अंत में, स्क्रिप्ट शाखा कर सकती है, अर्थात। एक प्रश्न का प्रत्येक उत्तर बाद के लोगों के आदेश को प्रभावित कर सकता है।

उदाहरण के लिए!

प्रारंभ करने के लिए, फ़ाइल को एक्सटेंशन .kts साथ फ़ोल्डर में संसाधन handlers साथ रखें: src/main/resources/handlers/ExampleHandler.kts ।

टैक्सी कॉल परिदृश्य

 enum class PaymentMethod { CARD, CASH } handler("/taxi", "") { // ① step<String>("locationFrom") { // ② question { // ③ MarkdownMessage(" ?") } } step<String>("locationTo") { question { MarkdownMessage(" ?") } } step<PaymentMethod>("paymentMethod") { question { state -> MarkdownMessage("   ?", "", "") // ④ } validation { // ⑤ when (it.toLowerCase()) { "" -> PaymentMethod.CARD "" -> PaymentMethod.CASH else -> throw ValidationException(",    ") // ⑥ } } next { state -> null // ⑦ } } process { state, answers -> // ⑧ val from = answers["locationFrom"] as String val to = answers["locationTo"] as String val paymentMethod = answers["paymentMethod"] as PaymentMethod // ⑨ // Business logic MarkdownMessage("""     #${state.chat.id}.   $from  $to.  $paymentMethod. """.trimIndent()) // ⑩ } }

स्टेप्स की कुंजी जानबूझकर स्थिरांक में नहीं ली गई थी। उत्पादन में, निश्चित रूप से, यह सबसे अच्छा बचा जाता है।

चलिए इसका पता लगाते हैं:

हम स्क्रिप्ट की घोषणा करते हैं। कम से कम एक टीम के नाम की आवश्यकता है। इस मामले में, दो टीमें हैं: "/ टैक्सी", "टैक्सी"। यदि उपयोगकर्ता का संदेश इन शब्दों से शुरू होता है, तो संबंधित हैंडलर को बुलाया जाएगा।
हम चरणों (प्रश्नों) का निर्धारण करते हैं। एक अद्वितीय चरण नाम की आवश्यकता है क्योंकि बाद में, उपयोगकर्ता की प्रतिक्रिया को इस कुंजी ("लोकेशनफ्रॉम") द्वारा ठीक से एक्सेस किया जा सकता है।
प्रत्येक चरण में तीन खंड होते हैं, जिनमें से पहला प्रश्न स्वयं है। प्रश्न एक अनिवार्य अनुभाग है जो हर कदम पर मौजूद होना चाहिए। बिना प्रश्न के एक चरण में कोई अर्थ नहीं है।
आप अपनी इच्छानुसार प्रश्न भर सकते हैं। इस स्थिति में, उपयोगकर्ता को कीबोर्ड के माध्यम से एक विकल्प चुनने के लिए प्रेरित किया जाएगा: "कार्ड" या "कैश"। इस ब्लॉक को कॉल करने के परिणामस्वरूप, TelegramSendRequest प्रकार का एक ऑब्जेक्ट होना चाहिए। क्षमा करें, मैं SendRequest प्रत्यय से बेहतर कुछ भी नहीं कर सकता, जो कि टेलीग्राम में एक निवर्तमान अनुरोध के रूप में संरचना का वर्णन करता है।
दूसरा सबसे महत्वपूर्ण चरण अनुभाग उपयोगकर्ता की प्रतिक्रिया की जांच करना है। प्रत्येक चरण के प्रकार को मानकीकृत किया जाता है (जेनेरिक), और इसलिए, सत्यापन ब्लॉक को ठीक उसी प्रकार वापस करना चाहिए जिसके द्वारा इसका चरण मानकीकृत है।
यदि उपयोगकर्ता की प्रतिक्रिया असंतोषजनक है, तो आप स्पष्ट पाठ के साथ ValidationException को फेंक सकते हैं, लेकिन एक ही कीबोर्ड, यदि यह प्रश्न में इंगित किया गया था।
अंतिम चरण अनुभाग अगले चरण को इंगित करने वाला एक ब्लॉक है। डिफ़ॉल्ट रूप से, चरणों को उनकी घोषणा के क्रम में निष्पादित किया जाएगा, ऊपर से नीचे तक। लेकिन इस प्रक्रिया को संबंधित ब्लॉक को ओवरराइड करके प्रभावित किया जा सकता है। या तो अगले चरण की कुंजी ( String ) या "नल" को इस ब्लॉक को निष्पादित करने के परिणामस्वरूप वापस किया जा सकता है, यह दर्शाता है कि कोई और कदम नहीं हैं और यह कमांड के निष्पादन के लिए आगे बढ़ने का समय है।
जब एक उपयोगकर्ता अनुरोध उत्पन्न होता है, तो उसके प्रसंस्करण की आवश्यकता होती है। लैम्ब्डा में तर्क स्टेट हैं (यह एक सत्र की तरह कुछ है) और उपयोगकर्ता प्रतिक्रियाएं।
ध्यान दें कि विफल प्रतिक्रिया अब उपयोगकर्ता की प्रतिक्रिया स्ट्रिंग नहीं है, लेकिन पहले से ही वांछित प्रकार की संसाधित वस्तु है।
कमांड की प्रतिक्रिया पैराग्राफ 4 के समान कोई भी हो सकती है। यदि कमांड की प्रतिक्रिया की आवश्यकता नहीं है, तो आप "शून्य" वापस कर सकते हैं।

एक हैंडलर के पास शायद कदम न हों। इस मामले में, आपको केवल कमांड को लागू करने के लिए हैंडलर के व्यवहार को निर्धारित करने की आवश्यकता है।

स्वागत पटकथा

 handler("/start") { process { _, _ -> MarkdownMessage("!") } }

कोशिश

प्रयास करने के लिए, रिपॉजिटरी को कांटा, इसे स्थानीय मशीन पर क्लोन करें और telegraff-sample फ़ोल्डर में जाएं। कॉन्फ़िगर करें, लॉन्च करें, स्पर्श करें!

सामान्य तौर पर, telegraff-sample एक जानबूझकर स्वतंत्र परियोजना है जो माता-पिता से संबंधित नहीं है और यहां तक कि इसका स्वयं का ग्रेडर रैपर भी है। आप केवल इस फ़ोल्डर को छोड़ सकते हैं। यह एक तरह का आडंबर है।

यह कैसे काम करता है?

तार

Telegram के साथ एकीकरण बहुत सरल है और TelegramApi में कार्यान्वित किया जाता है।

प्रत्येक विधि को जानबूझकर कई परिस्थितियों के कारण व्यक्तिगत रूप से लागू किया गया था: टेलीग्राम एपीआई की विशिष्टता के लिए स्प्रिंग की रेस्टेमप्लेट (और इसके लिए परीक्षण) के उपयोग से शुरू।

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

और यद्यपि अद्यतन (नए संदेश) प्राप्त करने के तरीके टेलीग्राम से भिन्न होते हैं, सार अपरिवर्तित होता है और स्प्रिंग के EventPublisher ("ऑब्जर्वर" पैटर्न) के माध्यम से नए संदेशों के बारे में एक घटना ( TelegramUpdateEvent ) प्रकाशित करता है। यदि आप चाहें, तो आप इस प्रकार के आयोजन के लिए अपने श्रोता को लागू कर सकते हैं। एक तार्किक, जैसा कि यह मुझे लगता है, अमूर्तता की परत है, क्योंकि यह बिल्कुल कोई फर्क नहीं पड़ता कि संदेश कैसे प्राप्त किया गया था।

फिल्टर

जैसे ही कोई नया संदेश प्राप्त होता है, उसे संसाधित करने और उपयोगकर्ता को जवाब देने की आवश्यकता होती है। ऐसा करने के लिए, संदेश को फ़िल्टर श्रृंखला से गुजरना होगा।

यह जावा प्रोग्रामर से परिचित जावा ईई फिल्टर के समान है। अंतर केवल इतना है कि तथाकथित हैंडलर (यदि हम जावा ईई के साथ एक समानांतर खींचते हैं, तो ये सर्वलेट हैं) फिल्टर से स्वतंत्र नहीं हैं, लेकिन उनका हिस्सा हैं।

फ़िल्टर श्रृंखला

इसलिए, फ़िल्टर सुव्यवस्थित हैं और संदेशों को श्रृंखला के नीचे जाने दे सकते हैं, शायद नहीं।

LoggingFilter स्पष्ट रूप से सर्वोच्च प्राथमिकता (पहला) फिल्टर है जिसे एक नए संदेश के प्रसंस्करण के हिस्से के रूप में कहा जाएगा। एक आने वाले संदेश पर जानकारी लॉग करता है और इसे श्रृंखला के नीचे भेजता है। मैंने जानबूझकर एक उदाहरण के रूप में LoggingFilter को जोड़ा। वास्तव में, यह समझ में नहीं आ सकता है, क्योंकि आने वाले संदेशों को क्लाइंट स्तर पर लॉग किया जाता है।

अगला फिल्टर CancelFilter । यह अनिवार्य रूप से HandlersFilter के साथ मिलकर काम करता है और इसका पूरक है। इसका कार्य सरल है: यदि उपयोगकर्ता वर्तमान स्क्रिप्ट को छोड़ना चाहता है, तो वह "रद्द करें" या "रद्द करें" और उसकी स्थिति (सत्र) लिख सकता है। वह पिछले एक को पूरा किए बिना किसी भी नए परिदृश्य को शुरू कर सकता है। इस कारण से, CancelFilter “उच्च” (प्राथमिकता) CancelFilter ।

HandlersFilter मौजूदा प्रक्रिया में मुख्य फिल्टर है। यह फ़िल्टर है जो उपयोगकर्ता की स्थिति को संग्रहीत करता है, वांछित हैंडलर (स्क्रिप्ट) को ढूंढता है और कॉल करता है, सत्यापन ब्लॉकों को लागू करता है, चरणों का क्रम निर्धारित करता है और उपयोगकर्ता को जवाब देता है।

यदि HandlersFilter को उपयोगकर्ता संदेश के लिए कोई उपयुक्त हैंडलर नहीं मिला है, तो सत्र या सामग्री में, संदेश को श्रृंखला के नीचे भेजा जाता है। चरम फ़िल्टर UnresolvedFilter । यह एक फिल्टर है जो जानता है कि यह अंतिम है, इसलिए इसकी कार्यक्षमता सरल है: यदि वे मेरे पास पहुंचे, तो संदेश का जवाब कैसे दें यह स्पष्ट नहीं है, मैं कहूंगा कि मुझे कुछ भी समझ नहीं आया। यह मुझे लगता है कि बॉट से कम से कम कुछ संदेश प्राप्त करना बेहतर है अगर यह नहीं जानता कि कैसे प्रतिक्रिया दें, तो कुछ भी नहीं प्राप्त करने की तुलना में।

अपना फ़िल्टर जोड़ने के लिए, आपको TelegramFilter वर्ग का बीन घोषित करना होगा और एनोटेशन @TelegramFilterOrder(ORDER_NUMBER) निर्दिष्ट करना होगा।

फ़िल्टर उदाहरण

 @Component @TelegramFilterOrder(Integer.MIN_VALUE) class LoggingFilter : TelegramFilter { override fun handleMessage(message: TelegramMessage, chain: TelegramFilterChain) { log.info("New message from #{}: {}", message.chat.id, message.text) chain.doFilter(message) } companion object { private val log = LoggerFactory.getLogger(LoggingFilter::class.java) } }

यह है कि कैसे @TinkoffRatesBot एक "कैलकुलेटर" लागू करता है। किसी भी स्क्रिप्ट और कमांड को कॉल किए बिना, आप एक संख्या भेज सकते हैं, उदाहरण के लिए, "1000", या यहां तक कि एक पूरी अभिव्यक्ति, उदाहरण के लिए, "4500 * 3 - 12000"। बॉट अभिव्यक्ति के परिणाम की गणना करेगा, वर्तमान विनिमय दरों को परिणाम पर लागू करेगा और इसके बारे में जानकारी प्रदर्शित करेगा। वास्तव में, इस तरह की कार्रवाइयों का नतीजा CalculationFilter का निष्पादन है, जो HandlersFilter नीचे की श्रृंखला में है, लेकिन UnresolvedFilter ऊपर है।

संचालकों

टेलीग्राफ स्क्रिप्टिंग सिस्टम (हैंडलर्स) कोटलिन डीएसएल पर बनाया गया है। संक्षेप में, यह लंबोदर और बिल्डरों के बारे में है।

मैं अलग से कोटलिन डीएसएल देखने की बात नहीं देखता, क्योंकि यह पूरी तरह से अलग बातचीत है। JetBrains से महान प्रलेखन और i_osipov से एक व्यापक रिपोर्ट है।

बारीकियों

यह खंड वर्तमान सुविधाओं के लिए समर्पित है। मेरी राय में, सभी महत्वपूर्ण नहीं हैं, उनमें से कुछ तय हो सकते हैं, कुछ नहीं। लेकिन आपको इन पहलुओं के बारे में जानने की जरूरत है।

यदि आपको इस खंड से एक या किसी अन्य बिंदु को सही करने का ज्ञान या भाग लेने की इच्छा है, तो मैं बहुत आभारी रहूंगा।

तार

टेलीग्राम के साथ एकीकरण परत शायद पूरी तरह से वर्णित नहीं है। केवल वे विधियाँ जो मुझे आवश्यक थीं, कार्यान्वित की गईं। अगर कोई ऐसी चीज है जिसकी आपको व्यक्तिगत कमी है, तो TelegramApi सही करें और PR भेजें!

फिलहाल महत्वपूर्ण भागों में इनलाइन कीबोर्ड सपोर्ट की कमी है (यह तब है जब कीबोर्ड सीधे रिबन में संदेश के नीचे है)। कार्य इस तथ्य से बढ़ जाता है कि इनलाइन-कीबोर्ड को मौजूदा संरचना में सही ढंग से "दर्ज" करने की आवश्यकता है ताकि यह सरल, सुविधाजनक, अलग-थलग रहे। इस कार्यक्षमता को लागू करने के लिए पहले से ही एक अच्छा विचार है, लेकिन इसे अभी तक किसी भी रूप में लागू और परीक्षण नहीं किया गया है।

मोटा जार

दुर्भाग्य से, कुछ लाइब्रेरी, जैसे कि JRuby और शायद Kotlin Embedded Compiler (स्क्रिप्ट संकलन के लिए आवश्यक) में Fat JAR भाग के रूप में समस्याएं हो सकती हैं। Fat JAR तब होता है जब आपका कोड और आपकी सारी निर्भरता एक फाइल ( *.jar ) में पैक हो जाती है।

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

प्लगइन विन्यास

 bootJar { requiresUnpack "**/**kotlin**.jar" requiresUnpack "**/**telegraff**.jar" }

हालांकि, अपनी सेम (सेवाओं, उदाहरण के लिए) को हैंडलर (स्क्रिप्ट) से संदर्भित करने के लिए, उन्हें भी अनपैक किया जाना चाहिए। जो, सिद्धांत रूप में, इस दृष्टिकोण के लाभ को समाप्त करता है।

जैसा कि मैंने इसे देखा, ग्रैडल application प्लगइन का उपयोग करना सबसे विश्वसनीय, सरल और सुविधाजनक तरीका है। इसके अलावा, यदि आप अपने आवेदन को कंटेनरीकृत कर रहे हैं, तो परिणाम से कोई अंतर नहीं है।

इस सब के बारे में मैंने यहाँ कुछ विस्तार से लिखा है ।

प्रारंभिक आदेश

यहां मैं दो परिस्थितियों पर ध्यान देना चाहूंगा।

सबसे पहले, यदि आप टैक्सी कॉल परिदृश्य को देखते हैं, तो आप देख सकते हैं कि enum वर्ग को handler(...) लिए कॉल के ऊपर परिभाषित किया गया है। यह आवश्यकता इस तथ्य से लगाया जाता है कि, वास्तव में, handler एक फ़ंक्शन कॉल है। एक फ़ंक्शन कॉल, जिसका परिणाम कुछ संरचना होना चाहिए, जिसे टेलीग्राफ बाद में उपयोग करेगा। यदि, आपकी स्क्रिप्ट के निष्पादन के परिणाम के अनुसार, कारखाना परिणाम को वांछित प्रकार में नहीं ला सकता है, तो प्रारंभिक चरण में एक त्रुटि गिर जाएगी।

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

निष्कर्ष

मैं कोशिश करना चाहता था - कांटा,
मैं इसे ठीक करना चाहता था - पीआर भेजें,
मैं धन्यवाद देना चाहता था - जीथब में एक तारांकन पोस्ट की तरह डालें और अपने दोस्तों को बताएं!

प्रोजेक्ट रिपॉजिटरी

टेलीग्राफ: टेलीग्राम के लिए कोटलिन डी.एस.एल.

प्रस्तावना

इसका उपयोग कैसे करें?

पर निर्भर करता है

विन्यास

संचालकों

कोशिश

यह कैसे काम करता है?

तार

फिल्टर

संचालकों

बारीकियों

तार

मोटा जार

प्रारंभिक आदेश

निष्कर्ष

More articles: