Freigeben über


URI.ParseServerAuthority Methode

Definition

Versucht, die Autoritätskomponente dieses URI, falls definiert, in Benutzerinformationen, Host- und Portkomponenten zu analysieren.

[Android.Runtime.Register("parseServerAuthority", "()Ljava/net/URI;", "")]
public Java.Net.URI? ParseServerAuthority ();
[<Android.Runtime.Register("parseServerAuthority", "()Ljava/net/URI;", "")>]
member this.ParseServerAuthority : unit -> Java.Net.URI

Gibt zurück

URI

Ein URI, dessen Autoritätsfeld als serverbasierte Autorität analysiert wurde

Attribute

Ausnahmen

wenn der Autoritätsteil nicht als serverbasierte Autorität analysiert werden konnte.

Hinweise

Versucht, die Autoritätskomponente dieses URI, falls definiert, in Benutzerinformationen, Host- und Portkomponenten zu analysieren.

Wenn die Autoritätskomponente dieses URI bereits als serverbasiert erkannt wurde, wurden sie bereits in Benutzerinformationen, Host- und Portkomponenten analysiert. In diesem Fall oder wenn dieser URI keine Autoritätskomponente aufweist, gibt diese Methode einfach diesen URI zurück.

Andernfalls versucht diese Methode erneut, die Autoritätskomponente in Benutzerinformationen, Host- und Portkomponenten zu analysieren, und löst eine Ausnahme aus, die beschreibt, warum die Autoritätskomponente auf diese Weise nicht analysiert werden konnte.

Diese Methode wird bereitgestellt, da die in RFC 2396 angegebene generische URI-Syntax keine falsch formatierte serverbasierte Autorität von einer legitimen registrierungsbasierten Autorität unterscheiden kann. Es muss daher einige Instanzen des früheren als Instanzen des letzteren behandelt werden. Die Autoritätskomponente in der URI-Zeichenfolge "//foo:bar"ist z. B. keine rechtliche serverbasierte Autorität, sie ist jedoch als registrierungsbasierte Autorität zulässig.

In vielen gängigen Situationen, z. B. beim Arbeiten von URIs, die als URNs oder URLs bekannt sind, werden die hierarchischen URIs, die verwendet werden, immer serverbasiert. Sie müssen daher entweder als solche analysiert oder als Fehler behandelt werden. In diesen Fällen wird eine Anweisung wie

<Blockquote u<= new URI(str).parseServerAuthority();/blockquote>URI>

kann verwendet werden, um sicherzustellen, dass u immer auf einen URI verweist, der, wenn er über eine Autoritätskomponente verfügt, über eine serverbasierte Autorität mit ordnungsgemäßen Benutzerinformationen, Host- und Portkomponenten verfügt. Durch Aufrufen dieser Methode wird auch sichergestellt, dass eine entsprechende Diagnosenachricht basierend auf der ausgelösten Ausnahme ausgegeben werden kann, wenn die Autorität nicht auf diese Weise analysiert werden konnte.

Java-Dokumentation für java.net.URI.parseServerAuthority().

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: