.NET 教學課程 - 您的第一個微服務

建立您的服務

在命令提示字元中,執行下列命令以建立您的應用程式:

在終端機中,執行下列命令以建立您的應用程式:

Command prompt
dotnet new webapi -o MyMicroservice --no-https

然後,瀏覽至上一個命令所建立的新目錄:

Command prompt
cd MyMicroservice

這些命令代表什麼?

dotnet 命令會建立類型 webapi (即 REST API 端點) 的新應用程式。

  • -o 參數會建立名為 MyMicroservice 的目錄,以儲存您的應用程式。
  • --no-https 旗標會建立可在沒有 HTTPS 憑證的情況下執行的應用程式,讓部署保持簡單。

cd MyMicroservice 命令可讓您進入新建立的應用程式目錄。

產生的程式碼

MyMicroservice 目錄中建立了數個檔案,為您提供一個可供執行的簡單服務,包括下列檔案:

  • Program.cs 是進入點檔案,並包含應用程式啟動時載入的所有設定和組態,而且具有簡單 API 的程式碼,可傳回未來五天的天氣預測。它也會啟動應用程式。
  • MyMycroservice.http 會用於測試 ASP.NET Core 專案。
  • MyMicroservice.csproj 定義應用程式的目標 .NET 版本、專案參考的程式庫等等。
  • Properties 目錄內的 launchSettings.json 檔案會定義本機開發環境的不同設定檔設定。專案建立時會自動指派介於 5000 至 5300 之間的連接埠編號,並儲存在此檔案。

下列程式碼顯示 Program.cs 檔案的內容:

Program.cs
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

var summaries = new[]
{
    "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
};

app.MapGet("/weatherforecast", () =>
{
    var forecast =  Enumerable.Range(1, 5).Select(index =>
        new WeatherForecast
        (
            DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
            Random.Shared.Next(-20, 55),
            summaries[Random.Shared.Next(summaries.Length)]
        ))
        .ToArray();
    return forecast;
})
.WithName("GetWeatherForecast")
.WithOpenApi();

app.Run();

record WeatherForecast(DateOnly Date, int TemperatureC, string? Summary)
{
    public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
}

選取下方的 [繼續] 按鈕以移至下一個步驟。

發生錯誤嗎?

如果您收到類似 無法建立範本「ASP.NET Core Web API」。無法建立範本。詳細資料: 拒絕存取路徑 'C:\Windows\System32\MyMicroservice',請將您目前的目錄變更為您有權限建立新資料夾的目錄,然後嘗試重新執行命令。

若 Windows 在您嘗試建立專案時找不到 SDK,且您確定已安裝 SDK,您的電腦可能會發生 PATH 環境變數的問題。如需如何診斷及修正此問題的說明,請參閱這篇 Stack Overflow 文章

如果您無法解決目前發生的問題,請選取下方的 [我遇到問題] 按鈕,以取得解決問題的協助。

繼續