Moq उपयोग के उदाहरण

Moq एक सरल और हल्का अलगाव फ्रेमवर्क है जो गुमनाम तरीकों और अभिव्यक्ति के पेड़ों पर बनाता है। वह मूक बनाने के लिए कोड पीढ़ी का उपयोग करता है, इसलिए वह "गीले" इंटरफेस, आभासी तरीकों (और यहां तक ​​कि संरक्षित तरीकों) की अनुमति देता है और "गीले" गैर-आभासी और स्थिर तरीकों की अनुमति नहीं देता है।

नोट
बाजार पर केवल दो ढांचे हैं जो आपको कुछ भी "गीला" करने की अनुमति देते हैं। ये TypeMockIsolator और Microsoft Fakes, Visual Studio 2012 में उपलब्ध हैं (जिन्हें पहले Microsoft Moles के रूप में जाना जाता था)। Moq के विपरीत, ये चौखटे, कोड पीढ़ी का उपयोग नहीं करते हैं, लेकिन CLR प्रोफाइलिंग एपीआई, जो आपको लगभग किसी भी तरीके से जागने और स्थैतिक, गैर-आभासी या निजी तरीकों के लिए भी मोकी / स्टब्स बनाने की अनुमति देता है।

Moq में, "स्टब्स" और "मोक्स" के बीच कोई अलगाव नहीं है या अधिक औपचारिक रूप से, राज्य सत्यापन और व्यवहार सत्यापन के बीच कोई अलगाव नहीं है। और यद्यपि ज्यादातर मामलों में स्टब्स और मोक के बीच अंतर इतना महत्वपूर्ण नहीं होता है, और कभी-कभी एक ही स्टब दोनों भूमिकाओं को निभाते हैं, हम सरल से जटिल तक के उदाहरणों पर विचार करेंगे, इसलिए पहले हम स्थिति की जाँच के उदाहरणों को देखेंगे, और उसके बाद ही हम व्यवहार की जाँच करने के लिए जाएंगे। ।

राज्य का सत्यापन

एक उदाहरण के रूप में, हम निम्नलिखित इंटरफ़ेस के लिए यूनिट परीक्षणों के एक सेट पर विचार करेंगे:

public interface ILoggerDependency { string GetCurrentDirectory(); string GetDirectoryByLoggerName(string loggerName); string DefaultLogger { get; } } 

1. GetCurrentDirectory विधि का दायरा:

 // Mock.Of    (-),   -. //   ,    GetCurrentDirectory() //   "D:\\Temp" ILoggerDependency loggerDependency = Mock.Of<ILoggerDependency>(d => d.GetCurrentDirectory() == "D:\\Temp"); var currentDirectory = loggerDependency.GetCurrentDirectory(); Assert.That(currentDirectory, Is.EqualTo("D:\\Temp")); 

2. GetDirectoryByLoggerName शीर्षक वाली विधि, हमेशा एक ही परिणाम लौटाती है :

 //     GetDirectoryByLoggerName  "C:\\Foo". ILoggerDependency loggerDependency = Mock.Of<ILoggerDependency>( ld => ld.GetDirectoryByLoggerName(It.IsAny<string>()) == "C:\\Foo"); string directory = loggerDependency.GetDirectoryByLoggerName("anything"); Assert.That(directory, Is.EqualTo("C:\\Foo")); 

3. GetDirrectoryByLoggerName विधि का दायरा , जो तर्क के आधार पर परिणाम लौटाता है:

 //    ,    //  GetDirrectoryByLoggerName    . //    : // public string GetDirectoryByLoggername(string s) { return "C:\\" + s; } Mock<ILoggerDependency> stub = new Mock<ILoggerDependency>(); stub.Setup(ld => ld.GetDirectoryByLoggerName(It.IsAny<string>())) .Returns<string>(name => "C:\\" + name); string loggerName = "SomeLogger"; ILoggerDependency logger = stub.Object; string directory = logger.GetDirectoryByLoggerName(loggerName); Assert.That(directory, Is.EqualTo("C:\\" + loggerName)); 

4. DefaultLogger संपत्ति शीर्षक :

 //  DefaultLogger       ILoggerDependency logger = Mock.Of<ILoggerDependency>( d => d.DefaultLogger == "DefaultLogger"); string defaultLogger = logger.DefaultLogger; Assert.That(defaultLogger, Is.EqualTo("DefaultLogger")); 

5. "moq फंक्शनल स्पेसिफिकेशन" (Moq v4 में प्रदर्शित) का उपयोग करके एक अभिव्यक्ति में कई तरीकों के व्यवहार को सेट करना।

 //        «» ILoggerDependency logger = Mock.Of<ILoggerDependency>( d => d.GetCurrentDirectory() == "D:\\Temp" && d.DefaultLogger == "DefaultLogger" && d.GetDirectoryByLoggerName(It.IsAny<string>()) == "C:\\Temp"); Assert.That(logger.GetCurrentDirectory(), Is.EqualTo("D:\\Temp")); Assert.That(logger.DefaultLogger, Is.EqualTo("DefaultLogger")); Assert.That(logger.GetDirectoryByLoggerName("CustomLogger"), Is.EqualTo("C:\\Temp")); 

6. सेटअप विधियों ("पुराने" v3 सिंटैक्स) को कॉल करके कई तरीकों के व्यवहार को निर्धारित करना:

 var stub = new Mock<ILoggerDependency>(); stub.Setup(ld => ld.GetCurrentDirectory()).Returns("D:\\Temp"); stub.Setup(ld => ld.GetDirectoryByLoggerName(It.IsAny<string>())).Returns("C:\\Temp"); stub.SetupGet(ld => ld.DefaultLogger).Returns("DefaultLogger"); ILoggerDependency logger = stub.Object; Assert.That(logger.GetCurrentDirectory(), Is.EqualTo("D:\\Temp")); Assert.That(logger.DefaultLogger, Is.EqualTo("DefaultLogger")); Assert.That(logger.GetDirectoryByLoggerName("CustomLogger"), Is.EqualTo("C:\\Temp")); 

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

व्यवहार का सत्यापन

व्यवहार का परीक्षण करने के लिए निम्न वर्ग और इंटरफ़ेस का उपयोग किया जाएगा:

 public interface ILogWriter { string GetLogger(); void SetLogger(string logger); void Write(string message); } public class Logger { private readonly ILogWriter _logWriter; public Logger(ILogWriter logWriter) { _logWriter = logWriter; } public void WriteLine(string message) { _logWriter.Write(message); } } 

1. ILogWriter के कॉल की जाँच करना। लॉगर वर्ग की किसी वस्तु के साथ। विधि (किसी भी तर्क के साथ):

 var mock = new Mock<ILogWriter>(); var logger = new Logger(mock.Object); logger.WriteLine("Hello, logger!"); // ,    Write      mock.Verify(lw => lw.Write(It.IsAny<string>())); 

2. ILogWriter के कॉल की जाँच करना। दिए गए तर्कों के साथ पर्याप्त विधि:

 mock.Verify(lw => lw.Write("Hello, logger!")); 

3. सत्यापन है कि ILogWriter .Write विधि को एक बार बुलाया गया था (और नहीं, कम नहीं):

 mock.Verify(lw => lw.Write(It.IsAny<string>()), Times.Once()); 

नोट
यह जांचने के लिए कई विकल्प हैं कि निर्भरता कितनी बार होती है। इसके लिए टाइम्स क्लास की विभिन्न विधियाँ हैं: AtLeast (int), AtMost (int), बिल्कुल, बीच, और अन्य।

4. सत्यापन विधि का उपयोग करते हुए व्यवहार का सत्यापन (यह सुविधाजनक हो सकता है जब आपको कुछ मान्यताओं की जांच करने की आवश्यकता होती है):

 var mock = new Mock<ILogWriter>(); mock.Setup(lw => lw.Write(It.IsAny<string>())); var logger = new Logger(mock.Object); logger.WriteLine("Hello, logger!"); //     Verify   . //  ,      //   mock.Setup mock.Verify(); 

5. सत्यापन () विधि का उपयोग करके कई कॉल का परीक्षण करना।

कुछ मामलों में, कई कॉल का परीक्षण करने के लिए कई सत्यापन विधियों का उपयोग करना असुविधाजनक है। इसके बजाय, आप एक नकली ऑब्जेक्ट बना सकते हैं और सेटअप विधियों का उपयोग करके अपेक्षित व्यवहार सेट कर सकते हैं और इन सभी मान्यताओं को एक सत्यापित () विधि कहकर सत्यापित कर सकते हैं । परीक्षण की सेटअप विधि में बनाई गई नकली वस्तुओं के पुन: उपयोग के लिए ऐसी तकनीक सुविधाजनक हो सकती है।

 var mock = new Mock<ILogWriter>(); mock.Setup(lw => lw.Write(It.IsAny<string>())); mock.Setup(lw => lw.SetLogger(It.IsAny<string>())); var logger = new Logger(mock.Object); logger.WriteLine("Hello, logger!"); mock.Verify(); 

विषय से विचलन। सख्त बनाम ढीले मॉडल

Moq दो व्यवहार परीक्षण मॉडल का समर्थन करता है: सख्त और ढीले। डिफ़ॉल्ट रूप से, एक नि: शुल्क परीक्षण मॉडल का उपयोग किया जाता है, जिसका अर्थ है कि कार्रवाई के निष्पादन के दौरान (एक्ट सेक्शन में) टेस्ट क्लास (क्लास अंडर टेस्ट, CUT), हमारी निर्भरता के किसी भी तरीके को कॉल कर सकते हैं और हमें उन सभी को निर्दिष्ट करने की आवश्यकता नहीं है।

तो, पिछले उदाहरण में, लकड़हारा .WriteLine विधि ILogWriter इंटरफ़ेस के दो तरीके कहता है: लिखो विधि और SetLogger । MockBehavior .Strict का उपयोग करते समय , सत्यापन विधि विफल हो जाएगी यदि हम स्पष्ट रूप से निर्दिष्ट नहीं करते हैं कि कौन सी सटीक निर्भरता विधियाँ कहलाएँगी :

 var mock = new Mock<ILogWriter>(MockBehavior.Strict); //      ,  //  mock.Verify()    mock.Setup(lw => lw.Write(It.IsAny<string>())); mock.Setup(lw => lw.SetLogger(It.IsAny<string>())); var logger = new Logger(mock.Object); logger.WriteLine("Hello, logger!"); mock.Verify(); 

MockRepository का उपयोग करना

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

1. Stock बनाने के लिए MockRepository .Of का उपयोग करना।
यह सिंटैक्स Mock .Of का उपयोग करने के समान है, लेकिन यह आपको अलग-अलग विधियों के व्यवहार को && ऑपरेटर के माध्यम से सेट करने की अनुमति देता है, लेकिन कई अन्य तरीकों का उपयोग करके:

 var repository = new MockRepository(MockBehavior.Default); ILoggerDependency logger = repository.Of<ILoggerDependency>() .Where(ld => ld.DefaultLogger == "DefaultLogger") .Where(ld => ld.GetCurrentDirectory() == "D:\\Temp") .Where(ld => ld.GetDirectoryByLoggerName(It.IsAny<string>()) == "C:\\Temp") .First(); Assert.That(logger.GetCurrentDirectory(), Is.EqualTo("D:\\Temp")); Assert.That(logger.DefaultLogger, Is.EqualTo("DefaultLogger")); Assert.That(logger.GetDirectoryByLoggerName("CustomLogger"), Is.EqualTo("C:\\Temp")); 

2. कई नकली वस्तुओं के व्यवहार को निर्धारित करने के लिए MockRepository का उपयोग करना।
मान लीजिए कि हमारे पास एक अधिक जटिल स्मार्टलॉगर वर्ग है जिसे दो निर्भरता की आवश्यकता है: ILogWriter और ILogMailer । हमारे परीक्षण वर्ग, जब इसकी लिखने की विधि को बुलाते हैं, तो दो निर्भरता के तरीकों को कॉल करना चाहिए:

 var repo = new MockRepository(MockBehavior.Default); var logWriterMock = repo.Create<ILogWriter>(); logWriterMock.Setup(lw => lw.Write(It.IsAny<string>())); var logMailerMock = repo.Create<ILogMailer>(); logMailerMock.Setup(lm => lm.Send(It.IsAny<MailMessage>())); var smartLogger = new SmartLogger(logWriterMock.Object, logMailerMock.Object); smartLogger.WriteLine("Hello, Logger"); repo.Verify(); 

अन्य तकनीकें

कुछ मामलों में इंटरफ़ेस द्वारा स्वयं मॉक ऑब्जेक्ट को प्राप्त करना उपयोगी हो सकता है ( ISomething इंटरफ़ेस के माध्यम से Mock <ISomething > प्राप्त करें)। उदाहरण के लिए, स्टब्स को इनिशियलाइज़ करने के लिए फंक्शनल सिंटैक्स एक मॉक ऑब्जेक्ट नहीं देता है, लेकिन तुरंत आवश्यक इंटरफ़ेस। यह सरल तरीकों के एक जोड़े के परीक्षण के लिए सुविधाजनक हो सकता है, लेकिन असुविधाजनक है यदि आपको व्यवहार की जांच करने की आवश्यकता है, या एक ऐसा तरीका सेट करें जो विभिन्न मापदंडों के लिए अलग-अलग परिणाम देता है। तो कभी-कभी तरीकों के एक हिस्से के लिए LINQ- आधारित सिंटैक्स का उपयोग करना और दूसरे के लिए सेटअप विधियों का उपयोग करना सुविधाजनक होता है:

 ILoggerDependency logger = Mock.Of<ILoggerDependency>( ld => ld.GetCurrentDirectory() == "D:\\Temp" && ld.DefaultLogger == "DefaultLogger"); //      GetDirectoryByLoggerName //    ,     Mock.Get(logger) .Setup(ld => ld.GetDirectoryByLoggerName(It.IsAny<string>())) .Returns<string>(loggerName => "C:\\" + loggerName); Assert.That(logger.GetCurrentDirectory(), Is.EqualTo("D:\\Temp")); Assert.That(logger.DefaultLogger, Is.EqualTo("DefaultLogger")); Assert.That(logger.GetDirectoryByLoggerName("Foo"), Is.EqualTo("C:\\Foo")); Assert.That(logger.GetDirectoryByLoggerName("Boo"), Is.EqualTo("C:\\Boo")); 

इसके अलावा, Moq आपको संरक्षित तरीकों, परीक्षण घटनाओं के व्यवहार की जांच करने की अनुमति देता है, और कुछ अन्य विशेषताएं शामिल हैं।

संबंधित लिंक

गिथब उदाहरण
मोकी और स्टब्स
Microsoft मोल्स