var Cities =from c in Cities
Select new {Id=c.Id, Name=c.Name};
return Json(Cities , JsonRequestBehavior.AllowGet);
Microsoft.JSInterop.JSException: Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded. Error: Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded. at Object.createBlobUrl
window.JsBinaryFilesUtils = {
createBlobUrl: function (byteArray, contentType) {
// The byte array in .NET is encoded to base64 string when it passes to JavaScript.
const numArray = atob(byteArray)
.split("")
.map((c) => c.charCodeAt(0));
const uint8Array = new Uint8Array(numArray);
const blob = new Blob([uint8Array], { type: contentType });
return URL.createObjectURL(blob);
}, window.JsBinaryFilesUtils = {
createBlobUrl: function (byteArray, contentType) {
const blob = new Blob([byteArray], { type: contentType });
return URL.createObjectURL(blob);
}, services.AddMvc();
app.Run(async (context) =>
{
await context.Response.WriteAsync("Hello World!");
}); namespace Razor
{
public class Startup
{
// This method gets called by the runtime. Use this method to add services to the container.
// For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
//app.Run(async (context) =>
//{
// await context.Response.WriteAsync("Hello World!");
//});
}
}
} namespace Razor.Models
{
public class Product
{
public int ProductID { get; set; }
public string Name { get; set; }
public string Description { get; set; }
public decimal Price { get; set; }
public string Category { set; get; }
}
} namespace Razor.Controllers
{
public class HomeController : Controller
{
// GET: /<controller>/
public ViewResult Index()
{
Product myProduct = new Product
{
ProductID = 1,
Name = "Kayak",
Description = "A boat for one person",
Category = "Watersports",
Price = 275M
};
return View(myProduct);
}
}
} @model Razor.Models.Product
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width"/>
<title>Index</title>
</head>
<body>
Content will go here
</body>
</html> @model Razor.Models.Product
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width"/>
<title>Index</title>
</head>
<body>
@Model.Name
</body>
</html>
@using Razor.Models
@model Product
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width"/>
<title>Index</title>
</head>
<body>
@Model.Name
</body>
</html> @{
Layout = null;
} 
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>@ViewBag.Title</title>
</head>
<body>
<div>
@RenderBody()
</div>
</body>
</html> <!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>@ViewBag.Title</title>
<style>
#mainDiv {
padding: 20px;
border: solid medium black;
font-size: 20pt
}
</style>
</head>
<body>
<h1>Product Information</h1>
<div id="mainDiv">
@RenderBody()
</div>
</body>
</html> @model Product
@{
Layout = "_BasicLayout";
ViewBag.Title = "Product";
} 
@{
Layout = "_Layout";
} @{
Layout = "_BasicLayout";
}
@model Product
@{
ViewBag.Title = "Product";
} | کامپوننت |
انجام میشود |
انجام نمیشود |
| Action Method |
یک شیء ViewModel را به View ارسال می‌کند. |
یک فرمت داده را به View ارسال می‌کند. |
| View |
از شیء ViewModel برای ارائه محتوا به کاربر استفاده می‌کند. |
هر جنبه‌ای از شیء View Model مشخصات را تغییر میدهد. |
*@
@model Product
@{
ViewBag.Title = "Product";
}
<p>Product Name: @Model.Name</p> <p>Product Price: @($"{Model.Price:C2}")</p> <p>Product Name: @Model.Name</p>
using Microsoft.AspNetCore.Mvc;
using Razor.Models;
namespace Razor.Controllers
{
public class HomeController : Controller
{
// GET: /<controller>/
public ViewResult Index()
{
Product myProduct = new Product
{
ProductID = 1,
Name = "Kayak",
Description = "A boat for one person",
Category = "Watersports",
Price = 275M
};
return View(myProduct);
}
}
} <p>Product Name: @Model.Name</p> <p>Product Price: @($"{Model.Price:C2}")</p> <p>Stock Level: @ViewBag.StockLevel</p> 
@model Product
@{
ViewBag.Title = "Product";
}
p>Product Name: @Model.Name</p> <p>Product Price: @($"{Model.Price:C2}")</p>
<p>Stock Level: @ViewBag.StockLevel</p>
<div data-productid="@Model.ProductID" data-stocklevel="@ViewBag.StockLevel">
<p>Product Name: @Model.Name</p>
<p>Product Price: @($"{Model.Price:C2}")</p>
<p>Stock Level: @ViewBag.StockLevel</p>
</div> <div data-productid="1" data-stocklevel="2"> <p>Product Name: Kayak</p> <p>Product Price: £275.00</p> <p>Stock Level: 2</p> </div>
@model Product
@{ ViewBag.Title = "Product Name"; }
<div data-productid="@Model.ProductID" data-stocklevel="@ViewBag.StockLevel">
<p>Product Name: @Model.Name</p>
<p>Product Price: @($"{Model.Price:C2}")</p>
<p>Stock Level:
@switch (ViewBag.StockLevel)
{
case 0:@:Out of Stock break;
case 1:
case 2:
case 3:
<b>Low Stock (@ViewBag.StockLevel)</b>
break;
default:
@: @ViewBag.StockLevel in Stock
break;
}
</p>
</div> 
<b>Low Stock (@ViewBag.StockLevel)</b>
<Window x:Class="FirstPrismSample.Shell"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:com="http://www.codeplex.com/CompositeWPF"
Title="Prism Sample By Masoud Pakdel" Height="400" Width="600" WindowStartupLocation="CenterScreen">
<DockPanel>
<ContentControl com:RegionManager.RegionName="WorkspaceRegion" Width="400"/>
<ContentControl com:RegionManager.RegionName="NavigatorRegion" DockPanel.Dock="Left" Width="200" />
</DockPanel>
</Window>کد کلاس ViewModelBase که فقط اینترفیس INotifyPropertyChanged رو پیاده سازی کرده است:
using System.ComponentModel;
namespace FirstPrismSample.Common
{
public abstract class ViewModelBase : INotifyPropertyChanged
{
public event PropertyChangedEventHandler PropertyChanged;
protected void RaisePropertyChangedEvent( string propertyName )
{
if ( PropertyChanged != null )
{
PropertyChangedEventArgs e = new PropertyChangedEventArgs( propertyName );
PropertyChanged( this, e );
}
}
}
}using Microsoft.Practices.Composite.Presentation.Events;
namespace FirstPrismSample.Common.Events
{
public class ViewRequestedEvent : CompositePresentationEvent<string>
{
}
}namespace FirstPrismSample .Common
{
public interface IModuleServices
{
void ActivateView(string viewName);
}
}using Microsoft.Practices.Composite.Regions;
using Microsoft.Practices.Unity;
namespace FirstPrismSample.Common
{
public class ModuleServices : IModuleServices
{
private readonly IUnityContainer m_Container;
public ModuleServices(IUnityContainer container)
{
m_Container = container;
}
public void ActivateView(string viewName)
{
var regionManager = m_Container.Resolve<IRegionManager>();
// غیر فعال کردن ویو
IRegion workspaceRegion = regionManager.Regions["WorkspaceRegion"];
var views = workspaceRegion.Views;
foreach (var view in views)
{
workspaceRegion.Deactivate(view);
}
//فعال کردن ویو انتخاب شده
var viewToActivate = regionManager.Regions["WorkspaceRegion"].GetView(viewName);
regionManager.Regions["WorkspaceRegion"].Activate(viewToActivate);
}
}
}<UserControl x:Class="FirstPrismSample.ModuleCategory.CategoryView "
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Background="LightGray" FlowDirection="RightToLeft" FontFamily="Tahoma">
<Grid>
<Grid.RowDefinitions>
<RowDefinition Height="Auto"/>
<RowDefinition Height="*"/>
</Grid.RowDefinitions>
<TextBlock Text=" طبقه بندی ها"/>
<ListView Grid.Row="1" Margin="10" Name="lvCategory">
<ListView.View>
<GridView>
<GridViewColumn Header="کد" Width="50" />
<GridViewColumn Header="عنوان" Width="200" />
</GridView>
</ListView.View>
</ListView>
</Grid>
</UserControl>using Microsoft.Practices.Composite.Events;
using Microsoft.Practices.Composite.Modularity;
using Microsoft.Practices.Composite.Regions;
using Microsoft.Practices.Unity;
using FirstPrismSample.Common;
using FirstPrismSample.Common.Events;
using Microsoft.Practices.Composite.Presentation.Events;
namespace FirstPrismSample.ModuleCategory
{
[Module(ModuleName = "ModuleCategory")]
public class CategoryModule : IModule
{
private readonly IUnityContainer m_Container;
private readonly string moduleName = "ModuleCategory";
public CategoryModule(IUnityContainer container)
{
m_Container = container;
}
~CategoryModule()
{
var eventAggregator = m_Container.Resolve<IEventAggregator>();
var viewRequestedEvent = eventAggregator.GetEvent<ViewRequestedEvent>();
viewRequestedEvent.Unsubscribe(ViewRequestedEventHandler);
}
public void Initialize()
{
var regionManager = m_Container.Resolve<IRegionManager>();
regionManager.Regions["WorkspaceRegion"].Add(new CategoryView(), moduleName);
var eventAggregator = m_Container.Resolve<IEventAggregator>();
var viewRequestedEvent = eventAggregator.GetEvent<ViewRequestedEvent>();
viewRequestedEvent.Subscribe(this.ViewRequestedEventHandler, true);
}
public void ViewRequestedEventHandler(string moduleName)
{
if (this.moduleName != moduleName) return;
var moduleServices = m_Container.Resolve<IModuleServices>();
moduleServices.ActivateView(moduleName);
}
}
}*برای تعریف ماژول کلاس مورد نظر حتما باید اینترفیس IModule را پیاده سازی کند. این اینترفیس فقط شامل یک متد است به نام Initialize.
*در این پروژه چون Viewهای برنامه صرفا جهت نمایش هستند در نتیجه نیاز به ایجاد ViewModel برای آنها نیست. در پروژه‌های اجرایی حتما برای هر View باید ViewModel متناظر با آن تهیه شود.
توضیح درباره متد Initialize
در این متد ابتدا با استفاده از Container موجود RegionManager را به دست می‌آوریم. با استفاده از RegionManager می‌تونیم یک CompositeUI طراحی کنیم. در فایل Shell مشاهده کردید که یک صفحه به دو ناحیه تقسیم شد و به هر ناحیه هم یک نام اختصاص دادیم. دستور زیر به یک ناحیه اشاره خواهد داشت:
regionManager.Regions["WorkspaceRegion"]
<UserControl x:Class="FirstPrismSample.ModuleBook.BookView"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Background="LightGray" FontFamily="Tahoma" FlowDirection="RightToLeft">
<Grid>
<Grid.RowDefinitions>
<RowDefinition Height="Auto"/>
<RowDefinition Height="*"/>
</Grid.RowDefinitions>
<TextBlock Text="لیست کتاب ها"/>
<ListView Grid.Row="1" Margin="10" Name="lvBook">
<ListView.View>
<GridView>
<GridViewColumn Header="کد" Width="50" />
<GridViewColumn Header="عنوان" Width="200" />
<GridViewColumn Header="نویسنده" Width="150" />
</GridView>
</ListView.View>
</ListView>
</Grid>
</UserControl>using Microsoft.Practices.Composite.Events;
using Microsoft.Practices.Composite.Modularity;
using Microsoft.Practices.Composite.Presentation.Events;
using Microsoft.Practices.Composite.Regions;
using Microsoft.Practices.Unity;
using FirstPrismSample.Common;
using FirstPrismSample.Common.Events;
namespace FirstPrismSample.ModuleBook
{
[Module(ModuleName = "moduleBook")]
public class BookModule : IModule
{
private readonly IUnityContainer m_Container;
private readonly string moduleName = "ModuleBook";
public BookModule(IUnityContainer container)
{
m_Container = container;
}
~BookModule()
{
var eventAggregator = m_Container.Resolve<IEventAggregator>();
var viewRequestedEvent = eventAggregator.GetEvent<ViewRequestedEvent>();
viewRequestedEvent.Unsubscribe(ViewRequestedEventHandler);
}
public void Initialize()
{
var regionManager = m_Container.Resolve<IRegionManager>();
var view = new BookView();
regionManager.Regions["WorkspaceRegion"].Add(view, moduleName);
regionManager.Regions["WorkspaceRegion"].Deactivate(view);
var eventAggregator = m_Container.Resolve<IEventAggregator>();
var viewRequestedEvent = eventAggregator.GetEvent<ViewRequestedEvent>();
viewRequestedEvent.Subscribe(this.ViewRequestedEventHandler, true);
}
public void ViewRequestedEventHandler(string moduleName)
{
if (this.moduleName != moduleName) return;
var moduleServices = m_Container.Resolve<IModuleServices>();
moduleServices.ActivateView(m_WorkspaceBName);
}
}
}<UserControl x:Class="FirstPrismSample.ModuleNavigator.NavigatorView"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
<Grid>
<StackPanel VerticalAlignment="Center">
<TextBlock Text="انتخاب ماژول" Foreground="Green" HorizontalAlignment="Center"
VerticalAlignment="Center" FontFamily="Tahoma" FontSize="24" FontWeight="Bold" />
<Button Command="{Binding ShowModuleCategory}" Margin="5" Width="125">طبقه بندی کتاب ها</Button>
<Button Command="{Binding ShowModuleBook}" Margin="5" Width="125">لیست کتاب ها</Button>
</StackPanel>
</Grid>
</UserControl>public interface INavigatorViewModel
{
ICommand ShowModuleCategory { get; set; }
ICommand ShowModuleBook { get; set; }
string ActiveWorkspace { get; set; }
IUnityContainer Container { get; set; }
event PropertyChangedEventHandler PropertyChanged;
}public class NavigatorViewModel : ViewModelBase, INavigatorViewModel
{
public NavigatorViewModel(IUnityContainer container)
{
this.Initialize(container);
}
public ICommand ShowModuleCategory { get; set; }
public ICommand ShowModuleBook { get; set; }
public string ActiveWorkspace { get; set; }
public IUnityContainer Container { get; set; }
private void Initialize(IUnityContainer container)
{
this.Container = container;
this.ShowModuleCategory = new ShowModuleCategoryCommand(this);
this.ShowModuleBook = new ShowModuleBookCommand(this);
this.ActiveWorkspace = "ModuleCategory";
}
}public class ShowModuleCategoryCommand : ICommand
{
private readonly NavigatorViewModel viewModel;
private const string workspaceName = "ModuleCategory";
public ShowModuleCategoryCommand(NavigatorViewModel viewModel)
{
this.viewModel = viewModel;
}
public bool CanExecute(object parameter)
{
return viewModel.ActiveWorkspace != workspaceName;
}
public event EventHandler CanExecuteChanged
{
add { CommandManager.RequerySuggested += value; }
remove { CommandManager.RequerySuggested -= value; }
}
public void Execute(object parameter)
{
CommandServices.ShowWorkspace(workspaceName, viewModel);
}
}public class ShowModuleBookCommand : ICommand
{
private readonly NavigatorViewModel viewModel;
private readonly string workspaceName = "ModuleBook";
public ShowModuleBookCommand( NavigatorViewModel viewModel )
{
this.viewModel = viewModel;
}
public bool CanExecute( object parameter )
{
return viewModel.ActiveWorkspace != workspaceName;
}
public event EventHandler CanExecuteChanged
{
add { CommandManager.RequerySuggested += value; }
remove { CommandManager.RequerySuggested -= value; }
}
public void Execute( object parameter )
{
CommandServices.ShowWorkspace( workspaceName , viewModel );
}
}public static void ShowWorkspace(string workspaceName, INavigatorViewModel viewModel)
{
var eventAggregator = viewModel.Container.Resolve<IEventAggregator>();
var viewRequestedEvent = eventAggregator.GetEvent<ViewRequestedEvent>();
viewRequestedEvent.Publish(workspaceName);
viewModel.ActiveWorkspace = workspaceName;
}xcopy "$(TargetDir)FirstPrismSample.ModuleBook.dll" "$(SolutionDir)FirstPrismSample\bin\$(ConfigurationName)\Modules\" /Y
public class Bootstrapper : UnityBootstrapper
{
protected override void ConfigureContainer()
{
base.ConfigureContainer();
Container.RegisterType<IModuleServices, ModuleServices>();
}
protected override DependencyObject CreateShell()
{
var shell = new Shell();
shell.Show();
return shell;
}
protected override IModuleCatalog GetModuleCatalog()
{
var catalog = new DirectoryModuleCatalog();
catalog.ModulePath = @".\Modules";
return catalog;
}
}"$(SolutionDir)FirstPrismSample\bin\$(ConfigurationName)\Modules\" /Y
public partial class App : Application
{
protected override void OnStartup(StartupEventArgs e)
{
base.OnStartup(e);
var bootstrapper = new Bootstrapper();
bootstrapper.Run();
}
}
public class Column<T>
{
public string Name { set; get; }
public T Data { set; get; }
}
IList<Column<T>> myList = new List<Column<T>>();
using System.Collections;
namespace Tests
{
public interface IColumn
{
string Name { set; get; }
object Data { set; get; }
}
public class Column<T> : IColumn
{
public string Name { set; get; }
public T Data { set; get; }
object IColumn.Data
{
get { return this.Data; }
set { this.Data = (T)value; }
}
}
}
var myList = new List<IColumn>();
var myList = new List<IColumn>
{
new Column<int> { Data = 1, Name = "Col1"},
new Column<double> { Data = 1.2, Name = "Col2"}
};
static T GetColumnData<T>(IList<IColumn> list, string name)
{
var column = (Column<T>)Convert.ChangeType(list.Single(s => s.Name.Equals(name)), typeof(Column<T>), null);
return column.Data;
}
int data = GetColumnData<int>(myList, "Col1");
<#@ template debug="false" hostspecific="false" language="C#" #> <#@ output extension=".txt" #> <# var T = DateTime.Now; #> The Time is : <#= T #> The Time is : <#= DateTime.Now #>
<#@ template debug="true" hostspecific="false" language="C#" #>
<#@ output extension=".cs" #>
using System;
using System.Text;
<# string ClassName = "DotnetTips"; #>
public class <#= ClassName + "_" + new MyTestClass().Str #>
{
}
<#+
public class MyTestClass
{
public string Str { get{return new DateTime().DayOfWeek.ToString() ;} }
}
#> using System;
using System.Text;
public class DotnetTips_Monday
{
} به عنوان یک مثال ساده دیگر برای فهم بیشتر به کد زیر جهت تولید Table در Html توجه کنید:
<#@ template debug="false" hostspecific="false" language="C#" #>
<#@ output extension=".html" #>
<html><body>
<table>
<# for (int i = 1; i <= 10; i++)
{ #>
<tr>
<td>Test name <#= i #> </td>
<td>Test value <#= i * i #> </td>
</tr>
<# } #>
</table>
</body></html> Install-Package Microsoft.Extensions.Caching.StackExchangeRedis
public interface IResponseCacheService
{
Task CacheResponseAsync(string cacheKey, object response, TimeSpan timeToLive);
Task<string> GetCachedResponseAsync(string cacheKey);
} public class ResponseCacheService : IResponseCacheService, ISingletonDependency
{
private readonly IDistributedCache _distributedCache;
public ResponseCacheService(IDistributedCache distributedCache)
{
_distributedCache = distributedCache;
}
public async Task CacheResponseAsync(string cacheKey, object response, TimeSpan timeToLive)
{
if (response == null) return;
var serializedResponse = JsonConvert.SerializeObject(response);
await _distributedCache.SetStringAsync(cacheKey, serializedResponse, new DistributedCacheEntryOptions
{
AbsoluteExpirationRelativeToNow = timeToLive
});
}
public async Task<string> GetCachedResponseAsync(string cacheKey)
{
var cachedResponse = await _distributedCache.GetStringAsync(cacheKey);
return string.IsNullOrWhiteSpace(cachedResponse) ? null : cachedResponse;
}
} public class RedisCacheSettings
{
public bool Enabled { get; set; }
public string ConnectionString { get; set; }
public int DefaultSecondsToCache { get; set; }
} "RedisCacheSettings": {
"Enabled": true,
"ConnectionString": "192.168.1.107:6379,ssl=False,allowAdmin=True,abortConnect=False,defaultDatabase=0,connectTimeout=500,connectRetry=3",
"DefaultSecondsToCache": 600
}, public class CacheInstaller : IServiceInstaller
{
public void InstallServices(IServiceCollection services, AppSettings appSettings, Assembly startupProjectAssembly)
{
var redisCacheService = appSettings.RedisCacheSettings;
services.AddSingleton(redisCacheService);
if (!appSettings.RedisCacheSettings.Enabled) return;
services.AddStackExchangeRedisCache(options =>
options.Configuration = appSettings.RedisCacheSettings.ConnectionString);
// Below code applied with ISingletonDependency Interface
// services.AddSingleton<IResponseCacheService, ResponseCacheService>();
}
} [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
public class CachedAttribute : Attribute, IAsyncActionFilter
{
private readonly int _secondsToCache;
private readonly bool _useDefaultCacheSeconds;
public CachedAttribute()
{
_useDefaultCacheSeconds = true;
}
public CachedAttribute(int secondsToCache)
{
_secondsToCache = secondsToCache;
_useDefaultCacheSeconds = false;
}
public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
{
var cacheSettings = context.HttpContext.RequestServices.GetRequiredService<RedisCacheSettings>();
if (!cacheSettings.Enabled)
{
await next();
return;
}
var cacheService = context.HttpContext.RequestServices.GetRequiredService<IResponseCacheService>();
// Check if request has Cache
var cacheKey = GenerateCacheKeyFromRequest(context.HttpContext.Request);
var cachedResponse = await cacheService.GetCachedResponseAsync(cacheKey);
// If Yes => return Value
if (!string.IsNullOrWhiteSpace(cachedResponse))
{
var contentResult = new ContentResult
{
Content = cachedResponse,
ContentType = "application/json",
StatusCode = 200
};
context.Result = contentResult;
return;
}
// If No => Go to method => Cache Value
var actionExecutedContext = await next();
if (actionExecutedContext.Result is OkObjectResult okObjectResult)
{
var secondsToCache = _useDefaultCacheSeconds ? cacheSettings.DefaultSecondsToCache : _secondsToCache;
await cacheService.CacheResponseAsync(cacheKey, okObjectResult.Value,
TimeSpan.FromSeconds(secondsToCache));
}
}
private static string GenerateCacheKeyFromRequest(HttpRequest httpRequest)
{
var keyBuilder = new StringBuilder();
keyBuilder.Append($"{httpRequest.Path}");
foreach (var (key, value) in httpRequest.Query.OrderBy(x => x.Key))
{
keyBuilder.Append($"|{key}-{value}");
}
return keyBuilder.ToString();
}
} [Cached]
[HttpGet]
public IActionResult Get()
{
var rng = new Random();
var weatherForecasts = Enumerable.Range(1, 5).Select(index => new WeatherForecast
{
Date = DateTime.Now.AddDays(index),
TemperatureC = rng.Next(-20, 55),
Summary = Summaries[rng.Next(Summaries.Length)]
})
.ToArray();
return Ok(weatherForecasts);
} using System.Collections.Generic;
namespace Refactoring.Day2.ExtractMethod.After
{
public class Receipt
{
private IList<decimal> _discounts;
private IList<decimal> _itemTotals;
public decimal CalculateGrandTotal()
{
_discounts = new List<decimal> { 0.1m };
_itemTotals = new List<decimal> { 100m, 200m };
decimal subTotal = CalculateSubTotal();
subTotal = CalculateDiscounts(subTotal);
subTotal = CalculateTax(subTotal);
return subTotal;
}
private decimal CalculateTax(decimal subTotal)
{
decimal tax = subTotal * 0.065m;
subTotal += tax;
return subTotal;
}
private decimal CalculateDiscounts(decimal subTotal)
{
if (_discounts.Count > 0)
{
foreach (decimal discount in _discounts)
subTotal -= discount;
}
return subTotal;
}
private decimal CalculateSubTotal()
{
decimal subTotal = 0m;
foreach (decimal itemTotal in _itemTotals)
subTotal += itemTotal;
return subTotal;
}
}
}
using System.Collections.Generic;
namespace Refactoring.Day3.ExtractMethodObject.After
{
public class Receipt
{
public IList<decimal> Discounts { get; set; }
public decimal Tax { get; set; }
public IList<decimal> ItemTotals { get; set; }
public decimal CalculateGrandTotal()
{
return new ReceiptCalculator(this).CalculateGrandTotal();
}
}
}
using System.Collections.Generic;
namespace Refactoring.Day3.ExtractMethodObject.After
{
public class ReceiptCalculator
{
Receipt _receipt;
public ReceiptCalculator(Receipt receipt)
{
_receipt = receipt;
}
public decimal CalculateGrandTotal()
{
decimal subTotal = CalculateSubTotal();
subTotal = CalculateDiscounts(subTotal);
subTotal = CalculateTax(subTotal);
return subTotal;
}
private decimal CalculateTax(decimal subTotal)
{
decimal tax = subTotal * _receipt.Tax;
subTotal += tax;
return subTotal;
}
private decimal CalculateDiscounts(decimal subTotal)
{
if (_receipt.Discounts.Count > 0)
{
foreach (decimal discount in _receipt.Discounts)
subTotal -= discount;
}
return subTotal;
}
private decimal CalculateSubTotal()
{
decimal subTotal = 0m;
foreach (decimal itemTotal in _receipt.ItemTotals)
subTotal += itemTotal;
return subTotal;
}
}
}
public virtual async Task<ClaimsPrincipal> CreateAsync(TUser user)
public override async Task<ClaimsPrincipal> CreateAsync(User user)
{
var principal = await base.CreateAsync(user).ConfigureAwait(false);
addCustomClaims(user, principal);
return principal;
}
private static void addCustomClaims(User user, IPrincipal principal)
{
((ClaimsIdentity) principal.Identity).AddClaims(new[]
{
new Claim(ClaimTypes.NameIdentifier, user.Id.ToString(), ClaimValueTypes.Integer),
new Claim(ClaimTypes.GivenName, user.FirstName ?? string.Empty),
new Claim(ClaimTypes.Surname, user.LastName ?? string.Empty),
new Claim(PhotoFileName, user.PhotoFileName ?? string.Empty, ClaimValueTypes.String),
});
} services.AddScoped<IUserClaimsPrincipalFactory<User>, ApplicationClaimsPrincipalFactory>(); services.AddScoped<UserClaimsPrincipalFactory<User, Role>, ApplicationClaimsPrincipalFactory>();
services.AddScoped<IPrincipal>(provider =>
provider.GetService<IHttpContextAccessor>()?.HttpContext?.User ?? ClaimsPrincipal.Current); public static string FindFirstValue(this ClaimsIdentity identity, string claimType)
{
return identity?.FindFirst(claimType)?.Value;
}
public static string GetUserClaimValue(this IIdentity identity, string claimType)
{
var identity1 = identity as ClaimsIdentity;
return identity1?.FindFirstValue(claimType);
} @User.Identity.GetUserDisplayName()
// reflect the changes, in the current user's Identity cookie await _signInManager.RefreshSignInAsync(user).ConfigureAwait(false);
PM> Install-Package DNTFrameworkCore -Version 1.0.0
مثال اول: یک موجودیت ساده بدون نیاز به مباحث ردیابی تغییرات
public class MeasurementUnit : Entity<int>, IAggregateRoot
{
public const int MaxTitleLength = 50;
public const int MaxSymbolLength = 50;
public string Title { get; set; }
public string NormalizedTitle { get; set; }
public string Symbol { get; set; }
public byte[] RowVersion { get; set; }
} کلاس جنریک Entity، در برگیرنده یکسری اعضای مشترک بین سایر موجودیت‌های سیستم از جمله Id و TrackingState (به منظور سناریوهای Master-Detail)، می‌باشد.
نکته: در این زیرساخت برای پیاده سازی CrudService برای یک موجودیت خاص، نیاز است تا واسط IAggregateRoot را نیز پیاده سازی کرده باشد. برای پیاده سازی واسط مذکور نیاز است تا خصوصیت RowVersion را به منظور مدیریت Optimistic مباحث همزمانی، به کلاس بالا اضافه کنیم. این موضوع برای موجودیت‌های وابسته به یک Aggregate ضروری نیست، چرا که آنها با AggregateRoot ذخیره خواهند شد و تراکنش جدایی برای ثبت، ویرایش و یا حذف آنها وجود ندارد.
مثال دوم: یک موجودیت به همراه مباحث ردیابی تغییرات ثبت و آخرین ویرایش
public class Blog : TrackableEntity<long>, IAggregateRoot
{
public const int MaxTitleLength = 50;
public const int MaxUrlLength = 50;
public string Title { get; set; }
public string NormalizedTitle { get; set; }
public string Url { get; set; }
public byte[] RowVersion { get; set; }
} کلاس جنریک TrackableEntity علاوه بر خصوصیات Id و TrackingState، یکسری خصوصیت دیگر از جمله زمان ثبت، زمان آخرین ویرایش، شناسه کاربر ثبت کننده، شناسه آخرین کاربر ویرایش کننده، اطلاعات مرورگرهای آنها و ... را نیز دارا می‌باشد. این خصوصیات به صورت خودکار توسط زیرساخت مقداردهی خواهند شد.
مثال سوم: یک موجودیت به همراه مباحث ردیابی تغییرات ثبت، آخرین ویرایش و حذف نرم
public class Blog : FullTrackableEntity<long>, IAggregateRoot
{
public const int MaxTitleLength = 50;
public const int MaxUrlLength = 50;
public string Title { get; set; }
public string NormalizedTitle { get; set; }
public string Url { get; set; }
public byte[] RowVersion { get; set; }
} کلاس جنریک FullTrackableEntity علاوه بر خصوصیات ذکر شده در مثال دوم، یکسری خصوصیت دیگر از جمله IsDeleted، شناسه کاربر حذف کننده، زمان حذف و ... را نیز دارا می‌باشد. همچنین مباحث فیلتر خودکار رکوردهای حذف شده، به صورت خودکار توسط زیرساخت انجام میگیرد که امکان غیرفعال کردن آن در شرایط مورد نیاز نیز وجود دارد.
مثال چهارم: یک موجودیت با پشتیبانی از چند مستاجری
public class Blog : Entity<long>, IAggregateRoot, ITenantEntity
{
public const int MaxTitleLength = 50;
public const int MaxUrlLength = 50;
public string Title { get; set; }
public string NormalizedTitle { get; set; }
public string Url { get; set; }
public byte[] RowVersion { get; set; }
public long TenantId { get; set; }
} با پیاده سازی واسط ITenantEntity، به صورت خودکار خصوصیت TenantId آن با توجه به اطلاعات مستاجر جاری سیستم مقداردهی خواهد شد و همچنین فیلتر خودکار بر روی رکوردهای مستاجرهای مختلف، توسط زیرساخت انجام میشود که این مکانیزم هم قابلیت غیرفعال شدن در شرایط خاص را دارد.
مثال پنجم: یک موجودیت به همراه تعدادی موجودیت جزئی (سناریوهای Master-Detail)
public class Invoice : TrackableEntity<long>, IAggregateRoot
{
public InvoiceStatus Status { get; set; }
public decimal TotalNet { get; set; }
public decimal Total { get; set; }
public decimal PayableTotal { get; set; }
public decimal Debit { get; set; }
public decimal Credit { get; set; }
public decimal Gratuity { get; set; }
public byte[] RowVersion { get; set; }
public ICollection<InvoiceItem> Items { get; set; }
}
public class InvoiceItem : TrackableEntity
{
public int Quantity { get; set; }
public decimal UnitPrice { get; set; }
public decimal Price { get; set; }
public decimal UnitPriceDiscount { get; set; }
public long ItemId { get; set; }
public Item Item { get; set; }
public long InvoiceId { get; set; }
public Invoice Invoice { get; set; }
} همانطور که مشخص می‌باشد، موجودیت وابسته یا همان Detail، نیاز به پیاده سازی IAggregateRoot را نخواهد داشت. همانطور که اشاره شد، تراکنش مجزایی برای این موجودیت‌ها نخواهیم داشت و درون تراکنش AggregateRoot، عملیات CRUD آنها انجام خواهد شد و برای انجام عملیات ویرایش، به همراه Root متناظر با خود، واکشی خواهند شد. این موضوع یکی از نقاط قوت زیرساخت محسوب میشود که در مقالات آینده و در قسمت طراحی سرویس‌های متناظر با موجودیت‌های سیستم، با جزئیات بیشتری بررسی خواهد شد.
مثال ششم: یک موجودیت با امکان شماره گذاری خودکار
public class Task : TrackableEntity, IAggregateRoot, INumberedEntity
{
public const int MaxTitleLength = 256;
public const int MaxDescriptionLength = 1024;
public string Title { get; set; }
public string NormalizedTitle { get; set; }
public string Number { get; set; }
public string Description { get; set; }
public TaskState State { get; set; } = TaskState.Todo;
public byte[] RowVersion { get; set; }
} همانطور که در مطلب «طراحی و پیاده سازی زیرساختی برای تولید خودکار کد منحصر به فرد در زمان ثبت رکورد جدید» ملاحظه کردید، نیاز است تا موجودیت مورد نظر، پیاده ساز واسط INumberedEntity نیز باشد. این واسط دارای خصوصیت رشته‌ای Number می‌باشد و همچنین زیرساخت به صورت خودکار در زمان ثبت، این خصوصیت را برای موجودیت‌هایی از این نوع، با رعایت مباحث همزمانی مقداردهی می‌کند.
مثال هفتم: یک موجودیت با امکان ذخیره سازی اطلاعات اضافی در قالب فیلد JSON
public class Task : TrackableEntity, IAggregateRoot, INumberedEntity, IExtendableEntity
{
public const int MaxTitleLength = 256;
public const int MaxDescriptionLength = 1024;
public string Title { get; set; }
public string NormalizedTitle { get; set; }
public string Number { get; set; }
public string Description { get; set; }
public TaskState State { get; set; } = TaskState.Todo;
public byte[] RowVersion { get; set; }
public string ExtensionJson { get; set; }
} با پیاده سازی واسط IExtendableEntity، یکسری متد الحاقی برروی اشیاء موجودیت مورد نظر فعال خواهند شد که امکان مقداردهی یا خواندن این اطلاعات اضافی را خواهید داشت. به عنوان مثال:
var task = new Task();
task.SetExtensionValue("Name","Value");
var value = task.ReadExtensionValue("Name");
//or any complex object as string json با دو متد الحاقی استفاده شده در بالا، امکان مقداردهی، تغییر و خواندن مقدار خصوصیت‌های اضافی را خواهیم داشت که نیاز است موجودیت مورد نظر در دل خود نگهداری کند ولی ارزش و اهمیت زیادی در Domain ندارند.
مثال هشتم: طراحی یک نوع شمارشی (Enum)
public class OrderStatus : Enumeration
{
public static OrderStatus Submitted = new OrderStatus(1, nameof(Submitted).ToLowerInvariant());
public static OrderStatus AwaitingValidation = new OrderStatus(2, nameof(AwaitingValidation).ToLowerInvariant());
public static OrderStatus StockConfirmed = new OrderStatus(3, nameof(StockConfirmed).ToLowerInvariant());
public static OrderStatus Paid = new OrderStatus(4, nameof(Paid).ToLowerInvariant());
public static OrderStatus Shipped = new OrderStatus(5, nameof(Shipped).ToLowerInvariant());
public static OrderStatus Cancelled = new OrderStatus(6, nameof(Cancelled).ToLowerInvariant());
protected OrderStatus()
{
}
public OrderStatus(int id, string name)
: base(id, name)
{
}
} برای سناریوهایی که صرفا قصد انتخاب یک یا چند (حالت enum flags) مورد از بین یک لیست مشخص و سپس ذخیره سازی آنها را دارید، استفاده از نوع داده enum کفایت می‌کند؛ ولی اگر قصد استفاده از آنها برای flow control را دارید، در این صورت به طراحی شکننده‌ای خواهید رسید که پر شده است از if/else هایی که مقادیر مختلف enum مورد نظر را بررسی می‌کنند. با استفاده از کلاس Enumeration امکان مدل کردن انوع شمارشی که مرتبط هستند با منطق تجاری سیستم را با راه حل شیء گرا خواهید داشت. در این صورت رفتارهای متناظر با هریک از فیلدهای یک نوع شمارشی می‌تواند به عنوان رفتاری در دل خود کپسوله شده باشد و اینبار داده و رفتار کنار هم خواهند بود.
نکته: برای مطالعه بیشتر میتوانید به مطالب ^ و ^ مراجعه کنید.
در نهایت میتوانید برای سناریوهای خاص خودتان از سایر واسط های موجود در زیرساخت، نیز به شکل زیر استفاده کنید:
نیاز به حذف نرم بدون نگهداری اطلاعات ردیابی تغییرات
public interface ISoftDeleteEntity
{
bool IsDeleted { get; set; }
} .با پیاده سازی واسط بالا این امکان را خواهید داشت که صرفا از مکانیزم حذف نرم استفاده کنید؛ بدون نیاز به نگهداری سایر اطلاعات
نیاز به مقداردهی خودکار زمان ثبت یک موجودیت خاص
این امر با پیاده سازی واسط زیر امکان پذیر خواهد بود.
public interface IHasCreationDateTime
{
DateTimeOffset CreationDateTime { get; set; }
} با توجه به اعمال اصل ISP در مباحث مطرح شده در مطلب جاری، بنا به نیاز خود از این واسط‌ها و کلاس‌های پایه پیاده ساز آنها میتوانید استفاده کنید.