हम REST API को Vert.x पर लिखते हैं। भाग 1: पर्यावरण की स्थापना

हाय, हरबौसर। लेखों की इस श्रृंखला में, हम Vert.x का उपयोग करके एक REST API लिखेंगे। चलो एक सरल के साथ शुरू करते हैं: खुद को लंबवत स्थापित करना और आईडीई में एक सरल अनुप्रयोग के लॉन्च की स्थापना करना।

फ्रेमवर्क के बारे में कुछ सामान्य जानकारी

Vert.x जावा दुनिया से एक प्रकार का नोड.जेएस है। यह समर्थित भाषाओं की अपनी बड़ी सूची (लिखने के समय: जावा, जावास्क्रिप्ट, कॉफीस्क्रिप्ट, ग्रूवी, पायथन, रूबी, क्लीजुर, स्काला) द्वारा प्रतिष्ठित है, साथ ही एक एकल वर्कफ़्लो के सिद्धांत को बनाए रखते हुए, अवरुद्ध संचालन और कई थ्रेड्स का उपयोग करने की क्षमता के लिए एक तंत्र की उपस्थिति है।

ढांचे के बारे में अधिक जानकारी:
vertx.io/manual.html - आधिकारिक मैनुअल
habrahabr.ru/post/181686 - फ्रेमवर्क के बारे में हब पर पाया गया एकमात्र पोस्ट

फ़्रेमवर्क स्थापित करें, IDE कॉन्फ़िगर करें और नमूना प्रोजेक्ट चलाएँ।

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

vertx version

और वह यह है। ढांचे के मुख्य सिद्धांतों में से एक विन्यास की सादगी है।

अगला, अपाचे मावेन का उपयोग करके, हम एक उदाहरण परियोजना उत्पन्न करेंगे। ऐसा करने के लिए, टर्मिनल में निम्नलिखित कमांड निष्पादित करें:

mvn archetype:generate -Dfilter=io.vertx:

हम io.vertx का चयन करते हैं: वर्धमान (पाया गया लेखन के समय, वहाँ से कोई एक से अधिक नहीं हैं) नवीनतम संस्करण का चयन करें। हम टर्मिनल में भविष्य के अनुप्रयोग के निम्नलिखित मापदंडों को सेट करते हैं: ग्रुपआईडी, आर्टिफीसिएड, संस्करण और मूल पैकेज। एक उदाहरण परियोजना के लिए, मैं उन्हें तदनुसार सेट करता हूं: com.example, vertx-example, 1.0.0-SNAPSHOT, com.example। जाँच लें कि प्रोजेक्ट सफलतापूर्वक बनाया गया है, इसके लिए हम टर्मिनल में निम्नलिखित कमांड निष्पादित करेंगे:

mvn install

यदि आप BUILD SUCCESS संदेश देखते हैं, तो सब कुछ सही ढंग से किया जाता है, जबकि परियोजना की संरचना कुछ इस तरह दिखनी चाहिए:



परियोजना का शुभारंभ सेट करें। मैंने IntelliJ IDEA की स्थापना की, लेकिन मैं आपको विश्वास दिलाता हूं कि अन्य IDE में कोई समस्या नहीं होनी चाहिए।

शीर्ष-कोर, वर्टेक्स-प्लेटफ़ॉर्म और वर्टेक्स-हेज़लकास्ट पैकेज से निर्भरता को हल करने में थोड़ी समस्या है। हमारी परियोजना में, अब उनके लिए गुंजाइश निर्धारित की गई है, जिसका अर्थ है कि उन्हें पर्यावरण द्वारा प्रदान किया जाएगा। हालांकि, IDE में हमारे एप्लिकेशन को चलाने के लिए, जो इन पैकेजों को प्रदान नहीं करता है, इसलिए, हम दो मावेन प्रोफाइल बनाएंगे: एक आईडीई में चलाने के लिए, दूसरा एप्लिकेशन बनाने के लिए, जो सीधे vert.x पर चलेगा, जो आवश्यक निर्भरता को वहन करता है। ऐसा करने के लिए, हमारे pom.xml में निम्न पाठ जोड़ें:

     <प्रोफ़ाइल>
         <प्रोफ़ाइल>
             <id> स्थानीय </ id>
             <गुण>
                 <vertx-गुंजाइश> संकलित करें </ vertx-गुंजाइश>
             </ गुण>
         </ प्रोफ़ाइल>
         <प्रोफ़ाइल>
             <id> परिनियोजन </ id>
             <गुण>
                 <vertx-गुंजाइश> प्रदान की गई </ vertx-गुंजाइश>
             </ गुण>
         </ प्रोफ़ाइल>
     </ प्रोफ़ाइल>

और वर्टिकल पैकेज के लिए गुंजाइश बदलें:

         <निर्भरता>
             <groupId> io.vertx </ groupId>
             <विरूपण साक्ष्य> लंब-कोर </ विरूपण साक्ष्य>
             <संस्करण> $ {vertx.version} </ संस्करण>
             <स्कोप> $ {vertx-स्कोप} </ स्कोप>
         </ निर्भरता>
         <निर्भरता>
             <groupId> io.vertx </ groupId>
             <विरूपण साक्ष्य> लंब-मंच </ विरूपण साक्ष्य>
             <संस्करण> $ {vertx.version} </ संस्करण>
             <स्कोप> $ {vertx-स्कोप} </ स्कोप>
         </ निर्भरता>
         <निर्भरता>
             <groupId> io.vertx </ groupId>
             <विरूपण साक्ष्य> अनुलंब-हेज़ेलकास्ट </ विरूपण साक्ष्य>
             <संस्करण> $ {vertx.version} </ संस्करण>
             <स्कोप> $ {vertx-स्कोप} </ स्कोप>
         </ निर्भरता>

एक क्लिक के साथ परियोजना शुरू करने के लिए, निम्न लॉन्च कॉन्फ़िगरेशन बनाएं:



अनिवार्य रूप से, हम org.vertx.java.platform.impl.cli.Starter साथ एक इनपुट बिंदु और runmod com.example~vertx-example~1.0-SNAPSHOT तर्कों के साथ कार्यक्रम चलाते हैं। तर्क इंगित करता है कि किस मॉड्यूल को चलाना है। नामकरण तर्क निम्नानुसार है: groupId ~ विरूपण साक्ष्य ~ संस्करण।

अब आप हमारे एप्लिकेशन को चला सकते हैं, यदि स्टार्टअप पर कंसोल का आउटपुट निम्न के समान है, तो सब कुछ सही तरीके से किया जाता है:

 Apr 08, 2014 5:47:39 अपराह्न org.vertx.java.core.log.impl.JULLogDelegate जानकारी
 जानकारी: PingVerticle की शुरुआत हुई
 Apr 08, 2014 5:47:39 अपराह्न org.vertx.java.core.log.impl.JULLogDelegate जानकारी
 जानकारी: मॉड्यूल को तैनात करने में सफल रहा

आपका ध्यान देने के लिए धन्यवाद। अगली बार हम इस परियोजना में क्या हो रहा है, इसका विश्लेषण करेंगे और अपना स्वयं का आवेदन लिखना शुरू करेंगे।

परिणामी परियोजना का स्रोत कोड GitHub: github.com/X3H4/vertx-example पर उपलब्ध है