URI Classe

Définition

[Android.Runtime.Register("java/net/URI", DoNotGenerateAcw=true)]
public sealed class URI : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable

[<Android.Runtime.Register("java/net/URI", DoNotGenerateAcw=true)>]
type URI = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable

Héritage

Object

JavaObject

Object

URI

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable ISerializable IComparable IDisposable

Remarques

Représente une référence URI (Uniform Resource Identifier).

Outre certains écarts mineurs indiqués ci-dessous, une instance de cette classe représente une référence d’URI telle que définie par RFC  ; 2396 : Uri (Uniform Resource Identifiers) : Syntaxehttp://www.ietf.org/rfc/rfc2396.txt générique modifiée par RFC  ; 2732 : Format des adresses IPv6 littérales dans leshttp://www.ietf.org/rfc/rfc2732.txt URL. Le format d’adresse IPv6 littéral prend également en charge scope_ids. La syntaxe et l’utilisation de scope_ids sont décrites ici. Cette classe fournit aux constructeurs la création d’instances d’URI à partir de leurs composants ou l’analyse de leurs formulaires de chaîne, des méthodes permettant d’accéder aux différents composants d’une instance et des méthodes de normalisation, de résolution et de relativisation des instances d’URI. Les instances de cette classe sont immuables.

<Syntaxe et composants >d’URI h3< /h3>

Au niveau le plus élevé, une référence d’URI (ci-après simplement « URI ») sous forme de chaîne a la syntaxe

<blockquote> [scheme<b><:/b>]scheme-specific-part[<b>#</b>fragment] </blockquote>

où les crochets [...] délimitent les composants facultatifs et les caractères <b>:</b et >b<>#</b> se trouvent eux-mêmes.

Un URI absolu spécifie un schéma ; un URI qui n’est pas absolu est dit être relatif. Les URI sont également classés selon qu’ils sont opaques ou hiérarchiques.

Un URI opaque est un URI absolu dont la partie spécifique au schéma ne commence pas par une barre oblique ('/'). Les URI opaques ne sont pas soumis à une analyse supplémentaire. Voici quelques exemples d’URI opaques :

<table blockquote><cellpadding=0 cellspacing=0 summary="layout"><tr><td>mailto:java-net@java.sun.com<></tr><><>news:comp.lang.java<td></tr tr tr td/tr><tr><td>urn:isbn:096139210x</td></tr></table></blockquote>

Un URI hiérarchique est un URI absolu dont la partie spécifique au schéma commence par un caractère de barre oblique ou un URI relatif, autrement dit, un URI qui ne spécifie pas de schéma. Voici quelques exemples d’URI hiérarchiques :

<blockquote>http://java.sun.com/j2se/1.3/<br br>docs/guide/collections/designfaq.html#28<>../../../demo/jfc/SwingSet2/src/SwingSet2.java<>file:///~/calendar</blockquote>

Un URI hiérarchique est soumis à une analyse supplémentaire en fonction de la syntaxe

<blockquote> [scheme<b>:</b>][<b>//</b>authority][path][<b><?/b>query][<b>#</b>fragment] </blockquote>

où les caractères <b>:</b, >b<>/</b>, <b>?</b> et <b>#</b> se trouvent eux-mêmes. La partie spécifique au schéma d’un URI hiérarchique se compose des caractères entre le schéma et les composants de fragment.

Le composant d’autorité d’un URI hiérarchique est, s’il est spécifié, basé sur un serveur ou un registre. Une autorité basée sur un serveur analyse en fonction de la syntaxe familière

<blockquote> [user-info<b><@/b>]host[<b>:</b>port] </blockquote>

où les caractères <b>@</b> et <b>:</b> se trouvent eux-mêmes. Presque tous les schémas d’URI actuellement utilisés sont basés sur le serveur. Un composant d’autorité qui n’analyse pas de cette façon est considéré comme basé sur le Registre.

Le composant de chemin d’accès d’un URI hiérarchique est lui-même dit absolu s’il commence par un caractère oblique ('/') ; sinon il est relatif. Chemin d’accès d’un URI hiérarchique qui est absolu ou spécifie qu’une autorité est toujours absolue.

Tout dit, alors, une instance d’URI a les neuf composants suivants :

<table blockquote><summary="Décrit les composants d’un URI :scheme,scheme-specific-part,authority,user-info,host,port,path,query,fragment"><tr><th>/th th<><>Type</th>< tr tr><><td scheme>/td<><>String</><tr tr><><>scheme-specific-part  ;   ;   ;   ;</td><td>String</td></tr tr><><td>authority</td><td>String</td></tr tr><><>td user-info</td><>String</td></tr tr><td/tr><>td host</td/td><>String<></tr tr><tr><td>port</td td><>int/td</tr>< tr><td/td/tr><>tr td</td><>String</tr><><tr><td>query</td><>String</td/td></tr tr><><td>fragment</td td><>String/td<></tr/tr></table></blockquote>

Dans une instance donnée, tout composant particulier n’est pas défini ou défini avec une valeur distincte. Les composants de chaîne non définis sont représentés par null, tandis que les composants entiers non définis sont représentés par -1. Un composant de chaîne peut être défini pour avoir la chaîne vide comme valeur ; cela n’équivaut pas à ce composant qui n’est pas défini.

Si un composant particulier est ou non défini dans une instance dépend du type de l’URI représenté. Un URI absolu a un composant de schéma. Un URI opaque a un schéma, une partie spécifique à un schéma, et éventuellement un fragment, mais n’a pas d’autres composants. Un URI hiérarchique a toujours un chemin d’accès (même s’il peut être vide) et une partie spécifique au schéma (qui contient au moins le chemin) et peut avoir l’un des autres composants. Si le composant d’autorité est présent et est basé sur le serveur, le composant hôte est défini et les informations utilisateur et les composants de port peuvent être définis.

<Opérations h4> sur les instances <d’URI /h4>

Les opérations clés prises en charge par cette classe sont celles de normalisation, de résolution et de relativisation.

La normalisation est le processus de suppression inutile "." et ".." de segments du composant de chemin d’accès d’un URI hiérarchique. Chaque "." segment est simplement supprimé. Un ".." segment est supprimé uniquement s’il est précédé d’un non-segment".." . La normalisation n’a aucun effet sur les URI opaques.

La résolution est le processus de résolution d’un URI par rapport à un autre URI de base . L’URI résultant est construit à partir de composants des deux URI de la manière spécifiée par RFC  ; 2396, en prenant des composants de l’URI de base pour ceux qui ne sont pas spécifiés dans l’original. Pour les URI hiérarchiques, le chemin d’accès de l’original est résolu par rapport au chemin de la base, puis normalisé. Résultat, par exemple, de résolution

<blockquote>docs/guide/collections/designfaq.html#28   ;   ;   ;   ;   ;   ;   ;   ;   ;   ;   ;   ;   ;   ;   ;   ; (1) </blockquote>

par rapport à l’URI http://java.sun.com/j2se/1.3/ de base est l’URI de résultat

<blockquote/blockquote>http://java.sun.com/j2se/1.3/docs/guide/collections/designfaq.html#28<>

Résolution de l’URI relatif

<blockquote>../../../demo/jfc/SwingSet2/src/SwingSet2.java  ;   ;   ;   ; (2) </blockquote>

contre ce résultat génère, à son tour,

<blockquote/blockquote>http://java.sun.com/j2se/1.3/demo/jfc/SwingSet2/src/SwingSet2.java<>

La résolution des URI absolus et relatifs, ainsi que des chemins absolus et relatifs dans le cas d’URI hiérarchiques, est prise en charge. La résolution de l’URI file:///~calendar par rapport à n’importe quel autre URI génère simplement l’URI d’origine, car il est absolu. La résolution de l’URI relatif (2) ci-dessus par rapport à l’URI de base relatif (1) génère l’URI normalisé, mais toujours relatif, URI

<blockquote/blockquote>demo/jfc/SwingSet2/src/SwingSet2.java<>

La relativisation, enfin, est l’inverse de la résolution : pour deux URI normalisés u et  ; v,

<blockquote>u.relativize(.resolve(v v)).equals()  ;   ; et<br>u.resolve(u.relativize(v v)).equals()  ;   ;.<br></blockquote>

Cette opération est souvent utile lors de la construction d’un document contenant des URI qui doivent être effectués par rapport à l’URI de base du document dans la mesure du possible. Par exemple, relativiser l’URI

<blockquote/blockquote>http://java.sun.com/j2se/1.3/docs/guide/index.html<>

par rapport à l’URI de base

<blockquote/blockquote>http://java.sun.com/j2se/1.3<>

génère l’URI docs/guide/index.htmlrelatif .

<catégories >de caractères h4< /h4>

RFC  ; 2396 spécifie précisément quels caractères sont autorisés dans les différents composants d’une référence d’URI. Les catégories suivantes, dont la plupart sont extraites de cette spécification, sont utilisées ci-dessous pour décrire ces contraintes :

<blockquote><table cellspacing=2 summary="Décrit les catégories alpha,digit,alphanum,unreserved,punct,reserved,escaped,and other"><tr><th valign=top>alpha</th><td>The US-ASCII alphabetic characters, 'A'  ; through  ;'Z' et 'a'  ; through  ;'z'</td></tr tr><><th valign=top>digit</th><td>The US-ASCII decimal digit characters, '0'  ; through  ;'9'</td></tr tr><><th valign=> alphanum</th><td>All alpha and digit characters</td></tr tr><><th valign=top> unreserved  ;   ;   ;   ;</th><td>Tous les caractères alphanum avec ceux de la chaîne "_-!.~'()*"</td></tr tr><><th valign=top>punct</th><td>Les caractères de la chaîne ",;:$&+="</td></tr tr><><th valign=top> reserved</th><td>All punct characters with the string "?/[]@"</td></tr><tr><th valign=top>octets escaped</th><>td escaped, autrement dit, triplets composés du caractère de pourcentage ('%') suivis de deux chiffres hexadécimaux ('0'-'9','A'-'F' et'a'-'f' )</td></tr tr><><tr th valign=top>/<th><td>Les caractères Unicode qui ne figurent pas dans le jeu de caractères US-ASCII, ne sont pas des caractères de contrôle (selon le java.lang.Character#isISOControl(char) Character.isISOControl méthode), et ne sont pas des caractères d’espace (selon la java.lang.Character#isSpaceChar(char) Character.isSpaceChar méthode)  ;   ; (<Écart>de RFC 2396</b>, limité à US-ASCII)</td></tr></table></blockquote>

« legal-chars »> L’ensemble de tous les caractères d’URI juridiques se compose des caractères non réservés, réservés, échappés et autres caractères.

< > octets échapés, guillemets, encodage et décodage </h4>

RFC 2396 permet aux octets échappés d’apparaître dans les composants d’informations utilisateur, de chemin, de requête et de fragment. L’échappement sert à deux fins dans les URI :

<ul>

<li>

Pour encoder des caractères nonUS-ASCII lorsqu’un URI est requis pour se conformer strictement à RFC  ; 2396 en ne contenant aucun autre caractère.

</li>

<li>

Pour citer des caractères qui ne sont pas valides dans un composant. Les informations utilisateur, le chemin d’accès, la requête et les composants de fragment diffèrent légèrement en termes de caractères considérés comme légaux et non valides.

</li>

</ul>

Ces objectifs sont servis dans cette classe par trois opérations connexes :

<ul>

<li>

« encoder »> Un caractère est encodé en le remplaçant par la séquence d’octets échappés qui représentent ce caractère dans le jeu de caractères UTF-8. Le symbole monétaire euro ('\u005Cu20AC'par exemple, est encodé en tant que "%E2%82%AC". (<b>Écart par rapport à RFC  ; 2396</b>, qui ne spécifie aucun jeu de caractères particulier.)

</li>

<li>

« quote »> Un caractère illégal est cité simplement en l’encodant. Le caractère d’espace, par exemple, est entre guillemets en le remplaçant par "%20". UTF-8 contient US-ASCII. Par conséquent, pour US-ASCII caractères, cette transformation a exactement l’effet requis par RFC  ;2396.

</li>

<li>

« décoder »> Une séquence d’octets échapés est décodée en la remplaçant par la séquence de caractères qu’elle représente dans le jeu de caractères UTF-8. UTF-8 contient US-ASCII, par conséquent, le décodage a l’effet de décoder les caractères entre guillemets US-ASCII ainsi que celui du décodage des caractères non-US-ASCII codés. Si une erreur de décodage se produit lors du décodage des octets échappés, les octets erronés sont remplacés par '\u005CuFFFD', le caractère de remplacement Unicode.

</li>

</ul>

Ces opérations sont exposées dans les constructeurs et méthodes de cette classe comme suit :

<ul>

<li>

Le constructeur à argument unique (java.lang.String) #URI(java.lang.String) exige que tous les caractères non autorisés dans son argument soient entre guillemets et conservent tous les octets échappés et d’autres caractères présents.

</li>

<li>

Le #URI(java.lang.String,java.lang.String,java.lang.String,int,java.lang.String,java.lang.String,java.lang.String) cite des caractères non valides comme requis par les composants dans lesquels ils apparaissent. Le caractère de pourcentage ('%') est toujours cité par ces constructeurs. Tous les autres caractères sont conservés.

</li>

<li>

Les #getRawUserInfo() getRawUserInfométhodes , #getRawPath() getRawPath#getRawQuery() getRawQuery#getRawFragment() getRawFragment#getRawAuthority() getRawAuthorityet #getRawSchemeSpecificPart() getRawSchemeSpecificPart retournent les valeurs de leurs composants correspondants sous forme brute, sans interpréter d’octets échappés. Les chaînes retournées par ces méthodes peuvent contenir à la fois des octets d’échappement et d’autres caractères, et ne contiennent aucun caractère illégal.

</li>

<li>

Les #getUserInfo() getUserInfométhodes , #getPath() getPath#getQuery() getQuery#getFragment() getFragment#getAuthority() getAuthority#getSchemeSpecificPart() getSchemeSpecificPart décodent tous les octets échappés dans leurs composants correspondants. Les chaînes retournées par ces méthodes peuvent contenir à la fois d’autres caractères et des caractères non valides, et ne contiennent pas d’octets d’échappement.

</li>

<li>

La #toString() toString méthode retourne une chaîne d’URI avec tous les guillemets nécessaires, mais qui peut contenir d’autres caractères.

</li>

<li>

La #toASCIIString() toASCIIString méthode retourne une chaîne d’URI entièrement entre guillemets et encodées qui ne contient aucun autre caractère.

</li>

</ul>

<Identités >h4< /h4>

Pour n’importe quel URI u, il s’agit toujours du cas

<blockquote>new URI(u.toString()).equals()  ;. </blockquote>

Pour tout URI u qui ne contient pas de syntaxe redondante, comme deux barres obliques avant une autorité vide (comme dans file:///tmp/  ;) ou un signe deux-points suivant un nom d’hôte, mais pas de port (comme dans http://java.sun.com:  ;), et qui n’encode pas les caractères à l’exception de ceux qui doivent être cités, les identités suivantes contiennent également :

new URI(<i>u</i>.getScheme(),
<i>u</i>.getSchemeSpecificPart(),
<i>u</i>.getFragment())
                .equals(<i>u</i>)

dans tous les cas,

new URI(<i>u</i>.getScheme(),
<i>u</i>.getUserInfo(), <i>u</i>.getAuthority(),
<i>u</i>.getPath(), <i>u</i>.getQuery(),
<i>u</i>.getFragment())
                .equals(<i>u</i>)

si u est hiérarchique et

new URI(<i>u</i>.getScheme(),
<i>u</i>.getUserInfo(), <i>u</i>.getHost(), <i>u</i>.getPort(),
<i>u</i>.getPath(), <i>u</i>.getQuery(),
<i>u</i>.getFragment())
                .equals(<i>u</i>)

si u est hiérarchique et n’a pas d’autorité ou d’autorité basée sur un serveur.

<URI h4> , URL et URL </h4>

Un URI est un identificateur de ressource uniforme alors qu’une URL est un localisateur de ressources uniforme. Par conséquent, chaque URL est un URI, abstraitement, mais pas chaque URI est une URL. Cela est dû au fait qu’il existe une autre sous-catégorie d’URI, des noms de ressources uniformes (URN), les ressources de nom, mais ne spécifient pas comment les localiser. mailto news Les isbnURI présentés ci-dessus sont des exemples d’URN.

La distinction conceptuelle entre les URI et les URL est reflétée dans les différences entre cette classe et la URL classe.

Une instance de cette classe représente une référence d’URI dans le sens syntaxique défini par RFC  ;2396. Un URI peut être absolu ou relatif. Une chaîne d’URI est analysée en fonction de la syntaxe générique sans tenir compte du schéma, le cas échéant, qu’elle spécifie. Aucune recherche de l’hôte, le cas échéant, n’est effectuée et aucun gestionnaire de flux dépendant du schéma n’est construit. L’égalité, le hachage et la comparaison sont définis strictement en termes de contenu de caractère de l’instance. En d’autres termes, une instance d’URI est peu plus qu’une chaîne structurée qui prend en charge les opérations syntactiques, indépendantes du schéma de comparaison, de normalisation, de résolution et de relativisation.

En revanche, une instance de la URL classe représente les composants syntaxiques d’une URL, ainsi que certaines informations requises pour accéder à la ressource qu’elle décrit. Une URL doit être absolue, c’est-à-dire qu’elle doit toujours spécifier un schéma. Une chaîne d’URL est analysée en fonction de son schéma. Un gestionnaire de flux est toujours établi pour une URL et, en fait, il est impossible de créer une instance d’URL pour un schéma pour lequel aucun gestionnaire n’est disponible. L’égalité et le hachage dépendent à la fois du schéma et de l’adresse Internet de l’hôte, le cas échéant ; la comparaison n’est pas définie. En d’autres termes, une URL est une chaîne structurée qui prend en charge l’opération syntaxique de résolution ainsi que les opérations d’E/S réseau de recherche de l’hôte et l’ouverture d’une connexion à la ressource spécifiée.

Ajouté dans la version 1.4.

Java documentation pour java.net.URI.

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