ई-डोबावकी - जावा और स्प्रिंग बूट में खाद्य योजकों की खोज के लिए एक वेब सेवा, जो मेरे छात्रों द्वारा लिखी गई है

परिचय

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

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

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

सेवा स्वयं यहाँ है - E-Dobavki.com.

परियोजना शैक्षणिक है और इसमें कोई विज्ञापन नहीं है। जैसा कि मैं समझता हूं यह प्रकाशन, आप ऐसी परियोजनाओं के लिंक प्रदान कर सकते हैं।

परियोजना का वर्णन करने से पहले, मैं आपको समूह की सीखने की प्रक्रिया के बारे में थोड़ा बताऊंगा; इसके बिना, तस्वीर अधूरी होगी।

9 महीने की ट्रेनिंग

जिस स्कूल में मैं पढ़ाता हूं, वहां जावा पाठ्यक्रम को 2 भागों में बांटा गया है। कुल मिलाकर, पाठ्यक्रम में सभी ब्रेक (नए साल की छुट्टियां, मध्यवर्ती परियोजनाएं लिखने का समय) के साथ लगभग 9 महीने लगते हैं।

पहला भाग छात्रों को भाषा की बुनियादी अवधारणाओं से परिचित कराता है। वेरिएबल्स, विधियाँ, ओओपी मूल बातें और वह सभी चीज़ें।

पाठ्यक्रम का दूसरा भाग प्रदान करता है कि छात्र पहले से ही कमोबेश समझता है कि जावा में कैसे लिखना है, और उसे "वयस्क" प्रौद्योगिकी स्टैक दिया जा सकता है। यह सब SQL से शुरू होता है, फिर JDBC, हाइबरनेट से। फिर HTTP, सर्वलेट्स। अगला है स्प्रिंग, गिट और मावेन के बारे में थोड़ा। और छात्र अंतिम प्रोजेक्ट लिखते हैं।

सभी प्रशिक्षण को मॉड्यूल में विभाजित किया गया है। मैंने सप्ताह में दो बार कक्षाएं आयोजित कीं। एक पाठ की अवधि दो घंटे है।

सीखने के प्रति मेरा दृष्टिकोण

मैंने 5 समूह जारी किए. यह दो वर्षों के लिए बहुत कुछ लगता है, लेकिन मैंने लगभग हमेशा समानांतर रूप से 2 समूहों का नेतृत्व किया।

मैंने अलग-अलग तरीके आज़माए हैं।

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

दूसरा विकल्प जो मेरे सामने आया और जिस पर मैं अभी काम कर रहा हूं वह यह है कि पूरे एक जोड़े को सिद्धांत के लिए समर्पित न किया जाए। इसके बजाय, मैं 5-10 मिनट के लिए सिद्धांत के छोटे खंडों को मिलाता हूं, और तुरंत उन्हें व्यावहारिक उदाहरणों के साथ सुदृढ़ करता हूं। यह दृष्टिकोण बेहतर काम करता है.

यदि पर्याप्त समय हो, तो मैं विद्यार्थियों को अपने स्थान पर बुलाता हूँ, उन्हें अपने लैपटॉप पर बैठाता हूँ, और वे स्वयं व्यावहारिक उदाहरण देते हैं। यह बढ़िया काम करता है, लेकिन दुर्भाग्य से इसमें बहुत समय लगता है।

हर कोई इसे अंत तक नहीं पहुँचा पाता

मेरे लिए एक रहस्योद्घाटन यह तथ्य था कि पूरा समूह पाठ्यक्रम के अंत तक नहीं पहुंचता है।

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

वे विभिन्न कारणों से चले जाते हैं।

पहली है जटिलता. चाहे वे कुछ भी कहें, जावा सबसे सरल भाषा नहीं है। यहां तक ​​कि सबसे सरल प्रोग्राम लिखने के लिए, आपको एक वर्ग की अवधारणा, एक विधि को समझने की आवश्यकता है। और यह समझने के लिए कि आपको लिखने की आवश्यकता क्यों है सार्वजनिक स्थैतिक शून्य मुख्य (स्ट्रिंग [] arg) समझने के लिए कुछ और अवधारणाएँ हैं।

इसकी तुलना टर्बो पास्कल से करें, जिसके साथ कई लोगों ने शुरुआत की, जिनमें मैं भी शामिल हूं:

begin
    writeln("Первая программа");
end.

जहां तक ​​मुझे पता है, स्कूल अतिरिक्त परीक्षण शुरू करके इस समस्या का समाधान करेगा। अब हर कोई जावा नहीं पढ़ सकता. यह अभी भी अवधारणा स्तर पर है, लेकिन यह कदम स्पष्ट रूप से सही है।

और दूसरा कारण नीचे दी गई तस्वीर जैसा है:

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

हकीकत थोड़ी अलग है. बहुत सारे नियमित कोड, स्पष्ट बग, निरंतर सीखने की प्रक्रिया। यह दिलचस्प है, लेकिन हर किसी के लिए नहीं.

ये आँकड़े हैं. पहले तो इससे मैं परेशान हो गया, मुझे लगा कि शायद मैं कुछ गलत कर रहा हूं। अब मैं समझता हूं कि अधिकांश पाठ्यक्रमों के आँकड़े लगभग समान हैं। अब मैं इसकी चिंता नहीं करता बल्कि उन लोगों को सिखाता हूं जो इसमें रुचि रखते हैं।'

सेवा विचार

एक बार जब छात्रों ने पूरा पाठ्यक्रम पूरा कर लिया, तो अंतिम प्रोजेक्ट लिखने का समय आ गया। अलग-अलग विचार थे. उन्होंने टूडू शीट, परियोजना प्रबंधन परियोजनाएं और कुछ और की पेशकश की।

मैं कुछ सरल लेकिन उपयोगी करना चाहता था। मेरी कसौटी सरल थी - क्या मैं और मेरे दोस्त इसका उपयोग कर सकते हैं। खाद्य योजकों की खोज के लिए एक वेब सेवा इन आवश्यकताओं को पूरा करती है।

विचार सरल है. जब आप किसी स्टोर से कोई उत्पाद खरीदते हैं, तो आपको उसकी संरचना में किसी प्रकार का ई-एडिटिव दिखाई देता है। कोड से यह स्पष्ट नहीं है कि यह कितना खतरनाक है या नहीं (और इसमें खतरनाक एडिटिव्स भी हैं जो कई देशों में प्रतिबंधित हैं)।

आप वेबसाइट खोलें, पूरक का नाम (संख्या, वैकल्पिक नामों में से एक) दर्ज करें, और पूरक का सारांश प्राप्त करें:

ऐसी ही परियोजनाएं हैं. आप ऐडिटिव को Google में आसानी से टाइप भी कर सकते हैं, हालाँकि यह हमेशा जानकारी को सही ढंग से नहीं दिखाता है।

लेकिन चूंकि परियोजना शैक्षिक है, उपरोक्त कठिनाइयों ने हमें नहीं रोका :)

कार्यान्वयन

सभी ने जावा में लिखा, Github पर प्रोजेक्ट का स्रोत कोड.

वहाँ हममें से 7 लोग थे, जिनमें मैं भी शामिल था। सभी ने पुल अनुरोध किया और मैंने या समूह के किसी अन्य व्यक्ति ने इस पुल अनुरोध को स्वीकार कर लिया।

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

पार्सिंग एडिटिव्स

डेटाबेस (इकाइयाँ, रिपॉजिटरी इत्यादि) के चारों ओर एक ढांचे के बुनियादी निर्माण के अलावा, छात्रों में से एक ने जो पहला काम किया, वह मौजूदा सूचना साइट से ऐड-ऑन को पार्स करना था।

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

स्प्रिंग बूट आपको एकाधिक प्रोफ़ाइल बनाने की अनुमति देता है। प्रोफ़ाइल सेटिंग्स वाली एक फ़ाइल है.

देव परिवेश के लिए, हमने स्थानीय H2 DBMS और डिफ़ॉल्ट HTTP पोर्ट (8080) के साथ एक प्रोफ़ाइल का उपयोग किया। इस प्रकार, हर बार जब एप्लिकेशन लॉन्च किया गया, तो डेटाबेस साफ़ हो गया। इस मामले में पार्सर ही वह चीज़ थी जिसने हमें बचाया।

खोजें और फ़िल्टर करें

एक महत्वपूर्ण बिंदु खोज और फ़िल्टरिंग है। स्टोर में मौजूद व्यक्ति को तुरंत सप्लीमेंट के कोड या किसी एक नाम पर क्लिक करना होगा और परिणाम प्राप्त करना होगा।

इसलिए, Additive इकाई में कई फ़ील्ड हैं। यह योगात्मक कोड, वैकल्पिक नाम, विवरण है। एक ही समय में सभी क्षेत्रों में लाइक का उपयोग करके खोज की जाती है। और यदि आप [123] या [ऐमारैंथ] दर्ज करते हैं, तो आपको वही परिणाम मिलेगा।

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

एक दर्जन विशिष्टताओं को लिखने के बाद, आप जटिल प्रश्न पूछ सकते हैं जैसे "सभी खतरनाक रंग भरने वाले पदार्थ जिनके विवरण में शब्द [लाल] है।"

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

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

सुरक्षा

यह आसान है। ऐसे उपयोगकर्ता हैं जिनके पास व्यवस्थापक भूमिका है - वे अतिरिक्त चीज़ों को संपादित कर सकते हैं, उन्हें हटा सकते हैं और नए जोड़ सकते हैं।

और अन्य उपयोगकर्ता भी हैं (पंजीकृत या नहीं)। वे केवल एडिटिव्स की सूची ब्राउज़ कर सकते हैं और जिनकी उन्हें आवश्यकता है उन्हें खोज सकते हैं।

स्प्रिंग सिक्योरिटी का उपयोग अधिकारों को अलग करने के लिए किया गया था। उपयोगकर्ता डेटा को एक डेटाबेस में संग्रहीत किया जाता है।

उपयोगकर्ता पंजीकरण कर सकते हैं. अब यह कुछ नहीं देता. यदि छात्र सेवा विकसित करना जारी रखते हैं और कुछ वैयक्तिकृत फ़ंक्शन पेश करते हैं, तो पंजीकरण काम में आएगा।

जवाबदेही और बूटस्ट्रैप

अगला बिंदु अनुकूलनशीलता है। हमारी सेवा के मामले में (कम से कम जिस तरह से हमने इसे देखा), अधिकांश उपयोगकर्ताओं के पास मोबाइल फोन होंगे। और आपको अपने मोबाइल फोन से पूरक को तुरंत देखना होगा।

सीएसएस से परेशानी न हो, इसके लिए हमने बूटस्ट्रैप लिया। सस्ता, प्रसन्नचित्त और सभ्य दिखता है।

मैं इंटरफ़ेस को आदर्श नहीं कह सकता. मुख्य पृष्ठ तो और भी छोटा है, और योजक के विस्तृत विवरण के लिए पृष्ठ संकीर्ण है; मोबाइल फोन पर इसे व्यापक बनाने की आवश्यकता है।

मैं केवल इतना कह सकता हूं कि मैंने काम में यथासंभव कम हस्तक्षेप करने की कोशिश की। यह अभी भी एक छात्र परियोजना है. और निश्चित रूप से, लोग बाद में ऐसे क्षणों को ठीक करने में सक्षम होंगे।

एसईओ अनुकूलन का एक मिनट

चूंकि मैं दो साल से अधिक समय से वेबसाइटों और एसईओ से जुड़ी हर चीज से जुड़ा हुआ हूं, इसलिए मैं कम से कम बुनियादी एसईओ अनुकूलन के बिना कोई प्रोजेक्ट जारी नहीं कर सका।

वास्तव में, मैंने प्रत्येक ऐड-ऑन के लिए शीर्षक और विवरण का एक टेम्पलेट तैयार किया। यूआरएल लगभग सीएनसी है, हालांकि इसे छोटा किया जा सकता है।

मैंने उपस्थिति काउंटर भी जोड़े। खोज इंजनों से चेतावनियों पर नज़र रखने के लिए साइट को यांडेक्स वेबमास्टर और Google सर्च कंसोल में जोड़ा गया।

यह पर्याप्त नहीं है। पूर्ण अनुक्रमण के लिए आपको robots.txt और sitemap.xml भी जोड़ना होगा। लेकिन फिर भी, यह एक छात्र परियोजना है। मैं उन्हें बताऊंगा कि क्या करने की जरूरत है और अगर वे चाहेंगे तो वे ऐसा करेंगे।

आपको एक SSL प्रमाणपत्र संलग्न करना होगा. निःशुल्क लेट्स एनक्रिप्ट भी काम करेगा। मैंने स्प्रिंग बूट के लिए ऐसा किया। ऐसा करना मुश्किल नहीं है और पीएस का भरोसा बढ़ता है.

प्रोजेक्ट के लिए आगे क्या है?

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

"स्निकर्स" दर्ज करें और देखें कि इसमें कौन से पोषक तत्व शामिल हैं।

परियोजना की शुरुआत में भी, मुझे पता था कि हमारे पास कोई उत्पाद नहीं होगा :) इसलिए, हमने केवल एडिटिव्स के साथ शुरुआत की।

अब आप उत्पाद जोड़ सकते हैं और अतिरिक्त उत्पाद पेश कर सकते हैं। बन्स यदि यह एक व्यापक डेटाबेस है, तो उपयोगकर्ता होंगे।

तैनाती

परियोजना को वीपीएस, अरूबा क्लाउड पर तैनात किया गया था। यह सबसे सस्ता वीपीएस है जो हमें मिल सकता है। मैं अपनी परियोजनाओं के लिए एक वर्ष से अधिक समय से इस प्रदाता का उपयोग कर रहा हूं, और मैं इससे काफी प्रसन्न हूं।

वीपीएस विशेषताएं: 1 जीबी रैम, 1 सीपीयू (मुझे आवृत्ति के बारे में नहीं पता), 20 जीबी एसएसडी। हमारे प्रोजेक्ट के लिए यह काफी है.

प्रोजेक्ट सामान्य एमवीएन क्लीन पैकेज का उपयोग करके बनाया गया है। परिणाम एक मोटा जार है - सभी निर्भरताओं के साथ एक निष्पादन योग्य फ़ाइल।

इस सब को थोड़ा स्वचालित करने के लिए, मैंने कुछ बैश स्क्रिप्ट लिखीं।

पहली स्क्रिप्ट पुरानी जार फ़ाइल को हटा देती है और एक नई बनाती है।

दूसरी स्क्रिप्ट असेंबल किए गए जार को लॉन्च करती है, इसे आवश्यक प्रोफ़ाइल का नाम देती है। इस प्रोफ़ाइल में डेटाबेस कनेक्शन जानकारी है.

DB - MySQL उसी VPS पर।

कुल परियोजना पुनरारंभ में शामिल हैं:

• SSH के माध्यम से VPS में लॉग इन करें
• नवीनतम गिट परिवर्तन डाउनलोड करें
• लोकल-jar.sh चलाएँ
• चल रहे एप्लिकेशन को मारें
• लॉन्च-प्रोडक्शन.श चलाएँ

इस प्रक्रिया में तीन मिनट का समय लगता है. इतने छोटे प्रोजेक्ट के लिए यह मुझे एक स्मार्ट विकल्प लगता है।

जटिलता

परियोजना बनाने में मुख्य कठिनाइयाँ संगठनात्मक प्रकृति की थीं।

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

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

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

इस सारे आन्दोलन का उद्देश्य सरल था। एक साथ काम करने के लिए, भले ही थोड़े समय के लिए ही सही, एक टीम बनाएं।

मैं चाहता था कि लोग महसूस करें कि उनका काम महत्वपूर्ण है। समझें कि वे निर्वात में गोलाकार कोड नहीं लिखते हैं। और वे मिलकर जो कर रहे हैं वह एक परियोजना है जिसका लोग उपयोग करेंगे।

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

मेरा मानना ​​है कि लक्ष्य हासिल कर लिया गया है. प्रोजेक्ट पूरा हो गया है, लोगों को एक टीम में काम करने का थोड़ा अनुभव मिला है। एक दृश्यमान, ठोस परिणाम है जिसे दोस्तों को दिखाया जा सकता है और आगे विकसित किया जा सकता है।

निष्कर्ष

सीखना दिलचस्प है.

प्रत्येक कक्षा के बाद मैं भावनात्मक रूप से उत्तेजित होकर वापस आता था। मैं प्रत्येक जोड़ी को अद्वितीय बनाने और जितना संभव हो उतना ज्ञान देने का प्रयास करता हूं।

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

हालाँकि लेख काफी बड़ा था, लेकिन सभी बिंदुओं को कवर करना निश्चित रूप से संभव नहीं था। इसलिए अपने सवाल कमेंट में लिखें।

स्रोत: www.habr.com