Partager via


URI.ParseServerAuthority Méthode

Définition

Tente d’analyser le composant d’autorité de cet URI, s’il est défini, en informations utilisateur, hôte et composants de port.

[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

Retours

URI

URI dont le champ d’autorité a été analysé en tant qu’autorité basée sur un serveur

Attributs

Exceptions

si la partie autorité n’a pas pu être analysée en tant qu’autorité basée sur le serveur.

Remarques

Tente d’analyser le composant d’autorité de cet URI, s’il est défini, en informations utilisateur, hôte et composants de port.

Si le composant d’autorité de cet URI a déjà été reconnu comme étant basé sur le serveur, il a déjà été analysé dans les informations utilisateur, l’hôte et les composants de port. Dans ce cas, ou si cet URI n’a aucun composant d’autorité, cette méthode retourne simplement cet URI.

Dans le cas contraire, cette méthode tente une fois de plus d’analyser le composant d’autorité dans les informations utilisateur, l’hôte et les composants de port, et lève une exception décrivant pourquoi le composant d’autorité n’a pas pu être analysé de cette façon.

Cette méthode est fournie, car la syntaxe d’URI générique spécifiée dans RFC 2396 ne peut pas toujours distinguer une autorité basée sur un serveur mal formée d’une autorité basée sur un registre légitime. Il doit donc traiter certaines instances de l’ancienne comme des instances de ce dernier. Le composant d’autorité dans la chaîne "//foo:bar"d’URI, par exemple, n’est pas une autorité basée sur un serveur légal, mais il est légal en tant qu’autorité basée sur le Registre.

Dans de nombreuses situations courantes, par exemple lors de l’utilisation d’URI connus sous la forme d’URL ou d’URL, les URI hiérarchiques utilisés sont toujours basés sur le serveur. Ils doivent donc être analysés comme tels ou traités comme une erreur. Dans ces cas, une instruction telle que

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

peut être utilisé pour s’assurer que u fait toujours référence à un URI qui, s’il a un composant d’autorité, a une autorité basée sur un serveur avec des informations utilisateur, un hôte et des composants de port appropriés. L’appel de cette méthode garantit également que si l’autorité n’a pas pu être analysée de cette façon, un message de diagnostic approprié peut être émis en fonction de l’exception levée.

Documentation Java pour java.net.URI.parseServerAuthority().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à