<?xml version="1.0" encoding="utf-8"?> <AccountingApplication> <Version>1.5.2</Version> <URL>http://www.myappsupport.ir</URL> </AccountingApplication>
...
using System.Xml;
namespace CheckUpdateApplication
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}
private void CheckUpdate_Click(object sender, EventArgs e)
{
Version NewVersion = null;
string DownloadPath = "";
try
{
XmlTextReader xmlRead = new XmlTextReader("http://www.myappsupport.ir/AccUpdateVersion.xml");
xmlRead.MoveToContent();
string elmName = "";
if ((xmlRead.NodeType == XmlNodeType.Element) && (xmlRead.Name == "AccountingApplication"))
{
while (xmlRead.Read())
{
if (xmlRead.NodeType == XmlNodeType.Element)
{
elmName = xmlRead.Name;
}
else
{
if ((xmlRead.NodeType == XmlNodeType.Text) && (xmlRead.HasValue))
{
switch (elmName)
{
case "Version":
NewVersion = new Version(xmlRead.Value);
break;
case "URL":
DownloadPath = xmlRead.Value;
break;
}
}
}
}
}
Version AppVertion = System.Reflection.Assembly.GetExecutingAssembly().GetName().Version;
if (AppVertion.CompareTo(NewVersion) < 0)
{
DialogResult Result = MessageBox.Show("نسخه " +
NewVersion.Major.ToString() + "." +
NewVersion.Minor.ToString() + "." +
NewVersion.Build.ToString() + " در دسترس میباشد مایل به دانلود هستید؟", "نسخه جدید",
MessageBoxButtons.YesNo,MessageBoxIcon.Question);
if (Result == DialogResult.Yes)
{
System.Diagnostics.Process.Start(DownloadPath);
}
}
else
{
MessageBox.Show("نرم افزار بروز میباشد");
}
}
catch (Exception E)
{
MessageBox.Show(E.Message);
}
}
}
} 
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title></title>
<!--KendoUI: Web-->
<link href="styles/kendo.common.min.css" rel="stylesheet" type="text/css" />
<link href="styles/kendo.default.min.css" rel="stylesheet" type="text/css" />
<script src="js/jquery.min.js" type="text/javascript"></script>
<script src="js/kendo.web.min.js" type="text/javascript"></script>
<!--KendoUI: DataViz-->
<link href="styles/kendo.dataviz.min.css" rel="stylesheet" type="text/css" />
<script src="js/kendo.dataviz.min.js" type="text/javascript"></script>
<!--KendoUI: Mobile-->
<link href="styles/kendo.mobile.all.min.css" rel="stylesheet" type="text/css" />
<script src="js/kendo.mobile.min.js" type="text/javascript"></script>
<script type="text/javascript">
$(function() {
$("#pickDate").kendoDatePicker();
});
</script>
</head>
<body>
<span>
Pick a date: <input id="pickDate" type="text"/>
</span>
</body>
</html> ابزارهای زیادی جهت تست کردن API های برنامه‌های وب موجود است. یکی از معروفترین آنها Fiddler است که ابزاری مستقل جهت دیباگ تحت پروتکل HTTP میباشد. یکی دیگر از این نرم افزارها Swashbuckle است که از Nuget قابل دریافت است و صفحه‌ای را به برنامه اضافه میکند که به اختصار API های برنامه را نمایش داده و امکان اجرای آنها را فراهم میکند.
اما ساده‌ترین راه جهت کردن تست کردن API های یک برنامه، استفاده از PowerShell است که عمل ایجاد درخواستهای HTTP را به راحتی از طریق Command line فراهم میکند و به شما اجازه میدهد بدون وارد شدن به جزئیات، بر روی نتیجه API مورد نظر تمرکز کنید. PowerShell ابتدا فقط برای محیط ویندوز طراحی شده بود ولی در حال حاضر قابلیت اجرای تحت Linux و Mac را نیز دارد.
در این بخش به شما نشان خواهم داد که چگونه متدهای یک Controller را با استفاده از PowerShell تست نمایید.
بدین منظور ابتدا کلاسی را به نام Reservation با مشخصات زیر، در یک پروژه ASP.NET Core Web Application ایجاد نمایید.
public class Reservation
{
public int ReservationId { get; set; }
public string ClientName { get; set; }
public string Location { get; set; }
} public interface IRepository
{
IEnumerable<Reservation> Reservations { get; }
Reservation this[int id] { get; }
Reservation AddReservation(Reservation reservation);
Reservation UpdateReservation(Reservation reservation);
void DeleteReservation(int id);
} public class MemoryRepository : IRepository
{
private Dictionary<int, Reservation> items;
public MemoryRepository()
{
items = new Dictionary<int, Reservation>();
new List<Reservation> {
new Reservation { ClientName = "Alice", Location = "Board Room" },
new Reservation { ClientName = "Bob", Location = "Lecture Hall" },
new Reservation { ClientName = "Joe", Location = "Meeting Room 1" }
}.ForEach(r => AddReservation(r));
}
public Reservation this[int id] => items.ContainsKey(id) ? items[id] : null;
public IEnumerable<Reservation> Reservations => items.Values;
public Reservation AddReservation(Reservation reservation)
{
if (reservation.ReservationId == 0)
{
int key = items.Count;
while (items.ContainsKey(key)) { key++; };
reservation.ReservationId = key;
}
items[reservation.ReservationId] = reservation;
return reservation;
}
public void DeleteReservation(int id) => items.Remove(id);
public Reservation UpdateReservation(Reservation reservation) => AddReservation(reservation);
} [Route("api/[controller]")]
public class ReservationController : Controller
{
private IRepository repository;
public ReservationController(IRepository repo) => repository = repo;
[HttpGet]
public IEnumerable<Reservation> Get() => repository.Reservations;
[HttpGet("{id}")]
public Reservation Get(int id) => repository[id];
[HttpPost]
public Reservation Post([FromBody] Reservation res) =>
repository.AddReservation(new Reservation
{
ClientName = res.ClientName,
Location = res.Location
});
[HttpPut]
public Reservation Put([FromBody] Reservation res) => repository.UpdateReservation(res);
[HttpPatch("{id}")]
public StatusCodeResult Patch(int id, [FromBody] JsonPatchDocument<Reservation> patch)
{
Reservation res = Get(id);
if (res != null)
{
patch.ApplyTo(res);
return Ok();
}
return NotFound();
}
[HttpDelete("{id}")]
public void Delete(int id) => repository.DeleteReservation(id);
} Invoke-RestMethod http://localhost:7000/api/reservation -Method GET
| location | clientName | reservationId |
| Board Room | Alice | 0 |
| Lecture Hall | Bob | 1 |
| Meeting Room 1 | Joe | 2 |
Invoke-RestMethod http://localhost:7000/api/reservation/1 -Method GET
| location | clientName | reservationId |
| Lecture Hall | Bob | 1 |
تمامی متدهای ارائه شده توسط یک API را میتوان به کمک PowerShell تست کرد. اگرچه در این حالت فرمت بعضی از درخواستهای ارسالی ممکن است کمی به هم ریخته به نظر برسد. در اینجا درخواستی جهت اضافه کردن یک رکورد را به لیست Reservation ارسال میکنیم و نتیجه را در پاسخ ارسال شده از سمت سرور خواهیم دید:
Invoke-RestMethod http://localhost:7000/api/reservation -Method POST -Body
(@{clientName="Anne"; location="Meeting Room 4"} | ConvertTo-Json) -ContentType "application/json" | location | clientName | reservationId |
| Meeting Room 4 | Anne | 1 |
Invoke-RestMethod http://localhost:7000/api/reservation -Method GET
| location | clientName | reservationId |
| Board Room | Alice | 0 |
| Lecture Hall | Bob | 1 |
| Meeting Room 1 | Joe | 2 |
| Meeting Room 4 | Anne | 3 |
درخواست از نوع PUT جهت جایگزینی داده‌ای موجود در لیست، با داده‌ی جدید است. بدین منظور کد داخلی شیء مورد نظر (در اینجا ReservationId) باید در URL گنجانده شود و مقادیر فیلدهای کلاس، در متن درخواست. مثالی جهت درخواست اصلاح داده موجود از طریق فرمان PowerShell :
Invoke-RestMethod http://localhost:7000/api/reservation -Method PUT -Body
(@{reservationId="1"; clientName="Bob"; location="Media Room"} | ConvertTo-Json)
-ContentType "application/json" | location | clientName | reservationId |
| Media Room | Bob | 1 |
Invoke-RestMethod http://localhost:7000/api/reservation -Method GET
| location | clientName | reservationId |
| Board Room | Alice | 0 |
| Media Room | Bob | 1 |
| Meeting Room 1 | Joe | 2 |
| Meeting Room 4 | Anne | 3 |
استفاده از دستور PATCH
این دستور جهت تغییر اطلاعات یک رکورد به کار میرود، ولی استفاده از آن در غالب برنامه‌های پیاده سازی شده نادیده گرفته میشود که البته چنانچه کاربران برنامه‌های مذکور به تمامی فیلدهای یک رکورد دسترسی داشته باشند، معقولانه به نظر می‌رسد. اما در یک برنامه بزرگ و پیچیده ممکن است به دلایلی از جمله مسایل امنیتی، کاربران اجازه دسترسی به تمامی فیلدهای یک رکورد را نداشته باشند و در این حالت نمی‌توان از دستور PUT جهت ارسال درخواست استفاده کرد. دستورهای مبتنی بر PATCH گزینشی بوده و میتوان فقط فیلدهای خاصی را که مورد نظر می‌باشند، با آن تغییر داد.
ASP.NET Core MVC از استاندارد Json PATCH پشتیبانی میکند و این کار اجازه میدهد تا بتوان تغییرات را بطور یکنواختی انجام داد. جهت مشاهده جزئیات این دستور میتوانید به این لینک مراجعه کنید. اما برای مثال فرض کنید میخواهید چنین درخواستی را که به فرمت Json است از طریق HTTP PATCH به سمت سرور ارسال کنید:
[
{ "op": "replace", "path": "clientName", "value": "Bob"},
{ "op": "replace", "path": "location", "value": "Lecture Hall"}
] دربسیاری از مواقع فقط از دستور replace درخواست PATCH استفاده میشود و کد داخلی رکورد مورد نظر، جهت تغییر در Url درخواست ارسالی، فرستاده خواهد شد. ASP.NET Core MVC به طور اتوماتیک این دستور را پردازش کرده و آنرا به صورت آبجکتی از نوع <JsonPatchDocument<T به اکشن کنترلر قید شده، پاس خواهد داد که در اینجا نوع T، از نوع کلاس مورد نظر ما میباشد. فرمت دستور ارسالی از طریق Powershell به شکل زیر خواهد بود:
Invoke-RestMethod http://localhost:7000/api/reservation/2 -Method PATCH -Body (@
{ op="replace"; path="clientName"; value="Bob"},@{ op="replace"; path="location";
value="Lecture Hall"} | ConvertTo-Json) -ContentType "application/json" Invoke-RestMethod http://localhost:7000/api/reservation -Method GET
| location | clientName | reservationId |
| Board Room | Alice | 0 |
| Media Room | Bob | 1 |
| Lecture Hall | Bob | 2 |
| Meeting Room 4 | Anne | 3 |
استفاده از دستور Delete
استفاده از دستور Delete هم به شکل زیر خواهد بود:
Invoke-RestMethod http://localhost:7000/api/reservation/2 -Method DELETE
Invoke-RestMethod http://localhost:7000/api/reservation -Method GET
enum Direction {
North,
East,
South,
West,
} enum Shape {
Circle(f64),
Rectangle(f64, f64),
Square(f64),
} fn area(shape: Shape) -> f64 {
match shape {
Shape::Circle(radius) => std::f64::consts::PI * radius * radius,
Shape::Rectangle(width, height) => width * height,
Shape::Square(side) => side * side,
}
} use std::io::Read;
use std::fs::File;
use std::io;
fn read_file_contents(file_path: &str) -> Result<String, io::Error> {
let mut file = File::open(file_path)?;
let mut contents = String::new();
file.read_to_string(&mut contents)?;
Ok(contents)
} struct Stack<T> {
elements: Vec<T>,
}
impl<T> Stack<T> {
fn new() -> Self {
Stack { elements: Vec::new() }
}
fn push(&mut self, item: T) {
self.elements.push(item);
}
fn pop(&mut self) -> Option<T> {
self.elements.pop()
}
} وب اسمبلی چیست؟
<BlazorMode> ... </BlazorMode> <WebAppDeploymentType> ... </WebAppDeploymentType>
همیشه در طراحی مدل‌ها مهمترین سوال این است مدلی که در حال طراحی است باید تمامی کسب و کار را در خود جای دهد و یا خالص باشد و کمترین وابستگی را داشته باشد در این مقاله این برسی می‌خوانید .
ساخت یک API عالی بستگی به یک معماری عالی دارد. در اینجا گذری در جنبه‌های طراحی api و ویژگیهای توسعه در asp.net core و فلسفه معماری و الگوهای طراحی انجام گرفته شده.
طراحی دیتابیس، مهمترین بخش اصلی هر برنامه کاربردیست. best practiceهای طراحی دیتابیس، امریست که به این مسئله کمک فراوانی میکند.
