Slide 1
Slide 1 text
No content
Slide 2
Slide 2 text
2
in .NET 5
▪
▪
▪
▪
▪
▪
▪
▪
▪ Twitter:
Slide 3
Slide 3 text
3
▪
▪
▪
▪
▪
in .NET 5
Slide 4
Slide 4 text
4
in .NET 5
Slide 5
Slide 5 text
5
• Anforderungen ändern sich
• APIs verändern sich zwangsläufig mit
• Breaking changes können nicht ausgeschlossen werden
in .NET 5
• Bei (öffentlichen) APIs, deren Clients nicht unter eigener Kontrolle sind
P
Slide 6
Slide 6 text
6
• Endpunkte
• Entfernen von Endpunkten
• Hinzufügen von neuen Pflichtparametern
• Änderungen am Verhalten von Endpunkten
• Datenmodell
• Entfernen oder Umbenennen von vorher gelieferten Daten
• Ändern von Datentypen
• Hinzufügen neuer Pflichtdaten beim Empfang (entweder ganz neu oder vorher optional)
• [Hinzufügen von neuen Daten beim Senden, für unflexible Clients]
in .NET 5
Slide 7
Slide 7 text
7
in .NET 5
Slide 8
Slide 8 text
8
in .NET 5
Slide 9
Slide 9 text
9
in .NET 5
Slide 10
Slide 10 text
10
in .NET 5
Slide 11
Slide 11 text
11
in .NET 5
P
Slide 12
Slide 12 text
12
in .NET 5
Slide 13
Slide 13 text
13
• Mittels externer Bibliothek
• NuGet: Microsoft.AspNetCore.Mvc.Versioning
• GitHub: https://github.com/microsoft/aspnet-api-versioning
• Hinweis
• Paket stammt nicht vom ASP.NET Core Team
• Nicht im aspnet/AspNetCore Repository
• Kein offizielles von Microsoft supportetes Paket
• Gewartet von einem Microsoft Entwickler aus dem Bing-Team
in .NET 5
Slide 14
Slide 14 text
14
• Version
• [Version Group.].[-Status]
• [.[.Minor]][-Status]
• Version Group
• YYYY-MM-DD
• Beispiele:
• 1.0
• 2.1-RC1
• 2019-11-07.1
• 2019-11-07.2.1-Alpha
in .NET 5
Slide 15
Slide 15 text
15
• Version kann festgelegt warden
• Auf einem Controller
• Auf einer einzelnen Action
• Ermöglicht
• Einen Controller pro Version
• Mehrere Action-Versionen auf einem Controller
• Beliebig mischbar
• Angefragte, aber nicht gefundene Version liefert einen 400 Bad Request
• Default-Version kann optional konfiguriert werden
• Es gibt viele weitere Konfigurations- und Anpassungsmöglichkeiten
in .NET 5
Slide 16
Slide 16 text
16
▪
▪
▪
▪
▪
in .NET 5
Slide 17
Slide 17 text
31
in .NET 5
Slide 18
Slide 18 text
32
• API-Versionierung ist nicht immer notwendig
• Es gibt verschiedene Arten der Versionsauswahl
• There’s a NuGet for that
• Allerdings nicht offiziell vom ASP.NET Core Team
• Verwendung benötigt wenig Code
• Aber etwas Gehirnschmalz bei der Planung
in .NET 5
1:1
Slide 19
Slide 19 text
No content