کتابخانه GMap.Net
سال گذشته بود که به بررسی کتابخانههای موجود برای دات نت که به ساخت نقشههای گوگل (+ ) میپردازند پرداختم. ولی مشکلی که وجود داشت، همه آنها در نهایت یک تصویر jpeg تحویل میدادند. ولی من میخواستم نقشهی من زنده و واکنشگرا باشد تا کاربر بتواند روی آن حرکت کند، زوم کند، مارکرها را جابجا کند و امکانات دیگری که در این نقشه در دسترس است را داشته باشد. برای همین شروع به ساخت یک class library کردم تا کاربر بتواند در محیط سی شارپ، تنظیمات را با اسامی قابل شناخت و یک intellisense قدرتمند بنویسد و در نهایت بر اساس اطلاعات کاربر، این کدها به صورت جاوا اسکریپت تولید شود. میتوانید سورس نهایی کتابخانهی GMap.Net را در گیت هاب، به همراه یک پروژهی نمونه ببینید.
پروژهی وابسته این کتابخانه، MS Ajax Minifier جهت کم حجم کردن کدهای جاوا اسکریپت است. در مورد این کتابخانه در سایت جاری بحث شده است.
برای نصب این کتابخانه میتوانید از طریق دستور زیر در Nuget عمل کنید:
Install-Package GMap.Net
در این کتابخانه مواردی که مورد توجه قرار گرفته است، تنظیمات نقشه و بعد از آن overlayها هستند که شامل مارکرها و اشکال مختلف میباشند. این اشکال شامل رسم مستطیل بر روی نقشه، چند ضلعیها و ... نیز میشوند.
برای شروع نیاز است که یک نمونه از کلاس GoogleMapApi را ایجاد کنید. بعد از آن با استفاده از خصوصیت SetLocation، مختصات مرکز نقشه را تنظیم نمایید. سپس با استفاده از خصوصیات دیگر نیز میتوانید نقشه را تنظیم نمایید. تعدادی از این خصوصیات مثل SetZoomVisibility هستند که با استفاده از آن میتوانید تنظیمات زوم را روی نقشه پیاده سازی کنید. البته فعال کردن این گزینه به تنهایی کافی نیست و باید از طریق خصوصیت ZoomControlOption پیکربندی کنترل زوم را نیز اینجام دهید که این پیکربندی شامل موقعیت قرارگیری کنترلهای زوم و اندازهی دکمهها میباشد و مابقی تنظیمات هم بدین شکل هستند:
به غیر از تنظیمات نقشه، Overlayهای زیر در این کلاس پشتیبانی میشوند:
عنوان | توضیحات |
Marker | یک نشانه گذار که برای مشخص کردن یک محل بر روی نقشه به کار میرود. این علامت گذار شامل خصوصیتهایی چون نقطهی قرارگیری، آیکن، عنوان و انیمیشنی برای نحوهی نمایش آن میباشد. همچنین شامل یک خصوصیت دیگر از نوع InfoWindow است که به شما امکان نمایش یک پنجرهی توضیحات را نیز بر روی مارکر میدهد. این محتوا میتواند به صورت HTML نمایش یابد. |
Circle | در صورتیکه بخواهید ناحیهای دایرهای شکل را بر روی نقشه مشخص کنید، کاربرد دارد. با دادن نقطهی مرکزی و شعاع میتوانید دایره را ترسیم کنید. همچنین شامل خصوصیات ظاهری چون رنگ داخل و حاشیهها و میزان شفافیت نیز میباشد. |
Rectangle | به رسم یک مستطیل میپردازد و تنها لازم است دو مختصات را به آن بدهید و بر اساس این دو نقطه، ناحیهی مستطیلی شکل ترسیم میگردد. در صورتیکه نقاط بیشتری را به آن اضافه کنید، فقط دوتای اولی در نظر گرفته میشوند. این گزینه شامل خصوصیات ظاهری نیز میگردد. |
Polyline | برای ترسیم مسیرها به صورت چند ضلعی به کار میرود و الزامی به بستن مسیرها نیست. دارای خصوصیات ظاهری نیز میباشد. |
polygon | کاملا شبیه Ployline است؛ با این تفاوت که یک چند ضلعی بسته است و میتواند داخل آن با رنگ پر باشد. برای بستن این چند ضلعی لازم نیست تا کاری انجام دهید. خود کلاس، نقطهی اول و آخر را به هم وصل میکند. |
خصوصیات آیتمهای بالا، شامل موارد زیر میشود:
نام خصوصیت | توضیحات |
Id | در سازندهی هر کدام به طور اجباری قرار گرفته است. این id برای زمانی است که بخواهید با استفاده از جاوااسکرپیت با آن ارتباط برقرار کنید. |
Editable | با فعال کردن این خاصیت، به کاربر این اجازه را میدهید که بتواند روی Overlay ویرایش انجام دهد. |
StrokeWeight | ضخامت لبهها را مشخص میکند. |
StrokeColor | رنگ لبه را مشخص میکند. |
StrokeOpacity | میزان شفافیت لبه را بین 0 تا 1 مشخص میکند. |
FillColor | بعضی از المانها مانند چند ضلعیهای بسته و مستطیل که ناحیهی داخلی دارند، شامل این گزینه هستند و رنگ داخل این ناحیه را مشخص میکنند. |
FillOpacity | میزان شفافیت خصوصیت بالا را از 0 تا 1 مشخص میکند. |
Points | با استفاده از این خاصیت میتوانید مختصات را با استفاده از کلاس Location به آن اضافه کنید. برای دایره خصوصیت Point وجود دارد. |
Radius | برای دایره کاربرد دارد. با مقدار نوع Int میتوانید شعاع آن را مقدار دهی کنید. |
public class MiladTower { public GoogleMapApi TestMarker() { var map=new GoogleMapApi(true); var location = new Location(35.7448416, 51.3753212); map.SetLocation(location); map.SetZoom(17); map.SetMapType(MapTypes.ROADMAP); map.SetBackgroundColor(Color.Aqua); map.ZoomControlVisibilty(true); map.ZoomOptions = new zoomControlOptions() { Position = Position.TOP_LEFT, ZoomStyle = ZoomStyle.SMALL }; Marker marker=new Marker("mymarker1"); marker.InfoWindow=new InfoWindow("iw1") { Content = "<b>Milad Tower</b><i>in Tehran</i><br/>Milad Tower is the highest tower in iran,many people and tourists visit it each year, but it's so expensive that i cant afford it as iranian citizen<br/>please see more info at <a href=\"https://en.wikipedia.org/wiki/Milad_Tower\"><img width='16px' height='16px' src='https://en.wikipedia.org/favicon.ico'/>wikipedia</a>" }; marker.MarkerPoint = location; map.Markers.Add(marker); var circle=new CircleMarker("mymarker2"); circle.FillColor = Color.Green; circle.FillOpacity = 0.6f; circle.StrokeColor = Color.Red; circle.StrokeOpacity = 0.8f; circle.Point = location; circle.Radius = 30; circle.Editable = true; circle.StrokeWeight = 3; map.Circles.Add(circle); Rectangle rect=new Rectangle("rect1"); rect.FillColor = Color.Black; rect.FillOpacity = 0.4f; rect.Points.Add(new Location(35.74728723483808, 51.37550354003906)); rect.Points.Add(new Location(35.74668641224311, 51.376715898513794)); map.Rectangles.Add(rect); Polyline polyline=new Polyline("poly1"); polyline.Points.Add(new Location(35.74457043569041, 51.373915672302246)); polyline.Points.Add(new Location(35.74470976097927, 51.37359380722046)); polyline.Points.Add(new Location(35.744378863020074, 51.37337923049927)); polyline.StrokeColor = Color.Blue; polyline.StrokeWeight = 2; map.Polylines.Add(polyline); Polygon polygon=new Polygon("poly2"); polygon.Points.Add(new Location(35.746494844665094, 51.374655961990356)); polygon.Points.Add(new Location(35.74635552250061, 51.37283205986023)); polygon.Points.Add(new Location(35.74598109297522, 51.372681856155396)); polygon.Points.Add(new Location(35.7454934611854, 51.37361526489258)); polygon.FillColor = Color.Black; polygon.FillOpacity = 0.5f; polygon.StrokeColor = Color.Gray; polygon.StrokeWeight = 1; map.Polygons.Add(polygon); return map; } }
@section javascript { @{ var map = new MiladTower().TestMarker(); @map.ShowMapForMvc("mapdiv") } } <br/><br/> <div id="mapdiv" style="width:600px;height:600px;"></div>
در نهایت نقشهی زیر نمایش داده میشود:
کم حجم کردن کدها
در صورتیکه به سورس صفحه نگاهی بیندازید، میبینید که کدهای جاوا اسکریپت، داخل صفحه نوشته شدهاند. اگر بخواهید برای کم حجمتر شدن کد، عملیات minify را انجام دهید، با true شدن خصوصیت minified با استفاده از کتابخانهی وابستهاش (MS Ajax Minifier) اینکار را انجام میدهد.
انتقال کدها به یک فایل خارجی
بسیاری از ما برای نوشتن کدهای جاوا اسکریپت، از یک فایل خارجی استفاده میکنیم. برای داشتن این قابلیت میتوانید به جای ShowMapForMVC متد CallJs را صدا بزنید تا کتابخانه api گوگل را صدا بزند و سپس در یک اکشن متد، متد GiveJustJS را صدا بزنید و طبق مقالهی موجود در سایت جاری محتوای آن را برگردانید و به عنوان یک فایل JS به این اکشن متد لینک بدهید. کدهای زیر به شما نحوهی این کار را نشان میدهند:
ابتدا در یک اکشن متد، کد زیر را وارد میکنیم:
public ActionResult MiladJs() { var output = new MiladTower().TestMarker().GiveJustJs("mapdiv"); Response.ContentType = "text/javascript"; return Content(output); }
بعد از آن در ویووی مربوطه کد زیر را داریم:
@section javascript { @{ var map = new MiladTower().TestMarker(); @map.CallJs() <script type="text/javascript" src="@Url.Action("MiladJs","Home")"></script> } } <br/><br/> <div id="mapdiv" style="width:600px;height:600px;"></div>
نحوهی کارکرد این کتابخانه
برای آشنایی با نحوهی کارکرد آن باید بدانید که اساس کار این کتابخانه string interpolation است. این کتابخانه کلاسی را به صورت Partial دارد که بین چندین فایل تقسیم شده است و هر یک از فایلها، با نام محتوای آن نامگذاری شدهاند. Public methods متدهای عمومی، private methods متدهای خصوصی، Constants یا ثابتها که حاوی تمام دستورات جاوا اسکریپتی هستند و در نهایت خود کلاس اصلی GoogleMapApi که حاوی کدهای اجرایی و تشکیل کد جاوا اسکریپت میباشد. در کنار کلاس اصلی، کلاسهای Overlay هم قرار دارند که شامل اطلاعات اشیاء روی نقشهها هستند؛ مثل مارکرها و چندضلعیها و ... و در نهایت یک سری کلاس و نوع شمارشی Enum شامل خصوصیتهایی که برای تنظیمات و پیکربندی نقشه به کار میروند.
کلاس GoogleMapApi برای ایجاد کدها، دادههایی را که برای هر کلاس در نظر گرفتهاید، با استفاده از interpolation و ثابتهای حاوی کد جاوا اسکریپت، در یک رشتهی جدید قرار میدهند و این رشتهها با اتصال درست در موقعیت خود، کد نهایی جاوا اسکریپت را تولید میکنند.
من هم با این مسئله مشکل دارم، وقتی از این کامپوننت در یک Dialog که Modal هست استفاده میکنم، دیگه دکمههای کامپوننت کار نمیکنن و با کلیک روی اونها ، کامپوننت بسته میشه
برای رفع مشکل ، z-index ش رو هم بالا بردم، ولی بازم درست نشد. توی یه دیالوگ z-index صفحه کدر پس زمینه 100 هست و z-index خود دیالوگ هم 101 هست. من خیلی بالاتر از این ارقام هم به دیالوگم دادم، حتی به تک تک دکمههای توی دیالوگ هم دادم، ولی بازم همون مشکل پابرجا هست.
کسی راه حلی سراغ نداره؟
MVC خیلی خوب است اما برای مثال شما در آن نمیتوانید یک کامپوننت ایجاد کرده و به راحتی در پروژههای بعدی استفاده کنید بدون اینکه به کدتان دست بزنید. (فقط از یک بُعد به کامپوننت نگاه نکنید. مثلا نه فقط بر پایه jQuery و این قبیل و یا فقط کد و ...)
این میتواند نقطه ضعف بزرگی باشد. به نظر من ASP.NET عقب افتاده است اما MVC نمیتواند جایگذین 100% آن باشد. چیز دیگری باید به وجود آید ولی آن MVC نیست. البته باید این را هم در نظر گرفت که شاید سیاستمداران مایکروسافت به این فکر کردهاند که وقتی با PHP وب سایتهای معتبری را راه میاندازند چه نیازی به کامپوننت گرایی و ...؟!
البته اگر از حق نگذریم وب محیطی متفاوت است و رفتار با آن مانند محیطهای دیگر، به هر حال باعث بروز سرباره میشود.
تهیه گزارش سرفصل های حسابداری
ولی در کل امکان گروه بندی پیش بینی شده. اطلاعات بیشتر در اینجا
در این قسمت به پیاده سازی و توضیح مدلهای انجمن خواهیم پرداخت. قبل از شروع پیشنهاد میکنم مقالات قبلی را مطالعه کنید.
همکاران این قسمت:
سلمان معروفی
سید مجتبی حسینی
پیشنیاز این قسمت:
مقالات SQL Antipattern
سعی کردیم چندین پروژهی سورس باز را هم بررسی کنیم و در نهایت کاملترین و بهترین روش را پیاده سازی کنیم. NForum ، MyBB ، MVCForum ، بخش CMS مربوط به SmartStore و ساختار دیتابیس StackOverFlow ازجملهی آنها هستند.
/// <summary> /// Represents the Forum /// </summary> public class Forum { #region Properties /// <summary> /// gets or sets Id that Identify Forum /// </summary> public virtual long Id { get; set; } /// <summary> /// gets or sets Forum's title /// </summary> public virtual string Title { get; set; } /// <summary> /// gets or sets Description of forum /// </summary> public virtual string Description { get; set; } /// <summary> /// gets or sets value indicating Custom Slug /// </summary> public virtual string SlugUrl { get; set; } /// <summary> /// gets or sets order for display forum /// </summary> public virtual long DisplayOrder { get; set; } /// <summary> /// Indicating This Forum is Active or Not /// </summary> public virtual bool IsActive { get; set; } /// <summary> /// Indicating This Forum is Close or Not /// </summary> public virtual bool IsClose { get; set; } /// <summary> /// Indicating This Forum is Private or Not /// </summary> public virtual bool IsPrivate { get; set; } /// <summary> /// sets or gets password for login to Private forums /// </summary> public virtual string PasswordHash { get; set; } /// <summary> /// sets or gets depth of forum in tree structure of forums /// </summary> public virtual int Depth { get; set; } /// <summary> /// sets or gets Count of posts That they are Approved /// </summary> public virtual long ApprovedPostsCount { get; set; } /// <summary> /// sets or gets Count of topics That they are Approved /// </summary> public virtual long ApprovedTopicsCount { get; set; } /// <summary> /// Gets or sets the id of last topic /// </summary> public virtual long LastTopicId { get; set; } /// <summary> /// gets or sets date of creation of last topic /// </summary> public virtual DateTime? LastTopicCreatedOn { get; set; } /// <summary> /// gets or sets title of last topic /// </summary> public virtual string LastTopicTitle { get; set; } /// <summary> /// gets or sets creator of last topic /// </summary> public virtual string LastTopicCreator { get; set; } /// <summary> /// gets or sets id of creator that create last topic /// </summary> public virtual long LastTopicCreatorId { get; set; } /// <summary> /// Indicate in this Forum Moderate Topics Before Display /// </summary> public virtual bool ModerateTopics { get; set; } /// <summary> /// Indicate in this Forum Moderate Posts Before Dipslay /// </summary> public virtual bool ModeratePosts { get; set; } /// <summary> /// gets or sets Count of posts that they are UnApproved /// </summary> public virtual long UnApprovedPostsCount { get; set; } /// <summary> /// gets or sets Count of topics that they are UnApproved /// </summary> public virtual long UnApprovedTopicsCount { get; set; } /// <summary> /// gets or sets Rowversion /// </summary> public virtual byte[] RowVersion { get; set; } /// <summary> /// gets or sets icon name with size 200*200 px for snippet /// </summary> public virtual string SocialSnippetIconName { get; set; } /// <summary> /// gets or sets title for snippet /// </summary> public virtual string SocialSnippetTitle { get; set; } /// <summary> /// gets or sets description for snippet /// </summary> public virtual string SocialSnippetDescription { get; set; } /// <summary> /// gets or sets path for tree structure antipattern (1/3/4/23) /// </summary> public virtual string Path { get; set; } /// <summary> /// Indicate this forum inherit moderators from parent forum /// </summary> public virtual bool IsModeratorsInherited { get; set; } /// <summary> /// gets or set datetime that Last Post is Created In this forum. used for ForumTracking /// </summary> public virtual DateTime? LastPostCreatedOn { get; set; } #endregion #region NavigationProperties /// <summary> /// sets or gets identifier forum's parent /// </summary> public virtual long? ParentId { get; set; } /// <summary> /// sets or gets forum's parent /// </summary> public virtual Forum Parent { get; set; } /// <summary> /// sets or gets sub forums of forum /// </summary> public virtual ICollection<Forum> Children { get; set; } /// <summary> /// set or get topics of forum /// </summary> public virtual ICollection<ForumTopic> Topics { get; set; } /// <summary> /// get or set moderators of this forum /// </summary> public virtual ICollection<ForumModerator> Moderators { get; set; } /// <summary> /// get or set Subscriptions List /// </summary> public virtual ICollection<User> Subscribers { get; set; } /// <summary> /// get or set Announcements Collection of this Forum /// </summary> public virtual ICollection<ForumAnnouncement> Announcements { get; set; } /// <summary> /// get or set Trackers List Of this Forum /// </summary> public virtual ICollection<ForumTracker> Trackers { get; set; } /// <summary> /// get or set Posts List that Posted in this forum for increase Performance for get Posts Count /// </summary> public virtual ICollection<ForumPost> Posts { get; set; } /// <summary> /// get or set /// </summary> public virtual ICollection<ForumTopicTracker> TopicTrackers { get; set; } #endregion
- IsActive : مشخص کنندهی این است که در این انجمن امکان ارسال تاپیک و پست وجود دارد و در صورت false بودن این خصوصیت، بر تمام زیر انجمنها هم اعمال خواهد شد و برای زمانی مفید است که میخواهیم برای مدتی به هر دلیل خاصی امکان ارسال تاپیک و پست را برای انجمن خاصی، ندهیم.
- IsColsed : خصوصت اولی که مطرح شد اگر مقدار false بگیرد، همچنان کاربران میتوانند تایپکها و پستهای قبلی را مشاهده و مطالعه کنند. ولی با مقدار دهی این خصوصیت با مقدار false، امکان کلیهی فعالیتها و مشاهدهای را از محتوای این انجمن و زیر انجمنهای آن نخواهیم داشت.
- IsPrivate : برای مواقعی که لازم است برای انجمن خاصی کلمهی عبور در نظر بگیریم تا افراد خاص که کلمهی عبور آن را دارند بتوانند در آن انجمن فعالیت کنند، در نظر گرفته شده است.
- ApprovedPostsCount , UnApprovedPostsCount,ApprovedTopicsCount,UnApprovedTopicsCount : برای بالا بردن کارآیی سیستم به مانند مدلهای قبل در نظر گرفته شدهاند.
- LastTopicId, LastTopicTitle , LastTopicCreator , LastTopicCreatorId , LastTopicCreatedOn: همچنین برای افزایش کارآیی سیستم و نمایش به عنوان قسمتی از مشخصات قابل مشاهده از هر انجمن، در نظر گرفته شدهاند.
- Depth : برای نشان دادن عمق گره در درخت استفاده میشود که هنگام درج انجمن، این مورد از نتیجهی جمع عمق پدر انتخاب شده و یک، به دست خواهد آمد. این مورد هنگام واکشی برای مثال 4 سطح اول برای نمایش آنها در صفحهی اول انجمن به صورت سلسله مراتبی خیلی مفید خواهد بود.
- Path : برای استفاده از SQL Antipattern شمارش مسیر در نظر گرفته شده است. این مورد جزء Best Practiceها میتواند باشد. چون هم با استفاده از ساختار خود ارجاع، درخت خود را داریم و با این Antipattern کوئریهای مربوط به درخت خیلی راحت خواهد بود.
- IsModeratorsInherited : اگر لازم است مدیران انجمن، پدر را به عنوان مدیر خود قبول کنند، این خصوصیت مقدار true خواهد گرفت.
- Subscribers : هر انجمنی میتواند یکسری مشترک نیز داشته باشد (به منظور اطلاع رسانی با درج یک تاپیک جدید در خود انجمن یا زیر انجمنهای آن) .
- Posts : به منظور افزایش کارایی هنگام محاسبه تعداد پستهای ارسالی در یک انجمن ، در نظر گرفته شده است.
- TopicTrackers : در مقاله بعد توضیح داده خواهد شد.
- LastPostCreatedOn : به منظور استفاده از آن برای سیستم Tracking انجمنها استفاده خواهد شد .
/// <summary> /// Represents The Moderator For Forum /// </summary> public class ForumModerator { #region NavigationProperties /// <summary> /// gets or sets Forum /// </summary> public virtual Forum Forum { get; set; } /// <summary> /// gets or sets identifier of forum /// </summary> public virtual long ForumId { get; set; } /// <summary> /// gets or sets user that moderate forum /// </summary> public virtual User Moderator { get; set; } /// <summary> /// gets or sets id of user that moderate forum /// </summary> public virtual long ModeratorId { get; set; } /// <summary> /// gets or sets permission of user that moderate forum /// </summary> public virtual ForumModeratorPermissions Permissions { get; set; } /// <summary> /// indicate moderator's permissions in this forum apply with /// </summary> public virtual bool ApplyChildren { get; set; } #endregion } [Flags] public enum ForumModeratorPermissions { CanEditPosts=1, CanDeletePosts=2, CanManageTopics=4, CanOpenCloseTopics=8, ... }
- ApplyChildren : برای اعمال دسترسیهای مدیریتی کاربر x به زیر انجمنهای انجمن y البته اگر خصوصیت IsModeratorsInherited زیر انجمنهای مورد نظر با مقدار true مقدار دهی شده باشد.
- Permissions : از نوع ForumModeratorPermissions و نگهدارنده دسترسیهای کاربر x به عنوان مدیر انجمن y، میباشد.
- نکته : برای این مدل آی دی در نظر گرفته نشده است و از کلید مرکب متشکل از ForumId و ModeratorId استفاده خواهیم کرد.
/// <summary> /// Represents the Announcement that shown Top Of Forums /// </summary> public class ForumAnnouncement { #region Ctor /// <summary> /// create one instance of <see cref="ForumAnnouncement"/> /// </summary> public ForumAnnouncement() { Id = SequentialGuidGenerator.NewSequentialGuid(); CreatedOn = DateTime.Now; } #endregion #region Properties /// <summary> /// gets or sets Identifier /// </summary> public virtual Guid Id { get; set; } /// <summary> /// gets or sets DateTime That this Announcement Will be Shown /// </summary> public virtual DateTime StartOn { get; set; } /// <summary> /// gets or sets DateTime That this Announcement Will be Finished /// </summary> public virtual DateTime? ExpireOn { get; set; } /// <summary> /// gets or sets Content of this Announcement /// </summary> public virtual string Message { get; set; } /// <summary> /// Indicate this Announcement Will be shown on Children Forums /// </summary> public virtual bool ApplyChildren { get; set; } /// <summary> /// gets or sets datetime that this record created /// </summary> public virtual DateTime CreatedOn { get; set; } #endregion #region NavigationProperties /// <summary> /// gets or sets Forum that associated With this Announcement /// </summary> public virtual Forum Forum { get; set; } /// <summary> /// gets or sets Identifier of Forum that associated With this Announcement /// </summary> public virtual long ForumId { get; set; } #endregion }
- ApplyChildren : برای مشخص کردین نمایش این اعلان در زیر انجمنهای انجمن مورد نظر
- ExpireOn : به این دلیل نال پذیر در نظر گرفته شده است که اگر لازم بود، در زمان مشخصی به پایان نرسد و با null مقدار دهی شود.
/// <summary> /// Represents a base class for AuditLog /// </summary> public abstract class AuditBaseEntity { #region Properties /// <summary> /// sets or gets identifier /// </summary> public virtual long Id { get; set; } /// <summary> /// gets or sets datetime that is created /// </summary> public virtual DateTime CreatedOn { get; set; } /// <summary> /// gets or sets datetime that is modified /// </summary> public virtual DateTime? LastModifiedOn { get; set; } /// <summary> /// gets or sets reason of Last Update for increase performance /// </summary> public virtual string LastModifyReason { get; set; } /// <summary> /// gets or sets displayName of Last Modifier for increase performance /// </summary> public virtual string LastModifier{ get; set; } /// <summary> /// indicate this entity is Locked for Modify /// </summary> public virtual bool ModifyLocked { get; set; } /// <summary> /// gets or sets rowversion for synchronization problem /// </summary> public virtual byte[] RowVersion { get; set; } /// <summary> /// gets or sets count of this content's Updates /// </summary> public virtual int ModifyCount { get; set; } #endregion #region NavigationProperties /// <summary> /// gets or sets creator of this record /// </summary> public virtual User Creator { get; set; } /// <summary> /// gets or sets creator's Id of this record /// </summary> public virtual long CreatorId { get; set; } #endregion }
/// <summary> /// Represents the Topic in the Forums /// </summary> public class ForumTopic { #region Ctor /// <summary> /// create one instance of <see cref="ForumTopic"/> /// </summary> public ForumTopic() { CreatedOn = DateTime.Now; } #endregion #region Properties /// <summary> /// sets or gets identifier /// </summary> public virtual long Id { get; set; } /// <summary> /// gets or sets datetime that is created /// </summary> public virtual DateTime CreatedOn { get; set; } /// <summary> /// gets or sets Title Of this topic /// </summary> public virtual string Title { get; set; } /// <summary> /// gets or sets name of tags that assosiated with /// this content fo increase performance /// </summary> public virtual string TagNames { get; set; } /// <summary> /// indicate this topic is Sticky and will be shown top of forum /// </summary> public virtual bool IsSticky { get; set; } /// <summary> /// indicate this topic is closed /// </summary> public virtual bool IsClosed { get; set; } /// <summary> /// gets or sets identifier of last post in this topic /// </summary> public virtual long LastPostId { get; set; } /// <summary> /// gets or sets identifier of Last user that post in this topic /// </summary> public virtual long LastPosterId { get; set; } /// <summary> /// gets or sets title of last Post in this topic /// </summary> public virtual string LastPostTitle { get; set; } /// <summary> /// gets or sets displayName of user that create lastpost in this topic /// </summary> public virtual string LastPoster { get; set; } /// <summary> /// gets or sets datetime that last post posted in this topic /// </summary> public virtual DateTime? LastPostCreatedOn { get; set; } /// <summary> /// indicate this topic is approved /// </summary> public virtual bool IsApproved { get; set; } /// <summary> /// indicate this topic is type of Announcements and shown in Annoucements sections /// </summary> public virtual bool IsAnnouncement { get; set; } /// <summary> /// gets or sets viewed count /// </summary> public virtual long ViewCount { get; set; } /// <summary> /// gets or sets count of posts that they are approved /// </summary> public virtual int ApprovedPostsCount { get; set; } /// <summary> /// gets or sets count of posts that they are Unapproved /// </summary> public virtual int UnApprovedPostsCount { get; set; } /// <summary> /// gets or sets specifications of this topic's rating /// </summary> public virtual Rating Rating { get; set; } /// <summary> /// gets or sets datetime that this topic closed /// </summary> public virtual DateTime? ClosedOn { get; set; } /// <summary> /// gets or sets reason that this topic colsed /// </summary> public virtual string ClosedReason { get; set; } /// <summary> /// gets or sets count of reports /// </summary> public virtual int ReportsCount { get; set; } /// <summary> /// indicate the posts of this topic should be Moderate Before Dipslay /// </summary> public virtual bool ModeratePosts { get; set; } /// <summary> /// gets or sets Level of this topic /// </summary> public virtual ForumTopicLevel Level { get; set; } /// <summary> /// gets or sets type of this topic /// </summary> public virtual ForumTopicType Type { get; set; } #endregion #region NavigationProperties /// <summary> /// gets or sets Collection of tags that associated with this topic /// </summary> public virtual ICollection<Tag> Tags { get; set; } /// <summary> /// gets or sets forum /// </summary> public virtual Forum Forum { get; set; } /// <summary> /// gets or sets identifier of Forum /// </summary> public virtual long ForumId { get; set; } /// <summary> /// gets or sets Posts Of this topic /// </summary> public virtual ICollection<ForumPost> Posts { get; set; } /// <summary> /// get or set Subscriptions List /// </summary> public virtual ICollection<User> Subscribers { get; set; } /// <summary> /// get or set Trackkers list of this Topic /// </summary> public virtual ICollection<ForumTopicTracker> Trackers { get; set; } /// <summary> /// gets or sets creator of this record /// </summary> public virtual User Creator { get; set; } /// <summary> /// gets or sets creator's Id of this record /// </summary> public virtual long CreatorId { get; set; } #endregion } public enum ForumTopicType { Non, Tutorial, Conversation, Question, News, Article } public enum ForumTopicLevel { Professional, Intermediate, Beginner }
- LastPostId , LastPosterId, LastPoster , LastPostTitle ,LastPostCreatedOn: برای افزایش کارآیی سیستم در نظر گرفته شدهاند.
- ModeratePosts : اگر لازم است پستهای یک تاپیک خاص، قبل از نمایش مدیریت شوند، با true مقدار دهی خواهد شد.
- Tags : لیستی از برچسبها که برای اعمال رابطهی چند به چند با مدل برچسبهای معرفی شدهی در مقاله اول، در نظر گرفته شده است.
- Posts : در هر تاپیکی یک سری پست به عنوان جوابهای آن ارسال خواهد شد.
- Subscribers : به مانند انجمنها، تاپیکهای ما هم میتوانند یک سری مشترک داشته باشند، تا از تغییرات این تاپیک مطلع شوند .
- Trackers : مربوط به سیستم Tracking تاپیک میباشد. و در مقاله بعد توضیح داده خواهد شد.
حتما لازم خواهد بود تاریخچهی تغییرات برای پستهای ارسالی ذخیره شوند؛ در مقالهی بعدی به این موضوع هم خواهیم پرداخت.
> ng test --help
یک مثال: بررسی اجرای دستور ng test
یکی از مثالهای بررسی شدهی در این سری را انتخاب و یا حتی یک برنامهی جدید را توسط Angular CLI ایجاد کرده و سپس دستور ng test را در ریشهی این پروژه اجرا کنید. به این ترتیب برنامه به صورت خودکار کامپایل شده و سپس به صورت خودکار آزمونهای واحد آنرا که در فایلهای spec.ts.* قرار دارند، اجرا میکند. در آخر نتیجه را در مرورگر گزارش میدهد:
همانطور که مشخص است، 3 specs, 3 failures داریم. در اینجا میتوان بر روی لینک Spec List کلیک کرد و لیست آزمونهای واحد موجود را مشاهده نمود:
هر کدام از عناوین ذکر شده نیز به جزئیات مشکلات آنها، لینک شدهاند. برای مثال اگر بر روی اولین مورد کلیک کنیم، خطایی مانند «'alert' is not a known element» قابل مشاهدهاست. به این معنا که برای نمونه در قسمت قبل کامپوننت alert را به صفحه اضافه کردیم:
<alert type="success">Alert success!</alert>
import { NO_ERRORS_SCHEMA } from '@angular/core'; describe('AppComponent', () => { beforeEach(async(() => { TestBed.configureTestingModule({ declarations: [ AppComponent ], schemas: [NO_ERRORS_SCHEMA] }).compileComponents(); }));
پس از این تغییر، بلافاصله مجدد برنامه کامپایل شده و آزمونهای واحد آن با موفقیت اجرا میشوند (با این فرض که هنوز پنجرهی اجرا کنندهی دستور ng test را باز نگه داشتهاید):
تغییر افزودن schemas: [NO_ERRORS_SCHEMA] را باید در مورد تمام فایلهای spec موجود تکرار کرد.
گزینههای مختلف دستور ng test
دستور ng test به همراه گزینههای متعددی است که شرح آنها را در جدول ذیل مشاهده میکنید:
گزینه | مخفف | توضیح |
code-coverage-- | cc- | تولید گزارش code coverage که به صورت پیش فرض خاموش است. |
colors-- | به صورت پیش فرض فعال است و سبب نمایش رنگهای قرمز و سبز، برای آزمونهای شکست خورده و یا موفق میشود. | |
single-run-- | sr- | اجرای یکبارهی آزمونهای واحد، بدون فعال سازی گزینهی مشاهدهی مداوم تغییرات که به صورت پیش فرض خاموش است. |
progress-- | نمایش جزئیات کامپایل و اجرای آزمونهای واحد که به صورت پیش فرض فعال است. | |
sourcemaps-- | sm- | تولید فایلهای سورسمپ که به صورت پیش فرض فعال است. |
watch-- | w- | بررسی مداوم تغییرات فایلها و اجرای آزمونهای واحد به صورت خودکار که به صورت پیش فرض فعال است. |
بنابراین اجرا دستور ng test بدون ذکر هیچ گزینهای به معنای اجرای مداوم آزمونهای واحد، در صورت مشاهدهی تغییراتی در آنها، به کمک Karma است.
همچنین دو دستور ذیل نیز به یک معنا هستند و هر دو سبب یکبار اجرای آزمونهای واحد میشوند:
> ng test -sr > ng test -w false
اجرای بررسی میزان پوشش آزمونهای واحد
یکی از گزینههای ng test روشن کردن پرچم code-coverage است:
> ng test --code-coverage
> ng test -sr -cc
کار این آزمون بررسی قسمتهای مختلف برنامه و ارائه گزارشی است که مشخص میکند آیا آزمونهای واحد نوشته شده تمام انشعابات برنامه را پوشش میدهند یا خیر؟ برای مثال اگر در متدی if/else دارید، آیا فقط قسمت if را پوشش دادهاید و یا آیا قسمت else هم در آزمونهای واحد، بررسی شدهاست.
اجرای آزمونهای end to end
هدف از ساخت یک برنامه ... استفادهی از آن توسط دیگران است؛ اینجا است که آزمونهای end to end مفهوم پیدا میکنند. در آزمونهای e2e رفتار برنامه همانند حالتی که یک کاربر از آن استفاده میکند، بررسی میشود (برای مثال باز کردن مرورگر، لاگین و مرور صفحات). برای این منظور، Angular CLI در پشت صحنه از Protractor برای این نوع آزمونها استفاده میکند.
برای مشاهدهی راهنما و گزینههای مختلف مرتبط با آزمونهای e2e، میتوان دستور ذیل را صادر کرد:
>ng e2e --help
گزینه | مخفف | توضیح |
config-- | c- | به فایل کانفیگ آزمونهای e2e اشاره میکند که به صورت پیشفرض همان protractor.conf.js واقع در ریشهی پروژهاست. |
element-explorer-- | ee- | بررسی و دیباگ protractor از طریق خط فرمان |
serve-- | s- | کامپایل و توزیع برنامه بر روی پورتی اتفاقی (حالت پیش فرض آن true است) |
specs-- | sp- | پیش فرض آن بررسی تمام specهای موجود در پروژهاست. اگر نیاز به لغو آن باشد میتوان از این گزینه استفاده کرد. |
webdriver-update-- | wu- |
به روز رسانی web driver که به صورت پیش فرض فعال است. |
بنابراین زمانیکه دستور ng e2e صادر میشود، به معنای کامپایل، توزیع برنامه بر روی پورتی اتفاقی و اجرای آزمونها است.
از این جهت که این نوع آزمونها، وابستهی به جزئی خاص از برنامه نیستند، حالت عمومی داشته و فایلهای spec آنها را میتوان در پوشهی e2e واقع در ریشهی پروژه، یافت. برای مثال در قسمتی از آن کار یافتن متن نمایش داده شدهی در صفحهی اول سایت انجام میشود
getParagraphText() { return element(by.css('app-root h1')).getText(); }
expect(page.getParagraphText()).toEqual('app works!');
برای آزمایش آن دستور ng e2e را در ریشهی پروژه صادر کنید. همچنین دقت داشته باشید که در این حالت نیاز است به اینترنت نیز متصل باشد؛ چون از chromedriver api گوگل نیز استفاده میکند. در غیراینصورت خطای ذیل را دریافت خواهید کرد:
Error: getaddrinfo ENOTFOUND chromedriver.storage.googleapis.com chromedriver.storage.googleapis.com:443
کار با اطلاعات متغیر دریافتی از سرور
در Postman یک برگهی جدید را باز کنید و سپس آدرس https://httpbin.org/uuid را در حالت Get درخواست نمائید:
این درخواست، یک Guid اتفاقی جدید را باز میگرداند. هربار که بر روی دکمهی Send کلیک کنیم، مقدار Guid دریافتی متفاوت خواهد بود. این خروجی دقیقا حالتی است که در برنامههای دنیای واقعی با آن سر و کار داریم. در این نوع برنامهها، پیشتر نمیتوان مقدار خروجی دریافتی از سرور را پیشبینی کرد. همچنین علاقمندیم این مقدار دریافتی (از درخواست 1) را به Post request ای که در انتهای قسمت قبل ایجاد کردیم (درخواست 2)، ارسال کنیم و اطلاعاتی را بین درخواستها به اشتراک بگذاریم.
برای این منظور، مجموعهی httpbin ای را که در قسمت قبل ایجاد کردیم، انتخاب کرده و Post request ذخیره شدهی در آنرا انتخاب کنید تا مجددا جزئیات آن بازیابی شود:
اکنون با مراجعه به برگهی بدنهی درخواست آن، قصد داریم یک خاصیت جدید id را با guid دریافتی از سرور توسط درخواستی دیگر، مقدار دهی کنیم:
برای دسترسی به این اطلاعات، میتوان از ویژگی بسیار قدرتمند postman به نام متغیرها استفاده کرد. به همین جهت به برگهی درخواست دریافت guid مراجعه کرده و برگهی Tests آنرا باز کنید:
این قسمت پس از پایان درخواست جاری، اجرا میشود. بنابراین دراینجا فرصت خواهیم داشت تا مقدار دریافتی از سرور را در یک متغیر ذخیره کنیم. سپس میتوان از این متغیر در حین ارسال درخواستی دیگر استفاده کرد. در پنل کنار textbox نوشتن آزمونها، تعدادی نمونه کد هم وجود دارند. برای مثال در اینجا نمونه کد «Set a global variable» را با کلیک بر روی آن انتخاب میکنیم:
pm.globals.set("uuid", "foo");
اکنون مجددا بر روی دکمهی Send این درخواست کلیک کنید. پس از اجرای آن، این قطعه کد اجرا شده و یک متغیر سراسری، با کلید uuid و مقدار ثابت مشخص شده، در تمام برگههای postman در دسترس خواهند بود. برای بررسی صحت این عملیات، میتوانید بر روی دکمهای با آیکن چشم، در بالای سمت راست صفحه، کلیک کنید:
در ادامه برای استفادهی از این متغیر سراسری، به برگهی Post request مراجعه کرده و بدنهی درخواست را به صورت زیر ویرایش میکنیم:
{ "name": "Vahid", "id": "{{uuid}}" }
سپس این درخواست را ارسال کنید، در خروجی دریافتی از سرور httpbin، خاصیت و مقدار جدید id قابل مشاهده هستند که به معنای ارسال صحیح آن به سرور است:
"json": { "id": "foo", "name": "Vahid" },
در این مرحله بر روی دکمهی Save برگهی uuid کلیک کرده و آنرا در مجموعهی httpbin، ذخیره کنید.
روش دسترسی و به اشتراک گذاری مقدار متغیر uuid دریافتی
تا اینجا متغیر سراسری uuid تنظیم شده، دارای یک مقدار ثابت است. برای تنظیم آن به مقدار Guid دریافتی از سرور، مجددا به برگهی Tests درخواست uuid مراجعه میکنیم و آنرا به نحو زیر تکمیل خواهیم کرد:
pm.response حاوی کل اطلاعات شیء response است و برای مثال بدنهی response دریافتی از سمت سرور httpbin، یک چنین شکلی را دارد:
{ "uuid": "4594e7ad-cae3-487b-bd42-fc49c312c0e9" }
let jsonResponse = pm.response.json(); pm.globals.set("uuid", jsonResponse.uuid);
{ "uuid": "83d437a8-bce6-438b-8693-068e5399182c" }
که به معنای دسترسی به مقدار متغیر uuid دریافتی از سمت سرور و تنظیم آن به عنوان یک متغیر سراسری است.
اکنون اگر مجددا به برگهی مجزای Post request مراجعه و آنرا ارسال کنیم، در خروجی بدنهی response دریافتی از سمت سرور:
"json": { "id": "83d437a8-bce6-438b-8693-068e5399182c", "name": "Vahid" },
تا اینجا تمام برگههای باز را ذخیره کنید:
در این تصویر، uuid پس از Post request قرار گرفته، چون ترتیب ذخیره سازی آنها به همین صورت بودهاست. اما نیاز است uuid را به پیش از درخواست post، منتقل کرد. برای اینکار میتوان از drag/drop آیتم آن کمک گرفت.
نوشتن یک آزمون ساده
هدف اصلی از برگهی Tests هر درخواست در Postman، نوشتن آزمونهای مختلف است. به همین جهت برای نوشتن یک آزمون ساده، به برگهی Post request که هم اکنون باز است، مراجعه کرده و سپس برگهی Tests آنرا به صورت زیر تنظیم میکنیم:
pm.test("Status code is 200", function () { pm.response.to.have.status(200); });
این آزمون، بررسی میکند که آیا status code بازگشتی از سرور 200 است یا خیر؟ برای اجرای آن، فقط کافی است بر روی دکمه Send این برگه کلیک کنید:
نتیجهی آنرا در برگهی جدید Test Results، در قسمت نمایش response دریافتی از سمت سرور، میتوان مشاهده کرد که بیانگر موفقیت آمیز بودن آزمایش انجام شدهاست.
اگر علاقمندید تا حالت شکست آنرا نیز مشاهده کنید، بجای عدد 200، عدد 404 را وارد کرده و مجددا درخواست را ارسال کنید.
اجرای ترتیبی آیتمهای یک مجموعه
تا اینجا اگر درخواستها را در مجموعهی httpbin ذخیره کرده و همچنین ترتیب آنها را نیز به نحوی که گفته شد، اصلاح کرده باشید، یک چنین شکلی را باید مشاهده کنید:
در اینجا برای اجرای ترتیبی این آیتمها و اجرای گردش کاری کوچکی که ایجاد کردهایم (درخواست post باید پس از درخواست uuid و بر اساس مقدار دریافتی آن از سرور اجرا شود)، میتوان از collection runner برنامهی Postman استفاده کرد:
با کلیک بر روی دکمهی Runner، در نوار ابزار برنامهی Postman، صفحهی Collection runner آن ظاهر میشود. در این صفحه ابتدا httpbin collection را انتخاب میکنیم که سبب نمایش محتویات و اجزای آن خواهد شد. سپس بدون ایجاد هیچگونه تغییری در تنظیمات این صفحه، بر روی دکمهی run httpbin کلیک میکنیم:
پس از اجرای خودکار مراحل این مجموعه، نتیجهی عملیات ظاهر میشود:
در اینجا هر مرحله، پس از مرحلهای دیگر اجرا شده و اگر آزمایشی نیز به همراه آنها بوده باشد نیز اجرا شدهاست. همچنین اگر بر روی نام هر کدام از مراحل کلیک کنیم، میتوان جزئیات آنها را نیز دقیقا بررسی کرد:
امکان اجرای یک چنین قابلیتی توسط برنامهی CLI ای به نام newman نیز به همراه Postman وجود دارد که جهت استفادهی در continuous integration servers میتواند بسیار مفید باشد. جزئیات آنرا در قسمتهای بعدی بررسی خواهیم کرد.
public Object Invoke(Object obj, Object[] parameters)
به مثال زیر که چگونگی این عملیات را شرح میدهد، توجه کنید:
public class TestMath { public int Squar(int i) { return i*i; } } static void Main(string[] args) { Type type = typeof (TestMath);//به دست آوردن نوع کلاس object obj = Activator.CreateInstance(type);//ساختن نمونهای از نوع مورد نظر MethodInfo methodInfo = type.GetMethod("Squar");//یافتن اطلاعات متد مورد نظر Console.WriteLine(methodInfo.Invoke(obj, new object[] { 100 }));// و نمایش نتیجه object[] ارسال عدد 100 به صورت Console.Read(); }
توجه کنید که دو متد GetMethod و Invoke در فضای نام System.Reflection قرار دارند.
روش دیگر
در شیوه دیگر برای انجام این کار، نیازی به استفاده از GetMethod و Invoke نیست و فراخوانی متد مورد نظر بسیار شبیه فراخوانی عادی متدهاست و نیازی به ساخت متغیر ویژهای از نوع []object برای ارسال پارامترها نیست. برای انجام این کار فقط کافیست نوع متغیری که نوع نمونهسازی شده را نگهمیدارد (در اینجا نمونه ای از کلاس را نگهمیدارد) به صورت dynamic باشد:
static void Main(string[] args) { Type type = typeof (TestMath); dynamic obj = Activator.CreateInstance(type); Console.WriteLine(obj.Square(100)); Console.Read(); }