Add multi-lingual entities

framework/Volo.Abp.sln

@@ -331,6 +331,10 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Volo.Abp.GlobalFeatures", "
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Volo.Abp.GlobalFeatures.Tests", "test\Volo.Abp.GlobalFeatures.Tests\Volo.Abp.GlobalFeatures.Tests.csproj", "{231F1581-AA21-44C3-BF27-51EB3AD5355C}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Volo.Abp.MultiLingualObject", "src\Volo.Abp.MultiLingualObject\Volo.Abp.MultiLingualObject.csproj", "{C9142DED-1F6C-4385-A37D-81E46B233306}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Volo.Abp.MultiLingualObject.Tests", "test\Volo.Abp.MultiLingualObject.Tests\Volo.Abp.MultiLingualObject.Tests.csproj", "{A30D63B0-E952-4052-BAEE-38B8BF924093}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Volo.Abp.Http.Client.IdentityModel.WebAssembly", "src\Volo.Abp.Http.Client.IdentityModel.WebAssembly\Volo.Abp.Http.Client.IdentityModel.WebAssembly.csproj", "{3D35A1E0-A9A1-404F-9B55-5F1A7EB6D5B8}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Volo.Abp.AspNetCore.Mvc.Client.Common", "src\Volo.Abp.AspNetCore.Mvc.Client.Common\Volo.Abp.AspNetCore.Mvc.Client.Common.csproj", "{8A22D962-016E-474A-8BB7-F831F0ABF3AC}"
@@ -1075,6 +1079,10 @@ Global
 		{A37BFEB5-7C57-4CDC-93B8-B5CE4BB9ACE1}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{A37BFEB5-7C57-4CDC-93B8-B5CE4BB9ACE1}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{A37BFEB5-7C57-4CDC-93B8-B5CE4BB9ACE1}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C9142DED-1F6C-4385-A37D-81E46B233306}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C9142DED-1F6C-4385-A37D-81E46B233306}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A30D63B0-E952-4052-BAEE-38B8BF924093}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A30D63B0-E952-4052-BAEE-38B8BF924093}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{8FDB3BF7-AD89-43F6-8DEB-C3E29B8801FE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{8FDB3BF7-AD89-43F6-8DEB-C3E29B8801FE}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{8FDB3BF7-AD89-43F6-8DEB-C3E29B8801FE}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -1268,6 +1276,8 @@ Global
 		{DD9519E0-5A68-48DC-A051-7BF2AC922F3E} = {5DF0E140-0513-4D0D-BE2E-3D4D85CD70E6}
 		{00D07595-993C-40FC-BD90-0DD6331414D3} = {447C8A77-E5F0-4538-8687-7383196D04EA}
 		{A37BFEB5-7C57-4CDC-93B8-B5CE4BB9ACE1} = {447C8A77-E5F0-4538-8687-7383196D04EA}
+		{C9142DED-1F6C-4385-A37D-81E46B233306} = {5DF0E140-0513-4D0D-BE2E-3D4D85CD70E6}
+		{A30D63B0-E952-4052-BAEE-38B8BF924093} = {447C8A77-E5F0-4538-8687-7383196D04EA}
 		{8FDB3BF7-AD89-43F6-8DEB-C3E29B8801FE} = {5DF0E140-0513-4D0D-BE2E-3D4D85CD70E6}
 		{ACFBA3FB-18CE-4655-9D14-1F1F5C3DFC30} = {5DF0E140-0513-4D0D-BE2E-3D4D85CD70E6}
 		{DADEA538-3CA1-4ADE-A7E6-EF77A0CE4401} = {447C8A77-E5F0-4538-8687-7383196D04EA}

framework/src/Volo.Abp.AutoMapper/AutoMapper/AbpAutoMapperMultiLingualDtoExtensions.cs

@@ -0,0 +1,54 @@
+using Volo.Abp.MultiLingualObject;
+using Volo.Abp.Threading;
+
+namespace AutoMapper
+{
+    public static class AbpAutoMapperMultiLingualDtoExtensions
+    {
+        public static CreateMultiLingualMapResult<TSource, TTranslation, TDestination> CreateMultiLingualMap<TSource, TTranslation, TDestination>(this Profile profile)
+            where TTranslation : class, IMultiLingualTranslation
+            where TSource : IHasMultiLingual<TTranslation>
+        {
+
+            return new(
+                profile.CreateMap<TSource, TDestination>().BeforeMap<AbpMultiLingualMapperAction<TSource, TTranslation, TDestination>>(),
+                profile.CreateMap<TTranslation, TDestination>());
+        }
+    }
+
+    public class AbpMultiLingualMapperAction<TSource, TTranslation, TDestination> : IMappingAction<TSource, TDestination>
+        where TTranslation : class, IMultiLingualTranslation
+        where TSource : IHasMultiLingual<TTranslation>
+    {
+        private readonly IMultiLingualObjectManager _multiLingualObjectManager;
+
+        public AbpMultiLingualMapperAction(IMultiLingualObjectManager multiLingualObjectManager)
+        {
+            _multiLingualObjectManager = multiLingualObjectManager;
+        }
+
+        public void Process(TSource source, TDestination destination, ResolutionContext context)
+        {
+            var translation = AsyncHelper.RunSync(() => _multiLingualObjectManager.GetTranslationAsync<TSource, TTranslation>(source));
+            if (translation != null)
+            {
+                context.Mapper.Map(translation, destination);
+            }
+        }
+    }
+
+    public class CreateMultiLingualMapResult<TSource, TTranslation, TDestination>
+    {
+        public IMappingExpression<TSource, TDestination> EntityMap { get; }
+
+        public IMappingExpression<TTranslation, TDestination> TranslateMap { get; }
+
+        public CreateMultiLingualMapResult(
+            IMappingExpression<TSource, TDestination> entityMap,
+            IMappingExpression<TTranslation, TDestination> translateMap)
+        {
+            EntityMap = entityMap;
+            TranslateMap = translateMap;
+        }
+    }
+}

framework/src/Volo.Abp.AutoMapper/Volo.Abp.AutoMapper.csproj

@@ -16,6 +16,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\Volo.Abp.Auditing\Volo.Abp.Auditing.csproj" />
+    <ProjectReference Include="..\Volo.Abp.MultiLingualObject\Volo.Abp.MultiLingualObject.csproj" />
     <ProjectReference Include="..\Volo.Abp.ObjectExtending\Volo.Abp.ObjectExtending.csproj" />
     <ProjectReference Include="..\Volo.Abp.ObjectMapping\Volo.Abp.ObjectMapping.csproj" />
   </ItemGroup>

framework/src/Volo.Abp.AutoMapper/Volo/Abp/AutoMapper/AbpAutoMapperModule.cs

@@ -27,6 +27,8 @@ public override void ConfigureServices(ServiceConfigurationContext context)
 
             context.Services.AddSingleton<MapperAccessor>(CreateMappings);
             context.Services.AddSingleton<IMapperAccessor>(provider => provider.GetRequiredService<MapperAccessor>());
+
+            context.Services.AddTransient(typeof(AbpMultiLingualMapperAction<,,>));
         }
 
         private MapperAccessor CreateMappings(IServiceProvider serviceProvider)

framework/src/Volo.Abp.Ddd.Domain/Volo.Abp.Ddd.Domain.csproj

@@ -20,6 +20,7 @@
     <ProjectReference Include="..\Volo.Abp.EventBus\Volo.Abp.EventBus.csproj" />
     <ProjectReference Include="..\Volo.Abp.ExceptionHandling\Volo.Abp.ExceptionHandling.csproj" />
     <ProjectReference Include="..\Volo.Abp.Guids\Volo.Abp.Guids.csproj" />
+    <ProjectReference Include="..\Volo.Abp.MultiLingualObject\Volo.Abp.MultiLingualObject.csproj" />
     <ProjectReference Include="..\Volo.Abp.MultiTenancy\Volo.Abp.MultiTenancy.csproj" />
     <ProjectReference Include="..\Volo.Abp.ObjectMapping\Volo.Abp.ObjectMapping.csproj" />
     <ProjectReference Include="..\Volo.Abp.Specifications\Volo.Abp.Specifications.csproj" />

framework/src/Volo.Abp.Ddd.Domain/Volo/Abp/Domain/AbpDddDomainModule.cs

@@ -6,6 +6,7 @@
 using Volo.Abp.ExceptionHandling;
 using Volo.Abp.Guids;
 using Volo.Abp.Modularity;
+using Volo.Abp.MultiLingualObject;
 using Volo.Abp.MultiTenancy;
 using Volo.Abp.ObjectMapping;
 using Volo.Abp.Specifications;
@@ -25,6 +26,7 @@ namespace Volo.Abp.Domain
         typeof(AbpTimingModule),
         typeof(AbpUnitOfWorkModule),
         typeof(AbpObjectMappingModule),
+        typeof(AbpMultiLingualObjectModule),
         typeof(AbpExceptionHandlingModule),
         typeof(AbpSpecificationsModule)
         )]

framework/src/Volo.Abp.MultiLingualObject/FodyWeavers.xml

@@ -0,0 +1,3 @@
+<Weavers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="FodyWeavers.xsd">
+  <ConfigureAwait ContinueOnCapturedContext="false" />
+</Weavers>

framework/src/Volo.Abp.MultiLingualObject/FodyWeavers.xsd

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
+  <!-- This file was generated by Fody. Manual changes to this file will be lost when your project is rebuilt. -->
+  <xs:element name="Weavers">
+    <xs:complexType>
+      <xs:all>
+        <xs:element name="ConfigureAwait" minOccurs="0" maxOccurs="1">
+          <xs:complexType>
+            <xs:attribute name="ContinueOnCapturedContext" type="xs:boolean" />
+          </xs:complexType>
+        </xs:element>
+      </xs:all>
+      <xs:attribute name="VerifyAssembly" type="xs:boolean">
+        <xs:annotation>
+          <xs:documentation>'true' to run assembly verification (PEVerify) on the target assembly after all weavers have been executed.</xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+      <xs:attribute name="VerifyIgnoreCodes" type="xs:string">
+        <xs:annotation>
+          <xs:documentation>A comma-separated list of error codes that can be safely ignored in assembly verification.</xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+      <xs:attribute name="GenerateXsd" type="xs:boolean">
+        <xs:annotation>
+          <xs:documentation>'false' to turn off automatic generation of the XML Schema file.</xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+    </xs:complexType>
+  </xs:element>
+</xs:schema>

framework/src/Volo.Abp.MultiLingualObject/Volo.Abp.MultiLingualObject.csproj

@@ -0,0 +1,21 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <Import Project="..\..\..\configureawait.props" />
+    <Import Project="..\..\..\common.props" />
+
+    <PropertyGroup>
+        <TargetFramework>netstandard2.0</TargetFramework>
+        <AssemblyName>Volo.Abp.MultiLingualObject</AssemblyName>
+        <PackageId>Volo.Abp.MultiLingualObject</PackageId>
+        <AssetTargetFallback>$(AssetTargetFallback);portable-net45+win8+wp8+wpa81;</AssetTargetFallback>
+        <GenerateAssemblyConfigurationAttribute>false</GenerateAssemblyConfigurationAttribute>
+        <GenerateAssemblyCompanyAttribute>false</GenerateAssemblyCompanyAttribute>
+        <GenerateAssemblyProductAttribute>false</GenerateAssemblyProductAttribute>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+      <ProjectReference Include="..\Volo.Abp.Localization\Volo.Abp.Localization.csproj" />
+    </ItemGroup>
+
+</Project>

framework/src/Volo.Abp.MultiLingualObject/Volo/Abp/MultiLingualObject/AbpMultiLingualObjectModule.cs

@@ -0,0 +1,11 @@
+using Volo.Abp.Localization;
+using Volo.Abp.Modularity;
+
+namespace Volo.Abp.MultiLingualObject
+{
+    [DependsOn(
+        typeof(AbpLocalizationModule))]
+    public class AbpMultiLingualObjectModule : AbpModule
+    {
+    }
+}

framework/src/Volo.Abp.MultiLingualObject/Volo/Abp/MultiLingualObject/IHasMultiLingual.cs

@@ -0,0 +1,10 @@
+using System.Collections.Generic;
+
+namespace Volo.Abp.MultiLingualObject
+{
+    public interface IHasMultiLingual<TTranslation>
+        where TTranslation : class, IMultiLingualTranslation
+    {
+        ICollection<TTranslation> Translations { get; set; }
+    }
+}

framework/src/Volo.Abp.MultiLingualObject/Volo/Abp/MultiLingualObject/IMultiLingualObjectManager.cs

@@ -0,0 +1,21 @@
+using System.Threading.Tasks;
+
+namespace Volo.Abp.MultiLingualObject
+{
+    public interface IMultiLingualObjectManager
+    {
+        TTranslation GetTranslation<TMultiLingual, TTranslation>(
+            TMultiLingual multiLingual,
+            bool fallbackToParentCultures = true,
+            string culture = null)
+            where TMultiLingual : IHasMultiLingual<TTranslation>
+            where TTranslation : class, IMultiLingualTranslation;
+
+        Task<TTranslation> GetTranslationAsync<TMultiLingual, TTranslation>(
+            TMultiLingual multiLingual,
+            bool fallbackToParentCultures = true,
+            string culture = null)
+            where TMultiLingual : IHasMultiLingual<TTranslation>
+            where TTranslation : class, IMultiLingualTranslation;
+    }
+}

framework/src/Volo.Abp.MultiLingualObject/Volo/Abp/MultiLingualObject/IMultiLingualTranslation.cs

@@ -0,0 +1,7 @@
+namespace Volo.Abp.MultiLingualObject
+{
+    public interface IMultiLingualTranslation
+    {
+        string Language { get; set; }
+    }
+}

framework/src/Volo.Abp.MultiLingualObject/Volo/Abp/MultiLingualObject/MultiLingualObjectManager.cs

@@ -0,0 +1,95 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.Linq;
+using System.Threading.Tasks;
+using Volo.Abp.DependencyInjection;
+using Volo.Abp.Localization;
+using Volo.Abp.Settings;
+using Volo.Abp.Threading;
+
+namespace Volo.Abp.MultiLingualObject
+{
+    public class MultiLingualObjectManager : IMultiLingualObjectManager, ITransientDependency
+    {
+        protected ISettingProvider SettingProvider { get; }
+
+        protected const int MaxCultureFallbackDepth = 5;
+
+        public MultiLingualObjectManager(ISettingProvider settingProvider)
+        {
+            SettingProvider = settingProvider;
+        }
+
+        public TTranslation GetTranslation<TMultiLingual, TTranslation>(
+            TMultiLingual multiLingual,
+            bool fallbackToParentCultures = true,
+            string culture = null)
+            where TMultiLingual : IHasMultiLingual<TTranslation>
+            where TTranslation : class, IMultiLingualTranslation
+        {
+            return AsyncHelper.RunSync(() =>
+                GetTranslationAsync<TMultiLingual, TTranslation>(multiLingual, fallbackToParentCultures, culture));
+        }
+
+        public virtual async Task<TTranslation> GetTranslationAsync<TMultiLingual, TTranslation>(
+            TMultiLingual multiLingual,
+            bool fallbackToParentCultures = true,
+            string culture = null)
+            where TMultiLingual : IHasMultiLingual<TTranslation>
+            where TTranslation : class, IMultiLingualTranslation
+        {
+            culture ??= CultureInfo.CurrentUICulture.Name;
+
+            if (multiLingual.Translations == null || !multiLingual.Translations.Any())
+            {
+                return null;
+            }
+
+            var translation = multiLingual.Translations.FirstOrDefault(pt => pt.Language == culture);
+            if (translation != null)
+            {
+                return translation;
+            }
+
+            if (fallbackToParentCultures)
+            {
+                translation =
+                    GeTranslationBasedOnCulturalRecursive(
+                        CultureInfo.CurrentUICulture.Parent, multiLingual.Translations, 0);
+                if (translation != null)
+                {
+                    return translation;
+                }
+            }
+
+            var defaultLanguage = await SettingProvider.GetOrNullAsync(LocalizationSettingNames.DefaultLanguage);
+
+            translation = multiLingual.Translations.FirstOrDefault(pt => pt.Language == defaultLanguage);
+            if (translation != null)
+            {
+                return translation;
+            }
+
+            translation = multiLingual.Translations.FirstOrDefault();
+            return translation;
+        }
+
+        protected virtual TTranslation GeTranslationBasedOnCulturalRecursive<TTranslation>(
+            CultureInfo culture, ICollection<TTranslation> translations, int currentDepth)
+            where TTranslation : class, IMultiLingualTranslation
+        {
+            if (culture == null || culture.Name.IsNullOrWhiteSpace() || translations.IsNullOrEmpty() ||
+                currentDepth > MaxCultureFallbackDepth)
+            {
+                return null;
+            }
+
+            var translation = translations.FirstOrDefault(pt =>
+                pt.Language.Equals(culture.Name, StringComparison.OrdinalIgnoreCase));
+            return translation ??
+                   GeTranslationBasedOnCulturalRecursive(culture.Parent,
+                       translations, currentDepth + 1);
+        }
+    }
+}