URI Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

URI

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable ISerializable IComparable IDisposable

Hinweise

Represents a Uniform Resource Identifier (URI) reference.

Abgesehen von einigen geringfügigen Abweichungen, die unten aufgeführt sind, stellt eine Instanz dieser Klasse einen URI-Verweis dar, wie durch RFC  definiert; 2396: Uniform Resource Identifiers (URI): Generische Syntaxhttp://www.ietf.org/rfc/rfc2396.txt, geändert durch RFC  2732: Format für Literale IPv6-Adressen in URLshttp://www.ietf.org/rfc/rfc2732.txt. Das Literal-IPv6-Adressformat unterstützt auch scope_ids. Die Syntax und Verwendung von scope_ids wird hier beschrieben. Diese Klasse stellt Konstruktoren zum Erstellen von URI-Instanzen aus ihren Komponenten oder durch Analysieren der Zeichenfolgenformen, Methoden für den Zugriff auf die verschiedenen Komponenten einer Instanz und Methoden zum Normalisieren, Auflösen und Relativieren von URI-Instanzen bereit. Instanzen dieser Klasse sind unveränderlich.

<h3-URI-Syntax> und -Komponenten </h3>

Auf der höchsten Ebene weist ein URI-Verweis (nachfolgend einfach "URI") in Zeichenfolgenform die Syntax auf.

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

wenn eckige Klammern [...] optionale Komponenten und die Zeichen <b>:</b> und <b>#</b> für sich selbst zeichnen.

Ein absoluter URI gibt ein Schema an; ein URI, der nicht absolut ist, wird als relativ bezeichnet. URIs werden auch klassifiziert, je nachdem, ob sie undurchsichtig oder hierarchisch sind.

Ein undurchsichtiger URI ist ein absoluter URI, dessen schemaspezifischer Teil nicht mit einem Schrägstrich ('/') beginnt. Undurchsichtige URIs unterliegen keiner weiteren Analyse. Einige Beispiele für undurchsichtige URIs sind:

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

Ein hierarchischer URI ist entweder ein absoluter URI, dessen schemaspezifischer Teil mit einem Schrägstrich oder einem relativen URI beginnt, d. h. ein URI, der kein Schema angibt. Einige Beispiele für hierarchische URIs sind:

<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>

Ein hierarchischer URI unterliegt der weiteren Analyse gemäß der Syntax.

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

soweit die Zeichen <b>:</b>, <b>/</b>, <b>?</b> und <b>#</b> für sich selbst stehen. Der schemaspezifische Teil eines hierarchischen URI besteht aus den Zeichen zwischen dem Schema und den Fragmentkomponenten.

Die Autoritätskomponente eines hierarchischen URI ist, falls angegeben, entweder serverbasiert oder registrierungsbasiert. Eine serverbasierte Autorität analysiert gemäß der vertrauten Syntax

<Blockquote [>b<>@/b<]>[b<>:/b<>] /blockquote<>

wobei die Zeichen <b>@</b> und <b/b>:<> für sich selbst stehen. Fast alle derzeit verwendeten URI-Schemas sind serverbasiert. Eine Autoritätskomponente, die auf diese Weise nicht analysiert wird, wird als registrierungsbasiert betrachtet.

Die Pfadkomponente eines hierarchischen URI ist selbst absolut, wenn sie mit einem Schrägstrich ('/') beginnt. Andernfalls ist sie relativ. Der Pfad eines hierarchischen URI, der entweder absolut ist oder angibt, dass eine Autorität immer absolut ist.

Alle erzählten, dann hat eine URI-Instanz die folgenden neun Komponenten:

<blockquote><table summary="Describes the components of a URI:scheme,scheme-specific-part,authority,user-info,host,port,path,query,fragment"><tr><th>Component</th th><>Type</th></tr td><><>scheme</td td></td>String</tr td></tr><td><>scheme-specific-part       </td><td>String</td></tr><td><>authority</td><td/td>String</td><><><> user-info</td td><td>String</><tr><tr><td>host</td td><td>String</><tr><><td>port</td><td td>int</td></tr td/tr><><td>path</td><td td/td> tdString<></tr><tr><td>query</td></td>String<></tr tr><><td>fragment</td td/td></td>String<></tr></table></blockquote>

In einer bestimmten Instanz ist eine bestimmte Komponente entweder nicht definiert oder mit einem eindeutigen Wert definiert . Nicht definierte Zeichenfolgenkomponenten werden durch nulldargestellt, während nicht definierte ganzzahlige Komponenten durch -1dargestellt werden. Eine Zeichenfolgenkomponente kann definiert werden, damit die leere Zeichenfolge als Wert angegeben wird. dies entspricht nicht der nicht definierten Komponente.

Ob eine bestimmte Komponente in einer Instanz definiert ist oder nicht, hängt vom Typ des dargestellten URI ab. Ein absoluter URI verfügt über eine Schemakomponente. Ein undurchsichtiger URI verfügt über ein Schema, einen schemaspezifischen Teil und möglicherweise ein Fragment, hat aber keine anderen Komponenten. Ein hierarchischer URI verfügt immer über einen Pfad (obwohl er leer sein kann) und einen schemaspezifischen Teil (der mindestens den Pfad enthält) und möglicherweise über eine der anderen Komponenten verfügt. Wenn die Autoritätskomponente vorhanden ist und serverbasiert ist, wird die Hostkomponente definiert, und die Benutzerinformationen und Portkomponenten können definiert werden.

<h4-Vorgänge> für URI-Instanzen </h4>

Die wichtigsten Vorgänge, die von dieser Klasse unterstützt werden, sind diejenigen der Normalisierung, Auflösung und Relativierung.

Normalisierung ist der Vorgang, unnötige Und "."".." Segmente aus der Pfadkomponente eines hierarchischen URI zu entfernen. Jedes "." Segment wird einfach entfernt. Ein ".." Segment wird nur entfernt, wenn es einem Nichtsegment".." vorangestellt ist. Die Normalisierung hat keine Auswirkung auf undurchsichtige URIs.

Die Auflösung ist der Prozess der Auflösung eines URI für einen anderen Basis-URI . Der resultierende URI wird aus Komponenten beider URIs in der von RFC  angegebenen Weise erstellt; 2396, wobei Komponenten aus dem Basis-URI für diejenigen verwendet werden, die nicht im Original angegeben sind. Bei hierarchischen URIs wird der Pfad des Originals anhand des Pfads der Basis aufgelöst und dann normalisiert. Das Ergebnis, z. B. der Auflösung

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

für den Basis-URI ist der Ergebnis-URI http://java.sun.com/j2se/1.3/ .

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

Auflösen des relativen URI

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

gegen dieses Ergebnis ergibt wiederum

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

Die Auflösung von absoluten und relativen URIs sowie von absoluten und relativen Pfaden im Fall hierarchischer URIs wird unterstützt. Durch das Auflösen des URI gegen einen anderen URI file:///~calendar wird einfach der ursprüngliche URI zurückgegeben, da er absolut ist. Das Auflösen des relativen URI (2) über dem relativen Basis-URI (1) führt zum normalisierten, aber dennoch relativen URI.

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

Relativierung ist schließlich die Umkehrung der Auflösung: Für alle zwei normalisierten URIs u und  v,

<Blockquote>u.relativize(u.resolve(v)).equals(v)    und<br>u u.resolve(.relativize(v v)).equals()   .<br></blockquote>

Dieser Vorgang ist häufig hilfreich beim Erstellen eines Dokuments mit URIs, die relativ zum Basis-URI des Dokuments erstellt werden müssen, sofern möglich. Beispiel: Relativierung des URI

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

für den Basis-URI

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

ergibt den relativen URI docs/guide/index.html.

<h4> Zeichenkategorien </h4>

RFC  2396 gibt genau an, welche Zeichen in den verschiedenen Komponenten eines URI-Verweises zulässig sind. Die folgenden Kategorien, von denen die meisten aus dieser Spezifikation stammen, werden unten verwendet, um diese Einschränkungen zu beschreiben:

<blockquote><table cellspacing=2 summary="Describes categories alpha,digit,alphanum,unreserved,punct,reserved,escaped,and other"><tr><th valign=top>alpha</th><td>The US-ASCII alphabetic characters, 'A'  through 'Z' und '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=top>alphanum</th><td>All alpha and digit characters</td></tr tr><><th valign=top> unreserved       </th><td>Alle Alphanumzeichen zusammen mit den Zeichen in der Zeichenfolge "_-!.~'()*"</td></tr tr><><th valign=top>punct</th><td td>Die Zeichen in der Zeichenfolge ",;:$&+="</td></tr tr><><th valign=top> reserviert</th><td>Alle Satzzeichen zusammen mit denen in der Zeichenfolge "?/[]@"</td></tr tr tr><><th valign=top valign=top>escaped</th><td>Escaped Octets, d. h., Triplets bestehend aus dem Prozentzeichen ('%') gefolgt von zwei hexadezimalen Ziffern ('0'-'9','A'-'F' und 'a'-'f')</td></tr tr><><th valign=top> other</th><td>Die Unicode-Zeichen, die sich nicht im US-ASCII Zeichensatz befinden, sind keine Steuerzeichen (gemäß dem java.lang.Character#isISOControl(char) Character.isISOControl -Methode) und keine Leerzeichen (gemäß der java.lang.Character#isSpaceChar(char) Character.isSpaceChar Methode)    (<b>Abweichung von RFC 2396</b>, die auf US-ASCII)</td></tr></table></blockquote beschränkt ist>

"legal-chars"> Der Satz aller rechtlichen URI-Zeichen besteht aus den nicht reservierten, reservierten, escaped und anderen Zeichen.

<h4> Escaped Octets, Anführungszeichen, Codierung und Decodierung </h4>

RFC 2396 ermöglicht Escape-Oktetts, die in den Komponenten für Benutzerinformationen, Pfad, Abfrage und Fragment angezeigt werden. Das Escapen dient zwei Zwecken in URIs:

<Ul>

<li>

Um Nicht-US-ASCII Zeichen zu codieren , wenn ein URI erforderlich ist, um strikt RFC  2396 durch keine weiteren Zeichen.

</li>

<li>

So geben Sie Anführungszeichen an, die in einer Komponente andernfalls unzulässig sind. Die Komponenten für Benutzerinformationen, Pfade, Abfragen und Fragmente unterscheiden sich geringfügig in Bezug auf die Zeichen als legal und illegal.

</li>

</ul>

Diese Zwecke werden in dieser Klasse von drei verwandten Vorgängen bereitgestellt:

<Ul>

<li>

"codieren"> Ein Zeichen wird codiert , indem es durch die Sequenz von Escape-Oktetts ersetzt wird, die dieses Zeichen im UTF-8-Zeichensatz darstellen. Das Euro-Währungssymbol ('\u005Cu20AC'), z. B. ist codiert als "%E2%82%AC". (<b>Abweichung von RFC  2396</b>, die keinen bestimmten Zeichensatz angibt.)

</li>

<li>

"Anführungszeichen"> Ein unzulässiges Zeichen wird einfach durch Codieren zitiert . Das Leerzeichen wird z. B. durch ersetzen durch "%20". UTF-8 enthält US-ASCII, daher hat diese Transformation für US-ASCII Zeichen genau den Effekt, der von RFC 2396 benötigt wird.

</li>

<li>

"Decodieren"> Eine Sequenz von escaped octets wird decodiert , indem sie durch die Abfolge von Zeichen ersetzt wird, die sie im UTF-8-Zeichensatz darstellt. UTF-8 enthält US-ASCII, daher hat die Decodierung auswirkungen auf die De quotierung aller zitierten US-ASCII Zeichen sowie die decodierung aller codierten Nicht-US-ASCII Zeichen. Wenn beim Decodieren der escaped octets ein Decodierungsfehler auftritt, werden die fehlerhaften Oktette durch '\u005CuFFFD'das Unicode-Ersetzungszeichen ersetzt.

</li>

</ul>

Diese Vorgänge werden in den Konstruktoren und Methoden dieser Klasse wie folgt verfügbar gemacht:

<Ul>

<li>

Der #URI(java.lang.String)-Konstruktor mit einem Argument erfordert, dass alle ungültigen Zeichen in ihrem Argument an zitiert werden und alle escaped oktets und andere zeichen beibehalten werden, die vorhanden sind.

</li>

<li>

Die #URI(java.lang.String,java.lang.String,java.lang.String,int,java.lang.String,java.lang.String,java.lang.String)-Konstruktoren geben unzulässige Zeichen an, wie sie von den Komponenten benötigt werden, in denen sie angezeigt werden. Das Prozentzeichen ('%') wird immer von diesen Konstruktoren zitiert. Alle anderen Zeichen bleiben erhalten.

</li>

<li>

Die #getRawUserInfo() getRawUserInfoMethoden , #getRawPath() getRawPath#getRawQuery() getRawQuery#getRawFragment() getRawFragment#getRawAuthority() getRawAuthorityund #getRawSchemeSpecificPart() getRawSchemeSpecificPart die Methoden geben die Werte ihrer entsprechenden Komponenten in unformatierter Form zurück, ohne escaped Octets zu interpretieren. Die von diesen Methoden zurückgegebenen Zeichenfolgen können sowohl Escape-Oktette als auch andere Zeichen enthalten und enthalten keine unzulässigen Zeichen.

</li>

<li>

Die #getUserInfo() getUserInfo, #getPath() getPath, #getQuery() getQuery, #getFragment() getFragment, #getAuthority() getAuthorityund #getSchemeSpecificPart() getSchemeSpecificPart Methoden decodieren alle escaped Octets in ihren entsprechenden Komponenten. Die von diesen Methoden zurückgegebenen Zeichenfolgen können sowohl andere Zeichen als auch unzulässige Zeichen enthalten und enthalten keine Escape-Oktetts.

</li>

<li>

Die #toString() toString Methode gibt eine URI-Zeichenfolge mit allen erforderlichen Anführungszeichen zurück, die jedoch andere Zeichen enthalten kann.

</li>

<li>

Die #toASCIIString() toASCIIString Methode gibt eine voll zitierte und codierte URI-Zeichenfolge zurück, die keine anderen Zeichen enthält.

</li>

</ul>

<h4-Identitäten></h4>

Für jeden URI u ist es immer der Fall, dass

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

Für alle URI u , die keine redundante Syntax enthalten, z. B. zwei Schrägstriche vor einer leeren Autorität (wie in file:///tmp/ ) oder einem Doppelpunkt nach einem Hostnamen, aber keinen Port (wie in http://java.sun.com: ), und das keine Zeichen codiert, mit Ausnahme derjenigen, die zitiert werden müssen, enthalten auch die folgenden Identitäten:

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

in allen Fällen,

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>)

wenn u hierarchisch ist und

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>)

wenn u hierarchisch ist und entweder keine Autorität oder eine serverbasierte Autorität besitzt.

<h4-URIs> , URLs und URNs </h4>

Ein URI ist ein einheitlicher Ressourcenbezeichner , während es sich bei einer URL um einen einheitlichen Ressourcenlocator handelt. Daher ist jede URL ein URI, abstrahiert, aber nicht jeder URI ist eine URL. Dies liegt daran, dass es eine weitere Unterkategorie von URIs, uniform resource names (URNs) gibt, die Ressourcen benennen, aber nicht angeben, wie sie gefunden werden sollen. mailtoDie newsoben gezeigten URIs und isbn URIs sind Beispiele für URNs.

Der konzeptionelle Unterschied zwischen URIs und URLs spiegelt sich in den Unterschieden zwischen dieser Klasse und der URL Klasse wider.

Eine Instanz dieser Klasse stellt einen URI-Verweis im syntaktischen Sinne dar, der von RFC 2396 definiert wird. Ein URI kann entweder absolut oder relativ sein. Eine URI-Zeichenfolge wird gemäß der generischen Syntax ohne Berücksichtigung des Schemas analysiert, sofern vorhanden, das sie angibt. Es wird kein Nachschlagevorgang des Hosts ausgeführt, und es wird kein schemaabhängiger Datenstromhandler erstellt. Gleichheit, Hashing und Vergleich werden streng in Bezug auf den Zeicheninhalt der Instanz definiert. Mit anderen Worten, eine URI-Instanz ist wenig mehr als eine strukturierte Zeichenfolge, die die syntaktischen, schemaunabhängigen Operationen von Vergleichs-, Normalisierungs-, Auflösungs- und Relativierungsvorgängen unterstützt.

Eine Instanz der URL Klasse stellt dagegen die syntaktischen Komponenten einer URL zusammen mit einigen der Informationen dar, die für den Zugriff auf die zu beschreibende Ressource erforderlich sind. Eine URL muss absolut sein, d. h. sie muss immer ein Schema angeben. Eine URL-Zeichenfolge wird gemäß ihrem Schema analysiert. Ein Datenstromhandler wird immer für eine URL eingerichtet, und tatsächlich ist es unmöglich, eine URL-Instanz für ein Schema zu erstellen, für das kein Handler verfügbar ist. Gleichheit und Hashing hängen sowohl vom Schema als auch von der Internetadresse des Hosts ab, falls vorhanden; Der Vergleich ist nicht definiert. Mit anderen Worten, eine URL ist eine strukturierte Zeichenfolge, die den syntaktischen Vorgang der Auflösung sowie die Netzwerk-E/A-Vorgänge unterstützt, um den Host nachzuschlagen und eine Verbindung mit der angegebenen Ressource zu öffnen.

In 1.4 hinzugefügt.

Java Dokumentation für java.net.URI.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.