क्या अकड़ को

Question

स्प्रिंग बाकी डॉक्स की तुलना स्प्रिंग बाकी दस्तावेज़ का उपयोग कर के लाभ है हाल ही में जारी किया गया था और प्रलेखन कहते हैं:

यह दृष्टिकोण सीमाओं स्वैगर

तरह

उपकरण द्वारा लगाए गए से आप को मुक्त कर देते इसलिए, मैं पूछना चाहता था कि स्प्रिंग रीस्ट डॉक्स स्वैगर की तुलना में उपयोग करने के लिए बेहतर है और कौन सी सीमाएं इसे मुक्त करती हैं।

Answer 1

मैं सिर्फ एक प्रस्तुति है कि यहाँ अन्य विषयों के बीच में अपने प्रश्न पर छू लेती देखा दिखाने:

https://www.youtube.com/watch?v=k5ncCJBarRI&t=26m58s

• स्वैगर बिल्कुल हाइपरमीडिया का समर्थन नहीं करता/यह यूआरआई है केंद्रित

• आपके कोड का निरीक्षण करने की स्वैगर की विधि आपके कोड के पीछे हो सकती है। यह संभव है कि आपके कोड में बदलाव करें कि स्वैगर समझने में विफल रहता है और स्वैगर अपडेट होने तक ठीक से संसाधित नहीं करेगा।

• स्वैगर को बहुत सी टिप्पणियों की आवश्यकता होती है, और एनोटि दस्तावेज़ में वर्णनात्मक पाठ को शामिल करना दर्दनाक है।

• कुछ ऐसी चीजें हैं जो स्वैगर आपके कोड का निरीक्षण करने से नहीं समझ सकते हैं।

किसी भी मामले में, ये केवल कुछ बिंदु हैं। प्रेजेंटर इससे बेहतर चर्चा कर रहा है जितना मैं कर सकता था।

Answer 2

स्वैगर और विशिष्ट वसंत ढेर के साथ कुछ सीमा है।

उदाहरण के लिए: अपने अनुरोध मैपिंग में "param" के साथ आप एक ही यूआरएल उत्तर के साथ एक से अधिक विधि को परिभाषित कर सकते हैं ताकि आपके कोड को सरल बना दिया जा सके। लेकिन अकड़ आप सिर्फ एक विधि

Answer 3

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

स्वैगर 2.0 बड़ा नाम और माइक्रोसॉफ्ट Azure, Paypal, SwaggerHub.com, DynamicApis.com, आदि ... ध्यान में रखने के कुछ जैसे बड़े प्लेटफॉर्म का एक बहुत द्वारा अपनाया जा रहा है कि Swagger is very simply a specification है। यह एक ढांचा नहीं है। वहां बहुत सारे frameworks हैं जो स्वैगर आउटपुट उत्पन्न करने के लिए बनाए गए हैं जो आपके एपीआई को प्रदर्शित करने वाले स्वैगर 2.0 JSON फ़ाइल को बनाने के लिए आपके एपीआई सूचना को देखकर आपके कोड को क्रॉल करते हैं। स्वैगर यूआई जिसे आप अपने एपीआई देखते हैं सीधे इस स्वैगर 2.0 जेएसओएन फ़ाइल से संचालित होता है। Fiddler यह इसे बाहर की जाँच करने के

यह ध्यान रखें कि एक रूपरेखा बनाया गया था कि आप "अकड़ का उपयोग करें" करने की अनुमति के लिए महत्वपूर्ण है कि कैसे नहीं स्वैगर काम करने के लिए किया गया है (यानी यह पूरी तरह से 3 के कार्यान्वयन पर निर्भर है पार्टी ढांचा)। यदि आप अपने स्वैगर 2.0 दस्तावेज़ और यूआई उत्पन्न करने के लिए उपयोग कर रहे ढांचे के लिए काम नहीं कर रहे हैं तो आपको स्वैगर कलाकृतियों को उत्पन्न करने और प्रौद्योगिकियों को स्वैप करने के लिए एक और ढांचा ढूंढने में सक्षम होना चाहिए।

उम्मीद है कि इससे मदद मिलती है।