24.09.2024
Interface
Alternativen zu Swagger in ASP.NET 9
Autor: Online Redaktion
dotnetpro
In ASP.NET 9 wurde Swagger aus den Templates entfernt. Es gibt jedoch weiterhin noch Alternativen, um interaktiv APIs zu erstellen und zu testen.
In der neuesten Version von ASP.NET, konkret in ASP.NET 9, hat das Entwicklungsteam das Tool Swagger aus den Standardvorlagen entfernt. Diese Entscheidung wurde getroffen, um die eigene Implementierung, die unter dem Microsoft.AspNetCore.OpenApi-Namespace läuft, voranzutreiben und eine Abhängigkeit von Swashbuckle zu vermeiden, das seit einer Weile nicht mehr aktiv gewartet wird. Bei der Erstellung eines neuen Projekts finden Entwickler nun lediglich das Minimalbeispiel, das die Nutzung von OpenAPI zeigt:
Code-Beispiel
Das zeigt Steven Giesel in einem Artikel. Mit dieser Konfiguration können Entwickler die OpenAPI-Spezifikation generieren, indem sie einfach zu https://localhost:<port>/openapi/v1.json navigieren. Allerdings müssen sie auf die vertraute interaktive Benutzeroberfläche verzichten, die Swagger bot.
Um diese Funktionalität wiederherzustellen, gibt es einige Alternativen. Die einfachste und unmittelbarste Lösung ist die erneute Installation von Swashbuckle. Das Paket wird weiterhin aktiv gewartet und ist wie gewohnt funktional. Nach der Installation fügen Entwickler einfach in ihrer Program.cs-Datei folgenden Code hinzu:
Code-Beispiel
1 2 |
<PackageReference Include="Swashbuckle.AspNetCore" Version="6.7.3" /> |
…
Für viele Entwickler ist Swagger aufgrund seiner hohen Anpassungsfähigkeit von großer Bedeutung.
Eine weitere Alternative stellt NSwag dar, das ebenso in der Lage ist, die Swagger-Benutzeroberfläche bereitzustellen. NSwag bietet zudem die Möglichkeit, TypeScript-Typen automatisch zu erstellen, was für Entwickler, die in modernen Webanwendungen arbeiten, äußerst nützlich sein kann.
Zu guter Letzt gibt es das neuere Tool Scalar, das ebenfalls mit .NET integriert werden kann. Scalar bietet eine ansprechende Benutzeroberfläche und kommt mit einem praktischen Onboarding-Guide. Um Scalar in ein ASP.NET-Projekt zu integrieren, installieren die Entwickler das Paket mittels:
Code-Beispiel
Nachfolgend ist ein Beispielcode für die Program.cs:
Code-Beispiel
ERP
Der digitale Zwilling des Unternehmens
Die digitale Transformation beruht in den meisten Unternehmen auf dem Einsatz von ERP-Software. Diese wird zunehmend zum entscheidenden Wettbewerbsfaktor.
>>
Programmiersprachen
Rust-nach-.NET-Compiler - ein Blick hinter die Kulissen
Ein Entwickler erklärt in einem Blogpost, was Unwinding und Panics in Rust sind und wie diese in einem Rust-to-.NET-Compiler behandelt werden.
>>
Künstliche Intelligenz
AlbiruniML, eine C#-Bibliothek für lineare Algebra und maschinelles Lernen
AlbiruniML bietet für Entwickler eine leistungsstarke Plattform für lineare Algebra und maschinelles Lernen in C#, inspiriert von TensorFlow.
>>
Interface
Alternativen zu Swagger in ASP.NET 9
In ASP.NET 9 wurde Swagger aus den Templates entfernt. Es gibt jedoch weiterhin noch Alternativen, um interaktiv APIs zu erstellen und zu testen.
>>