I’ve started looking at using MediatR for my domain events implementations. To that end, I created a quick sample project using ASP.NET Core 2.0. Overall things were pretty easy to get going. If you haven’t used MediatR before, or if you’re looking for a quick intro on how to set it up for ASP.NET Core, keep reading (if not, how did you get here? Was the title not clear?).
·قسمتی از Application است که Domain Logic را پیاده سازی میکند.
·همچنین با عنوان Business Logic نیز شناخته میشود.
Public Class PersonModel
{
long Id{get;set;}
string Name{get;set;}
}Public Class PersonModel
{
long Id{get;set;}
string Name{get;set;}
int SavePerson(person p);
Person Finde(long personId);
}- تکرار داده‌ای که قرار هست ویرایش بشه. فرض کن که یک لینک از کارمند مورد نظر ایجاد شده با شماره پرسنلی که pk است. الان این لینک یاد داشت شده دیگه کار نمی‌کنه. این یک مثال ساده است. یا به روز رسانی تمام رکوردهای یک جدول با یک update که تریگر هم روش تعریف شده ممکنه مشکل ساز بشه یا اصلا کار نکنه.
- در ef هر موجودیت نیاز به یک کلید منحصربفرد داره برای شناسایی و از این کلید در سیستم ردیابی خودش استفاده می‌کنه. اگر این کلید قرار باشه تغییر کنه، ef نیاز داره تا یک وهله جدید رو خلق کنه و نمونه قبلی رو نابود. به این ترتیب عملکردش بهم می‌خوره و مجبور میشه رکورد جدید ثبت کنه بجای آپدیت قبلی. البته این کارها هم بدعتی نیست چون طراحی اون برای اساس اصول domain driven design انجام شده.
dotnet new --install DNTFrameworkCoreTemplateAPI::*
dotnet new dntcore-api
2- پروژه Infrastructure دربرگیرنده DbContext، مهاجرت‌ها و کلاس‌های تنظیمات نگاشت موجودیت‌ها به جداول بانک اطلاعاتی پروژه میباشد. به عنوان مثال، به صورت پیش‌فرض تنظیمات نگاشت موجودیت‌های کاربر و گروه‌کاربری و موجودیت‌های وابسته آنها در این قالب پیاده‌سازی شده‌اند. همچنین دو مهاجرت CreateInitialSchema و CreateIdentitySchema ایجاده شده‌اند.
3- پروژه Application دربرگیرنده مدل‌ها/DTOها، اعتبارسنج‌های مدل‌ها، سرویس‌ها و همچنین Eventهای سفارشی و Handlerهای رویدادهای متناظر با موجودیت‌های سیستم، میباشد. همانطور که شکل زیر ملاحظه می‌کنید، برای موجودیت‌های کاربر و گروه‌کاربری طراحی و پیاده‌سازی پیش‌فرضی از قسمت‌های مذکور ارائه شده است.
5- از پروژه Common نیز می‌توان به عنوان دربرگیرنده کلاس‌های کمکی مورد استفاده در سایر قسمت‌ها، بهره برد.
6- پروژه UnitTests دربرگیرده آزمون‌های واحد پروژه میباشد. به عنوان مثال، به صورت پیش‌فرض آزمون‌های واحد مرتبط با UserValidator و RoleValidator به صورت کامل در این قالب تدارک دیده شده است.
7- پروژه IntegrationTests دربرگیرنده آزمون‌های جامعیت مرتبط با پروژه میباشد. به عنوان مثال، آزمون‌های جامعیت متناظر با سرویس‌های کاربر و گروه‌کاربری نیز در این قالب تدارک دیده شده است.
نکته: بدلیل اینکه مکانیزم اعتبارسنجی خودکار ورودی‌ها به عنوان یک Aspect برروی این سرویس‌ها اعمال شده است و بدین ترتیب در فرآیند تست سرویس‌ها نیز دخالت دارند، به صورت ناخواسته به سمت آزمون جامعیت سوق پیدا کرده‌ایم. با این حال اگر برای لایه بالاتر/خارجی پروژه خود یا همان API در قالب، قصد تهیه آزمون جامعیت داشته باشید، میتوانید این تنظیمات ValidationInterceptor را از فایل ApplicationRegistry در پروژه Application حذف کرده و آزمون‌های سرویس‌ها را در قالب آزمون واحد انجام دهید. با این حال باید توجه کنید که برای برخی از سناریوها که امکانات هیچ کدام از مهیاکننده‌های InMemory و SQLite درون حافظه، جوابگوی نیاز شما نباشد، نیاز خواهید داشت تا از بانک اطلاعاتی واقعی از جمله LocalDb استفاده کنید؛ در این صورت آزمون‌های شما نیز در ردیف آزمون‌های جامعیت قرار خواهند داشت.
8- پروژه API دربرگیرنده کنترلرها، هاب‌های SignalR، زیرساخت Authentication مبتنی‌بر JWT و سایر تنظیمات آغازین پروژه، میباشد. CRUD API متناظر با موجودیت‌های کاربر و گروه‌کاربری نیز در این قالب تدارک دیده شده است.
کدهای کامل این قسمت را میتوانید از اینجا دریافت کنید.
<link href="Styles/bootstrap.min.css" rel="stylesheet" />
//برای نمایش و استفاده از جعبه‌ی رنگ در بوت استراپ
<link href="Styles/bootstrap-colorpalette.css" rel="stylesheet" />
<script src="Scripts/jquery-1.8.2.js"></script>
<script type="text/javascript" src='Scripts/jquery.signalR-1.1.3.js'></script>
<script src="Scripts/bootstrap.min.js"></script>
<script src="Scripts/bootstrap-colorpalette.js"></script>
<script type="text/javascript" src='<%: ResolveClientUrl("~/signalr/hubs") %>'></script>
//حاوی متدهایی برای رسم خط با استفاده از HTML5
<script src="Scripts/draw.js" type="text/javascript"></script>
//تعریف کلاینت‌های متصل به هاب
<script src="Scripts/Whiteboard.js"></script> using Microsoft.AspNet.SignalR;
using Microsoft.AspNet.SignalR.Hubs;
using OnlineSignalRWhiteboard.Model;
namespace OnlineSignalRWhiteboard.Hubs
{
[HubName("onWhiteboard")]
public class Whiteboard : Hub
{
public void OnDrawPen(Point prev, Point current, string color, int width)
{
Clients.All.drawPen(prev, current, color, width);
}
public void ClearBoard()
{
Clients.All.clear();
}
}
} $(function () {
$.connection.hub.logging = true;
var whiteboard = $.connection.onWhiteboard;
$("#clear").click(function () {
//پاک کردن صفحه نمایش
whiteboard.server.clearBoard();
});
var color = function (colors) {
//تغییر رنگ قلم
draw.colour = colors;
};
$(".size").click(function () {
//تغییر سایز قلم
draw.lineWidth = $(this).height();
$('#size').css('height', $(this).height());
});
$.connection.hub.start().done(function () {
})
.fail(function () {
alert("Could not Connect!");
});
draw.onDraw = function (prev, current, color, width) {
//ارسال پارامترها به سمت سرور تا سرور بتواند داده‌ها را به سمت سایر کلاینت‌ها نیز ارسال کند
whiteboard.server.onDrawPen(prev, current, color, width);
};
whiteboard.client.drawPen = function (prev, current, color, width) {
draw.drawPen(prev, current, color, width);
};
whiteboard.client.clear = function () {
draw.clear();
};
$('#colorpalette3').colorPalette()
.on('selectColor', function (e) {
$('#color').css('background-color', e.color);
color(e.color);
});
var canvas = document.getElementById('draw');
//تغییر سایر کانواس متناسب با پنجره‌ی مرورگر
window.addEventListener('resize', resizeCanvas, false);
function resizeCanvas() {
canvas.width = window.innerWidth - 20;
canvas.height = window.innerHeight - 70;
}
resizeCanvas();
}); <!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<link href="Styles/bootstrap.min.css" rel="stylesheet" />
<link href="Styles/bootstrap-colorpalette.css" rel="stylesheet" />
<script src="Scripts/jquery-1.8.2.js"></script>
<script type="text/javascript" src='Scripts/jquery.signalR-1.1.3.js'></script>
<script src="Scripts/bootstrap.min.js"></script>
<script src="Scripts/bootstrap-colorpalette.js"></script>
<script type="text/javascript" src='<%: ResolveClientUrl("~/signalr/hubs") %>'></script>
<script src="Scripts/draw.js" type="text/javascript"></script>
<script src="Scripts/Whiteboard.js"></script>
</head>
<body>
<form id="form1" runat="server">
<div>
<div style="position: static;">
<div>
<div>
<a data-toggle="collapse" data-target=".navbar-inverse-collapse">
<span></span>
<span></span>
<span></span>
</a>
<a href="#">تخته وایت برد آنلاین توسط SignalR و HTML5</a>
<div>
<ul>
<li>
<div>
<a id="selected-color2" data-toggle="dropdown">
<div style="width: 20px; height: 20px; background: black" id="color">
</div>
</a>
<ul style="width:293px;">
<li style="display:inline-block;">
<div>رنگ پس زمینه</div>
<div id="colorpalette3"></div>
</li>
</ul>
</div>
</li>
<li></li>
<li>
<div>
<a data-toggle="dropdown" style="width: 120px; height: 20px" href="#">
<hr style="width: 120px; height: 1px; background-color: black;margin: 0px; display: table-cell" id="size">
</a>
<ul style="width: 120px">
<li><hr style="width: 140px; height: 1px; background-color: black"></li>
<li></li>
<li><hr style="width: 140px; height: 3px; background-color: black"></li>
<li></li>
<li><hr style="width: 140px; height: 7px; background-color: black"></li>
<li></li>
<li><hr style="width: 140px; height: 10px; background-color: black"></li>
<li></li>
<li><hr style="width: 140px; height: 20px; background-color: black"></li>
</ul>
</div>
</li>
<li></li>
<li>
<div>
<a href="#" id="clear"><i></i>جدید</a>
</div>
</li>
</ul>
</div><!-- /.nav-collapse -->
</div>
</div><!-- /navbar-inner -->
</div>
</div>
<div>
<div>
<canvas id="draw" style="cursor: crosshair;border: 1px solid black;"></canvas>
</div>
</div>
</form>
</body>
</html> Domain Driven Design: The Good Parts
The greenfield project started out so promising. Instead of devolving into big ball of mud, the team decided to apply domain-driven design principles. Ubiquitous language, proper boundaries, encapsulation, it all made sense.
But along the way, something went completely and utterly wrong. It started with arguments on the proper way of implementing aggregates and entities. Arguments began over project and folder structure. Someone read a blog post that repositories are evil, and ORMs the devil incarnate. Another read that relational databases are last century, we need to store everything as a stream of events. Then came the actor model and frameworks that sounded like someone clearing their throat. Instead of a nice, clean architecture, the team chased the next new approach without ever actually shipping anything.
Beyond the endless technical arguments it causes, domain-driven design can actually produce great software. We have to look past the hype into the true value of DDD, what it can bring to our organizations and how it can enable us to build quality systems. With the advent of microservices, DDD is more important than ever - but only if we can get to the good parts.
