សួស្តីអ្នកទាំងអស់គ្នា។ យើងកំពុងងើបចេញពីស្រមោលបន្តិចម្តងៗ ហើយបន្តអត្ថបទជាបន្តបន្ទាប់អំពីផលិតផលរបស់យើង។ បន្ទាប់ពី មុន អត្ថបទពិនិត្យ យើងបានទទួលមតិកែលម្អជាច្រើន (ភាគច្រើនជាវិជ្ជមាន) ការផ្ដល់យោបល់ និងរបាយការណ៍កំហុស។ ថ្ងៃនេះយើងនឹងបង្ហាញ តេស្តមេស នៅក្នុងសកម្មភាព ហើយអ្នកនឹងអាចពេញចិត្តចំពោះលក្ខណៈពិសេសមួយចំនួននៃកម្មវិធីរបស់យើង។ សម្រាប់ការពន្លិចពេញលេញបន្ថែមទៀត ខ្ញុំណែនាំអ្នកឱ្យយោងទៅឯកសាររបស់យើងនៅ http://docs-ru.testmace.com. អញ្ចឹងតោះទៅ!

ការកំណត់

ចូរចាប់ផ្តើមជាមួយ banality ។ កម្មវិធីនេះមានហើយត្រូវបានសាកល្បងយ៉ាងពិតប្រាកដនៅលើវេទិកាបីគឺ Linux, Windows, MacOS។ អ្នកអាចទាញយកកម្មវិធីដំឡើងសម្រាប់ OS ដែលអ្នកចាប់អារម្មណ៍ពី គេហទំព័ររបស់យើង។. សម្រាប់អ្នកប្រើប្រាស់លីនុច គេអាចដំឡើងបាន។ កញ្ចប់ខ្ទាស់. យើងពិតជាសង្ឃឹមថា Microsoft Store និង App Store នឹងឈានដល់ពេលឆាប់ៗនេះ (តើវាចាំបាច់ទេ? តើអ្នកគិតយ៉ាងណា?)។

សេណារីយ៉ូពិសោធន៍

យើងបានជ្រើសរើសសេណារីយ៉ូស្តង់ដារខាងក្រោមជាប្រធានបទតេស្តរបស់យើង៖

ចូល៖ អ្នកប្រើប្រាស់ - អ្នកគ្រប់គ្រង, ពាក្យសម្ងាត់ - ពាក្យសម្ងាត់
បន្ថែមធាតុថ្មី។
សូមពិនិត្យមើលថាកំណត់ត្រាត្រូវបានបន្ថែមត្រឹមត្រូវ។

យើងនឹងសាកល្បង https://testmace-quick-start.herokuapp.com/. នេះជារឿងធម្មតា json-serverល្អឥតខ្ចោះសម្រាប់ការសាកល្បងកម្មវិធីបែបនេះ។ យើងទើបតែបានបន្ថែមការអនុញ្ញាតដោយសញ្ញាសម្ងាត់ទៅកាន់គ្រប់ផ្លូវ json-server ហើយបានបង្កើតវិធីសាស្ត្រចូលដើម្បីទទួលបានសញ្ញាសម្ងាត់នេះ។ យើងនឹងធ្វើដំណើរជាបន្តបន្ទាប់ ធ្វើឱ្យគម្រោងរបស់យើងប្រសើរឡើងជាលំដាប់។

ការបង្កើតគម្រោង និងព្យាយាមបង្កើតអង្គភាពដោយគ្មានការអនុញ្ញាត

ដំបូងយើងបង្កើតគម្រោងថ្មី (ឯកសារ->គម្រោងថ្មី) ប្រសិនបើអ្នកកំពុងបើកដំណើរការកម្មវិធីជាលើកដំបូង គម្រោងថ្មីនឹងបើកដោយស្វ័យប្រវត្តិ។ ជាដំបូង ចូរយើងព្យាយាមធ្វើសំណើដើម្បីបង្កើតកំណត់ត្រាថ្មី (ក្នុងករណីដែលការបង្កើតកំណត់ត្រាអាចរកបានដោយគ្មានការអនុញ្ញាត)។ ជ្រើសរើសធាតុពីម៉ឺនុយបរិបទថ្នាំងគម្រោង បន្ថែមថ្នាំង -> ជំហានស្នើសុំ. កំណត់ឈ្មោះថ្នាំងទៅ បង្កើត-ប្រកាស. ជាលទ្ធផល ថ្នាំងថ្មីនឹងត្រូវបានបង្កើតនៅក្នុងមែកធាង ហើយផ្ទាំងមួយសម្រាប់ថ្នាំងនេះនឹងបើក។ តោះកំណត់ប៉ារ៉ាម៉ែត្រស្នើសុំខាងក្រោម៖

ប្រភេទសំណើ៖ ប្រកាស
url: https://testmace-quick-start.herokuapp.com/posts
ស្នើសុំតួ៖ json ជាមួយតម្លៃ {"title": "New testmace quick start post"}
ប្រសិនបើអ្នកបានធ្វើអ្វីគ្រប់យ៉ាងត្រឹមត្រូវ ចំណុចប្រទាក់នឹងមើលទៅដូចនេះ៖

ទោះយ៉ាងណាក៏ដោយ ប្រសិនបើយើងព្យាយាមបំពេញសំណើនោះ ម៉ាស៊ីនមេនឹងត្រឡប់លេខកូដ 401 ហើយដោយគ្មានការអនុញ្ញាត យើងនឹងមិនអាចទទួលបានអ្វីនៅលើម៉ាស៊ីនមេនេះទេ។ ជាការប្រសើរណាស់, ជាទូទៅ, ដូចដែលបានរំពឹងទុក) ។

បន្ថែមការស្នើសុំការអនុញ្ញាត

ដូចដែលបាននិយាយរួចមកហើយថាយើងមានចំណុចបញ្ចប់ POST /loginដែលយក json ជាតួសំណើនៃទម្រង់៖ {"username": "<username>", "password": "<password>"}ដែលជាកន្លែង username и password (ម្តងទៀតពីកថាខណ្ឌណែនាំខាងលើ) មានអត្ថន័យ admin и password រៀងៗខ្លួន។ ជាការឆ្លើយតប ចំណុចបញ្ចប់នេះត្រឡប់ json ដូច {"token": "<token>"}. យើងនឹងប្រើវាសម្រាប់ការអនុញ្ញាត។ តោះបង្កើត ជំហានស្នើសុំ ថ្នាំងដែលមានឈ្មោះ ចូលនឹងដើរតួជាបុព្វបុរស គម្រោង ថ្នាំង ដោយប្រើការអូស និងទម្លាក់ ផ្លាស់ទីថ្នាំងដែលបានផ្តល់ឱ្យនៅក្នុងមែកធាងខ្ពស់ជាងថ្នាំង បង្កើត-ប្រកាស. ចូរកំណត់ប៉ារ៉ាម៉ែត្រខាងក្រោមទៅនឹងសំណើដែលបានបង្កើតថ្មី៖

ប្រភេទសំណើ៖ ប្រកាស
url: https://testmace-quick-start.herokuapp.com/login
ស្នើសុំតួ៖ json ជាមួយតម្លៃ {"username": "admin", "password": "password"}

ចូរប្រតិបត្តិសំណើរ ហើយទទួលលេខកូដពីររយជាមួយនឹងសញ្ញាសម្ងាត់ក្នុងការឆ្លើយតប។ អ្វីមួយដូចនេះ:

Refactoring: លុបការចម្លងដែន

រហូតមកដល់ពេលនេះ សំណើមិនត្រូវបានភ្ជាប់ជាស្គ្រីបតែមួយទេ។ ប៉ុន្តែនេះមិនមែនជាគុណវិបត្តិតែមួយទេ។ ប្រសិនបើអ្នកក្រឡេកមើលឱ្យដិតដល់ អ្នកនឹងសម្គាល់ឃើញថា យ៉ាងហោចណាស់ដែនត្រូវបានស្ទួនក្នុងសំណើទាំងពីរ។ មិនល្អ។ វាដល់ពេលហើយដើម្បីកែតម្រូវផ្នែកនេះនៃស្គ្រីបនាពេលអនាគត ហើយអថេរនឹងជួយយើងក្នុងរឿងនេះ។

ចំពោះការប៉ាន់ស្មានដំបូង អថេរបម្រើតួនាទីដូចគ្នានឹងឧបករណ៍ស្រដៀងគ្នាផ្សេងទៀត និងភាសាសរសេរកម្មវិធី - ការលុបបំបាត់ការចម្លង ការបង្កើនលទ្ធភាពអាន ។ល។ អ្នកអាចអានបន្ថែមអំពីអថេរនៅក្នុង ឯកសាររបស់យើង។. ក្នុងករណីនេះយើងនឹងត្រូវការអថេរអ្នកប្រើប្រាស់។

ចូរកំណត់អថេរនៅកម្រិតថ្នាំងគម្រោង domain ជាមួយនឹងអត្ថន័យ https://testmace-quick-start.herokuapp.com. សម្រាប់រឿងនេះវាចាំបាច់

បើកផ្ទាំងដោយប្រើថ្នាំងនេះហើយចុចលើរូបតំណាងម៉ាស៊ីនគិតលេខនៅខាងស្តាំខាងលើ
ចុចលើ + បន្ថែមអថេរ
បញ្ចូលឈ្មោះ និងតម្លៃអថេរ
ក្នុងករណីរបស់យើង ប្រអប់ដែលមានអថេរបន្ថែមនឹងមើលទៅដូចនេះ៖

យល់ព្រម។ ឥឡូវនេះ ដោយសារមរតក យើងអាចប្រើអថេរនេះនៅក្នុងកូនចៅនៃកម្រិតសំបុកណាមួយ។ ក្នុងករណីរបស់យើងទាំងនេះគឺជាថ្នាំង ចូល и បង្កើត-ប្រកាស. ដើម្បីប្រើអថេរក្នុងវាលអត្ថបទ អ្នកត្រូវសរសេរ ${<variable_name>}. ឧទាហរណ៍ URL ចូលត្រូវបានបំប្លែងទៅជា ${domain}/loginរៀងគ្នាសម្រាប់ បង្កើត-ប្រកាស node url នឹងមើលទៅដូច ${domain}/posts.

អាស្រ័យហេតុនេះ ដោយបានដឹកនាំដោយគោលការណ៍ DRY យើងបានកែលម្អសេណារីយ៉ូនេះបន្តិច។

រក្សាទុកនិមិត្តសញ្ញាទៅជាអថេរ

ដោយសារយើងកំពុងនិយាយអំពីអថេរ ចូរយើងពង្រីកប្រធានបទនេះបន្តិច។ នៅពេលនេះ នៅក្នុងករណីនៃការចូលដោយជោគជ័យ យើងទទួលបានពីម៉ាស៊ីនមេនូវសញ្ញាសម្ងាត់អនុញ្ញាត ដែលយើងនឹងត្រូវការក្នុងសំណើជាបន្តបន្ទាប់។ តោះរក្សាទុកសញ្ញាសម្ងាត់នេះទៅជាអថេរ។ ដោយសារតែ តម្លៃនៃអថេរនឹងត្រូវបានកំណត់កំឡុងពេលដំណើរការស្គ្រីប យើងប្រើយន្តការពិសេសសម្រាប់រឿងនេះ - អថេរថាមវន្ត.

ជាដំបូង សូមអនុវត្តការស្នើសុំចូល។ នៅក្នុងផ្ទាំង ញែក ចម្លើយ ផ្លាស់ទីទស្សន៍ទ្រនិចលើសញ្ញាសម្ងាត់ និងក្នុងម៉ឺនុយបរិបទ (ដែលត្រូវបានគេហៅថាដោយប្រើប៊ូតុងកណ្ដុរខាងស្ដាំ ឬដោយចុចលើប៊ូតុង ... ) ជ្រើសរើសធាតុ កំណត់ទៅអថេរ. ប្រអប់មួយនឹងបង្ហាញជាមួយវាលខាងក្រោម៖

ផ្លូវ - ផ្នែកណាមួយនៃចម្លើយត្រូវបានយក (ក្នុងករណីរបស់យើងវាគឺជា body.token)
តម្លៃនាពេលបច្ចុប្បន្ននេះ - តើតម្លៃអ្វីដែលស្ថិតនៅតាមបណ្តោយផ្លូវ (ក្នុងករណីរបស់យើងនេះគឺជាតម្លៃនិមិត្តសញ្ញា)
ឈ្មោះអថេរ។ - ឈ្មោះអថេរដែល តម្លៃនាពេលបច្ចុប្បន្ននេះ នឹងត្រូវបានរក្សាទុក។ ក្នុងករណីរបស់យើងវានឹងមាន token
ថ្នាំង - បុព្វបុរសណាដែលអថេរនឹងត្រូវបានបង្កើត ឈ្មោះអថេរ។. តោះជ្រើសរើសគម្រោង

ប្រអប់ដែលបានបញ្ចប់មើលទៅដូចនេះ៖

ឥឡូវនេះរាល់ពេលដែលថ្នាំងត្រូវបានប្រតិបត្តិ ចូល អថេរថាមវន្ត token នឹងត្រូវបានអាប់ដេតជាមួយនឹងតម្លៃថ្មីពីការឆ្លើយតប។ ហើយអថេរនេះនឹងត្រូវបានរក្សាទុកនៅក្នុង គម្រោង node និង អរគុណចំពោះមរតក នឹងមានសម្រាប់កូនចៅ។

ដើម្បីចូលប្រើអថេរថាមវន្ត អ្នកត្រូវតែប្រើ អថេរដែលភ្ជាប់មកជាមួយ $dynamicVar. ឧទាហរណ៍ ដើម្បីចូលប្រើនិមិត្តសញ្ញាដែលបានរក្សាទុក អ្នកត្រូវហៅទូរសព្ទ ${$dynamicVar.token}.

យើងបញ្ជូនសញ្ញាអនុញ្ញាតទៅក្នុងសំណើ

នៅក្នុងជំហានមុន យើងបានទទួលសញ្ញាសម្ងាត់អនុញ្ញាត ហើយអ្វីដែលយើងត្រូវធ្វើគឺបន្ថែមបឋមកថា Authorization ជាមួយនឹងអត្ថន័យ Bearer <tokenValue> នៅក្នុងសំណើទាំងអស់ដែលទាមទារការអនុញ្ញាត រួមទាំង បង្កើត-ប្រកាស. មានវិធីជាច្រើនដើម្បីធ្វើវា៖

ចម្លងសញ្ញាសម្ងាត់ដោយដៃ ហើយបន្ថែមបឋមកថាអនុញ្ញាតទៅសំណើចំណាប់អារម្មណ៍។ វិធីសាស្ត្រនេះដំណើរការ ប៉ុន្តែការប្រើប្រាស់របស់វាត្រូវបានកំណត់ចំពោះតែសំណើនៃប្រភេទ "បានធ្វើហើយបោះចោល" ប៉ុណ្ណោះ។ មិនស័ក្តិសមសម្រាប់ការអនុវត្តស្គ្រីបដដែលៗ
ប្រើមុខងារ ការអនុញ្ញាត.
Использовать បឋមកថាលំនាំដើម

ការប្រើវិធីសាស្រ្តទីពីរហាក់ដូចជាជាក់ស្តែង ប៉ុន្តែនៅក្នុងបរិបទនៃអត្ថបទនេះ វិធីសាស្រ្តនេះគឺ ... មិនគួរឱ្យចាប់អារម្មណ៍។ ជាការប្រសើរណាស់៖ យន្តការអនុញ្ញាតបូកដកគឺស៊ាំនឹងអ្នកពីឧបករណ៍ផ្សេងទៀត (ទោះបីជាយើងមានរបស់ដូចជា ការអនុញ្ញាតមរតក) ហើយទំនងជាមិនលើកសំណួរទេ។

រឿងមួយទៀតគឺបឋមកថាលំនាំដើម! សរុបមក បឋមកថាលំនាំដើមត្រូវបានទទួលមរតកបឋមកថា HTTP ដែលត្រូវបានបន្ថែមទៅសំណើតាមលំនាំដើម លុះត្រាតែត្រូវបានបិទយ៉ាងច្បាស់លាស់។ ដោយប្រើមុខងារនេះ អ្នកអាចអនុវត្តការអនុញ្ញាតផ្ទាល់ខ្លួន ឬគ្រាន់តែកម្ចាត់ការស្ទួននៅក្នុងស្គ្រីប។ តោះប្រើមុខងារនេះដើម្បីបញ្ជូនសញ្ញាសម្ងាត់នៅក្នុងបឋមកថា។

ពីមុន យើងបានរក្សាទុកសញ្ញាសម្ងាត់ដោយប្រយ័ត្នប្រយែងទៅជាអថេរថាមវន្ត $dynamicVar.token នៅកម្រិតថ្នាំងគម្រោង។ អ្វីដែលនៅសល់គឺត្រូវធ្វើដូចខាងក្រោមៈ

កំណត់ចំណងជើងលំនាំដើម Authorization ជាមួយនឹងអត្ថន័យ Bearer ${$dynamicVar.token} នៅកម្រិតថ្នាំងគម្រោង។ ដើម្បីធ្វើដូច្នេះ ក្នុងចំណុចប្រទាក់គម្រោងនៃថ្នាំង អ្នកត្រូវបើកប្រអប់ដែលមានចំណងជើងលំនាំដើម (ប៊ូតុង បឋមកថា នៅជ្រុងខាងស្តាំខាងលើ) ហើយបន្ថែមចំណងជើងដែលត្រូវគ្នា។ ប្រអប់ដែលមានតម្លៃបំពេញនឹងមើលទៅដូចនេះ៖
បិទបឋមកថានេះពីសំណើចូល។ នេះអាចយល់បាន៖ នៅពេលចូល យើងមិនទាន់មានសញ្ញាសម្ងាត់ទេ ហើយយើងនឹងដំឡើងវាជាមួយសំណើនេះ។ ដូច្នេះនៅក្នុងចំណុចប្រទាក់ចូលនៃសំណើនៅក្នុងផ្ទាំង បឋមកថា នៅក្នុងតំបន់នៃ មរតក ដោះធីកបឋមកថាអនុញ្ញាត។

អស់ហើយ។ ឥឡូវនេះបឋមកថាអនុញ្ញាតនឹងត្រូវបានបន្ថែមទៅសំណើទាំងអស់ដែលជាកូនរបស់ថ្នាំងគម្រោង លើកលែងតែថ្នាំងចូល។ វាប្រែថានៅដំណាក់កាលនេះ យើងមានស្គ្រីបរួចរាល់ហើយ ហើយអ្វីដែលយើងត្រូវធ្វើគឺចាប់ផ្តើមវា។ អ្នកអាចដំណើរការស្គ្រីបដោយជ្រើសរើស រត់ នៅក្នុងម៉ឺនុយបរិបទរបស់ថ្នាំងគម្រោង។

ពិនិត្យមើលភាពត្រឹមត្រូវនៃការបង្កើតប្រកាស

នៅដំណាក់កាលនេះ ស្គ្រីបរបស់យើងអាចចូលបាន ហើយដោយប្រើសញ្ញាអនុញ្ញាត បង្កើតប្រកាស។ ទោះយ៉ាងណាក៏ដោយ យើងត្រូវធ្វើឱ្យប្រាកដថា ប្រកាសដែលបានបង្កើតថ្មីមានឈ្មោះត្រឹមត្រូវ។ នោះហើយជាខ្លឹមសារ អ្វីដែលនៅសេសសល់គឺត្រូវធ្វើដូចខាងក្រោម៖

ផ្ញើសំណើដើម្បីទទួលបានប្រកាសតាមលេខសម្គាល់,
ពិនិត្យមើលថាឈ្មោះដែលបានទទួលពីម៉ាស៊ីនបម្រើត្រូវនឹងឈ្មោះដែលបានផ្ញើពេលបង្កើតប្រកាស

សូមក្រឡេកមើលជំហានដំបូង។ ដោយសារតម្លៃលេខសម្គាល់ត្រូវបានកំណត់កំឡុងពេលដំណើរការស្គ្រីប អ្នកត្រូវបង្កើតអថេរថាមវន្ត (តោះហៅវាថា postId) ពីថ្នាំង បង្កើត-ប្រកាស នៅកម្រិតថ្នាំងគម្រោង។ យើងដឹងពីរបៀបធ្វើវារួចហើយ គ្រាន់តែយោងទៅផ្នែក រក្សាទុកនិមិត្តសញ្ញាទៅជាអថេរ. អ្វីដែលនៅសេសសល់គឺបង្កើតសំណើរដើម្បីទទួលបានការប្រកាសដោយប្រើលេខសម្គាល់នេះ។ ដើម្បីធ្វើដូចនេះយើងបង្កើត RequestStep ទទួល-ប្រកាស ជាមួយនឹងប៉ារ៉ាម៉ែត្រដូចខាងក្រោមៈ

ប្រភេទសំណើ៖ ទទួល
URL៖ ${domain}/posts/${$dynamicVar.postId}

ដើម្បីអនុវត្តជំហានទីពីរ យើងត្រូវស្គាល់ ការអះអាង knot ។ ថ្នាំងអះអាងគឺជាថ្នាំងដែលអនុញ្ញាតឱ្យអ្នកសរសេរការត្រួតពិនិត្យសម្រាប់សំណើជាក់លាក់។ ថ្នាំងការអះអាងនីមួយៗអាចមានការអះអាងជាច្រើន (ពិនិត្យ)។ អ្នកអាចអានបន្ថែមអំពីការអះអាងគ្រប់ប្រភេទពីរបស់យើង។ ឯកសារ. យើងនឹងប្រើ Compare ការអះអាងជាមួយប្រតិបត្តិករ equal. មានវិធីជាច្រើនដើម្បីបង្កើតការអះអាង៖

វែង។ បង្កើតថ្នាំងអះអាងដោយដៃពីម៉ឺនុយបរិបទនៃថ្នាំងស្នើសុំជំហាន។ នៅក្នុងថ្នាំងការអះអាងដែលបានបង្កើត បន្ថែមការអះអាងនៃការចាប់អារម្មណ៍ ហើយបំពេញក្នុងវាល។
លឿន។ បង្កើតថ្នាំងការអះអាងរួមជាមួយនឹងការអះអាងពីការឆ្លើយតបថ្នាំងស្នើសុំជំហានដោយប្រើម៉ឺនុយបរិបទ

តោះប្រើវិធីទីពីរ។ នេះជាអ្វីដែលវានឹងមើលទៅសម្រាប់ករណីរបស់យើង។

សម្រាប់អ្នកដែលមិនយល់នោះគឺជាអ្វីដែលកំពុងកើតឡើង:

ធ្វើការស្នើសុំនៅក្នុង node ទទួល-ប្រកាស
នៅក្នុងផ្ទាំង ញែក ឆ្លើយ ហៅម៉ឺនុយបរិបទ ហើយជ្រើសរើស បង្កើតការអះអាង -> ប្រៀបធៀប -> ស្មើ

សូមអបអរសាទរ យើងបានបង្កើតការធ្វើតេស្តដំបូងរបស់យើង! សាមញ្ញណាស់មែនទេ? ឥឡូវនេះអ្នកអាចដំណើរការស្គ្រីបទាំងស្រុងហើយរីករាយនឹងលទ្ធផល។ អ្វីដែលនៅសល់គឺត្រូវកែប្រែវាបន្តិចហើយយកវាចេញ title ទៅជាអថេរដាច់ដោយឡែក។ ប៉ុន្តែយើងនឹងទុកវាទុកជាកិច្ចការផ្ទះ)

សេចក្តីសន្និដ្ឋាន

នៅក្នុងការណែនាំនេះ យើងបានបង្កើតសេណារីយ៉ូពេញលេញមួយ ហើយក្នុងពេលតែមួយបានពិនិត្យមើលលក្ខណៈពិសេសមួយចំនួននៃផលិតផលរបស់យើង។ ជាការពិតណាស់ យើងមិនបានប្រើប្រាស់មុខងារទាំងអស់នោះទេ ហើយនៅក្នុងអត្ថបទខាងក្រោម យើងនឹងផ្តល់នូវទិដ្ឋភាពលម្អិតនៃសមត្ថភាពរបស់ TestMace ។ ចាំមើល!

PS សម្រាប់អ្នកដែលខ្ជិលច្រានចោលរាល់ជំហានទាំងអស់ យើងបានថតដោយចិត្តល្អ។ ឃ្លាំង ជាមួយនឹងគម្រោងពីអត្ថបទ។ អ្នកអាចបើកវាជាមួយ ឯកសារ -> គម្រោងបើក ហើយជ្រើសរើសថតគម្រោង។

ប្រភព: www.habr.com

តេស្តមេស។ ការចាប់ផ្តើមលឿន