اگر تا بحال با بانک‌های NoSql کار کرده و لذت برده‌اید، به شما پیشنهاد میکنم حتما RavenDb را هم امتحان کنید، تا لذت استفاده از NoSql را چندین برابر حس کنید! RavenDb یک بانک اطلاعاتی NoSql از نوع DocumentStore است که به‌صورت متن باز توسعه داده میشود و مخزن کد آن در Github موجود است. از ویژگی‌های بارز RavenDb نسبت به سایر DocumentStoreها، Transactional بودن میباشد و در نسخه‌ی 4 بصورت کامل از Net Core. پشتیبانی میکند. برای آشنایی بیشتر با NoSql میتوانید از مقالات موجود در گروه NoSql استفاده کنید و برای آشنایی با RavenDb از دوره ای که در سایت وجود دارد استفاده نمایید(دوره مربوط به نسخه‌ی 3.5 میباشد).
از بارز‌ترین ویژگی‌های NoSqlها توانایی آنها در ذخیره‌ی اطلاعات، بدون توجه به اسکیمای آن هاست؛ پس هر نوع مدلی که ما برای ذخیره اطلاعات نرم افزار تعریف میکنیم، فقط برای درک بهتر ما هست و بس!
با این مقدمه مدل‌های زیر را برای شروع کار داریم:
Public Class User
{
public string Id { get; set; }
public string PhoneNumber { get; set; }
public Dictionary<string, App> Apps { get; set; }
}
public class App
{
public string FirstName { get; set; }
public string LastName { get; set; }
public string UserName { get; set; }
public List<string> Roles { get; set; }
public List<String> Messages { get; set; }
public String AdressId { get; set; }
public bool IsActive { get; set; } = true;
[JsonIgnore]
public string DisplayName => $"{FirstName} {LastName}";
} در این مدل، هر کاربر با یک شماره تماس میتواند در چندین برنامه ثبت شود و اطلاعات او در هر برنامه هم میتواند متفاوت باشد.
برای اتصال به RavenDb، به DocumentStore و برای ارسال درخواست‌ها به سمت سرور، به DocumentSession نیاز داریم. نمونه سازی DocumentStore هزینه‌بر بوده و باید در طی اجرای نرم افزار فقط یکبار(Singleton) نمونه سازی شود. DocumentSession بسیار سبک بوده و باید به ازای هر درخواست که به سمت سرور RavenDb ارسال میگردد یک بار نمونه سازی شده و بعد از آن نابود شود. پس برای استفاده در ASP.NET Core به این پیاده سازی در Startup میرسیم:
services.AddSingleton<IDocumentStore>(serviceProvider =>
{
var store = new DocumentStore()
{
Urls = new[] { "http://192.168.1.10:8080" },
Database = "AccountingSystem",
}.Initialize();
return store;
});
services.AddScoped<IAsyncDocumentSession>(serviceProvider =>
{
var store = serviceProvider.GetRequiredService<IDocumentStore>();
return store.OpenAsyncSession();
}); حال در تمام بخش‌های نرم افزار میتوانیم DocumentSession استفاده کنیم.
برای ذخیره سازی مدل در RavenDb از کد زیر استفاده میکنیم:
var user = new User
{
PhoneNumber = user.PhoneNumber
};
user.Apps.Add(appCode, new ActiveApp
{
FirstName = "عبدالصالح",
LastName = "کاشانی",
UserName = abdossaleh,
IsActive = true,
RolesId = new List<string>{"Admin"}
});
await _documentSession.StoreAsync(user);
await _documentSession.SaveChangesAsync() این ساده‌ترین کاری هست که میتوانیم انجام دهیم. بلافاصله بعد از استفاده از متد StoreAsync و بدون رفت و برگشتی به سرور، ویژگی Id برای user مقداردهی میشود و توضیح این رفتار هم پیشتر گفته شده است. با فراخوانی متد SaveChangesAsync تغییرات اتفاق افتاده در DocumentSession برای ذخیره سازی به سمت سرور ارسال می‌شوند. بله! الگوی Repository و UnitOfWork.
حال برای دریافت همین مدل، در صورتیکه Id آن را در اختیار داشته باشیم، از متد LoadAsync استفاده میکنیم.
var user = await _documentSession.LoadAsync<User>("Users/131-A"); Patching
به معنای تغییر دادن قسمتی از سند که شامل تغییر مقادیر، اضافه یا حذف یک ویژگی، ایجاد تغییرات در لیست و ... میباشد. با استفاده از متدهای Patch سند، میتوانیم بدون نیاز به لود سند و تغییر و ذخیره آن، قسمتی از سند را ویرایش کنیم. عملیات Patch، سمت سرور اجرا می‌شوند. برای مثال برای تغییر شماره تماس، از متد زیر استفاده میکنیم:
_documentSession.Advanced.Patch<User, string>("Users/131-A",
u => u.PhoneNumber
, "09131110000"); برای اضافه کردن یک آیتم به لیست، از Patch بصورت زیر استفاده میکنیم:
_documentSession.Advanced.Patch<User, string>("Users/131-A",
u => u.Apps["59"].RolesId
, r => r.Add("Admin")); _documentSession.Advanced.Increment<User, int>("Users/131-A", x => x.TestProp, 10);
_documentSession.Advanced.Defer(new PatchCommandData("Users/131-A", null,
new PatchRequest()
{
Script = $@"this.Apps[args.appCode] = args.app",
Values =
{
{"appCode", appCode},
{"app", new ActiveApp
{
FirstName = "عبدالصالح",
LastName = "کاشانی",
UserName = abdossaleh,
RolesId = new List<string>{"Admin"}
}
}
}
}, null)); Script = "this.Apps[args.app].Roles.splice(args.index,0,args.role)",
Values =
{
{
"index": 1 // مکانی که میخواهیم عملیات انجام شود
"app", 59
"role", "User"
}
} از همین روش میتوانیم برای ویرایش کردن یک آیتم هم استفاده کنیم. برای مثال اگر مقدار 0 را در متد splice به یک تغییر دهیم، عملیات ویرایش صورت میگیرد (در واقع حذف آیتم در مکان index و درج آیتم جدید در همان مکان):
splice(args.index,1,args.role)
Script = @"this.Roles= this.Apps[args.app].Roles.filter(role=> role != args.role);",
Values =
{
{"app", 59}
{"role", "User"}
} 
