در قسمتهای پیشین (
^ ،
^
) در مورد عملیات CRUD در سطح دیتابیس و به طور کلی در مورد ایندکس گذاری
صحبت کردیم. در این بخش قصد داریم یکی از موارد بسیار مهم، یعنی ذخیرهی فایلهای
باینری را در دیتابیس، مورد بررسی قرار دهیم. روشهای مختلفی برای اینکار
وجود دارند؛ ولی بعضی از این روشها در حال حاضر منسوخ شده اعلام شدهاند که در
اینجا ما آخرین روش را که در حال حاضر هیچ ویژگی منسوخ شدهای ندارد، به
کار میگیریم.
از آنجاکه نهایت اندازهی یک سند BSON نمیتواند بیشتر از 16 مگابایت باشد،
قابلیتی به نام GridFS ایجاد شدهاست تا بتوان فایلهای باینری را در آن
ذخیره کرد. GridFS شامل دو بخش مختلف برای ذخیره اطلاعات یک فایل باینری
است:
-
fs.chunks که برای ذخیره اطلاعات قطعههای یک فایل باینری به کار میرود.
-
fs.files که برای ذخیره اطلاعات و متادیتاها به کار میرود.
قبل از هر چیزی باید بدانید که کتابخانه مربوط به GridFs در یک پکیج جداگانه عرضه شده است و باید آن از طریق
nuget نصب کنیم:
install-package MongoDB.Driver.GridFS
برای آپلود یک فایل باینری به داخل سیستم از کد زیر استفاده میکنیم:
var client = new MongoClient();
var db = client.GetDatabase("publisher");
IGridFSBucket bucket = new GridFSBucket(db);
ابتدا یک شیء GridFsBucket را ایجاد میکنیم که از ما اطلاعات دیتابیس مورد نظر را
برای ارسال فایل میخواهد و نتیجهی آن یک کلاس از جنس اینترفیس
IGridFSBucket میباشد. این باکت یا سطل در واقع همانند کالکشن رفتار
میکند.
byte[] source=File.ReadAllBytes(@"D:\Untitled.png");
var options = new GridFSUploadOptions
{
ChunkSizeBytes = 64512, // 63KB
Metadata = new BsonDocument
{
{ "CoverType", "Front" },
{ "copyrighted", true }
}
};
در مرحله بعد فایل باینری را به صورت آرایهای از بایتها میخوانیم (البته
حالتهای مختلفی چون استریم را نیز پشتیبانی میکند). بعد از خواندن فایل،
یک شیء از جنس کلاس GridFSUploadOptions را ایجاد و اطلاعات فایل آپلودی را
مشخص میکنیم. به عنوان مثال اولین خصوصیتی که پر میکنیم خصوصیت تعیین سایز
قطعات فایل باینری میباشد که به طور پیشفرض بر روی 64 مگابایت قرار گرفته
است و عموما هم برای اکثر موارد، پاسخگوی نیازها است (در بخش بعدی مقالات، بیشتر
این مورد را بررسی میکنیم).
مورد دومی که مقداردهی شدهاست، متادیتاها هستند و این قابلیت را داریم که
پرس و جوی خود را بر اساس آنها نیز فیلتر کنیم. این خصوصیت مقدار دریافتی
از جنس BsonDocument را دریافت میکند. ولی اگر شما برای فایل خود، کلاس اختصاصی
برای متادیتاها در نظر گرفتهاید میتوانید از یک Extension Method به نام
ToBsonDocument استفاده کنید و شیء خود را به این نوع تبدیل کنید:
var options = new GridFSUploadOptions
{
ChunkSizeBytes = 64512, // 63KB
Metadata = metaData.ToBsonDocument()
};
در نهایت آن را آپلود میکنیم:
var id = bucket.UploadFromBytes("GoneWithTheWind", source, options);
پارامتر اول آن، نامی برای بسته آپلودی است. پارامتر دوم، خود فایل آپلودی
میباشد و با پارمتر آخر هم تنظیماتی را که برای فایل مورد نظر توسط کلاس
GridFSUploadOptions تعیین کردهایم، مشخص میکنیم. موقعیکه آپلود انجام
شود، به ازای این کد، یک شناسهی اختصاصی از جنس ObjectId را دریافت میکنیم که
میتوانیم آن را به یک خصوصیت در سند اصلی نسبت دهیم تا ارتباط بین سند و
فایل هایش را داشته باشیم.
نکته: اگر در یک کلاس، چند فیلد از جنس ObjectId دارید، مونگو در بین تشخیص
شناسه اصلی سند و شناسه تصاویر، با توجه به نام خصوصیتها و غیره، تا حد
زیادی هوشمند عمل میکند. ولی اگر خواستید صریحا شناسه اصلی را ذکر کنید و آن
را متمایز از بقیه نشان دهید، میتوانید از خصوصیت BsonId در بالای نام
فیلد ID استفاده کنید:
[BsonId]
public ObjectId Id { get; set; }
جهت خواندن فایل آپلود شده، تنها کافی است از طریق شناسهی دریافتی در مرحلهی آپلود، اقدام نماییم:
var bytes = bucket.DownloadAsBytes(id);
نکته:
تمام متدهای آپلود و دانلود دیتا، هم به صورت آرایه ای از بایتها و هم به
صورت استریم میتوانند مورد استفاده قرار بگیرند و به ازای هر کدام، متدهای
همزمان و غیرهمزمان نیز موجود هستند.
اگر قصد دارید بر اساس نام داده شده، فایل را دریافت کنید، ممکن است که
چندین فایل، تحت یک نام ذخیره شده باشند که میتوانید در حالتهای مختلفی این
تصاویر را واکشی نمایید:
0 : فایل اصلی
1: اولین نسخه فایل
2: دومین نسخه فایل
و الی آخر...
1-: جدیدترین نسخه فایل (مقدار پیش فرض)
2-: نسخه ماقبل جدیدترین نسخه فایل
و الی آخر...
منظور از نسخه، فایلهایی با نامی موجود و از قبل ذخیره شده هستند که نسخه جدیدی از فایل قبلی بوده و فایل اول، فایل اصلی محسوب میشود.
برای درک بهتر مسئله، من تصاویر زیر را به ترتیب از سمت راست به سمت چپ، تحت یک نام، وارد سیستم میکنم:
اولین تصویر، تصویر اصلی محسوب میشود و بعد از آن، نسخه اول و نسخه دوم
تصویر، وارد سیستم میشوند و تکه کد زیر از آنجاکه با مقدار پیش فرض پر شدهاست باید آخرین تصویر، تصویر سمت چپ را برای شما بر روی دیسک ذخیره کند:
var client = new MongoClient();
var db = client.GetDatabase("publisher");
IGridFSBucket bucket = new GridFSBucket(db);
var image=bucket.DownloadAsBytesByName("City of Glass-cover");
File.WriteAllBytes(@"D:\a.jpg",image);
برای مقداردهی خواص بالا به شکل زیر عمل میکنیم:
var client = new MongoClient();
var db = client.GetDatabase("publisher");
IGridFSBucket bucket = new GridFSBucket(db);
var options = new GridFSDownloadByNameOptions
{
Revision = 0
};
var image=bucket.DownloadAsBytesByName("City of Glass-cover",options);
File.WriteAllBytes(@"D:\a.jpg",image);
با پاس کردن مقدار 0 به مونگو، اولین تصویر وارد شده، یعنی تصویر اصلی را
دریافت میکنیم که اولین تصویر از سمت راست میشود. اگر مقادیر 1 یا 1- را
پاس دهیم، چون تنها سه تصویر بیشتر نیست، در هر دو حالت تصویر دوم بازگردانده
میشود.
برای بازگردانی تصاویر از طریق مقادیر موجود در متادیتا، باید از کلاس ویژهای به نام GridFSFileInfo استفاده کنیم. در اینجا هم همانند روزهای اول، از
کلاس بیلدر جهت ایجاد شرط استفاده میکنیم:
var client = new MongoClient();
var db = client.GetDatabase("publisher");
IGridFSBucket bucket = new GridFSBucket(db);
var filter = Builders<GridFSFileInfo>.Filter.Gte(x => x.Length , 600);
var sort = Builders<GridFSFileInfo>.Sort.Descending(x => x.UploadDateTime);
var options =new GridFSFindOptions()
{
Limit = 3,
Sort = sort
};
var cursor = bucket.Find(filter, options);
var list = cursor.ToList();
در اینجا ابتدا مشخص کردهایم که فایل مورد نظر باید حجمی بیشتر از 600
بایت داشته باشد و مرتب سازی آن به صورت نزولی، بر اساس زمان آپلود باشد. در
عبارت لامبدا تعریف شده، میتوانید خصوصیتهای مختلف یک فایل از قبیل
نام، حجم (سایز) ، زمان آپلود و ... را ببینید. سپس مرتب سازی و
تعداد رکورد برگشتی از ابتدای جدول را مشخص میکنیم و از متد Find یا
FindAsync جهت جستوجو استفاده میکنیم. با شکل گرفتن کوئری درخواست، لیستی
از آن را تهیه میکنیم. مقدار بازگشتی این شیء، در واقع اسنادی از تصاویر
هستند که میتوانید از طریق Id یا نام آنها، فایل اصلی را واکشی نمایید.
برای یافتن تصاویر بر اساس متادیتاهای تعریف شده، از کد زیر استفاده میکنیم:
var filter = Builders<GridFSFileInfo>.Filter.Eq("metadata.CoverType","Front");
تغییر نام تصاویر
جهت ویرایش یک نام فایل از طریق متدهای زیر اقدام مینماییم:
bucket.Rename(id, newFilename);
//یا در حالت غیرهمزمان
await bucket.RenameAsync(id, newFilename);
حذف تصویر bucket.Delete(id);
//یا
await bucket.DeleteAsync(id);
برای حذف کل bucket از طریق کد زیر اقدام مینماییم:
bucket.Drop();
//یا
await bucket.DropAsync();
در بخش بعدی Chunk را مورد بررسی قرار میدهیم.