第一隻 .net 6 web api & mysql 8

學習.net 6 的基本環境建置，和連線 mysql 做資料 CRUD，寫 code 的部分不多，從基本的範本來觀摩 .net 6 web api 如何實作。

事前準備

1. 安裝 VS code, dbeaver, docker desktop
2. 安裝 .net 6 sdk & run time
3. docker 安裝 mysql ＆ 建立一個 table ex: Books
   參考資料： https://ithelp.ithome.com.tw/articles/10272193

4. 安裝 dotnet tool

# dotnet ef
dotnet 工具安裝 --global dotnet-ef   
dotnet 工具更新 --global dotnet-ef 

# dotnet-aspnet-codegenerator
dotnet 工具安裝-g dotnet-aspnet-codegenerator 
dotnet 工具更新-g dotnet-aspnet-codegenerator 

dotnet 工具列表-g   # 查看包（全城）

開始建立專案

• 建專案的目錄：~/Projects
• 專案名稱：BookApi
• 連線字串：”server=localhost;Port=3306;Database=Joe;User=DevAuth;Password=Dev127336;”

# 切到專案目錄
cd ~/Projects 

# 建立解決方案
dotnet new sln -o BookApi
cd BookApi

# 建立資料夾
mkdir BookApi
cd BookApi

# 建立 web api -f || --framework
dotnet new webapi -f net6.0

# ef core
dotnet add package Microsoft.EntityFrameworkCore 

# mysql provider
dotnet add package Pomelo.EntityFrameworkCore.MySql   

# dotnet-ef cli 的依賴
dotnet add package Microsoft.EntityFrameworkCore.Design 

# dotnet-aspnet-codegenerator cli 的依賴
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 6.0  # 最新版我的環境裝不過 所以裝v6

# dbcontext scaffold -o 產生的包裝的目錄 -c dbcontext -f 強制
dotnet ef dbcontext scaffold "server=localhost;Port=3306;Database=Joe; User=DevAuth;Password=Dev127336;" "Pomelo.EntityFrameworkCore.MySql" -o ./Models -c DataContext -f

# 產生 controller
dotnet aspnet-codegenerator controller --controllerName BookController -async -api -actions -m Book -dc DataContext -outDir Controllers -f

dotnet sln add Bookapi # 跑好之後 可以順便把專案 加入到解決方案裡面 
cat BookApi.sln # 看一下 可以看到我們的 BookApi 專案

# 切到專案內
cd BookApi

# git 
git init
dotnet new gitignore
git add .
git commit -m 'first commit'

# vs code 開啟
code .

先把用不到的檔案刪掉

rm WeatherForecast.cs 
rm WeatherForecastController
rm -r Data # Dbcontext 我們在 Models目錄底下 dotnet ef dbcontext scaffold 已經有幫我們產生好了

接下來 還有一些調整

Models/DataContext.cs

• override OnCofiguring 設定連線資訊
• _configuration.GetConnectionString 可以拿到 appsetting 設定檔
• override OnModelCreating 會對應資料庫設定

appsetting.json 設定檔

Program.cs

sql server 連線設定是 code generator 預設幫我們設定的 我們可以把 DbContextOptionsBuilder這段刪掉 然後要 using BookApi.Models;

Controllers/BookController.cs

這裡出現了很多報錯 是因為 dbset 沒有跟我們dbcontext 對應上加上s就好了

dotnet build # 建置
dotnet run # 運行

在 swagger/index.html 目錄下 就會有預設的 swagger 可以測試api 囉！

.net 6幫我設定好 swagger 真的很方便，就不用再自己開 postman 打 api

appxtech