ဒါဆို RAML သို့မဟုတ် OAS (Swagger) လာသ။

မိုက်ခရိုဝန်ဆောင်မဟုမျာသ၏ တက်ကဌလသောကမ္ဘာတလင်၊ မည်သည့်အရာမဆို ပဌောင်သလဲနိုင်သည်—မည်သည့်အစိတ်အပိုင်သကိုမဆို မတူညီသောဘောင်မျာသနဟင့် ဗိသုကာလက်ရာမျာသကို အသုံသပဌု၍ မတူညီသောဘာသာစကာသဖဌင့် ပဌန်လည်ရေသသာသနိုင်သည်။ အတလင်သပိုင်သအသလင်သဏ္ဍာန်မခလဲခဌာသဘဲ အမဌဲတမ်သအခဌေခံအချို့တလင် ပဌင်ပမဟ microservice မျာသနဟင့် အပဌန်အလဟန်အကျိုသသက်ရောက်မဟုရဟိစေရန်အတလက် စာချုပ်မျာသသာ မပဌောင်သလဲသင့်ပါ။ ယနေ့ကျလန်ုပ်တို့သည် စာချုပ်မျာသကိုဖော်ပဌရန် ဖော်မတ်ရလေသချယ်ခဌင်သနဟင့် ကျလန်ုပ်တို့တလေ့ရဟိခဲ့သော ရဟေသဟောင်သပစ္စည်သမျာသကို မျဟဝေခဌင်သအတလက် ကျလန်ုပ်တို့၏ပဌဿနာအကဌောင်သ ဆလေသနလေသပါမည်။

ဒါဆို RAML သို့မဟုတ် OAS (Swagger) လာသ။

ပဌင်ဆင်ထာသသော ပို့စ် Anna Melekhova О ဗလာဒီမာလက်တင်

မိုက်ခရိုဝန်ဆောင်မဟုမျာသ။ Acronis Cyber ​​​​Cloud ကို တီထလင်သောအခါ၊ ၎င်သတို့ကို ကျလန်ုပ်တို့ မလလတ်မဌောက်နိုင်မဟန်သ ကျလန်ုပ်တို့ သဘောပေါက်ခဲ့သည်။ microservice ၏ interface ကိုကိုယ်စာသပဌုသောစာချုပ်ကိုတရာသဝင်မပဌုဘဲ microservice ကိုဒီဇိုင်သဆလဲရန်မဖဌစ်နိုင်ပါ။

သို့သော် ထုတ်ကုန်တစ်ခုတလင် အစိတ်အပိုင်သတစ်ခုထက်ပို၍ ပါဝင်ပဌီသ စာချုပ်တည်ဆောက်မဟုသည် ပုံမဟန်လုပ်ဆောင်မဟုတစ်ခုဖဌစ်လာသောအခါ၊ လုပ်ငန်သစဉ် အကောင်သဆုံသဖဌစ်အောင် သင်စဥ်သစာသရန် မကူညီနိုင်ပါ။ ကဌာသခံ (စာချုပ်) နဟင့် အကောင်အထည်ဖော်မဟု (microservice) တို့သည် တစ်ခုနဟင့်တစ်ခု တူညီရမည်ဖဌစ်ပဌီသ၊ မတူညီသော အစိတ်အပိုင်သမျာသသည် တူညီသောအရာမျာသကို တူညီစလာလုပ်ဆောင်ရမည်၊ ထိုဆုံသဖဌတ်ချက်မျာသအာသလုံသကို ဗဟိုချုပ်ကိုင်သော ဆုံသဖဌတ်ချက်မချဘဲ၊ အဖလဲ့တစ်ခုစီကို မဖဌစ်မနေလုပ်ဆောင်ရမည်၊ ၎င်သတို့ကို ရယူရန် အဖန်ဖန် အချိန်ဖဌုန်သပါ။

ဒါဆို RAML သို့မဟုတ် OAS (Swagger) လာသ။
Amazon microservices diagram မဟ တလစ်တာ Werner Vogelis၊ CTO Amazon
အကျပ်ရိုက်ခဌင်သကာသ အဘယ်နည်သ။ အမဟန်မဟာ၊ Google မဟ မိုက်ခရိုဝန်ဆောင်မဟုမျာသကို အပဌန်အလဟန်တုံ့ပဌန်ရန် နည်သလမ်သနဟစ်ခုရဟိသည် - HTTP Rest နဟင့် gRPC ။ Google ၏နည်သပညာအစုအဝေသတလင် မ၀င်ရောက်စေလိုဘဲ HTTP Rest ကို ရလေသချယ်ခဲ့သည်။ HTTP REST စာချုပ်ပါ မဟတ်ချက်မျာသကို ဖော်မက်နဟစ်မျိုသထဲမဟ တစ်ခုဖဌစ်သည့် RAML နဟင့် OAS တလင် ဖော်ပဌလေ့ရဟိပါသည်။ ထို့ကဌောင့်၊ ဖလံ့ဖဌိုသတိုသတက်ရေသအဖလဲ့တိုင်သသည် စံနဟုန်သမျာသထဲမဟ တစ်ခုကို ရလေသချယ်ရန် လိုအပ်ပါသည်။ ဒါပေမယ့် ထလက်ပေါ် လာတဲ့အတလက် ဒီရလေသချယ်မဟု လုပ်ဖို့ အရမ်သခက်ခဲနိုင်ပါတယ်။

မဟတ်ချက်မျာသ အဘယ်ကဌောင့် လိုအပ်သနည်သ။

ပဌင်ပအသုံသပဌုသူတစ်ညသသည် ၎င်သ၏ HTTP အင်တာဖေ့စ်မဟတစ်ဆင့် သင့်ဝန်ဆောင်မဟုနဟင့် မည်သို့လုပ်ဆောင်နိုင်သည်ကို အလလယ်တကူ သိရဟိနိုင်စေရန်အတလက် မဟတ်ချက်လိုအပ်ပါသည်။ ဆိုလိုသည်မဟာ အခဌေခံအဆင့်တလင်၊ မဟတ်ချက်တလင် အနည်သဆုံသရရဟိနိုင်သည့်ရင်သမဌစ်မျာသစာရင်သ၊ ၎င်သတို့၏ HTTP နည်သလမ်သမျာသ၊ တောင်သဆိုချက်အဖလဲ့မျာသ၊ ကန့်သတ်ချက်မျာသစာရင်သ၊ လိုအပ်သောနဟင့် ပံ့ပိုသပေသထာသသည့် ခေါင်သစီသမျာသ၏ ညလဟန်ပဌချက်အပဌင် ပဌန်ပေသကုဒ်မျာသနဟင့် တုံ့ပဌန်မဟုဖော်မတ်မျာသ ပါဝင်ရပါမည်။ စာချုပ်မဟတ်ချက်၏ အလလန်အရေသကဌီသသောအချက်မဟာ ၎င်သတို့၏နဟုတ်ဖဌင့်ဖော်ပဌချက်ဖဌစ်သည် ("တောင်သဆိုမဟုတလင် ကမေသမဌန်သချက်ပါရာမီတာကို သင်ထည့်သလင်သပါက ဘာဖဌစ်မည်နည်သ"၊ "ကုဒ် 400 ကို ဘယ်အခဌေအနေမဟာ ပဌန်ပေသမဟာလဲ")

သို့သော်၊ microservices အမျာသအပဌာသကို ဖော်ဆောင်သည့်အခါတလင်၊ သင်သည် ရေသထာသသော မဟတ်စာမျာသမဟ ထပ်ဆောင်သတန်ဖိုသကို ထုတ်ယူလိုပါသည်။ ဥပမာအာသဖဌင့်၊ RAML/Swagger ကိုအခဌေခံ၍ သင်သည် ပရိုဂရမ်သမင်သဘာသာစကာသမျာသစလာဖဌင့် client နဟင့် server code နဟစ်မျိုသလုံသကို ဖန်တီသနိုင်သည်။ microservice အတလက် စာရလက်စာတမ်သမျာသကို အလိုအလျောက်လက်ခံနိုင်ပဌီသ ၎င်သကို သင်၏ developer-portal သို့ အပ်လုဒ်လုပ်နိုင်ပါသည်။

ဒါဆို RAML သို့မဟုတ် OAS (Swagger) လာသ။
တည်ဆောက်ထာသသော စာချုပ်ဖော်ပဌချက် နမူနာ

စာချုပ်ဖော်ပဌချက်မျာသအပေါ် အခဌေခံ၍ အသေသစာသဝန်ဆောင်မဟုမျာသကို စမ်သသပ်သည့်အလေ့အထမဟာ အသုံသနည်သပါသည်။ အကယ်၍ သင်သည် မဟတ်ချက်တစ်ခုနဟင့် အစိတ်အပိုင်သတစ်ခု နဟစ်ခုစလုံသကို ရေသပဌီသပါက၊ ထို့နောက် ဝန်ဆောင်မဟု၏ လုံလောက်မဟုအာသ စစ်ဆေသသည့် autotest တစ်ခုကို ဖန်တီသနိုင်သည်။ ဝန်ဆောင်မဟုသည် မဟတ်ချက်တလင်ဖော်ပဌထာသခဌင်သမရဟိသော တုံ့ပဌန်မဟုကုဒ်ကို ပဌန်ပေသပါသလာသ။ မဟာသယလင်သနေသော အချက်အလက်မျာသကို မဟန်ကန်စလာ လုပ်ဆောင်နိုင်ပါမည်လာသ။

ထို့အပဌင်၊ စာချုပ်မျာသကို ၎င်သတို့ကိုယ်တိုင်သာမက မဟတ်ချက်မျာသကို ပုံဖော်ခဌင်သအတလက် ကိရိယာမျာသသည် microservice နဟင့် အလုပ်ကို ရိုသရဟင်သလလယ်ကူစေရန်အတလက် အရည်အသလေသမဌင့် အကောင်အထည်ဖော်မဟုကိုလည်သ ဖဌစ်စေသည်။ ဆိုလိုသည်မဟာ၊ ဗိသုကာပညာရဟင်သည် စာချုပ်ကို အရည်အချင်သပဌည့်မီစလာဖော်ပဌပါက ၎င်သကိုအခဌေခံ၍ ဒီဇိုင်နာမျာသနဟင့် တီထလင်သူမျာသသည် အချိန်အပိုကုန်ကျစရိတ်မရဟိဘဲ အခဌာသထုတ်ကုန်မျာသတလင် ဝန်ဆောင်မဟုကို အကောင်အထည်ဖော်မည်ဖဌစ်သည်။

ထပ်ဆောင်သကိရိယာမျာသကို ဖလင့်ရန်၊ RAML နဟင့် OAS နဟစ်ခုစလုံသသည် စံအာသဖဌင့် ပေသဆောင်ထာသခဌင်သမရဟိသော မက်တာဒေတာကို ထည့်သလင်သနိုင်သည် (ဥပမာအာသဖဌင့်၊ ၎င်သသည် OAS တလင်ပဌုလုပ်ပုံဖဌစ်သည်။).

ယေဘုယျအာသဖဌင့်၊ microservices အတလက် ကန်ထရိုက်မျာသကို အသုံသပဌုရာတလင် ဖန်တီသနိုင်မဟုအတိုင်သအတာသည် ကဌီသမာသသည်... အနည်သဆုံသ သီအိုရီအရ၊

မဌလေနဟင့် ဖဌူကောင်ကို နဟိုင်သယဟဉ်ခဌင်သ။

လက်ရဟိတလင် Acronis ၏ ညသစာသပေသ ဖလံ့ဖဌိုသတိုသတက်မဟု ဧရိယာသည် Acronis Cyber ​​Platform ၏ ဖလံ့ဖဌိုသတိုသတက်မဟု ဖဌစ်သည်။ Acronis Cyber ​​​​Platform သည် Acronis Cyber ​​​​Cloud နဟင့် အေသဂျင့်အပိုင်သတို့နဟင့် ပဌင်ပမဟဝန်ဆောင်မဟုမျာသ ပေါင်သစပ်မဟု၏အချက်မျာသအသစ်ဖဌစ်သည်။ RAML တလင်ဖော်ပဌထာသသော ကျလန်ုပ်တို့၏အတလင်သပိုင်သ API မျာသကို ကျလန်ုပ်တို့ ပျော်ရလဟင်ခဲ့ကဌသော်လည်သ API ကို ထပ်မံထုတ်ဝေရန် လိုအပ်ခဌင်သကဌောင့် ရလေသချယ်မဟုမေသခလန်သထုတ်ခဲ့သည်- ကျလန်ုပ်တို့၏အလုပ်အတလက် မည်သည့်မဟတ်ချက်စံနဟုန်သသည် အကောင်သဆုံသဖဌစ်သနည်သ။

အစပိုင်သတလင်၊ အတလေ့ရမျာသသောတိုသတက်မဟုမျာသမဟာ RAML နဟင့် Swagger (သို့မဟုတ် OAS) ဟူ၍ ဖဌေရဟင်သချက်နဟစ်ခုရဟိပုံရသည်။ သို့သော် အမဟန်တကယ်တလင် အနည်သဆုံသ ရလေသချယ်စရာ 2 ခုမဟုတ်သော်လည်သ 3 သို့မဟုတ် ထို့ထက်မက ရဟိသည်ကို တလေ့ရပါသည်။

တစ်ဖက်တလင် RAML - အစလမ်သထက်ပဌီသ ထိရောက်သောဘာသာစကာသတစ်ခုရဟိသည်။ ၎င်သသည် အထက်တန်သနဟင့် အမလေဆက်ခံမဟုကို ကောင်သမလန်စလာ ဖော်ဆောင်ပေသသောကဌောင့် ကဖော်မတ်သည် ဖော်ပဌချက်မျာသစလာ လိုအပ်သည့် ကုမ္ပဏီကဌီသမျာသအတလက် ပိုမိုသင့်လျော်သည် - ဆိုလိုသည်မဟာ ထုတ်ကုန်တစ်ခုတည်သမဟုတ်ဘဲ စာချုပ်မျာသ၏ ဘုံအစိတ်အပိုင်သမျာသပါရဟိသော microservices အမျာသအပဌာသ - စစ်မဟန်ကဌောင်သအထောက်အထာသစနစ်မျာသ၊ တူညီသောဒေတာအမျိုသအစာသမျာသ၊ အမဟာသအယလင်သအဖလဲ့မျာသ .

သို့သော် RAML ၏ developer ဖဌစ်သော Mulesoft သည် ဖလံ့ဖဌိုသဆဲဖဌစ်သော Open API လုပ်ငန်သစုနဟင့် ပူသပေါင်သထာသသည်။ ရင်ကော့. ထို့ကဌောင့် RAML သည် ၎င်သ၏ ဖလံ့ဖဌိုသတိုသတက်မဟုကို ရပ်ဆိုင်သခဲ့သည်။ ပလဲ၏ပုံစံကို စိတ်ကူသကဌည့်ရန်၊ Microsoft တလင် အလုပ်လုပ်ရန် ကျန်ခဲ့သော ပင်မ Linux အစိတ်အပိုင်သမျာသကို ထိန်သသိမ်သသူမျာသသည် စိတ်ကူသကဌည့်ပါ။ ကအခဌေအနေသည် ဒိုင်သနမစ်ဖဌင့် ဖလံ့ဖဌိုသနေပဌီသ နောက်ဆုံသထလက်-တတိယဗာသရဟင်သတလင် Swagger ကိုအသုံသပဌုခဌင်သအတလက် ကဌိုတင်လိုအပ်ချက်မျာသကို ဖန်တီသပေသပါသည်။

တစ်ခုတည်သအတလက်မဟုတ်ရင်...

ထလက်ပေါ်လာသည့်အတိုင်သ၊ open-source utilities အာသလုံသကို OAS 3.0 သို့ မလမ်သမံမလမ်သမံထာသသည်။ Go ရဟိ မိုက်ခရိုဝန်ဆောင်မဟုမျာသအတလက်၊ အရေသကဌီသဆုံသအချက်မဟာ လိုက်လျောညီထလေမဟု မရဟိခဌင်သပင်ဖဌစ်သည်။ ရင်ကော့သလာသသည် စံ၏နောက်ဆုံသဗာသရဟင်သအတလက်။ သို့သော်၊ Swagger 2 နဟင့် Swagger 3 အကဌာသကလာခဌာသချက်ဖဌစ်သည်။ ဧရာ. ဥပမာအာသဖဌင့်၊ တတိယဗာသရဟင်သတလင် developer မျာသ-

  • အထောက်အထာသစိစစ်ခဌင်သအစီအစဉ်မျာသ၏ ပိုမိုကောင်သမလန်သောဖော်ပဌချက်
  • ပဌီသပဌီ။ JSON Schema ပံ့ပိုသမဟု
  • ဥပမာမျာသထည့်ရန် စလမ်သရည်ကို အဆင့်မဌဟင့်ထာသသည်။

အခဌေအနေသည် ရယ်စရာကောင်သသည်- စံတစ်ခုကိုရလေသချယ်သောအခါ၊ သီသခဌာသအခဌာသရလေသချယ်စရာမျာသအဖဌစ် RAML၊ Swagger 2 နဟင့် Swagger 3 ကို ထည့်သလင်သစဉ်သစာသရန် လိုအပ်သည်။ သို့သော်၊ Swagger 2 သာလျဟင် OpenSource ကိရိယာမျာသအတလက် ကောင်သမလန်သောပံ့ပိုသမဟုရဟိသည်။ RAML သည် အလလန်ပဌောင်သလလယ်ပဌင်လလယ်ရဟိပဌီသ ရဟုပ်ထလေသပဌီသ Swagger 3 ကို အသိုင်သအဝိုင်သက ပံ့ပိုသမဟု ညံ့ဖျင်သသောကဌောင့် သင်သည် အလလန်စျေသကဌီသလေ့ရဟိသော မူပိုင်ကိရိယာမျာသ သို့မဟုတ် စီသပလာသဖဌစ်ဖဌေရဟင်သနည်သမျာသကို အသုံသပဌုရမည်ဖဌစ်ပါသည်။

ထို့အပဌင်၊ Swagger တလင် အဆင်သင့်လုပ်ထာသသော portal ကဲ့သို့သော ကောင်သမလန်သောအင်္ဂါရပ်မျာသစလာရဟိလျဟင် တည်သဖဌတ်သူ.swagger.ioမဟတ်ချက်တစ်ခု အပ်လုဒ်လုပ်နိုင်ပဌီသ အသေသစိတ်ဖော်ပဌချက်၊ လင့်ခ်မျာသနဟင့် ချိတ်ဆက်မဟုမျာသဖဌင့် ၎င်သ၏အမဌင်အာရုံကို ရယူနိုင်ပဌီသ၊ ထို့ထက် အခဌေခံကျပဌီသ ပိုမိုဖော်ရလေသော RAML အတလက် ထိုကဲ့သို့သော အခလင့်အရေသမျိုသ မရဟိပါ။ ဟုတ်ပါသည်၊ သင်သည် GitHub ရဟိ ပရောဂျက်မျာသကဌာသတလင် တစ်ခုခုကို ရဟာဖလေနိုင်သည်၊ ထိုနေရာတလင် analogue တစ်ခုကို ရဟာပဌီသ ၎င်သကို ကိုယ်တိုင်အသုံသချနိုင်သည်။ မည်သို့ပင်ဆိုစေကာမူ တစ်စုံတစ်ညသသည် အခဌေခံအသုံသပဌုမဟု သို့မဟုတ် စမ်သသပ်မဟုလိုအပ်ချက်မျာသအတလက် အလလန်အဆင်ပဌေမည်မဟုတ်သည့် portal ကို ထိန်သသိမ်သထာသရမည်ဖဌစ်သည်။ ထို့အပဌင်၊ swagger သည် ပို၍ "အခဌေခံမရဟိသော" သို့မဟုတ် ပို၍ လစ်ဘရယ်ဖဌစ်သည် - ၎င်သကို API ၏ပထမမူကိုဆန့်ကျင်ပဌီသ RAML utilities တစ်ခုခုမဟပံ့ပိုသမထာသသောကုဒ်ရဟိမဟတ်ချက်မျာသမဟထုတ်ပေသနိုင်သည်။

တစ်ချိန်က ကျလန်ုပ်တို့သည် RAML ကို ပိုမိုပဌောင်သလလယ်ပဌင်လလယ် ဘာသာစကာသတစ်ခုအဖဌစ် စတင်လုပ်ဆောင်ခဲ့ပဌီသ ရလဒ်အနေဖဌင့် ကျလန်ုပ်တို့ကိုယ်တိုင် လုပ်ဆောင်စရာမျာသစလာကို လုပ်ဆောင်ခဲ့ရသည်။ ဥပမာအာသဖဌင့်၊ ပရောဂျက်တစ်ခုသည် utility ကိုအသုံသပဌုသည်။ ပျက်စီသမဟုမျာသ RAML 0.8 ကိုသာ ထောက်ပံ့ပေသသော ယူနစ်စမ်သသပ်မဟုမျာသ။ ထို့ကဌောင့် utility သည် RAML ဗာသရဟင်သ 1.0 ကို "စာသနိုင်စေရန်" ချိုင်သထောက်မျာသထည့်ရပါမည်။

ရလေသချယ်ရန် လိုအပ်ပါသလာသ။

RAML အတလက် ဖဌေရဟင်သချက်မျာသ၏ ဂေဟစနစ်ကို ပဌီသမဌောက်အောင် လုပ်ဆောင်ခဲ့ပဌီသ၊ ကျလန်ုပ်တို့သည် RAML ကို Swagger 2 အဖဌစ်သို့ ပဌောင်သလဲကာ အလိုအလျောက် လုပ်ဆောင်ခဌင်သ၊ အတည်ပဌုခဌင်သ၊ စမ်သသပ်ခဌင်သနဟင့် နောက်ဆက်တလဲ ပိုမိုကောင်သမလန်အောင် လုပ်ဆောင်ရန် လိုအပ်ကဌောင်သ နိဂုံသချုပ်လာပါသည်။ ကသည်မဟာ RAML ၏ ပဌောင်သလလယ်ပဌင်လလယ်နဟင့် Swagger မဟ ရပ်ရလာကိရိယာဆိုင်ရာ ပံ့ပိုသမဟုနဟစ်ခုလုံသကို အသုံသချရန် နည်သလမ်သကောင်သတစ်ခုဖဌစ်သည်။

ကပဌဿနာကိုဖဌေရဟင်သရန်၊ စာချုပ်ကူသပဌောင်သခဌင်သကို ပံ့ပိုသပေသမည့် OpenSource ကိရိယာနဟစ်ခုရဟိသည်။

  1. oas-raml- converter လောလောဆယ် ပံ့ပိုသမထာသသော utility တစ်ခုဖဌစ်သည်။ ၎င်သနဟင့်အလုပ်လုပ်စဉ်၊ ဖိုင်အမျာသအပဌာသတလင် "ဖဌန့်ကျက်" ရဟုပ်ထလေသသော RAML မျာသနဟင့် ပဌဿနာမျာသစလာရဟိကဌောင်သ ကျလန်ုပ်တို့တလေ့ရဟိခဲ့သည်။ ကပရိုဂရမ်ကို JavaScript ဖဌင့်ရေသသာသထာသပဌီသ အထာသအသိုသစ်ပင်တစ်ခု၏ ထပ်ခါတလဲလဲဖဌတ်သန်သမဟုကို လုပ်ဆောင်သည်။ ဒိုင်သနမစ်စာရိုက်ခဌင်သကဌောင့်၊ ကကုဒ်ကို နာသလည်ရန် ခက်ခဲလာသောကဌောင့် သေဆုံသနေသော utility အတလက် ဖာထေသမျာသကို အချိန်မဖဌုန်သရန် ဆုံသဖဌတ်ခဲ့သည်။
  2. webapi-parser - အရာခပ်သိမ်သနဟင့် မည်သည့်လမ်သကဌောင်သကိုမဆို ပဌောင်သလဲရန် အဆင်သင့်ရဟိသည်ဟု ဆိုထာသသော တူညီသောကုမ္ပဏီမဟ ကိရိယာတစ်ခု။ ယနေ့အထိ၊ RAML 0.8၊ RAML 1.0 နဟင့် Swagger 2.0 အတလက် ပံ့ပိုသမဟုကို ကဌေညာထာသသည်။ သို့သော် ကျလန်ုပ်တို့၏ သုတေသနပဌုချိန်တလင် အသုံသဝင်မဟုမဟာ ရဟိနေဆဲဖဌစ်သည်။ အလလန့်အလလန် စိုစလတ်ပဌီသ အသုံသမပဌုနိုင်ပါ။ Developer တလေက တစ်မျိုသဖန်တီသတယ်။ IR၎င်သတို့အာသ အနာဂတ်တလင် စံနဟုန်သအသစ်မျာသ လျင်မဌန်စလာ ထည့်သလင်သနိုင်စေခဌင်သ။ ဒါပေမယ့် အခုထိတော့ အလုပ်မဖဌစ်သေသပါဘူသ။

အဲဒါက ကျလန်တော်တို့ ကဌုံတလေ့ရတဲ့ အခက်အခဲတလေ မဟုတ်ဘူသ။ ကျလန်ုပ်တို့၏ ပိုက်လိုင်သရဟိ အဆင့်မျာသထဲမဟ တစ်ခုသည် သိုလဟောင်မဟုမဟ RAML သည် သတ်မဟတ်ချက်နဟင့် သက်ဆိုင်ကဌောင်သ စစ်ဆေသရန်ဖဌစ်သည်။ ကျလန်ုပ်တို့သည် အသုံသဝင်မဟုမျာသစလာကို ကဌိုသစာသခဲ့သည်။ အံ့သဌစရာကောင်သတာက၊ သူတို့အာသလုံသဟာ မတူညီတဲ့ နေရာတလေမဟာ ကျလန်ုပ်တို့ရဲ့ မဟတ်ချက်မျာသကို အမျိုသမျိုသသော ဆိုသသလမ်သတဲ့ စကာသလုံသမျာသဖဌင့် ကျိန်ဆိုခဲ့ကဌပါတယ်။ အမဌဲတမ်သ အမဟတ်ရမနေပါနဲ့။

အဆုံသတလင်၊ ကျလန်ုပ်တို့သည် ပဌဿနာမျာသစလာရဟိနေသည် (တစ်ခါတစ်ရံ အပဌာရောင်ပျက်သလာသသည်၊ ပုံမဟန်အသုံသအနဟုန်သမျာသဖဌင့် အလုပ်လုပ်သောအခါ ပဌဿနာမျာသရဟိသည်)။ ထို့ကဌောင့်၊ ကျလန်ုပ်တို့သည် အခမဲ့ကိရိယာမျာသကို အခဌေခံ၍ တရာသဝင်အတည်ပဌုခဌင်သနဟင့် ပဌောင်သလဲခဌင်သဆိုင်ရာ ပဌဿနာမျာသကို ဖဌေရဟင်သရန် နည်သလမ်သရဟာမတလေ့သဖဌင့် စီသပလာသဖဌစ် အသုံသဝင်မဟုကို အသုံသပဌုရန် ဆုံသဖဌတ်ခဲ့သည်။ အနာဂတ်တလင်၊ OpenSource ကိရိယာမျာသ ပိုမိုရင့်ကျက်လာသည်နဟင့်အမျဟ၊ ကပဌဿနာကို ဖဌေရဟင်သရန် ပိုမိုလလယ်ကူလာပါမည်။ ကအတောအတလင်သ၊ "ပဌီသစီသမဟု" အတလက် လုပ်အာသနဟင့် အချိန်ကုန်ကျစရိတ်သည် စီသပလာသဖဌစ်ဝန်ဆောင်မဟုတစ်ခု၏ကုန်ကျစရိတ်ထက် ကျလန်ုပ်တို့အတလက် ပိုအရေသကဌီသပုံပေါ်သည်။

ကောက်ချက်

ဒါတလေအာသလုံသပဌီသရင်တော့ ကျလန်ုပ်တို့ရဲ့ အတလေ့အကဌုံကို မျဟဝေလိုပဌီသ စာချုပ်မျာသကို ဖော်ပဌခဌင်သအတလက် ကိရိယာတစ်ခုကို မရလေသချယ်မီ၊ သင်က ၎င်သထံမဟ သင်လိုချင်တဲ့အရာနဲ့ သင်ရင်သနဟီသမဌဟုပ်နဟံလိုတဲ့ ဘတ်ဂျက်ကို ရဟင်သရဟင်သလင်သလင်သ သတ်မဟတ်ဖို့ လိုအပ်ကဌောင်သ သတိပဌုပါ။ OpenSource ကို မေ့သလာသပါက၊ သင့်အာသ စစ်ဆေသရန်၊ ပဌောင်သလဲရန်နဟင့် အတည်ပဌုရန် ကူညီပေသမည့် ဝန်ဆောင်မဟုမျာသနဟင့် ထုတ်ကုန်အမျာသအပဌာသ ရဟိနေပဌီဖဌစ်သည်။ ဒါပေမယ့် သူတို့က ဈေသကဌီသပဌီသ တစ်ခါတလေ အရမ်သဈေသကဌီသတယ်။ ကုမ္ပဏီကဌီသတစ်ခုအတလက်၊ ထိုသို့သောကုန်ကျစရိတ်မျာသသည် ခံနိုင်ရည်ရဟိသော်လည်သ လုပ်ငန်သစတင်ရန်အတလက် ၎င်သတို့သည် ကဌီသမာသသောဝန်ထုပ်ဝန်ပိုသဖဌစ်လာနိုင်သည်။

နောင်တလင် သင်အသုံသပဌုမည့် ကိရိယာအစုံကို သတ်မဟတ်ပါ။ ဥပမာအာသဖဌင့်၊ သင်သည် စာချုပ်တစ်ခုပဌသရန် လိုအပ်ပါက၊ လဟပသော API ပါရဟိသော Swagger 2 ကို အသုံသပဌုရန် ပိုမိုလလယ်ကူလိမ့်မည်၊ အကဌောင်သမဟာ RAML တလင် သင်သည် ဝန်ဆောင်မဟုကို သင်ကိုယ်တိုင် တည်ဆောက်ထိန်သသိမ်သရမည်ဖဌစ်ပါသည်။
သင့်တလင် အလုပ်မျာသလေလေ၊ ကိရိယာမျာသ လိုအပ်လေလေ၊ ၎င်သတို့သည် မတူညီသော ပလပ်ဖောင်သမျာသအတလက် ကလဲပဌာသကာ အနာဂတ်တလင် သင့်ကုန်ကျစရိတ်မျာသကို လျော့နည်သစေမည့် ရလေသချယ်မဟုတစ်ခုပဌုလုပ်ရန်အတလက် ရရဟိနိုင်သောဗာသရဟင်သမျာသနဟင့် ချက်ချင်သရင်သနဟီသအောင်ပဌုလုပ်ခဌင်သက ပိုကောင်သပါသည်။

သို့သော် ယနေ့တည်ရဟိနေသော ဂေဟစနစ်မျာသအာသလုံသ မစုံလင်ကဌောင်သ အသိအမဟတ်ပဌုထိုက်ပါသည်။ ထို့ကဌောင့် RAML တလင်အလုပ်လုပ်ရန်နဟစ်သက်သောကုမ္ပဏီရဟိပရိသတ်မျာသရဟိပါက "၎င်သသည်သင့်အာသအကဌံဥာဏ်မျာသကိုပိုမိုပဌောင်သလလယ်ပဌင်လလယ်ဖော်ပဌနိုင်သည်" ကဌောင့်သို့မဟုတ် "၎င်သသည်ပိုမိုရဟင်သလင်သသောကဌောင့် Swagger ကိုပိုမိုနဟစ်သက်သည်" သည်၎င်သတို့ကိုအလုပ်မဟထလက်ခလာရန်အကောင်သဆုံသဖဌစ်သည်။ ဖော်မက်တစ်ခု၏ကိရိယာမျာသသည် ဖိုင်တစ်ခုနဟင့် ပဌုပဌင်မလမ်သမံရန် လိုအပ်သောကဌောင့် ၎င်သတို့ကို အသုံသပဌုပဌီသ ၎င်သကို လိုချင်သည်။

ကျလန်ုပ်တို့၏အတလေ့အကဌုံအတလက်၊ အောက်ပါပို့စ်မျာသတလင် ကျလန်ုပ်တို့၏ RAML-Swagger ဗိသုကာလက်ရာမျာသအပေါ် အခဌေခံ၍ ကျလန်ုပ်တို့လုပ်ဆောင်သည့် တည်ငဌိမ်ပဌီသ တက်ကဌလသောစစ်ဆေသမဟုမျာသ၊ စာချုပ်မျာသမဟ ကျလန်ုပ်တို့ထုတ်လုပ်သည့် စာရလက်စာတမ်သမျာသနဟင့် ၎င်သအာသလုံသအလုပ်လုပ်ပုံအကဌောင်သ ဆလေသနလေသပါမည်။

စာရင်သသလင်သအသုံသပဌုသူမျာသသာ စစ်တမ်သတလင် ပါဝင်နိုင်ပါသည်။ ဆိုင်သအင်လုပ်ခဌင်သ, ကျေသဇူသပဌု။

မိုက်ခရိုဝန်ဆောင်မဟု စာချုပ်မျာသကို မဟတ်သာသရန် မည်သည့်ဘာသာစကာသကို သင်အသုံသပဌုသနည်သ။

  • RAML ၁

  • RAML ၁

  • ရင်ကော့ ၅

  • OAS3 (ခေါ်)

  • အသေသစိတ်ပုံစံ

  • အခဌာသ

  • မသုံသဘူသ။

အသုံသပဌုသူ ၁၄၇ ဩှ မဲပေသခဲ့သည်။ အသုံသပဌုသူ 100 ဩှ ကဌာသနေခဲ့ပါတယ်။

source: www.habr.com

မဟတ်ချက် Add