feat: Add FirstBestMatchForLanguage for IEnumerable<IHasLanguageCode>

Author: artem-dudarev

src/VirtoCommerce.Xapi.Core/Extensions/IHasLanguageExtensions.cs

@@ -8,6 +8,17 @@ namespace VirtoCommerce.Xapi.Core.Extensions
 {
     public static class IHasLanguageExtensions
     {
+        /// <summary>
+        /// Looking for first best-match language-specific value in the enumerable
+        /// </summary>
+        /// <param name="hasLanguages">An enumerable with values to search</param>
+        /// <param name="language">Language to search</param>
+        /// <returns>First matching item to the specified language</returns>
+        public static IHasLanguageCode FirstBestMatchForLanguage(this IEnumerable<IHasLanguageCode> hasLanguages, string language)
+        {
+            return hasLanguages.FirstBestMatchForLanguage(x => x.LanguageCode, language);
+        }
+
         /// <summary>
         /// Looking for first best-match language-specific value in the enumerable, based on specified language value selector function
         /// </summary>
@@ -20,12 +31,14 @@ public static T FirstBestMatchForLanguage<T>(this IEnumerable<T> hasLanguages, F
         {
             ArgumentNullException.ThrowIfNull(hasLanguages);
 
-            //Try find object for passed language event if it null
-            var result = hasLanguages.FirstOrDefault(x => langSelector(x)?.EqualsIgnoreCase(language) ?? langSelector(x) == language);
+            var hasLanguagesCollection = hasLanguages as ICollection<T> ?? hasLanguages.ToList();
+
+            //Try to find object for passed language event if it is null
+            var result = hasLanguagesCollection.FirstOrDefault(x => langSelector(x)?.EqualsIgnoreCase(language) ?? langSelector(x) == language);
             if (result == null)
             {
                 //find the first with no language set
-                result = hasLanguages.FirstOrDefault(x => langSelector(x) == null);
+                result = hasLanguagesCollection.FirstOrDefault(x => langSelector(x) == null);
             }
             return result;
         }
@@ -36,6 +49,7 @@ public static T FirstBestMatchForLanguage<T>(this IEnumerable<T> hasLanguages, F
         /// <param name="hasLanguages">An enumerable with values to search</param>
         /// <param name="language">Language to search</param>
         /// <returns>First matching item to the specified language</returns>
+        [Obsolete("Use IEnumerable<IHasLanguageCode>.FirstBestMatchForLanguage()", DiagnosticId = "VC0011", UrlFormat = "https://docs.virtocommerce.org/products/products-virto3-versions")]
         public static IHasLanguage FirstBestMatchForLanguage(this IEnumerable<IHasLanguage> hasLanguages, string language)
         {
             return hasLanguages.FirstBestMatchForLanguage(x => x.LanguageCode, language);