रेजर से परे ASP.NET का उपयोग करना

इसलिए, कल Microsoft ने ASP.NET MVC3 RTM जारी किया , जिसमें नया रेज़र व्यू इंजन शामिल है। जैसा कि आप शायद पहले से ही जानते हैं, रेजर में वेब के लिए विशिष्ट कोई घटक नहीं होता है, जिसका अर्थ है कि इसका उपयोग अन्य अनुप्रयोगों में किया जा सकता है। खैर, अगर आप अभी भी यह नहीं जानते हैं - तो यह पता लगाने का समय है!



इस पोस्ट में मैं दिखाऊंगा कि रेजर को आपकी आवश्यकताओं के लिए एक टेम्पलेट इंजन के रूप में कैसे उपयोग किया जाए। इसका स्रोत एंड्रयू नर्स का ब्लॉग पोस्ट "ASP.Net के बाहर होस्टिंग रेजर" था, लेकिन यह प्रत्यक्ष अनुवाद नहीं है।







उदाहरण के लिए, मैं एक टेक्स्ट लेटर बनाऊंगा जिसमें ऑर्डर के बारे में जानकारी होगी।



एक आदेश दो वर्गों द्वारा वर्णित किया जाता है, ऑर्डरमॉडल और ऑर्डर इटेममॉडल:

public class OrderModel { public string FirstName { get; set; } public string LastName { get; set; } public List<OrderItemModel> Items { get; set; } } public class OrderItemModel { public string ProductName { get; set; } public Decimal Price { get; set; } public int Qty { get; set; } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ई-मेल बनाने के लिए मैं जिस टेम्पलेट का उपयोग करूंगा वह नीचे दिखाया गया है। आप रेज़र सिंटैक्स के बारे में अधिक विस्तृत जानकारी प्राप्त कर सकते हैं, उदाहरण के लिए, आंद्रेई टरित्सिन के ब्लॉग पोस्ट में "रेज़र सिंटैक्स क्विक संदर्भ [अनुवाद]" ।

 , @Model.FirstName @Model.LastName! #   -  - ---------- ------ ------ ------ @for (var i = 0; i < Model.Items.Count; i++) { var item = Model.Items[i]; @String.Format( "{0} {1,-10} {2,6} {3,6} {4,6}\r\n", i + 1, @item.ProductName, @item.Price, @item.Qty, item.Price * item.Qty) } : @(((OrderModel)Model).Items.Sum(x => x.Price * x.Qty)) WBR, ACME team
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

मुझे एक ऐसे वर्ग की आवश्यकता होगी जो मेरे टेम्पलेट के लिए आधार के रूप में उपयोग किया जाएगा:

 public abstract class TemplateBase { public TextWriter Output { get; set; } public dynamic Model { get; set; } public abstract void Execute(); public virtual void Write(object value) { this.Output.Write(value); } public virtual void WriteLiteral(object value) { this.Output.Write(value); } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

आउटपुट गुण TextWriter सेट करता है, जो टेम्पलेट निष्पादन का परिणाम प्राप्त करता है।



मॉडल प्रॉपर्टी का उपयोग टेम्प्लेट में पैरामीटर पास करने के लिए किया जाता है।



विरासत में मिली कक्षा में निष्पादन () पद्धति में टेम्प्लेट कोड होगा।



लिखने () और WriteLiteral () विधियों का उपयोग क्रमशः आउटपुट, अभिव्यक्तियों और पाठ स्ट्रिंग के मूल्यांकन के परिणामों के लिए किया जाता है। क्योंकि मुझे गणना के परिणामों के लिए या स्ट्रिंग्स के लिए अतिरिक्त प्रसंस्करण की आवश्यकता नहीं है; इन विधियों का कोड समान है।



नोट: नाम Execute (), Write (), और WriteLiteral () डिफ़ॉल्ट रूप से उपयोग किए जाते हैं, यदि आवश्यक हो, तो आप RazorEngineHost वर्ग की आवृत्ति के GeneratedClassContext संपत्ति का उपयोग करके अन्य नाम निर्दिष्ट कर सकते हैं।



अब मैं रेजर के लिए एक मेजबान बनाऊंगा, यह दर्शाता है कि मेरे टेम्पलेट में C # का उपयोग किया जाता है (यदि रेज़र C # और VB का समर्थन करता है, यदि आवश्यक हो, तो आप VBRazorCodeLanguage का RazorineineHost constructor का एक उदाहरण पारित करके VB का उपयोग कर सकते हैं):

 var razorHost = new RazorEngineHost(new CSharpRazorCodeLanguage());
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

अगला, मैं आधार वर्ग का नाम, नाम स्थान जिसमें टेम्पलेट कोड स्थित होगा, और टेम्पलेट श्रेणी का नाम निर्दिष्ट करता हूं:

 razorHost.DefaultBaseClass = typeof(TemplateBase).FullName; razorHost.DefaultNamespace = "StandaloneRazorDemo"; razorHost.DefaultClassName = "Template";
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

टेम्पलेट वर्ग के कोड में उपलब्ध नामस्थान का एक सेट जोड़ें:

 razorHost.NamespaceImports.Add("System"); razorHost.NamespaceImports.Add("System.Collections.Generic"); razorHost.NamespaceImports.Add("System.Linq"); razorHost.NamespaceImports.Add("System.Text");
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

और अंत में, मैं एक टेम्पलेट इंजन बनाता हूं:

 var razorEngine = new RazorTemplateEngine(razorHost);
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

अब मैं अपने टेम्पलेट को पार्स करने की कोशिश करूंगा:

 var templateText = File.ReadAllText("template.txt"); GeneratorResults generatorResults = null; using (var reader = new StringReader(templateText)) { generatorResults = razorEngine.GenerateCode(reader); }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

जेनरेटरसूट्स वर्ग की सफलता संपत्ति इंगित करती है कि पार्सिंग कितना सफल था। यदि समस्याएँ हैं, तो मैं त्रुटियों की एक सूची प्रदर्शित करता हूँ:

 if (!generatorResults.Success) { foreach (var error in generatorResults.ParserErrors) { Console.WriteLine( "Razor error: ({0}, {1}) {2}", error.Location.LineIndex + 1, error.Location.CharacterIndex + 1, error.Message); } throw new ApplicationException(); }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

यदि पार्सिंग सफल होता है, तो GeneratedCode प्रॉपर्टी में DOM ट्री होता है, जिसका उपयोग कोड उत्पन्न करने के लिए किया जा सकता है:

 return generatorResults.GeneratedCode;
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

अब मुझे टेम्पलेट संकलित करने की आवश्यकता है:

 private static string CompileTemplate(CodeCompileUnit generatedCode) { var codeProvider = new CSharpCodeProvider(); #if DEBUG using (var writer = new StreamWriter("out.cs", false, Encoding.UTF8)) { codeProvider.GenerateCodeFromCompileUnit( generatedCode, writer, new CodeGeneratorOptions()); } #endif var outDirectory = "temp"; Directory.CreateDirectory(outDirectory); var outAssemblyName = Path.Combine(outDirectory, String.Format("{0}.dll", Guid.NewGuid().ToString("N"))); var refAssemblyNames = new List<string>(); refAssemblyNames.Add(new Uri(typeof(TemplateBase).Assembly.CodeBase).AbsolutePath); refAssemblyNames.Add("System.Core.dll"); refAssemblyNames.Add("Microsoft.CSharp.dll"); var compilerResults = codeProvider.CompileAssemblyFromDom( new CompilerParameters(refAssemblyNames.ToArray(), outAssemblyName), generatedCode); if (compilerResults.Errors.HasErrors) { var errors = compilerResults .Errors .OfType<CompilerError>() .Where(x => !x.IsWarning); foreach (var error in errors) { Console.WriteLine("Compiler error: ({0}, {1}) {2}", error.Line, error.Column, error.ErrorText); } throw new ApplicationException(); } return outAssemblyName; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

उपरोक्त विधि में असेंबली का नाम है जिसमें संकलित टेम्पलेट है।



#If DEBUG ... #endif में संलग्न कोड का उपयोग डिबगिंग के लिए किया जाता है और आपको यह देखने की अनुमति देता है कि इस पर किए गए सभी जोड़तोड़ के बाद टेम्पलेट क्या बदल गया।



अब मुझे बस इतना करना है कि विधानसभा को लोड करें, टेम्पलेट क्लास का एक उदाहरण बनाएं और इसे "निष्पादित करें":

 var assembly = Assembly.LoadFrom(outAssemblyName); var type = assembly.GetType("StandaloneRazorDemo.Template", true); var template = Activator.CreateInstance(type) as TemplateBase; using (var writer = new StringWriter()) { template.Output = writer; template.Model = GetModel(); template.Execute(); File.WriteAllText("out.txt", writer.ToString(), Encoding.UTF8); }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

GetModel () विधि निम्नानुसार परिभाषित की गई है:

 private static OrderModel GetModel() { var model = new OrderModel { FirstName = "", LastName = "" }; model.Items = new List<OrderItemModel>(); model.Items.Add(new OrderItemModel { ProductName = "Apple", Price = 4.95m, Qty = 1 }); model.Items.Add(new OrderItemModel { ProductName = "Kiwi", Price = 9.95m, Qty = 2 }); return model; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

अब फ़ाइल "out.txt" में टेम्पलेट के "निष्पादन" का परिणाम है:

 ,  ! #   -  - ---------- ------ ------ ------ 1 Apple 4,95 1 4,95 2 Kiwi 9,95 2 19,90 : 24,85 WBR, ACME team
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

वह सब है!



उदाहरण कोड:

StandaloneRazorDemo.zip