HTTP Logging is a middleware that logs information about HTTP requests and HTTP responses. HTTP logging provides logs of
HTTP request information
Common properties
Headers
Body
HTTP response information
HTTP Logging is valuable in several scenarios to
Record information about incoming requests and responses
Filter which parts of the request and response are logged
Filtering which headers to log
<div class="form-group">
<InputFile OnChange="HandleImageUpload" multiple></InputFile>
</div>
@code
{
private async Task HandleImageUpload(InputFileChangeEventArgs args)
{
}
} using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
namespace BlazorServer.Models
{
public class HotelRoomDTO
{
// ...
public virtual ICollection<HotelRoomImageDTO> HotelRoomImages { get; set; } = new List<HotelRoomImageDTO>();
}
} @inject IHotelRoomService HotelRoomService
@inject NavigationManager NavigationManager
@inject IJSRuntime JsRuntime
@inject IFileUploadService FileUploadService
@inject IWebHostEnvironment WebHostEnvironment
@code
{
// ...
private async Task HandleImageUpload(InputFileChangeEventArgs args)
{
var files = args.GetMultipleFiles(maximumFileCount: 5);
if (args.FileCount == 0 || files.Count == 0)
{
return;
}
var allowedExtensions = new List<string> { ".jpg", ".png", ".jpeg" };
if(!files.Any(file => allowedExtensions.Contains(Path.GetExtension(file.Name), StringComparer.OrdinalIgnoreCase)))
{
await JsRuntime.ToastrError("Please select .jpg/.jpeg/.png files only.");
return;
}
foreach (var file in files)
{
var uploadedImageUrl = await FileUploadService.UploadFileAsync(file, WebHostEnvironment.WebRootPath, "Uploads");
HotelRoomModel.HotelRoomImages.Add(new HotelRoomImageDTO { RoomImageUrl = uploadedImageUrl });
}
}
} @using Microsoft.AspNetCore.Hosting @using System.Linq @using System.IO
.room-image {
display: block;
width: 100%;
height: 150px;
background-size: cover !important;
border: 3px solid green;
position: relative;
}
.room-image-title {
position: absolute;
top: 0;
right: 0;
background-color: green;
color: white;
padding: 0px 6px;
display: inline-block;
} <div class="form-group">
<InputFile OnChange="HandleImageUpload" multiple></InputFile>
<div class="row">
@if (HotelRoomModel.HotelRoomImages.Count > 0)
{
var serial = 1;
foreach (var roomImage in HotelRoomModel.HotelRoomImages)
{
<div class="col-md-2 mt-3">
<div class="room-image" style="background: url('@roomImage.RoomImageUrl') 50% 50%; ">
<span class="room-image-title">@serial</span>
</div>
<button type="button" class="btn btn-outline-danger btn-block mt-4">Delete</button>
</div>
serial++;
}
}
</div>
</div> // ...
@inject IHotelRoomImageService HotelRoomImageService
@code
{
// ...
private async Task AddHotelRoomImageAsync(HotelRoomDTO roomDto)
{
foreach (var imageDto in HotelRoomModel.HotelRoomImages)
{
imageDto.RoomId = roomDto.Id;
await HotelRoomImageService.CreateHotelRoomImageAsync(imageDto);
}
}
} HotelRoomModel.HotelRoomImages.Add(new HotelRoomImageDTO { RoomImageUrl = uploadedImageUrl }); private async Task HandleHotelRoomUpsert()
{
// ...
// Create Mode
var createdRoomDto = await HotelRoomService.CreateHotelRoomAsync(HotelRoomModel);
await AddHotelRoomImageAsync(createdRoomDto);
await JsRuntime.ToastrSuccess($"The `{HotelRoomModel.Name}` created successfully.");
// ...
} protected override async Task OnInitializedAsync()
{
if (Id.HasValue)
{
// Update Mode
Title = "Update";
HotelRoomModel = await HotelRoomService.GetHotelRoomAsync(Id.Value);
}
// ...
} namespace BlazorServer.Services
{
public class HotelRoomService : IHotelRoomService
{
// ...
public IAsyncEnumerable<HotelRoomDTO> GetAllHotelRoomsAsync()
{
return _dbContext.HotelRooms
.Include(x => x.HotelRoomImages)
.ProjectTo<HotelRoomDTO>(_mapperConfiguration)
.AsAsyncEnumerable();
}
public Task<HotelRoomDTO> GetHotelRoomAsync(int roomId)
{
return _dbContext.HotelRooms
.Include(x => x.HotelRoomImages)
.ProjectTo<HotelRoomDTO>(_mapperConfiguration)
.FirstOrDefaultAsync(x => x.Id == roomId);
}
}
} private async Task HandleHotelRoomUpsert()
{
//...
// Update Mode
var updatedRoomDto = await HotelRoomService.UpdateHotelRoomAsync(HotelRoomModel.Id, HotelRoomModel);
await AddHotelRoomImageAsync(updatedRoomDto);
await JsRuntime.ToastrSuccess($"The `{HotelRoomModel.Name}` updated successfully.");
//...
} private async Task AddHotelRoomImageAsync(HotelRoomDTO roomDto)
{
foreach (var imageDto in HotelRoomModel.HotelRoomImages.Where(x => x.RoomId == 0))
{
imageDto.RoomId = roomDto.Id;
await HotelRoomImageService.CreateHotelRoomImageAsync(imageDto);
}
} public async Task<HotelRoomDTO> CreateHotelRoomAsync(HotelRoomDTO hotelRoomDTO)
{
var hotelRoom = _mapper.Map<HotelRoom>(hotelRoomDTO); .
تولید یک پرووایدر منابع دیتابیسی - بخش سوم
برای پیاده‌سازی ویژگی به‌روزرسانی ورودی‌های منابع در زمان اجرا راه‌حل‌های مخنلفی ممکن است به ذهن برنامه‌نویس خطور کند که هر کدام معایب و مزایای خودش را دارد. اما درنهایت بسته به شرایط موجود انتخاب روش مناسب برعهده خود برنامه‌نویس است.
مثلا برای پرووایدر سفارشی دیتابیسی تهیه‌شده در مطالب قبلی، تنها کافی است ابزاری تهیه شود تا به کاربران اجازه به‌روزرسانی مقادیر موردنظرشان در دیتابیس را بدهد که کاری بسیار ساده است. بدین ترتیب به‌روزرسانی این مقادیر در زمان اجرا کاری بسیار ابتدایی به نظر می‌رسد. اما در قسمت قبل نشان داده شد که برای بالا بردن بازدهی بهتر است که مقادیر موجود در دیتابیس در حافظه سرور کش شوند. استراتژی اولیه و ساده‌ای نیز برای نحوه پیاده‌سازی این فرایند کشینگ ارائه شد. بنابراین باید امکاناتی فراهم شود تا درصورت تغییر مقادیر کش‌شده در سمت دیتابیس، برنامه از این تغییرات آگاه شده و نسبت به به‌روزرسانی این مقادیر در متغیر کشینگ اقدامات لازم را انجام دهد.
اما همانطور که در قسمت قبل نیز اشاره شد، نکته‌ای که باید درنظر داشت این است که مدیریت تمامی نمونه‌های تولیدشده از کلاس‌های موردبحث کاملا برعهده ASP.NET است، بنابراین دسترسی مستقیمی به این نمونه‌ها در بیرون و در زمان اجرا وجود ندارد تا این ویژگی را بتوان در مورد آنها پیاده کرد.
یکی از روش‌های موجود برای حل این مشکل این است که مکانیزمی پیاده شود تا بتوان به تمامی نمونه‌های تولیدی از کلاس DbResourceManager در بیرون از محیط سیستم مدیریت منابع ASP.NET دسترسی داشت. مثلا یک کلاس حاول متغیری استاتیک جهت ذخیره نمونه‌های تولیدی از کلاس DbResourceManager، به کتابخانه خود اضافه کرد تا با استفاده از یکسری امکانات بتوان این نمونه‌های تولیدی را از تغییرات رخداده در سمت دیتابیس آگاه کرد. در این قسمت پیاده‌سازی این راه‌حل شرح داده می‌شود.
.
نکته: قبل از هرچیز برای مناسب شدن طراحی کتابخانه تولیدی و افزایش امنیت آن بهتر است تا سطح دسترسی تمامی کلاس‌های پیاده‌سازی شده تا این مرحله به internal تغییر کند. ازآنجاکه سیستم مدیریت منابع ASP.NET از ریفلکشن برای تولید نمونه‌های موردنیاز خود استفاده می‌کند، بنابراین این تغییر تاثیری بر روند کاری آن نخواهد گذاشت.
.
نکته: با توجه به شرایط خاص موجود، ممکن است نام‌های استفاده شده برای کلاس‌های این کتابخانه کمی گیج‌کننده باشد. پس با دقت بیشتری به مطلب توجه کنید.
.
پیاده‌سازی امکان پاک‌سازی مقادیر کش‌شده
برای اینکار باید تغییراتی در کلاس DbResourceManager داده شود تا بتوان این کلاس را از تغییرات بوجود آمده آگاه ساخت. روشی که من برای این کار درنظر گرفتم استفاده از یک اینترفیس حاوی اعضای موردنیاز برای پیاده‌سازی این امکان است تا مدیریت این ویژگی در ادامه راحت‌تر شود.
.
اینترفیس IDbCachedResourceManager
این اینترفیس به صورت زیر تعریف شده است:
namespace DbResourceProvider
{
internal interface IDbCachedResourceManager
{
string ResourceName { get; }
void ClearAll();
void Clear(string culture);
void Clear(string culture, string resourceKey);
}
}در پراپرتی فقط خواندنی ResourceName نام منبع کش شده ذخیره خواهد شد.
متد ClearAll برای پاک‌سازی تمامی ورودی‌های کش‌شده استفاده می‌شود.
متدهای Clear برای پاک‌سازی ورودی‌های کش‌شده یک کالچر به خصوص و یا یک ورودی خاص استفاده می‌شود.
با استفاده از این اینترفیس، پیاده‌سازی کلاس DbResourceManager به صورت زیر تغییر می‌کند:
using System.Collections.Generic;
using System.Globalization;
using DbResourceProvider.Data;
namespace DbResourceProvider
{
internal class DbResourceManager : IDbCachedResourceManager
{
private readonly string _resourceName;
private readonly Dictionary<string, Dictionary<string, object>> _resourceCacheByCulture;
public DbResourceManager(string resourceName)
{
_resourceName = resourceName;
_resourceCacheByCulture = new Dictionary<string, Dictionary<string, object>>();
}
public object GetObject(string resourceKey, CultureInfo culture) { ... }
private object GetCachedObject(string resourceKey, string cultureName) { ... }
#region Implementation of IDbCachedResourceManager
public string ResourceName
{
get { return _resourceName; }
}
public void ClearAll()
{
lock (this)
{
_resourceCacheByCulture.Clear();
}
}
public void Clear(string culture)
{
lock (this)
{
if (!_resourceCacheByCulture.ContainsKey(culture)) return;
_resourceCacheByCulture[culture].Clear();
}
}
public void Clear(string culture, string resourceKey)
{
lock (this)
{
if (!_resourceCacheByCulture.ContainsKey(culture)) return;
_resourceCacheByCulture[culture].Remove(resourceKey);
}
}
#endregion
}
}اعضای اینترفیس IDbCachedResourceManager به صورت مناسبی در کد بالا پیاده‌سازی شدند. در تمام این پیاده‌سازی‌ها مقادیر مربوطه از درون متغیر کشینگ پاک می‌شوند تا پس از اولین درخواست، بلافاصله از دیتابیس خوانده شوند. برای جلوگیری از دسترسی هم‌زمان نیز از بلاک lock استفاده شده است.
برای استفاده از این امکانات جدید همانطور که در بالا نیز اشاره شد باید بتوان نمونه‌های تولیدی از کلاس DbResourceManager توسط ASP.NET درون متغیری استاتیک ذخیره شوند. برای اینکار از کلاس جدیدی با عنوان DbResourceCacheManager استفاده می‌شود که برخلاف تمام کلاس‌های تعریف‌شده تا اینجا با سطح دسترسی public تعریف می‌شود.
کلاس DbResourceCacheManager
مدیریت نمونه‌های تولیدی از کلاس DbResourceManager در این کلاس انجام می‌شود. این کلاس پیاده‌سازی ساده‌ای به‌صورت زیر دارد:
using System.Collections.Generic;
using System.Linq;
namespace DbResourceProvider
{
public static class DbResourceCacheManager
{
internal static List<IDbCachedResourceManager> ResourceManagers { get; private set; }
static DbResourceCacheManager()
{
ResourceManagers = new List<IDbCachedResourceManager>();
}
public static void ClearAll()
{
ResourceManagers.ForEach(r => r.ClearAll());
}
public static void Clear(string resourceName)
{
GetResouceManagers(resourceName).ForEach(r => r.ClearAll());
}
public static void Clear(string resourceName, string culture)
{
GetResouceManagers(resourceName).ForEach(r => r.Clear(culture));
}
public static void Clear(string resourceName, string culture, string resourceKey)
{
GetResouceManagers(resourceName).ForEach(r => r.Clear(culture, resourceKey));
}
private static List<IDbCachedResourceManager> GetResouceManagers(string resourceName)
{
return ResourceManagers.Where(r => r.ResourceName.ToLower() == resourceName.ToLower()).ToList();
}
}
}ازآنجاکه نیازی به تولید نمونه ای از این کلاس وجود ندارد، این کلاس به صورت استاتیک تعریف شده است. بنابراین تمام اعضای درون آن نیز استاتیک هستند.
از پراپرتی ResourceManagers برای نگهداری لیستی از نمونه‌های تولیدی از کلاس DbResourceManager استفاده می‌شود. این پراپرتی از نوع <List<IDbCachedResourceManager تعریف شده است و برای جلوگیری از دسترسی بیرونی، سطح دسترسی آن internal درنظر گرفته شده است.
در کانستراکتور استاتیک این کلاس (اطلاعات بیشتر درباره static constructor در اینجا) این پراپرتی با مقداردهی به یک نمونه تازه از لیست، اصطلاحا initialize می‌شود.
سایر متدها نیز برای فراخوانی متدهای موجود در اینترفیس IDbCachedResourceManager پیاده‌سازی شده‌اند. تمامی این متدها دارای سطح دسترسی public هستند. همانطور که می‌بینید از خاصیت ResourceName برای مشخص‌کردن نمونه موردنظر استفاده شده است که دلیل آن در قسمت قبل شرح داده شده است.
دقت کنید که برای اطمینان از انتخاب درست همه موارد موجود در شرط انتخاب نمونه موردنظر در متد GetResouceManagers از متد ToLower برای هر دو سمت شرط استفاده شده است.
.
نکته مهم: درباره علت برگشت یک لیست از متد انتخاب نمونه موردنظر از کلاس DbResourceManager در کد بالا (یعنی متد GetResouceManagers) باید نکته‌ای اشاره شود. در قسمت قبل عنوان شد که سیستم مدیریت منابع ASP.NET نمونه‌های تولیدی از پرووایدرهای منابع را به ازای هر منبع کش می‌کند. اما یک نکته بسیار مهم که باید به آن توجه کرد این است که این کش برای «عبارات بومی‌سازی ضمنی» و نیز «متد مربوط به منابع محلی» موجود در کلاس HttpContext و یا نمونه مشابه آن در کلاس TemplateControl (همان متد GetLocalResourceObject که درباره این متدها در قسمت سوم این سری شرح داده شده است) از یکدیگر جدا هستند و استفاده از هریک از این دو روش موجب تولید یک نمونه مجزا از پرووایدر مربوطه می‌شود که متاسفانه کنترل آن از دست برنامه نویس خارج است. دقت کنید که این اتفاق برای منابع کلی رخ نمی‌دهد.
بنابراین برای پاک کردن مناسب ورودی‌های کش‌شده در کلاس فوق به جای استفاده از متد Single در انتخاب نمونه موردنظر از کلاس DbResourceManager (در متد GetResouceManagers) از متد Where استفاده شده و یک لیست برگشت داده می‌شود. چون با توجه به توضیح بالا امکان وجود دو نمونه DbResourceManager از یک منبع درخواستی محلی در لیست نمونه‌های نگهداری شده در این کلاس وجود دارد.
.
افزودن نمونه‌ها به کلاس DbResourceCacheManager
برای نگهداری نمونه‌های تولید شده از DbResourceManager، باید در یک قسمت مناسب این نمونه‌ها را به لیست مربوطه در کلاس DbResourceCacheManager اضافه کرد. بهترین مکان برای انجام این عمل در کلاس پایه BaseDbResourceProvider است که درخواست تولید نمونه را در متد EnsureResourceManager درصورت نال بودن آن می‌دهد. بنابراین این متد را به صورت زیر تغییر می‌دهیم:
private void EnsureResourceManager()
{
if (_resourceManager != null) return;
{
_resourceManager = CreateResourceManager();
DbResourceCacheManager.ResourceManagers.Add(_resourceManager);
}
}
تا اینجا کار پیاده‌سازی امکان مدیریت مقادیر کش‌شده در کتابخانه تولیدی به پایان رسیده است.
.
استفاده از کلاس DbResourceCacheManager
پس از پیاده‌سازی تمامی موارد لازم، حالتی را درنظر بگیرید که مقادیر ورودی‌های تعریف شده در منبع "dir1/page1.aspx" تغییر کرده است. بنابراین برای بروزرسانی مقادیر کش‌شده کافی است تا از کدی مثل کد زیر استفاده شود:
DbResourceCacheManager.Clear("dir1/page1.aspx");کد بالا کل ورودی‌های کش‌شده برای منبع "dir1/page1.aspx" را پاک می‌کند. برای پاک کردن کالچر یا یک ورودی خاص نیز میتوان از کدهایی مشابه زیر استفاده کرد:
DbResourceCacheManager.Clear("Default.aspx", "en-US");
DbResourceCacheManager.Clear("GlobalTexts", "en-US", "Yes");.
دریافت کد پروژه
کد کامل پروژه DbResourceProvider به همراه مثال و اسکریپت‌های دیتابیسی مربوطه از لینک زیر قابل دریافت است:
برای استفاده از این مثال ابتدا باید کتابخانه Entity Framework (با نام EntityFramework.dll) را مثلا از طریق نوگت دریافت کنید. نسخه‌ای که من در این مثال استفاده کردم نسخه 4.4 با حجم حدود 1 مگابایت است.
نکته: در این کد یک بهبود جزئی اما مهم در کلاس ResourceData اعمال شده است. در قسمت سوم این سری، اشاره شد که نام ورودی‌های منابع Case Sensitive نیست. بنابراین برای پیاده‌سازی این ویژگی، متدهای این کلاس باید به صورت زیر تغییر کنند:
public Resource GetResource(string resourceKey, string culture)
{
using (var data = new TestContext())
{
return data.Resources.SingleOrDefault(r => r.Name.ToLower() == _resourceName.ToLower() && r.Key.ToLower() == resourceKey.ToLower() && r.Culture == culture);
}
}
public List<Resource> GetResources(string culture)
{
using (var data = new TestContext())
{
return data.Resources.Where(r => r.Name.ToLower() == _resourceName.ToLower() && r.Culture == culture).ToList();
}
}.
در آینده...
در ادامه مطالب، بحث تهیه پرووایدر سفارشی فایلهای resx. برای پیاده‌سازی امکان به‌روزرسانی در زمان اجرا ارائه خواهد شد. بعد از پایان تهیه این پرووایدر سفارشی، این سری مطالب با ارائه نکات استفاده از این پرووایدرها در ASP.NET MVC پایان خواهد یافت.
.
منابع
<div ng-app="myApp">
<div ng-controller="CommentCtrl">
<div ng-repeat="comment in comments">
<div style="float:right;cursor:pointer;" ng-click="remove(comment.Id,$index);">X</div>
<a href="#">
<img style="width:32px;" ng-src="/Content/user.gif" alt="{{comment.Name}}">
</a>
<div>
<h4>{{comment.Name}}</h4>
{{comment.CommentBody}}
</div>
</div>
<div>
<form action="/Comment/Add" method="post">
<div>
<label for="Name">Name</label>
<input id="Name" type="text" name="Name" ng-model="comment.Name" placeholder="Your Name" />
</div>
<div>
<label for="Email">Email</label>
<input id="Email" type="text" name="Email" ng-model="comment.Email" placeholder="Your Email" />
</div>
<div>
<label for="CommentBody">Comment</label>
<textarea id="CommentBody" name="CommentBody" ng-model="comment.CommentBody" placeholder="Your Comment"></textarea>
</div>
<button type="button" ng-click="addComment()">Send</button>
</form>
</div>
</div>
</div> var app = angular.module('myApp', []);
app.controller('CommentCtrl', function ($scope, $http) {
$scope.comment = {};
$http.get('/Comment/GetAll').success(function (data) {
$scope.comments = data;
})
$scope.addComment = function () {
$http.post("/Comment/Add", $scope.comment).success(function () {
$scope.comments.push({ Name: $scope.comment.Name, CommentBody: $scope.comment.CommentBody });
$scope.comment = {};
});
};
$scope.remove = function (id, index) {
$http.post("/Comment/Remove", { id: id }).success(function () {
$scope.comments.splice(index, 1);
});
};
}); 
<?php
namespace App;
use Illuminate\Database\Eloquent\Model;
class Comment extends Model
{
/**
* Get the owning commentable model.
*/
public function commentable()
{
return $this->morphTo();
}
}
class Post extends Model
{
/**
* Get all of the post's comments.
*/
public function comments()
{
return $this->morphMany('App\Comment', 'commentable');
}
}
class Video extends Model
{
/**
* Get all of the video's comments.
*/
public function comments()
{
return $this->morphMany('App\Comment', 'commentable');
}
} $post = App\Post::find(1);
foreach ($post->comments as $comment) {
//
} $comment = App\Comment::find(1); $commentable = $comment->commentable;
public enum CommentType
{
Article,
Video,
Event
}
public class Comment
{
public int Id { get; set; }
public string CommentText { get; set; }
public string User { get; set; }
public int? TypeId { get; set; }
public CommentType CommentType { get; set; }
} public class Comment
{
public int Id { get; set; }
public string CommentText { get; set; }
public string User { get; set; }
public virtual Article Article { get; set; }
public int ArticleId { get; set; }
}
public class Article
{
public int Id { get; set; }
public string Title { get; set; }
public string Slug { get; set; }
public string Description { get; set; }
public virtual ICollection<Article> Articles { get; set; }
} interface ICommentable
{
int Id { get; set; }
}
public class Article : ICommentable
{
public int Id { get; set; }
public string Title { get; set; }
public string Slug { get; set; }
public string Description { get; set; }
[NotMapped]
public ICollection<Comment> Comments { get; set; }
}
public class Video : ICommentable
{
public int Id { get; set; }
public string Url { get; set; }
public string Description { get; set; }
[NotMapped]
public ICollection<Comment> Comments { get; set; }
}
public class Event : ICommentable
{
public int Id { get; set; }
public string Name { get; set; }
public DateTimeOffset? Start { get; set; }
public DateTimeOffset? End { get; set; }
[NotMapped]
public ICollection<Comment> Comments { get; set; }
} public class Comment
{
public int Id { get; set; }
public string CommentText { get; set; }
public string User { get; set; }
public int? TypeId { get; set; }
public CommentType CommentType { get; set; }
ICommentable _parent;
[NotMapped]
public ICommentable Parent
{
get => _parent;
set
{
_parent = value;
TypeId = value.Id;
CommentType = (CommentType) Enum.Parse(typeof(CommentType), value.GetType().Name);
}
}
} var article = dbContext.Articles.Find(1);
article.Comments = dbContext.Comments
.Where(c => c.TypeId == article.Id
&& c.CommentType == CommentType.Article)
.ToList();
foreach (var comment in article.Comments)
comment.Parent = article;
foreach (var comment in article.Comments)
{
Console.WriteLine($"{comment.User} - ${comment.CommentText} - {((Article) comment.Parent).Title}");
}