E-Dobavki - ვებ სერვისი საკვები დანამატების საძიებლად Java და Spring Boot, დაწერილი ჩემი სტუდენტების მიერ.

შესავალი

მოხდა ისე, რომ ბოლო თითქმის ორი წელიწადი ვასწავლი პროგრამირებას კიევის ერთ-ერთ IT სკოლაში. დავიწყე ამის გაკეთება მხოლოდ გასართობად. ერთხელ დავწერე პროგრამირების ბლოგი, შემდეგ დავთმე. მაგრამ დაინტერესებული ადამიანებისთვის სასარგებლო რამის თქმის სურვილი არ გამქრალა.

ჩემი ძირითადი ენა ჯავაა. მასზე დავწერე თამაშები მობილური ტელეფონებისთვის, პროგრამული უზრუნველყოფა რადიო კომუნიკაციებისთვის და სხვადასხვა ვებ სერვისები. და ვასწავლი ჯავას.

აქ მინდა მოგიყვეთ ჩემი ბოლო ჯგუფის ვარჯიშის ამბავი. როგორ გადავიდნენ ისინი ტრენინგის დაწყებიდან სამუშაო ვებ სერვისის დაწერამდე. სასარგებლო ვებ სერვისი საკვები დანამატების მოსაძებნად. უფასო, რეკლამის გარეშე, რეგისტრაცია და SMS.

თავად სერვისი აქ არის - E-Dobavki.com.

პროექტი არის საგანმანათლებლო და არ შეიცავს რეკლამას. როგორც მივხვდი ეს პუბლიკაცია, შეგიძლიათ მოგვაწოდოთ ბმულები მსგავსი პროექტებისთვის.

სანამ თავად პროექტს აღვწერ, ცოტას გეტყვით ჯგუფის სასწავლო პროცესის შესახებ, ამის გარეშე სურათი არასრული იქნება.

9 თვიანი ტრენინგი

სკოლაში, სადაც ვასწავლი, ჯავის კურსი დაყოფილია 2 ნაწილად. საერთო ჯამში, კურსს დაახლოებით 9 თვე სჭირდება, ყველა შესვენებით (საახალწლო არდადეგები, შუალედური პროექტების დაწერის დრო).

პირველი ნაწილი მოსწავლეებს აცნობს ენის ძირითად ცნებებს. ცვლადები, მეთოდები, OOP საფუძვლები და ეს ყველაფერი.

კურსის მეორე ნაწილი ითვალისწინებს, რომ სტუდენტს უკვე მეტ-ნაკლებად ესმის Java-ში წერა და მას შეიძლება მიეცეს „ზრდასრული“ ტექნოლოგიური სტეკი. ეს ყველაფერი იწყება SQL-ით, შემდეგ JDBC, Hibernate-ით. შემდეგ HTTP, სერლეტები. შემდეგი არის გაზაფხული, ცოტა რამ გიტისა და მავენის შესახებ. და სტუდენტები წერენ საბოლოო პროექტებს.

ყველა ტრენინგი დაყოფილია მოდულებად. კვირაში ორჯერ ვატარებდი გაკვეთილებს. ერთი გაკვეთილის ხანგრძლივობა ორი საათია.

ჩემი მიდგომა სწავლისადმი

გამოვუშვი 5 ჯგუფი. როგორც ჩანს, ორი წელი ბევრია, მაგრამ თითქმის ყოველთვის პარალელურად ვხელმძღვანელობდი 2 ჯგუფს.

მე ვცადე სხვადასხვა მიდგომები.

პირველი ვარიანტი არის ის, რომ ერთი წყვილი გამოიყოფა თეორიით პრეზენტაციისთვის. მეორე წყვილი სუფთა პრაქტიკაა. ეს მიდგომა რატომღაც მუშაობდა, მაგრამ ეს არ იყო ძალიან ეფექტური, ჩემი აზრით.

მეორე ვარიანტი, რაზეც მივედი და რომელზეც ახლა ვმუშაობ, არის მთელი წყვილის თეორიას არ მივუძღვნა. სამაგიეროდ, თეორიის მოკლე მონაკვეთებს ვურევ 5-10 წუთის განმავლობაში და მაშინვე ვამაგრებ მათ პრაქტიკული მაგალითებით. ეს მიდგომა უკეთ მუშაობს.

თუ დრო საკმარისია, მოსწავლეებს ჩემს ადგილას ვურეკავ, ლეპტოპთან ვჯდები და ისინი თვითონ აკეთებენ პრაქტიკულ მაგალითებს. ის მშვენივრად მუშაობს, მაგრამ სამწუხაროდ ამას დიდი დრო სჭირდება.

ყველა არ მიდის ბოლომდე

ჩემთვის აღმოჩენა იყო ის ფაქტი, რომ მთელი ჯგუფი არ აღწევს კურსის ბოლომდე.

ჩემი დაკვირვებით, მოსწავლეების მხოლოდ ნახევარი წერს საბოლოო პროექტს. მათი უმეტესობა გამოირიცხება კურსის პირველ ნაწილში. და ვინც მიაღწია მეორე ნაწილს, როგორც წესი, არ ცდება.

ისინი ტოვებენ სხვადასხვა მიზეზის გამო.

პირველი არის სირთულე. რაც არ უნდა თქვან, ჯავა არ არის უმარტივესი ენა. თუნდაც უმარტივესი პროგრამის დასაწერად, თქვენ უნდა გესმოდეთ კლასის კონცეფცია, მეთოდი. და იმის გასაგებად, თუ რატომ გჭირდებათ დაწერა საჯარო სტატიკური სიცარიელე მთავარი (სტრიქონი[] arg) კიდევ რამდენიმე ცნებაა გასაგებად.

შეადარეთ ეს Turbo Pascal-ს, რითაც დაიწყო ბევრმა, მათ შორის მეც:

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

როგორც ვიცი, სკოლა ამ პრობლემას დამატებითი ტესტირების შემოღებით მოაგვარებს. ახლა ყველას არ შეუძლია ჯავის შესწავლა. ეს ჯერ კიდევ კონცეფციის ეტაპზეა, მაგრამ ნაბიჯი აშკარად სწორია.

და მეორე მიზეზი არის როგორც ქვემოთ მოცემულ სურათზე:

ადამიანები ხშირად ფიქრობენ, რომ პროგრამირება არის ბევრი ტექსტის აკრეფა და ამისთვის ბევრი ფულის მიღება. კოპირაიტერის მსგავსად, მხოლოდ მეტი ფული.

რეალობა ცოტა განსხვავებულია. ბევრი რუტინული კოდი, გაუგებარი შეცდომები, მუდმივი სწავლის პროცესი. საინტერესოა, მაგრამ არა ყველასთვის.

ეს არის სტატისტიკა. თავიდან გამაბრაზა, ვიფიქრე, იქნებ რაღაცას არასწორად ვაკეთებდი. ახლა მე მესმის, რომ სტატისტიკა დაახლოებით იგივეა კურსების უმეტესობისთვის. ახლა ამაზე არ ვდარდობ, მაგრამ ვასწავლი იმ ადამიანებს, ვისაც ეს აინტერესებს.

მომსახურების იდეა

მას შემდეგ რაც სტუდენტებმა დაასრულეს მთელი კურსი, დრო იყო დაეწერა საბოლოო პროექტი. იყო სხვადასხვა იდეები. მათ შესთავაზეს ToDo ფურცლები, პროექტის მართვის პროექტები და სხვა რამ.

მინდოდა რაღაც მარტივი, მაგრამ სასარგებლო გამეკეთებინა. ჩემი კრიტერიუმი მარტივი იყო - შეგვეძლო თუ არა მე და ჩემი მეგობრები გამოვიყენოთ. ამ მოთხოვნებს აკმაყოფილებდა საკვები დანამატების ძიების ვებ სერვისი.

იდეა მარტივია. როდესაც ყიდულობთ პროდუქტს მაღაზიაში, კომპოზიციაში ხედავთ რაიმე სახის E-დანამატს. კოდიდან არ ჩანს, რამდენად საშიშია ეს თუ არა (და ასევე არის საშიში დანამატები, რომლებიც აკრძალულია ბევრ ქვეყანაში).

თქვენ ხსნით ვებგვერდს, შეიყვანთ დანამატის სახელს (ნომერს, ერთ-ერთ ალტერნატიულ სახელს) და იღებთ დანამატის რეზიუმეს:

არის მსგავსი პროექტები. თქვენ ასევე შეგიძლიათ უბრალოდ ჩაწეროთ დანამატი Google-ში, თუმცა ის ყოველთვის არ აჩვენებს ინფორმაციას სწორად.

მაგრამ რადგან პროექტი საგანმანათლებლოა, ზემოთ მოცემულმა სირთულეებმა ხელი არ შეგვიშალა :)

Реализация

ყველა წერდა ჯავაზე, პროექტის წყაროს კოდი Github-ზე.

7 კაცი ვიყავით, მათ შორის მეც. ყველამ გააკეთა მოთხოვნა და მე, ან ჯგუფის სხვა ადამიანმა, მივიღეთ ეს მოთხოვნა.

პროექტის განხორციელებას დაახლოებით ერთი თვე დასჭირდა - იდეის გაჟღერებიდან იმ მდგომარეობამდე, რასაც ახლა ხედავთ.

პარსინგის დანამატები

პირველი, რაც ერთ-ერთმა სტუდენტმა გააკეთა, გარდა მონაცემთა ბაზის (ერთეულები, საცავები და ა.შ.) ირგვლივ ჩარჩოს შექმნისა, იყო არსებული საინფორმაციო საიტიდან დანამატების გარჩევა.

ეს აუცილებელი იყო დარჩენილი ქულების შესამოწმებლად. მონაცემთა ბაზის შესავსებად დამატებითი კოდი არ არის საჭირო. რამდენიმე დანამატის სწრაფად გაანალიზების შემდეგ, ჩვენ შეგვეძლო UI-ის შემდგომი ტესტირება, დახარისხება და გაფილტვრა.

Spring Boot გაძლევთ საშუალებას შექმნათ მრავალი პროფილი. პროფილი არის ფაილი პარამეტრებით.

დეველოპერის გარემოსთვის, ჩვენ გამოვიყენეთ პროფილი ადგილობრივი H2 DBMS და ნაგულისხმევი HTTP პორტი (8080). ამრიგად, აპლიკაციის გაშვებისას, მონაცემთა ბაზის გასუფთავება მოხდა. ამ შემთხვევაში პარსერი იყო ის, რაც გადაგვარჩინა.

ძებნა და გაფილტვრა

მნიშვნელოვანი წერტილი არის ძებნა და გაფილტვრა. მაღაზიაში მყოფმა ადამიანმა სწრაფად უნდა დააჭიროს დანამატის კოდს, ან ერთ-ერთ სახელს და მიიღოს შედეგი.

ამრიგად, დანამატის ერთეულს აქვს რამდენიმე ველი. ეს არის დანამატი კოდი, ალტერნატიული სახელები, აღწერა. ძიება ხორციელდება Like-ის გამოყენებით ყველა ველში ერთდროულად. და თუ შეხვალთ [123] ან [ამარანტი], იგივე შედეგს მიიღებთ.

ჩვენ ეს ყველაფერი გავაკეთეთ სპეციფიკაციების საფუძველზე. ეს არის გაზაფხულის ნაწილი, რომელიც საშუალებას გაძლევთ აღწეროთ საძიებო ძირითადი პირობები (მაგალითად, ზოგიერთი ველი) და შემდეგ დააკავშიროთ ეს პირობები (OR ან AND).

ათეული სპეციფიკაციის დაწერის შემდეგ, შეგიძლიათ დასვათ რთული კითხვები, როგორიცაა „ყველა საშიში შეღებვის დანამატი, რომელსაც აღწერილობაში აქვს სიტყვა [წითელი]“.

Spring მონაცემთა ბაზასთან მუშაობის კუთხით ძალიან მოსახერხებელი მიმაჩნია. ეს განსაკუთრებით ეხება რთულ შეკითხვებთან მუშაობისას. მე მესმის, რომ ამას აქვს საკუთარი ზედნადები და ხელით დაწერილი და ოპტიმიზებული SQL მოთხოვნა უფრო სწრაფად იმუშავებს.

მაგრამ მე ასევე ვიცავ თვალსაზრისს, რომ არ არის საჭირო ყველაფრის წინასწარ ოპტიმიზაცია. პირველი ვერსია უნდა დაიწყოს, იმუშაოს და დაუშვას ცალკეული ნაწილების შეცვლა. და თუ არის დატვირთვა, ეს ცალკეული ნაწილები უნდა გადაიწეროს.

უსაფრთხოება

Ეს მარტივია. არიან მომხმარებლები ADMIN როლით - მათ შეუძლიათ დამატებების რედაქტირება, წაშლა და ახლის დამატება.

და არის სხვა მომხმარებლები (რეგისტრირებული თუ არა). მათ შეუძლიათ მხოლოდ დაათვალიერონ დანამატების სია და მოძებნონ მათთვის საჭირო.

საგაზაფხულო უსაფრთხოება გამოიყენებოდა უფლებების განცალკევებისთვის. მომხმარებლის მონაცემები ინახება მონაცემთა ბაზაში.

მომხმარებლებს შეუძლიათ რეგისტრაცია. ახლა ის არაფერს იძლევა. თუ სტუდენტები განაგრძობენ სერვისის განვითარებას და პერსონალიზებული ფუნქციების დანერგვას, მაშინ რეგისტრაცია გამოგადგებათ.

რეაგირება და Bootstrap

შემდეგი წერტილი არის ადაპტირება. ჩვენი სერვისის შემთხვევაში (ყოველ შემთხვევაში, როგორც ჩვენ ვნახეთ), მომხმარებლების უმეტესობა იქნება მობილური ტელეფონებით. და თქვენ უნდა სწრაფად ნახოთ დანამატი თქვენი მობილური ტელეფონიდან.

იმისათვის, რომ არ ვიტანჯოთ CSS-ით, ჩვენ ავიღეთ Bootstrap. იაფი, მხიარული და გამოიყურება წესიერად.

ინტერფეისს იდეალურს ვერ ვუწოდებ. მთავარი გვერდი კიდევ უფრო ნაკლებია, ხოლო დანამატის დეტალური აღწერილობის გვერდი ვიწროა; მობილურ ტელეფონებზე ის უფრო ფართოა.

მხოლოდ იმის თქმა შემიძლია, რომ ვცდილობდი რაც შეიძლება ნაკლებად ჩამერეო საქმეში. ეს ჯერ კიდევ სტუდენტური პროექტია. და რა თქმა უნდა, ბიჭები მოგვიანებით შეძლებენ ასეთი მომენტების გამოსწორებას.

SEO ოპტიმიზაციის წუთი

მას შემდეგ, რაც ორ წელზე მეტია მჭიდროდ ვარ ჩართული ვებსაიტებში და ყველაფერში, რაც SEO-სთან არის დაკავშირებული, მე ვერ გამოვაქვეყნებდი პროექტს მინიმუმ ძირითადი SEO ოპტიმიზაციის გარეშე.

ფაქტობრივად, მე გავაკეთე სათაურის და აღწერილობის შაბლონის თაობა თითოეული დანამატისთვის. URL არის თითქმის CNC, თუმცა შეიძლება უფრო მოკლე იყოს.

დასწრების მრიცხველებიც დავამატე. დაემატა საიტი Yandex Webmaster-სა და Google Search Console-ს საძიებო სისტემების გაფრთხილებების მონიტორინგისთვის.

Არ არის საკმარისი. თქვენ ასევე უნდა დაამატოთ robots.txt და sitemap.xml სრული ინდექსირებისთვის. მაგრამ კიდევ ერთხელ, ეს არის სტუდენტური პროექტი. მე ვეტყვი რა უნდა გაკეთდეს და თუ მოინდომებენ, გააკეთებენ.

თქვენ უნდა დაურთოთ SSL სერთიფიკატი. უფასო Let's Encrypt ასევე იმუშავებს. ეს გავაკეთე საგაზაფხულო ჩექმისთვის. ამის გაკეთება რთული არ არის და PS-ის ნდობა იზრდება.

რა ელის პროექტს?

მაშინ, ფაქტობრივად, არჩევანი ბიჭებზეა. პროექტის თავდაპირველი იდეა ასევე მოიცავდა პროდუქტების მონაცემთა ბაზას დანამატების ბმულებით.

შეიყვანეთ "Snickers" და ნახეთ რა საკვებ დანამატებს შეიცავს იგი.

ჯერ კიდევ პროექტის დაწყებისას ვიცოდი, რომ პროდუქცია არ გვექნებოდა :) ამიტომ დავიწყეთ მხოლოდ დანამატებით.

ახლა თქვენ შეგიძლიათ დაამატოთ პროდუქტები და შემოგთავაზოთ დამატებითი. ფუნთუშები. თუ ეს არის ვრცელი მონაცემთა ბაზა, იქნებიან მომხმარებლები.

განლაგება

პროექტი განთავსდა VPS-ზე, Aruba Cloud-ზე. ეს არის ყველაზე იაფი VPS, რომელიც ჩვენ შეგვიძლია ვიპოვოთ. წელიწადზე მეტია ვიყენებ ამ პროვაიდერს ჩემი პროექტებისთვის და სასიამოვნოდ კმაყოფილი ვარ ამით.

VPS მახასიათებლები: 1 GB ოპერატიული მეხსიერება, 1 CPU (სიხშირე არ ვიცი), 20 GB SSD. ჩვენი პროექტისთვის ეს საკმარისია.

პროექტი აგებულია ჩვეულებრივი mvn სუფთა პაკეტის გამოყენებით. შედეგი არის ცხიმიანი ქილა - შესრულებადი ფაილი ყველა დამოკიდებულებით.

ამ ყველაფრის ცოტა ავტომატიზაციისთვის, დავწერე რამდენიმე ბაშის სკრიპტი.

პირველი სკრიპტი წაშლის ძველ jar ფაილს და აშენებს ახალს.

მეორე სკრიპტი იწყებს აწყობილ ქილას, გადასცემს მას საჭირო პროფილის სახელს. ეს პროფილი შეიცავს მონაცემთა ბაზის კავშირის ინფორმაციას.

DB - MySQL იმავე VPS-ზე.

პროექტის სრული გადატვირთვა მოიცავს:

• შედით VPS-ში SSH-ის საშუალებით
• ჩამოტვირთეთ უახლესი git ცვლილებები
• აწარმოებს ადგილობრივ-ჯარ.შ
• მოკვლა გაშვებული აპლიკაცია
• გაშვება-წარმოება.შ

ამ პროცედურას სამი წუთი სჭირდება. ეს ჩემთვის ჭკვიანური არჩევანია ასეთი პატარა პროექტისთვის.

სირთულეები

პროექტის შექმნისას ძირითადი სირთულეები ორგანიზაციული ხასიათისა იყო.

არის ადამიანთა ჯგუფი, რომელმაც, როგორც ჩანს, იცის პროგრამირება, მაგრამ არც ისე კარგად. მათ რაღაც იციან, მაგრამ მაინც ვერ გამოიყენებენ. ახლა კი მათ პროექტი ერთ თვეში უნდა დაასრულონ.

ამ ჯგუფში დავადგინე პირობითი გუნდის ლიდერი. ის ინახავდა Google Doc-ს დავალებების სიით, ანაწილებდა დავალებებს და აკონტროლებდა მათ მიღებას. მან ასევე მიიღო გაყვანის მოთხოვნები.

ასევე ვთხოვე მოსწავლეებს ყოველ საღამოს დაეწერათ მოკლე მოხსენება პროექტზე შესრულებული სამუშაოს შესახებ. თუ არაფერი გააკეთე, კარგი, უბრალოდ დაწერე "არაფერი გააკეთე". ეს შესანიშნავი პრაქტიკაა და ცოტა დაძაბულობას გიქმნის. ყველა არ იცავდა ამ წესს, სამწუხაროდ.

მთელი ამ მოძრაობის მიზანი მარტივი იყო. შექმენით გუნდი, თუნდაც მცირე ხნით, ერთად ვიმუშაოთ.

მინდოდა ბიჭებს ეგრძნოთ, რომ მათი საქმე მნიშვნელოვანი იყო. გესმოდეთ, რომ ისინი არ წერენ სფერულ კოდს ვაკუუმში. და რასაც ისინი ერთად აკეთებენ არის პროექტი, რომელსაც ხალხი გამოიყენებს.

პირველი ან ორი კვირა იყო დაგროვება. სუბიექტები და მცირე ვალდებულებები ნელნელა გაკეთდა. ნელ-ნელა ავურიე ისინი და მუშაობა უფრო სახალისო გახდა. ჩატში კომუნიკაცია უფრო ცოცხალი გახდა, სტუდენტებმა შესთავაზეს თავიანთი დამატებები.

მე მჯერა, რომ მიზანი მიღწეულია. პროექტი დასრულებულია, ბიჭებმა გუნდში მუშაობის მცირე გამოცდილება მიიღეს. არის თვალსაჩინო, ხელშესახები შედეგი, რომელიც შეიძლება აჩვენო მეგობრებს და შემდგომ განვითარდეს.

დასკვნები

სწავლა საინტერესოა.

ყოველი გაკვეთილის შემდეგ ემოციურად აჟიტირებული ვბრუნდებოდი. ვცდილობ, თითოეული წყვილი უნიკალური იყოს და რაც შეიძლება მეტი ცოდნა გადმოვცე.

სასიამოვნოა, როცა ჯგუფი, რომელსაც ვასწავლი, ფინალში გადის. განსაკუთრებით მაგარია, როცა ბიჭები წერენ „სამსახური ვიშოვე, ყველაფერი კარგადაა, გმადლობთ“. თუნდაც ეს უმცროსი იყოს, თუნდაც ეს არ იყოს ყველაზე დიდი ფული თავიდან. მაგრამ ყველაზე მნიშვნელოვანი ის არის, რომ მათ გადადგნენ ნაბიჯი თავიანთი სურვილებისკენ და მიაღწიეს წარმატებას.

მიუხედავად იმისა, რომ სტატია საკმაოდ მოცულობითი აღმოჩნდა, ყველა პუნქტის გაშუქება რა თქმა უნდა შეუძლებელი იყო. ამიტომ, დაწერეთ თქვენი შეკითხვები კომენტარებში.

წყარო: www.habr.com