สวัสดีวันนี้อยู่กับผมแอดเอฟกันเหมือนเดิม เมื่อไม่นานมานี้ก็มีเพื่อน ๆ ที่มีโอกาสที่ไปจับงานทำเว็บที่ใช้ .NET แล้วอยากให้เราช่วยสอนการทำ API ด้วย ASP.NET Core Minimal API แล้วยังไม่รู้ว่าจะเริ่มต้นยังไง? เรามาดูไปพร้อมกันในบทความนี้ครับ
หากใครยังไม่ติดตั้ง .NET ให้เราไปดาวน์โหลดที่ลิงก์นี้ก่อนนะครับ https://dotnet.microsoft.com/en-us/download หากพร้อมแล้วลองรันคำสั่ง dotnet —version เพื่อเช็คความพร้อมกันหน่อย
เปิด Terminal หรือ Command Prompt แล้วพิมพ์คำสั่ง
dotnet new webapi -n UserApi
cd UserApi
- dotnet new webapi → สร้างโปรเจกต์ Web API
- n UserApi → ตั้งชื่อปรเจกต์ว่า UserApi
แล้วก็สามารถลองรันโปรเจกต์ด้วยคำสั่ง dotnet run ได้เลย พอเราใช้คำสั่งนี้แล้ว เราก็จะต้องหาว่าแอปมันรันที่ port ไหน? ง่าย ๆ เลยให้เราดูที่ Console
จะเห็นได้ว่าตอนนี้มันรันอยู่ที่ http://localhost:5080 แต่หากเราเปิดหน้าเว็บขึ้นมามันจะไม่เจออะไร
เพราะว่าโค้ดที่สร้างมาใหม่จากโปรเจกต์เริ่มต้นไม่ได้มี route ที่เป็น “/” เราสามารถไปดูได้ที่ไฟล์ Program.cs
จะเห็นได้ว่า route ที่มีมาให้จะเป็น “weatherforecast” นั่นเอง ทีนี้เราลองเข้าใหม่ที่ http://localhost:5080/weatherforecast ก็จะเจอข้อมูลที่มาจาก API แล้ว
โดยไฟล์ Program.cs เป็นไฟล์เริ่มต้นของเว็บแอป ASP.NET Core Minimal API ที่จะรันเว็บเซิร์ฟเวอร์
ซึ่งเราจะมาเริ่มแบบง่าย ๆ ก่อนเลยคือทำ API แค่ให้แสดงคำว่า Hello World ออกมา
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
// สร้าง Endpoint ง่าย ๆ
app.MapGet("/", () => "Hello World!");
app.Run();
ให้เราลองลบโค้ดทั้งหมดในไฟล์ Program.cs แล้วแทนที่โค้ดด้านบนไป ง่าย ๆ คือบรรทัดแรกเราก็ใช้ method .CreateBuilder() ที่มีอยู่ใน WebApplication เหมือนเราบอกว่าจะสร้างแอป แล้วรอรับ args ของที่จะเอามาสร้างแอป ต่อมาบรรทัดที่สองคือ Build() ก็คือเป็นตัวที่เวลาเอาของโน้นนี่นั้นมาสร้างแอปแล้ว ก็ Build แอปขึ้นมา สองส่วนนี้ไม่มีไม่ได้
ต่อมาใครเคยทำ API ก็จะคุ้นเคยกันดีการสร้าง Endpoint แบบ RESTFul API ที่ต้องมีการกำหนด Path ว่าจะไปที่ URL Path ไหน ใช้ Method อะไร และ .MapGet ก็คือวิธีเรียกใช้ method GET ในแบบของ .NET นั่นเอง สุดท้ายก็สตาร์ทเครื่องแอปของเราด้วย app.Run(); นั่นเอง
แค่นี้เราก็จะได้ API แรกที่สร้างด้วย .NET แล้วนั่นเอง เดี๋ยวส่วนอื่น ๆ แอดจะมาต่อให้ในบทความหน้านะคร้าบบบบ
