WebApp.Start <TStartup> Methode Typ Parameter

Question

In der Einrichtung Owin meine Windows-Service-Anwendung auf Selbst Host mit basierend auf diesem Artikel:

http://www.asp.net/web-api/overview/hosting-aspnet-web-api/use-owin-to-self-host-web-api

ich diese Überlastung der WebApp.Start Methode verwendet:

WebApp.Start Method (String)

Hier ist mein Code:

//(in startup method) 
_server = WebApp.Start<Startup>(BaseAddress); 

public class Startup 
{ 
    // This code configures Web API. The Startup class is specified as a type 
    // parameter in the WebApp.Start method. 
    public void Configuration(IAppBuilder appBuilder) 
    { 
     // Configure Web API for self-host. 
     var config = new HttpConfiguration(); 
     config.Routes.MapHttpRoute("DefaultApi", "api/{controller}/{id}", new 
     { 
      id = RouteParameter.Optional 
     }); 

     appBuilder.UseWebApi(config); 
    } 
} 

Es funktioniert gut, also keine Beschwerden.

Aber was genau sind die Anforderungen des Typparameters der Startmethode? Es scheint keine Einschränkungen zu geben, und ich konnte keine Dokumentation darüber finden, was meine Optionen/Anforderungen an diesem Parameter sind. Sucht es nach Methoden, die IAppBuilder als Parameter verwenden? Was passiert, wenn ich den Namen der Configuration() -Methode in etwas anderes ändere? Was, wenn ich die Methode intern mache? Gibt es andere Optionen, die ich mit dieser Klasse konfigurieren kann?

Wo ist das alles dokumentiert? Ich habe das Gefühl, ohne den oben genannten Artikel hätte ich nie herausfinden können, was ich umsetzen soll.

Answer 1

Die WebApp Klasse verwendet Reflektion, um einen Zeiger auf die Configuration(IAppBuilder) Methode zu erhalten, ruft sie dann auf. Wenn die Klasse, die Sie als Argument des generischen Typs angegeben haben, keine Configuration-Methode mit den erwarteten Argumenten hat, erhalten Sie zur Laufzeit einen Fehler.

Ich stimme zu, dass dies nicht so auffindbar ist, wie wir es gerne hätten, und ich bin nicht sicher, warum die ursprünglichen Entwickler es auf diese Weise implementiert haben, anstatt eine where T: IStartup Einschränkung hinzuzufügen. Dies würde nicht nur die Dokumentation ohne Dokumentation leichter machen, sondern es dem Compiler auch ermöglicht haben, dies zur Kompilierungszeit zu überprüfen.

Der einzige Vorteil dieses Ansatzes besteht darin, dass die OWIN-Entwickler in Zukunft weitere Methoden oder Methoden mit unterschiedlichen Signaturen hinzufügen können, ohne den vorhandenen Code zu unterbrechen.