Minimal Hosting API

22 Jan 2023 - Matthias Voigt

Minimal Hosting APIs sind eine neue Funktion in ASP.NET Core, die es ermöglicht, einfache APIs mit minimalem Code und Konfiguration zu erstellen. Diese APIs sind besonders nützlich für kleine Dienste oder Microservices, bei denen eine vollständige ASP.NET Core-Setup überflüssig wäre.

Ein einfaches Beispiel

Hier ein einfaches Beispiel, wie man eine Minimal API in ASP.NET Core erstellt:

1. Projekt erstellen: Erstelle ein neues ASP.NET Core-Projekt über die Kommandozeile oder Visual Studio.

2. Program.cs bearbeiten: Die gesamte Konfiguration und die API-Definition erfolgen in der Program.cs-Datei.

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

In diesem Beispiel wird eine einfache GET-Route definiert, die “Hello World!” zurückgibt.

Vorteile von Minimal Hosting APIs

1. Weniger Code: Minimal Hosting APIs erfordern weniger Code, was die Entwicklung schneller und einfacher macht.
2. Einfache Konfiguration: Die gesamte Konfiguration erfolgt in einer Datei, was die Verwaltung erleichtert.
3. Perfekt für Microservices: Diese APIs sind ideal für kleine Dienste und Microservices, die keine umfangreiche Konfiguration benötigen.

Erweiterung der API

Natürlich kann man auch komplexere APIs mit minimalen APIs erstellen. Hier ein Beispiel mit einem einfachen CRUD-API:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var items = new List<string>();

app.MapGet("/items", () => items);
app.MapPost("/items", (string item) => items.Add(item));
app.MapPut("/items/{index}", (int index, string item) => items[index] = item);
app.MapDelete("/items/{index}", (int index) => items.RemoveAt(index));

app.Run();

In diesem Beispiel wird eine Liste von Strings verwaltet, und es gibt Endpunkte zum Abrufen, Hinzufügen, Aktualisieren und Löschen von Einträgen.

Fazit

Minimal Hosting APIs sind eine großartige Ergänzung zu ASP.NET Core, die es Entwicklern ermöglicht, schnell und einfach kleine, leistungsfähige APIs zu erstellen. Sie sind besonders nützlich für Microservices und andere Szenarien, in denen eine minimale Konfiguration und ein schlanker Code von Vorteil sind.

Für weitere Informationen und eine detaillierte Anleitung besuche den Link zur Quelle.