🤛🏾 🛤️ 👋🏾 मावेन में अपने आर्कटाइप्स और निर्देशिका बनाएं 🏸 👩🏿‍💼 🎅🏽

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

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

परियोजना पर एक मामला था जब टीम का एक नया सदस्य बिल्ड को इकट्ठा नहीं कर सका, एक अनपेक्षित निष्कर्ष प्राप्त किया कि यह खुदाई के दो घंटे बाद ही पाया गया कि यह पता चला कि जावा के पांचवें संस्करण को मुख्य संस्करण के रूप में किसी न किसी के रूप में बनाया गया था, लेकिन यह स्थापित नहीं था।

प्लगइन्स को ढूंढना और उन्हें स्थापित करना भी नरक के कष्टदायक घेरे हैं, लेकिन एंटे पर एक्सएमएल प्रोग्रामिंग की तुलना में, यह अभी भी कुछ भी नहीं है।

हालांकि, सही दृष्टिकोण और एक पूर्ण कौशल के साथ, मावेन व्यावहारिक रूप से काम में महसूस नहीं किया जाता है, जो मुझे वास्तव में पसंद है।

दरअसल, इस लेख में हम पीड़ाओं के बारे में नहीं, बल्कि आर्कटाइप्स, उनके कैटलॉग और हमारे अपने आर्कटाइप्स और कैटलॉग के निर्माण के बारे में बात करेंगे।

इन सरल अवधारणाओं की मदद से, आप एक नई परियोजना बनाते समय अपने जीवन को सरल बना सकते हैं।

एक स्थानीय निर्देशिका बनाएँ

मावेन में आर्कटाइप एक नई परियोजना के लिए एक टेम्पलेट है, जिसमें स्रोत और कॉन्फ़िगरेशन फ़ाइलों की संरचना और लेआउट है।

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

	 mvan के श्लोक: create \ n
	   -DarchetypeGroupId = <archetype-groupId> \
	   -DarchetypeArtifactId = <archetype-विरूपण साक्ष्य>>
	   -DarchetypeVersion = <archetype- संस्करण> \
	   -DgroupId = <my-groupid> \
	   -डार्टवर्कआईड = <माय-आर्टिफ़ाइटी>

आवश्यक मापदंडों को प्राप्त करने का प्रश्न हमेशा मुझे चिंतित करता है, आमतौर पर मैं विनम्रता से Google से पूछता हूं और वह आमतौर पर मुझे जवाब देता है :)

यदि, उदाहरण के लिए, हम एक साधारण एप्लिकेशन बनाना चाहते हैं, तो हम इस तरह के उदाहरण के लिए maven-archetype-quickstart नामक एक आर्कटाइप का उपयोग करते हैं:

	 mvan के श्लोक: create \ n
	   -DarchetypeGroupId = org.apache.maven.archetypes \
	   -DarchetypeArtifactId = मावेन-आर्कटाइप-क्विकस्टार्ट \ _
	   -DarchetypeVersion = 1.0 \
	   -DgroupId = org.example \
	   -डार्टवर्कआईडी = सरल

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

  mvan के श्लोक: उत्पन्न

लेकिन एक समस्या है। मावेन तैयार किए गए टेम्पलेट्स की सूची से नई परियोजना के प्रकार को चुनने की पेशकश करता है, और इस सूची में 300 से कम विकल्प नहीं हैं। सही टेम्प्लेट ढूंढना एक नॉन-टोटल टास्क है, आमतौर पर मैं आउटपुट को फाइल में डंप करता हूं और फिर एक ग्रेप लुक के लिए जिसकी मुझे जरूरत है।

थोड़ी सी गुगली करते हुए, मुझे अपने लिए इस समस्या का हल मिल गया, मेरे लिए उतना अंतिम नहीं था, लेकिन लालित्य का एक संकेत था। Archetypes को कैटलॉग में जोड़ा जा सकता है! लेकिन यह कैसे मदद कर सकता है?

निर्देशिका उस URL से निर्धारित होती है जहां वह स्थित है, मावेन के अलावा तीन पूर्वनिर्धारित निर्देशिकाएं हैं, या यदि आप चाहते हैं, तो एक उपनाम: आंतरिक , दूरस्थ और स्थानीय ।

आंतरिक	मावेन में निर्मित आर्कटाइप्स हैं, उनमें से कुछ हैं और वे पहले से ही वितरण के साथ आने वाले वास्तविक हैं
दूरस्थ	मावेन केंद्रीय निर्देशिका, http://repo1.maven.org/maven2/archetype-catalog.xml पर स्थित है, इसका स्थान मावेन की वर्तमान सेटिंग्स पर निर्भर करता है, उदाहरण के लिए, इस URL को रिपॉजिटरी दर्पण में से किसी एक पर फिर से परिभाषित करना संभव है।
स्थानीय	स्थानीय रिपॉजिटरी से एक निर्देशिका, आमतौर पर ~ / .m2 / archetype-कैटलॉग। Xml में स्थित है

आर्कटाइप: टार्गेट जेनरेट करने के लिए एक आर्कटाइपक्राफ्ट पैरामीटर है, जिसके साथ आप उन डायरेक्टरी की एक सूची निर्दिष्ट कर सकते हैं, जहाँ संभव आर्कषक चीज़ों को देखना है। डिफ़ॉल्ट रूप से, पैरामीटर का मान 'दूरस्थ, स्थानीय' होता है। लेकिन अगर आप वहां से रिमोट निकालते हैं, तो हमें लगभग वही मिलता है, जिसकी आपको जरूरत है।

उदाहरण के लिए, इस तरह:

	 grim @ ब्लैकबॉक्स: ~ / प्रोजेक्ट्स $ mvan archetype: generate -DarchetypeCatalog = स्थानीय

	 [... चीयर्स ...]

	 आर्काइव चुनें:
	 1: स्थानीय -> मावेन-आर्कटाइप-क्विकार्टार्ट (क्विकस्टार्ट)
	 2: स्थानीय
	 3: स्थानीय -> मावेन-आर्कटाइप-वेबैप (वेबएप)
	 एक नंबर चुनें: 1:

आप दूरस्थ निर्देशिका से फ़ाइल संरचना को देख सकते हैं। उदाहरण के लिए, ऊपर की सूची प्राप्त करने के लिए, फ़ाइल को दिखना चाहिए

<?xml version="1.0" encoding="UTF-8"?> <archetype-catalog xsi:schemaLocation="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0 http://maven.apache.org/xsd/archetype-catalog-1.0.0.xsd" xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <archetypes> <archetype> <groupId>org.apache.maven.archetypes</groupId> <artifactId>maven-archetype-quickstart</artifactId> <version>1.1</version> <description>quickstart</description> </archetype> <archetype> <groupId>org.apache.maven.archetypes</groupId> <artifactId>maven-archetype-archetype</artifactId> <version>1.0</version> <description>archetype</description> </archetype> <archetype> <groupId>org.apache.maven.archetypes</groupId> <artifactId>maven-archetype-webapp</artifactId> <version>1.0</version> <description>webapp</description> </archetype> </archetypes> </archetype-catalog>

मावेन के विन्यास के साथ थोड़ा जुड़ा हुआ होने पर, आप इस स्थिति को स्थायी बना सकते हैं; आपको एक ऐसी प्रोफ़ाइल बनाने की ज़रूरत है, जिसमें archetypeCatalog वैरिएबल का मान सेट किया जा सके। ऐसा करने के लिए, अपनी सेटिंग्स में जोड़ें। xml फ़ाइल

  <profiles> <profile> <id>dev</id> <activation> <activeByDefault>true</activeByDefault> </activation> <properties> <archetypeCatalog>local</archetypeCatalog> </properties> </profile> </profiles>

मूंछें! अब, जब कहा जाता है, तो आर्कषक का लक्ष्य: कचरे के टन के बजाय उत्पन्न होता है, जो आप कहते हैं वह प्रदर्शित करेगा।

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

	 ग्रिम @ ब्लैकबॉक्स: ~ / प्रोजेक्ट्स $ mvan archetype: crawl -Dcatalog = ~ / .m2 / archetype-catalog.xml

आधिकारिक प्रलेखन के विपरीत, पैरामीटर को कैटलॉगफाइल नहीं, बल्कि कैटलॉग कहा जाता है।

अपना आर्कषक बनाएं

दूसरी समस्या जिस पर हम विचार करेंगे, वह है हमारे अपने शिल्पी का निर्माण। इसकी आवश्यकता क्यों है? यह सरल कारण के लिए आवश्यक है कि सभी आर्कषक की बहुतायत के साथ, उनमें से सरल वेब विकास के लिए उपयुक्त नहीं था। कई समान हैं, उदाहरण के लिए, एक ही मावेन-आर्कटाइप-वेबैप, लेकिन इसमें वर्णनकर्ता पुराने हैं, कोई लॉग 4j और एक सामान्य जेएसपी टेम्पलेट नहीं है। कुल मिलाकर, एक खाली प्रोजेक्ट बनाने के बाद, आपको फ़ाइल मोड पर स्विच करने और Google को हर चीज़ को फिर से उपयोग करने के लिए उपयोग करना चाहिए जैसा कि इसे करना चाहिए। अंत में, दसवीं बार, मैं इससे थक गया था, और मैंने अपना स्वयं का सबसे अच्छा और सबसे सही, अपने स्वयं के आर्कषक बनाने का फैसला किया। अधिक विशेष रूप से, हम सर्वलेट 2.5 / JSP 2.1 / JSTL 1.2 का उपयोग करने के लिए एक सरल स्प्रिंग-एमवीसी एप्लिकेशन के लिए एक रिक्त तैयार करेंगे जिसमें लॉग-इन का उपयोग किया जाएगा।

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

सबसे पहले आपको मावेन-आर्कटाइप-आर्कटाइप आर्कहैप्ट का उपयोग करके हमारे आर्कटाइप के लिए एक प्रोजेक्ट बनाने की आवश्यकता है, उदाहरण के लिए, एक ही आर्कटाइप का उपयोग करके: बनाएँ।

	 गंभीर @ ब्लैकबॉक्स: ~ / परियोजनाओं $ mvan archetype: create \
	    -DarchetypeArtifactId = मावेन-आर्कटाइप-आर्कटाइप \ _
	    -डार्टवर्कआईड = बेयरमाइक \ _
	    -DgroupId = उदाहरण

कंसोल में पीड़ित नहीं होने के लिए, आइए ग्रहण करने के लिए आगे बढ़ें, हालांकि निश्चित रूप से नीचे लिखी गई सब कुछ विम या कुछ और के साथ किया जा सकता है।

	 grim @ ब्लैकबॉक्स: ~ / प्रोजेक्ट्स $ cd नंगेमिक्स && mvan eclipe: ग्रहण

फिर हम आयात करते हैं और संरचना को अधिक विस्तार से देखते हैं।

प्रोजेक्ट में एक संसाधन फ़ोल्डर होता है, जिसमें दो सबफ़ोल्डर होते हैं: आर्कटाइप-संसाधन और मेटा-इन। पहले वाले में भविष्य की उत्कृष्ट परियोजनाओं की रीढ़ है, जो प्रोग्रामर की पीढ़ियों द्वारा हमारी मृत्यु के बाद बनाई जाएगी, दूसरे में फ़ाइल मेटा-इन / मावेन / archetype.xml शामिल है। यह एक आर्कषक विवरण है। इसमें वह वर्णन शामिल होगा जो कि पुरालेख में शामिल है।

हम आपके द्वारा आवश्यक सभी चीज़ों के साथ रीढ़ की हड्डी को पूरक करेंगे: एक साधारण jsp पृष्ठ, अधिक या कम सहने योग्य web.xml, एक साधारण नियंत्रक और log4j.properties कॉन्फ़िगरेशन जोड़ें। यह सब आपको संग्रह में मिलेगा , जिसे डाउनलोड किया जा सकता है । दिलचस्प बिंदुओं में से, आपको ध्यान देना चाहिए कि प्रोजेक्ट बनाते समय मावेन किस जगह बनाता है। कट्टरपंथी वेग-आधारित टेम्पलेट इंजन को लागू करता है, जो व्यावहारिक रूप से प्रलेखित नहीं है, यदि कोई इसके विपरीत के बारे में सुनिश्चित है, तो इसे साझा करें, मैं आभारी रहूंगा।

विशेष रूप से, टेम्प्लेट के माध्यम से नियंत्रक ने पैकेज नाम के प्रतिस्थापन को लागू किया।

  // HomeController.java package $package; import org.apache.commons.logging.Log; @Controller public class HomeController { ...

स्प्रिंग एमवीसी कॉन्फ़िगरेशन में और लक्ष्य pom.xml बनाने में उसी चाल का उपयोग किया गया था। अब तक, मेरे लिए ज्ञात चर की सूची बल्कि दुर्लभ है: $ groupId , $ विरूपण साक्ष्य , $ संस्करण और $ पैकेज । मुझे लगता है कि हर कोई समझता है कि हर किसी का क्या मतलब है, यह सब एक चापलूसी से परियोजना बनाते समय इंगित किया गया है।

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

जब टेम्प्लेट तैयारी की प्रक्रिया पूरी हो जाती है, तो आपको एक ही तरह के ऑर्किटेक्ट डिस्क्रिप्टर फाइल को तैयार करने की जरूरत होती है।

  <archetype xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/plugins/maven-archetype-plugin/archetype/1.0.0 http://maven.apache.org/xsd/archetype-1.0.0.xsd"> <id>baremvc</id> <sources> <source>src/main/java/HomeController.java</source> </sources> <resources> <resource>src/main/resources/log4j.properties</resource> <resource>src/main/webapp/home.jsp</resource> <resource>src/main/webapp/WEB-INF/applicationContext.xml</resource> <resource>src/main/webapp/WEB-INF/web.xml</resource> </resources> <testSources /> </archetype>

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

<स्रोत>	src / main / java
<संसाधन>	src / मुख्य / संसाधन
<TestSources>	src / परीक्षण / जावा
<TestResources>	src / परीक्षण / संसाधन
<SiteResources>	src / साइट

एक बार जब सब कुछ तैयार हो जाता है, तो आप रिपॉजिटरी का उपयोग करके हमारे आर्च को स्थापित कर सकते हैं

	 गंभीर @ ब्लैकबॉक्स: ~ / परियोजनाओं / नंगे पीवीसी $ mvan साफ स्थापित करें

और अब यह उपयोग करने के लिए तैयार है।

	 गंभीर @ ब्लैकबॉक्स: ~ / परियोजनाओं / नंगे पीवीसी $ cd ..
	 गंभीर @ ब्लैकबॉक्स: ~ / परियोजनाओं $ mvan archetype: create \
	   -DarchetypeGroupId = org.example \
	   -DarchetypeArtifactId = baremvc \
	   -DarchetypeVersion = 1.0 \
	   -DgroupId = org.example \
	   -डार्टवर्कआईडी = नंगेमुबैप

हमारा छोटा प्रोजेक्ट लॉन्च करने के लिए तैयार है।

	 grim @ ब्लैकबॉक्स: ~ / प्रोजेक्ट्स / नंगेमबैप $ $ सीडी नंगेमबैप
	 ग्रिम @ ब्लैकबॉक्स: ~ / प्रोजेक्ट्स / नंगेमबप्प्प $ मवन टॉमकैट: रन

फिर, लिंक http: // localhost: 8080 / baremvcapp का उपयोग करके , आप इस निर्माण को देख सकते हैं।

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

	 grim @ ब्लैकबॉक्स: ~ / प्रोजेक्ट्स $ mvan archetype: crawl -Dcatalog = / home / grim / .m2 / archetype-catalog.xml

अब जब आप आर्कटाइप: जेनरेट करते हैं, तो सूची में एक लाइन दिखनी चाहिए

	 1: स्थानीय -> नंगे पीवीसी (नंगेमुई)

जिसके साथ मैं हमें बधाई देता हूं।

निष्कर्ष में, यह जोड़ना बाकी है कि ऊपर वर्णित विधि पुराना (अफसोस) है, और पदावनत के रूप में चिह्नित है, लेकिन यह अभी भी काम करता है, और बिल्ली प्रलेखन के सही तरीके के बारे में रोया। अब तक मुझे पता है कि डिस्क्रिप्टर को बदल दिया गया है, अब इसे archetype-metadata.xml कहा जाता है और इसमें अधिक शक्तिशाली वाक्यविन्यास है। मुझे उम्मीद है कि मेरे पास अगले दस साल पहले लिखने के लिए पर्याप्त लेख होंगे।

डाउनलोड करने योग्य संग्रह

जिन स्रोतों को देखा जा सकता है

संसाधनों का उपयोग किया

आर्किटेप्स बनाने के लिए गाइड - http://maven.apache.org/plugins/maven-archetype-plugin-1.0-alpha-7/examples/archetype.html
मावेन आर्केचेप प्लगिन - http://maven.apache.org/archetype/maven-archetype-plugin/
मावेन - उपयोग के दो साल बाद विचार - http://habrahabr.ru/blogs/personal/102181/

UPD: इसमें भी एक लक्ष्य है : create-from-project , जो आपके प्रोजेक्ट से एक टेम्पलेट तैयार करेगा। टेम्पलेट लक्ष्य / जनरेट-सोर्स / आर्कटाइप फ़ोल्डर में उत्पन्न होता है। यही है, वास्तव में, आपकी किसी भी परियोजना से, आप एक आर्च उत्पन्न कर सकते हैं और फिर इसे एक प्रारंभिक बिंदु के रूप में उपयोग कर सकते हैं। धन्यवाद 1nd1go

मावेन में अपने आर्कटाइप्स और निर्देशिका बनाएं

एक स्थानीय निर्देशिका बनाएँ

अपना आर्कषक बनाएं

संसाधनों का उपयोग किया

More articles: