Ich betreibe meine Website hinter einem Loadbalancer auf einem nicht standardmäßigen Port. Beim Laden der / metadata-Seite hat mein öffentlicher Domain-Name noch den lokalen Port, auf dem die App gehostet wird, wodurch auch die Links zu den verschiedenen Formaten unterbrochen werden.
Beispiel:
Gibt es eine Möglichkeit, diese Links in der Ausgabe anzupassen? Ist es außerdem möglich, den anderen Text / css / etc der Seite so anzupassen, dass er so angepasst werden kann, dass er in die Vorlage passt, die ich für den Rest meiner Site verwende?
v4 ServiceStack bietet eine Reihe neuer Möglichkeiten zum Anpassen der integrierten Metadaten-Seiten:
Das virtuelle Dateisystem von ServiceStack greift standardmäßig (d. h. wenn keine physische Datei vorhanden ist) auf die Suche nach eingebetteten Ressourcendateien in DLLs zurück.
Sie können die Anzahl und den Vorrang der Assemblies angeben, die mit Config.EmbeddedResourceSources betrachtet werden, die standardmäßig Folgendes anzeigen:
Mit dem VFS können Sie jetzt die integrierten ServiceStack-Metadatenseiten und -Templates vollständig durch eigene ersetzen, indem Sie einfach die Metadaten oder HtmlFormat Template-Dateien, die Sie anpassen möchten, kopieren und in Ihren Ordner einfügen:
Sie können Links zu Ihren eigenen Plugins auf den Metadatenseiten hinzufügen mit:
%Vor% AddPluginLink fügt Links im Abschnitt Plugin-Links hinzu, während AddDebugLink von Plugins verwendet werden kann, die nur während des Debuggens oder der Entwicklung verfügbar sind.
Viele der Attribute, die in Swagger verwendet werden, werden auch in den Metadatenseiten verwendet zB:
%Vor%ServiceStack Die Metadata-Seite ermöglicht eine eingeschränkte Anpassung über die EndpointHostConfig Konfigurationseinstellungen (in denen alle ServiceStack-Konfigurationslebensläufe enthalten sind). Z.B. Sie können die Homepage Body HTML und die Seite Betriebsseite in Ihrem AppHost mit:
ändern %Vor%Sie können auch weitere Metadaten-Dokumentation für jeden Web-Service hinzufügen, indem Sie das Anforderungs-DTO mit dem [Description] -Attribut verknüpfen, wie in MoviesRest Beispielprojekt :
%Vor%Und wie sieht es auf der MoviesRest / Metadatenseite aus?
>Schauen Sie hier für Einblicke. Es geht nicht darum, wie man die Metadaten-Seite anpasst, sondern wie man XHTML verwendet, um dasselbe über Hypermedia-APIs zu machen.
Die Seite Metadaten des Service-Stacks ist vollständig anpassbar. Sie können Attribute verwenden, um bestimmte Eigenschaften oder Dienste zu kommentieren, während der automatisch generierte Inhalt beibehalten wird.
Der Inhalt wird mit eingebetteten HTML-Vorlagen geliefert und kann auch für eine detaillierte Anpassung ersetzt werden.
Die Metadatenseiten können vollständig deaktiviert werden, was ich normalerweise mache , indem ich das folgende Snippet verwende.
%Vor%Weitere Details finden Sie auf Service Stack Wiki .
Tags und Links api servicestack metadata