[.NET 5] เริ่มต้นทำ RestFul Api ด้วย .NET 5 (ติดตั้ง) ตอน 1

เริ่มต้นทำ RestFul Api ด้วย .NET 5 (ติดตั้ง) ตอน 1

.NET 5 เป็นอีกขั้นของ .Net Core 3.1 หรือ .Net Core ที่ผ่านๆมาทุก Version มันคือ Version ล่าสุด ณ​ วันที่เขียนบทความนี้อยู่

โดยทำไมต้องชื่อ .NET 5 แทนที่จะเป็น .NET Core 4 หรือ .NET Core 4 ก็เพราะว่า กันความสับสน เรื่องชื่อกับ .Net Framework 4

และทำไมจะต้องตัดคำว่า Core ออก ก็เพราะว่า .NET 5 นั้น มันคือการผสมผสานหลายๆ Feature ระหว่าง .NET Core version เดิมๆ หรือ .Net Framework และมี Feature อีกมากมายที่เพิ่มเข้ามา ก็เลยเอาคำว่า Core ออกเพราะมันล้ำไปกว่านั้นแล้ว

งั้นเรามาเริ่มต้นกันเลยครับ สำหรับการทำ RestFul API ด้วย .NET 5

STEP 1) Download .NET 5 SDK (Software Development Kit)

Download .NET (Linux, macOS, and Windows)

เมื่อเข้ามาแล้วจะมีหน้าให้ Download SDK ถ้าใครใช้ระบบปฏิบัติการ Windows ก็เลือก Download ให้ถูก Operating System

หน้าจอ Download .NET 5 SDK เลือก OS ให้ถูกและไปต่อกันครับ

โดยผู้ใช้ MacOS สามารถใช้คำสั่งของ brew ในการติดตั้งได้ง่ายๆ ด้วยคำส่ัง

brew install --cask dotnet-sdk

เมื่อทุกคนติดตั้งเสร็จแล้ว ลองเปิด Terminal ของเครื่องตัวเองและใช้คำสั่ง

dotnet --version

เมื่อใช้คำสั่ง dotnet — version หลังจากติดตั้งเสร็จแล้วจะได้ดังภาพนี้

STEP 2) เริ่มต้นสร้าง Project .Net 5 RestFul API

ให้เพื่อนๆ เริ่มต้นจากการ พื้นที่ว่างๆบนเครื่อง Computer ของทุกคน ตรงไหนก็ได้ซักที่แล้วใช้คำสั่งนี้ บน Terminal ของเพื่อนๆ

dotnet new webapi -o example-dotnet-api

อธิบายคำสั่งคือ เรากำลังจะสร้าง Project .Net 5 ในรูปแบบประเภทของ WebAPI โดย เมื่อ Initial ทุกอย่างเสร็จหมดแล้ว ให้สร้าง Folder example-dotnet-api แล้วเอาทุกอย่างไปไว้ในนั้นด้วยนะ

เมื่อ Initial Project .Net 5 สมบูรณ์ก็จะได้หน้าจอเหมือน Terminal ดังภาพ

STEP 3) เริ่มต้น Run Project .NET 5 ครั้งแรก

เมื่อทุกคนอยู่ภายใต้ Folder ชื่อ example-dotnet-api เรียบร้อยแล้ว ให้ทุกคนใช้คำสั่งนี้ในการ Start Server ของ Project .NET 5 WebAPI ขึ้นมา

dotnet watch run

เมื่อ Start Server .NET 5 WebAPI สมบูรณ์ก็จะได้หน้าตาดังภาพ

อธิบายคำสั่ง dotnet watch run โดยปกติ เราสามารถใช้คำสั่ง dotnet run เฉยๆในการ Start Server ขึ้นมาก็ได้เช่นกัน แต่ที่เราเพิ่มคำสั่ง watch เข้าไปด้วยก็

เพราะว่า เมื่อไหร่ก็ตาม ที่เราแก้ไข Source Code ของ Project .NET 5 ตัว dotnet server ก็จะ Auto Restart ให้เรา โดยที่เราไม่ต้องมาคอย dotnet run บ่อยๆ ทุกครั้งที่เราแก้ไข Source Code

และที่สำคัญขณะที่เพื่อนๆ run คำสั่ง dotnet watch run อยู่นั้น ตัว .NET 5 ก็จะ Auto เปิด Browser ของเพื่อนๆขึ้นมา พร้อมเข้า

URL: https://localhost:5001/swagger/index.html ให้แบบ Auto

Default API Document (Swagger) ที่ติดตั้งมาให้ใน .NET 5 WebAPI

สิ่งที่เพื่อนๆเห็นในภาพมันก็คือ API Document (Swagger) ที่ติดตั้งมาให้เป็น Default ของตัว .NET 5 WebAPI เอง ไว้ในบทอื่นๆจะค่อยมาลงในรายละเอียดของส่วน Swagger มากขึ้น

STEP 4) ลองยิง API ครั้งแรก

ผมอยากให้เพื่อนลองเปิด POSTMAN หรือลองเอา URL นี้ไปแนบบน URL Bar ของ Browser ก็ได้แล้วก็ลองกด Enter หรือลองยิงด้วย POSTMAN ดู

https://localhost:5001/WeatherForecast

ก็จะได้ JSON Response ที่เป็นค่าการพยากรอากาศออกมา ซึ่งเป็น API Example ของตัว .NET 5

STEP 5) เพิ่ม API ของเราเองอีก 1 เส้นแบบไวๆ ต้องทำอย่างไร

ก่อนที่จะถึงตอน 2 อธิบาย โครงสร้างของตัว Project .NET 5 WebAPI เผื่อเพื่อนๆ คนไหนรีบใช้งาน API ก่อน สามารถ เปิดไฟล์ชื่อ WeatherForecastController.cs

เมื่อเปิดไฟล์แล้วจะได้ลักษณะไฟล์ดังภาพนี้

วิธีการเพิ่ม API อีกเส้น ก็คือ ทำตามตัวอย่าง Source Code ด้านล่างนี้ครับ ยกตัวอย่างว่า เราจะทำ API ดึงข้อมูลสภาพอากาศกรุงเทพ โดยเรา Hard Code อุณหภูมิเอาไว้ว่า 34 องศา เราจะเติม Source Code ไปแบบนี้

เมื่อลองเอา Source Code ไปวางในไฟล์ WeatherForecastController.cs ถ้าใคร Start Server ด้วย dotnet watch run ก็สามารถ ทดลองยิง

API URL : https://localhost:5001/WeatherForecast/bangkok

เมื่อวาง Source Code ถูกต้องและลองยิงแล้วก็จะได้หน้าตาตามภาพนี้

หวังว่าบทความนี้ จะเป็นความรู้เบื้องต้นในการใช้งาน .NET 5 WebAPI ได้ ในตอน 2 ในบทความถัดไป จะเป็นเรื่องของ การอธิบายโครงสร้างตัว Project อะไรควรวางตรงไหน ไฟล์นี้คือไฟล์อะไร ต่างๆมากมาย และเพื่อนๆจะเข้าใจมันยิ่งขึ้นครับ