एक डेटाबेस का उपयोग करके ASP.NET MVC एप्लिकेशन का स्थानीयकरण

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

सबसे पहले, मैं साइट को स्थानीय बनाने के विकल्पों के बारे में संक्षेप में बात करूँगा, मेरे रिसोर्सप्रोवेइडरफैक्टरी बनाने का एक उदाहरण दिखाऊँगा, और फिर प्रदर्शन के लिए एक छोटा अनुप्रयोग बनाऊँगा।

स्थानीयकरण विकल्प

कई चर्चाओं और लेखों में, केवल दो स्थानीयकरण विकल्पों का उल्लेख किया गया है, उदाहरण के लिए, एक ASP.NET MVC 3 अंतर्राष्ट्रीयकरण लेख, जिसमें आप कई लिंक पा सकते हैं, निम्नलिखित पर प्रकाश डालते हैं:
- संसाधन फ़ाइलें (resx)
- विभिन्न "दृश्य" का उपयोग करें (देखें)
पहली विधि आमतौर पर स्टैटिक्स के लिए उपयोग की जाती है: फ़ील्ड नाम, सत्यापन और बहुत कुछ। दूसरे का उपयोग करने का एक महत्वपूर्ण नुकसान एक ही कोड को कॉपी करने पर बहुत सारे मैनुअल काम करने की आवश्यकता है, अगर आपको लेआउट को थोड़ा भी बदलने की आवश्यकता है, तो कई भाषाओं के साथ साइट की संरचना की कल्पना करना भी मुश्किल है, फ़ाइलों की संख्या बहुत बड़ी होगी, कभी-कभी अनुवाद को निर्देशिकाओं में विभाजित किया जाता है। यह निश्चित रूप से अधिक दृश्य हो जाता है, लेकिन स्केलेबिलिटी वांछित होने के लिए बहुत कुछ छोड़ देती है। मेरे मामले में, मुझे डायनामिक कंटेंट को ट्रांसलेट करने की ज़रूरत थी, जो कि एडमिन पैनल के माध्यम से जोड़ा जाता है, मैंने एडमिन पैनल से रेक्स फाइलों को एडिट करने के विकल्प पर विचार नहीं किया, लेकिन आप खुद ही इंप्लीमेंटेशन पा सकते हैं, जैसा कि वे कहते हैं, एक शौकिया के लिए, इसलिए हम तीसरे विकल्प को उजागर करते हैं।
- डेटाबेस का उपयोग कर स्थानीयकरण
बेशक, आप इन तीनों विकल्पों को मिला सकते हैं।

कार्यान्वयन का उदाहरण

मुझे तुरंत यह कहना होगा कि मैं एक खाली MVC 3 प्रोजेक्ट बना रहा हूं, क्योंकि मैं Entity Framework Code First का उपयोग करूंगा, मैं इस लेख में सदस्यता प्रदाता को फिर से नहीं लिखूंगा, आप यह देख सकते हैं कि यह कैसे करना है, उदाहरण के लिए, कस्टम सदस्यता प्रदाता । बस याद रखें कि "व्यवस्थापक पैनल" सार्वजनिक रूप से उपलब्ध होगा, निश्चित रूप से यह एक विन्यास फाइल के माध्यम से प्राधिकरण को लागू करना संभव था, जैसा कि स्टीफन सैंडरसन ने अपनी पुस्तकों में प्रदर्शित किया है, लेकिन लेख दूसरे के बारे में है।

चलो गोदाम की पैरोडी बनाते हैं, हमारे पास 4 क्षेत्रों के साथ एक उत्पाद तालिका होगी:
-Identifikator
उत्पाद का नाम (हम डेटाबेस का उपयोग करके इसका अनुवाद करेंगे)
-प्रास (हमें स्थानीयकरण के दौरान सत्यापन के साथ समस्याओं को प्रदर्शित करने के लिए इस क्षेत्र की आवश्यकता है)
प्रसव के समय (पिछले के समान)

अगला कदम उत्पाद वर्ग बनाना और डेटा एनोटेशन का उपयोग करके विशेषताओं को सेट करना है (यदि आप इस विकल्प को पसंद नहीं करते हैं, तो आप धाराप्रवाह एपीआई का उपयोग कर सकते हैं, जिसे आपको किसी भी बड़ी परियोजना में उपयोग करना होगा) और DbContext बनाएं:

public class Product { public int ProductId { get; set; } [Required] [StringLength(128)] public string Name { get; set; } [Required] public decimal Price { get; set; } [Required] public DateTime ImportDate { get; set; } } public class ProductDbContext : DbContext { public DbSet<Product> Products { get; set; } } 

अब मैं अपने आप कंट्रोलर और सभी क्रियाएं (क्रियाएँ) उत्पन्न कर दूंगा, यह थोड़ा डरावना था, इसलिए मुझे शैलियों को जोड़ना होगा, हालांकि मैं पीढ़ी के लिए थोड़ा अलग दृष्टिकोण का उपयोग करने की सलाह दूंगा। एक दृश्य में निर्माण और संपादन का संयोजन, उदाहरण के लिए, इस प्रकार: ASP.NET MVC के बारे में ख़राब नोट्स। भाग 1 (और केवल एक) जो एक विचार को हटा देता है, जितना संभव हो उतना कम कॉपी-पेस्ट करने का प्रयास करें।

नतीजतन, हमारे पास ऐसी तालिका है:



हम रिसोर्सप्रोविडरफैक्टरी की ओर मुड़ते हैं, थोड़ा सा गूगल, मुझे एमएसपीएनडी में एएसपी.नेट 2.0 रिसोर्स-प्रोवाइडर मॉडल का विस्तार करने के बजाय एक पुराना लेख मिला, साथ ही एक कार्यान्वयन उदाहरण के साथ रिसोर्सप्रोविडरफैक्टरी क्लास का विवरण, लेकिन 4 के फ्रेमवर्क के लिए। उसी कोडप्रोजेक्ट पर एक तैयार उदाहरण है, जिसे आधार के रूप में भी लिया जा सकता है: ASP.NET 2.0 कस्टम SQL सर्वर रिसोर्स सर्वर ।

अब अनुवादों को संग्रहीत करने के लिए एक कक्षा बनाएँ:

 public class GlobalizationResource { public int GlobalizationResourceId { get; set; } [Required] [StringLength(128)] public string ResourceObject { get; set; } [Required] [StringLength(128)] public string ResourceName { get; set; } [Required] [StringLength(5)] public string Culture { get; set; } [Required] [StringLength(4000)] public string ResourceValue { get; set; } } 

और इसे डेटाबेस के संदर्भ में जोड़ना मत भूलना। मुझे कोडप्रोजेक्ट और MSDN से एक उदाहरण के बीच एक औसत कार्यान्वयन मिला, कोड को लेख के अंत में डाउनलोड किया जा सकता है, क्योंकि लगभग 150 लाइनें हैं। और प्रदाता को कॉन्फ़िगर में जोड़ें:

  <system.web> <globalization enableClientBasedCulture="true" resourceProviderFactoryType="DbLocalizationExample.Models.CustomResourceProviderFactory" uiCulture="auto" culture="auto" /> ... </system.web> 

सब कुछ ठीक होगा, लेकिन स्थानीयकरण को सत्यापित करने के लिए हमें भाषा चुनने की क्षमता चाहिए, मैं स्थानीयकरण को संग्रहीत करने के लिए कुकीज़ का उपयोग करूंगा (मैं एक सत्र का उपयोग करने की सिफारिश नहीं करूंगा, क्योंकि यह संभावना नहीं है कि उपयोगकर्ता 20 मिनट में लॉग इन करके खुश हो जाएगा (मानक जीवनकाल, जहां तक ​​मुझे याद है) फिर से आपको एक भाषा चुनने की जरूरत है)। हम आधार के रूप में afana.me से विचार लेते हैं और इस तरह के एक वर्ग प्राप्त करते हैं:

 public static class CultureHelper { private static readonly List<string> Cultures = new List<string> { "ru-RU", // first culture is the DEFAULT "en-US", }; /// <summary> /// Returns a valid culture name based on "name" parameter. If "name" is not valid, it returns the default culture "en-US" /// </summary> /// <param name="name">Culture's name (eg en-US)</param> public static string GetValidCulture(string name) { if (string.IsNullOrEmpty(name)) return GetDefaultCulture(); // return Default culture if (Cultures.Contains(name)) return name; // Find a close match. For example, if you have "en-US" defined and the user requests "en-GB", // the function will return closes match that is "en-US" because at least the language is the same (ie English) foreach (var c in Cultures) if (c.StartsWith(name.Substring(0, 2))) return c; return GetDefaultCulture(); // return Default culture as no match found } public static string GetDefaultCulture() { return Cultures.ElementAt(0); // return Default culture } public static string GetCultureFromCookies(HttpRequest request) { string cultureName = null; // Attempt to read the culture cookie from Request HttpCookie cultureCookie = request.Cookies["_culture"]; if (cultureCookie != null) { cultureName = cultureCookie.Value; } else if (request.UserLanguages != null) { cultureName = request.UserLanguages[0]; // obtain it from HTTP header AcceptLanguages } // Validate culture name return GetValidCulture(cultureName); // This is safe } private static string AcceptLanguage() { return HttpUtility.HtmlAttributeEncode(System.Threading.Thread.CurrentThread.CurrentUICulture.ToString()); } public static IHtmlString MetaAcceptLanguage<T>(this HtmlHelper<T> html) { return new HtmlString(String.Format(@"<meta name=""accept-language"" content=""{0}"" />", AcceptLanguage())); } public static IHtmlString GlobalizationLink<T>(this HtmlHelper<T> html) { return new HtmlString(String.Format(@"<script src=""../../Scripts/globalization/cultures/globalize.culture.{0}.js"" type=""text/javascript""></script>", AcceptLanguage())); } } 

अब हमें बस कुकीज को सेट करने और पढ़ने के लिए क्रियाओं को जोड़ना होगा:

 public ActionResult SetCulture(string culture) { // Validate input culture = CultureHelper.GetValidCulture(culture); // Save culture in a cookie HttpCookie cookie = Request.Cookies["_culture"]; if (cookie != null) { cookie.Value = culture; // update cookie value } else { cookie = new HttpCookie("_culture"); cookie.HttpOnly = false; // Not accessible by JS. cookie.Value = culture; cookie.Expires = DateTime.Now.AddYears(1); } Response.Cookies.Add(cookie); return RedirectToAction("Index"); } 

कैशिंग का उपयोग करने के लिए संस्कृति को स्थापित करने और GetVaryByCustomString की जाँच करने के लिए Global.asax में तर्क।

 protected void Application_AcquireRequestState(object sender, EventArgs e) { string cultureName = CultureHelper.GetCultureFromCookies(Request); // Modify current thread's culture Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(cultureName); Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultureName); } public override string GetVaryByCustomString(HttpContext context, string arg) { // It seems this executes multiple times and early, so we need to extract language again from cookie. if (arg == "culture") // culture name (eg "en-US") is what should vary caching { string cultureName = CultureHelper.GetCultureFromCookies(Request); return cultureName.ToLower();// use culture name as cache key, "es", "en-us", "es-cl", etc. } return base.GetVaryByCustomString(context, arg); } 

अनुवाद तर्क के बारे में कुछ शब्द: मेरा डेटाबेस डिफ़ॉल्ट भाषा को संग्रहीत करेगा, अर्थात्। सिर्फ एक उत्पाद वस्तु, लेकिन जब मैं इसमें अनुवाद जोड़ना चाहता हूं तो दृश्य में लिखूंगा:

 @(Culture == "ru-RU" ? item.Name : HttpContext.GetLocalResourceObject("/Home/Index", "Product_" + item.ProductId)) 

वह डेटाबेस में स्वतः एक डिफ़ॉल्ट मान जोड़ देगा। पहला पैरामीटर केवल स्पष्टता के लिए पथ के समान है, वर्णों का कोई भी अनुक्रम हो सकता है (हमारी घोषणा के लिए डेटाबेस में सीमित सच्चाई 128 है), दूसरा एक अद्वितीय पहचानकर्ता है।

लेआउट में, भाषा चुनने की क्षमता जोड़ें:

 <div class="language"> <span>@Html.ActionLink("rus", "SetCulture", "Home", new { culture = "ru-RU" }, null)</span> <span>@Html.ActionLink("eng", "SetCulture", "Home", new { culture = "en-US" }, null)</span> </div> 

आप इसे चला सकते हैं, लेकिन यह वहां नहीं था, मैंने संदर्भ बदल दिया (संसाधनों के लिए एक वर्ग जोड़ा गया) और अब ईएफ ने तालिका से डेटा प्रदर्शित करने से इनकार कर दिया। देखें -> अन्य विंडोज -> पैकेज प्रबंधक कंसोल और दर्ज करें (प्रत्येक पंक्ति अलग से):

 Update-Package EntityFramework Enable-Migrations 

अब आप एक माइग्रेशन बना सकते हैं और डेटाबेस को अपडेट कर सकते हैं:

 Add-Migration AddGlobalizationResources Update-Database 

लेकिन यहां हम परेशान हैं, स्टूडियो का कहना है कि हमने एक पुराने EF के साथ एक डेटाबेस बनाया है, जहां कोई माइग्रेशन इतिहास नहीं है, इसलिए अपने डेटाबेस को अपने हाथों से हटाने के लिए नहीं, ऐसी लाइन को इंडेक्स में जोड़ें (यदि आप माइग्रेशन के विरोध में हैं, तो इसे Application_Start में जोड़ना अधिक सही है, लेकिन याद रखें कि यह सभी डेटा हटाता है):

 Database.SetInitializer(new DropCreateDatabaseIfModelChanges<ProductDbContext>()); 

इसे संकलित और एक्सेस करने के बाद, इसे हटा दें, क्योंकि भविष्य में हम माइग्रेशन के सभी लाभों का आनंद ले सकते हैं: EF 4.3 ऑटोमैटिक माइग्रेशन वॉकथ्रू ।

हमारे काम का परिणाम इस तरह दिखेगा:



डेटाबेस में अंग्रेजी संस्करण स्वचालित रूप से बनाया जाता है, जबकि रूसी संस्करण उत्पाद में संग्रहीत किया जाता है। मैं आपके लिए डेटाबेस को संपादित करने के लिए तर्क छोड़ दूंगा, कुछ भी जटिल नहीं है।

ग्राहक मान्यता

भाषा स्विच करते समय, हमें दशमलव और डेटाटाइम की समस्या होती है। रूसी भाषा के लिए हमारे पास "4.00" है, और अंग्रेजी के लिए यह "4.00" है। दिनांक की भी समस्याएं हैं: 12/21/2012 और 12/21/2012। इन समस्याओं को हल करने के लिए, हम वैश्वीकरण का उपयोग करेंगे और jquery यूआई डेटापीकर को प्रारूप को स्वचालित रूप से सेट करने और तिथियों को आसान बनाने में सक्षम करेंगे।

लेआउट में निम्नलिखित जोड़ें (वैश्वीकरण का "मूल", एक विशेष भाषा के लिए वैश्वीकरण, ग्राहक पक्ष के लिए एक मेटा टैग और संख्याओं को मान्य करने और jquery ui datapicker को बदलने के लिए सामान्य स्क्रिप्ट):

 <script src="@Url.Content("~/Scripts/globalization/globalize.js")" type="text/javascript"></script> @Html.GlobalizationLink() @Html.MetaAcceptLanguage() <script src="@Url.Content("~/Scripts/common.js")" type="text/javascript"></script> 

यह क्लाइंट-साइड सत्यापन का केवल एक छोटा सा हिस्सा है; स्थानीयकरण का एक उदाहरण यहां पाया जा सकता है: ASP.NET MVC 3 अंतर्राष्ट्रीयकरण - भाग 2 (NerdDinner)

परिणाम

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



परियोजना को यहां डाउनलोड किया जा सकता है (दृश्य स्टूडियो 2010): लिंक (2.89 एमबी) (उदाहरण केवल गतिशीलता के स्थानीयकरण को प्रदर्शित करता है, स्थैतिक अनुवाद को जोड़ना परिमाण का एक क्रम आसान है, इसलिए कोड में लेख में वर्णित केवल एक है)

सूत्रों का कहना है

संदर्भ

ASP.NET 2.0 संसाधन प्रदाता मॉडल का विस्तार
रिसोर्सप्रोइडरफैक्ट्री क्लास
ASP.NET 2.0 कस्टम SQL सर्वर रिसोर्सप्रोवाइडर
ASP.NET MVC 3 अंतर्राष्ट्रीयकरण
ASP.NET MVC 3 अंतर्राष्ट्रीयकरण - भाग 2 (नर्डडिनर)

किताबें

फ्रीमैन ए। सैंडर्सन एस - प्रो ASP.NET MVC 3 फ्रेमवर्क तीसरा संस्करण - 2011
जूलिया लर्मन और रोवन मिलर - प्रोग्रामिंग एंटिटी फ्रेमवर्क: कोड फर्स्ट - 2012

नोट: यदि आप इस ASP.NET MVC 3 अंतर्राष्ट्रीयकरण गाइड का स्थानीयकरण कर रहे हैं, तो आपको याद रखना चाहिए कि MVC 4 में निकाल दी गई बेस क्लास में ExecuteCore () MVC 4 ExecuteCore में काम नहीं करती है।