URI Classe

Definição

[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

Herança

Object

JavaObject

Object

URI

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable ISerializable IComparable IDisposable

Comentários

Representa uma referência de URI (Uniform Resource Identifier).

Além de alguns desvios menores observados abaixo, uma instância dessa classe representa uma referência de URI, conforme definido por RFC  2396: Uniform Resource Identifiers (URI): Sintaxehttp://www.ietf.org/rfc/rfc2396.txt genérica, alterada por RFC  2732: Formatar endereços IPv6 literais em URLshttp://www.ietf.org/rfc/rfc2732.txt. O formato de endereço IPv6 literal também dá suporte a scope_ids. A sintaxe e o uso de scope_ids é descrito aqui. Essa classe fornece construtores para criar instâncias de URI de seus componentes ou analisando seus formulários de cadeia de caracteres, métodos para acessar os vários componentes de uma instância e métodos para normalizar, resolver e relativizar instâncias de URI. As instâncias dessa classe são imutáveis.

<Sintaxe de URI h3> e componentes </h3>

No nível mais alto, uma referência de URI (hereinafter simplesmente "URI") na forma de cadeia de caracteres tem a sintaxe

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

em que colchetes [...] delineam componentes opcionais e os caracteres <b>:</b> e <b>#</b> se posicionam para si mesmos.

Um URI absoluto especifica um esquema; um URI que não é absoluto é dito ser relativo. As URIs também são classificadas de acordo com se são opacas ou hierárquicas.

Um URI opaco é um URI absoluto cuja parte específica do esquema não começa com um caractere de barra ('/'). URIs opacas não estão sujeitas a análises adicionais. Alguns exemplos de URIs opacos são:

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

Um URI hierárquico é um URI absoluto cuja parte específica do esquema começa com um caractere de barra ou um URI relativo, ou seja, um URI que não especifica um esquema. Alguns exemplos de URIs hierárquicas são:

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

Um URI hierárquico está sujeito a análise adicional de acordo com a sintaxe

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

em que os caracteres <b>:</b>, <b>/</b>, <b>?</b> e <b>#</b> se posicionam para si mesmos. A parte específica do esquema de um URI hierárquico consiste nos caracteres entre o esquema e os componentes do fragmento.

O componente de autoridade de um URI hierárquico é, se especificado, baseado em servidor ou em registro. Uma autoridade baseada em servidor analisa de acordo com a sintaxe familiar

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

em que os caracteres <b>@</b> e <b>:</b> se posicionam para si mesmos. Quase todos os esquemas de URI atualmente em uso são baseados em servidor. Um componente de autoridade que não analisa dessa forma é considerado baseado no Registro.

O componente de caminho de um URI hierárquico é considerado absoluto se ele começa com um caractere de barra ('/'); caso contrário, é relativo. O caminho de um URI hierárquico que seja absoluto ou especifique uma autoridade é sempre absoluto.

Ao todo, uma instância de URI tem os seguintes nove componentes:

<resumo da tabela blockquote><="Descreve os componentes de um URI:scheme,scheme-specific-part, authority,user-info, host, port,path,query,fragment"><tr><th>Component</th th><>Type</th></tr><tr><td>scheme</td td><>String</td></tr><tr td><>scheme-specific-part       </td td><>String</td></tr><tr><td>authority</td td><>String</td></tr><tr><td>user-info</td td><>String</td></tr><tr><td>host</td td><>String</td></tr><tr><td>port</td td><>int/td</td></tr><tr><td>path</td td><>String</td></tr><tr><td>query</td td><>String</td></tr><tr><td>fragment</td td><>String</td></tr></table></blockquote>

Em uma determinada instância, qualquer componente específico é indefinido ou definido com um valor distinto. Componentes de cadeia de caracteres indefinidos são representados por null, enquanto componentes inteiros indefinidos são representados por -1. Um componente de cadeia de caracteres pode ser definido para ter a cadeia de caracteres vazia como seu valor; isso não é equivalente a esse componente ser indefinido.

Se um componente específico é ou não definido em uma instância depende do tipo do URI que está sendo representado. Um URI absoluto tem um componente de esquema. Um URI opaco tem um esquema, uma parte específica do esquema e, possivelmente, um fragmento, mas não tem outros componentes. Um URI hierárquico sempre tem um caminho (embora possa estar vazio) e uma parte específica do esquema (que pelo menos contém o caminho) e pode ter qualquer um dos outros componentes. Se o componente de autoridade estiver presente e for baseado em servidor, o componente host será definido e os componentes de porta e informações do usuário poderão ser definidos.

<Operações h4> em instâncias <de URI /h4>

As principais operações compatíveis com essa classe são as de normalização, resolução e relativização.

A normalização é o processo de remoção desnecessária "." e ".." de segmentos do componente de caminho de um URI hierárquico. Cada "." segmento é simplesmente removido. Um ".." segmento será removido somente se for precedido por um segmento diferente".." . A normalização não tem efeito sobre URIs opacas.

A resolução é o processo de resolução de um URI em relação a outro, o URI base . O URI resultante é construído a partir de componentes de ambas as URIs da maneira especificada por RFC  2396, tirando componentes do URI base para aqueles não especificados no original. Para URIs hierárquicas, o caminho do original é resolvido no caminho da base e, em seguida, normalizado. O resultado, por exemplo, da resolução

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

em relação ao URI http://java.sun.com/j2se/1.3/ base é o URI de resultado

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

Resolvendo o URI relativo

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

em relação a esse resultado gera, por sua vez,

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

Há suporte para a resolução de URIs absolutas e relativas e de caminhos absolutos e relativos no caso de URIs hierárquicas. Resolver o URI file:///~calendar em relação a qualquer outro URI simplesmente gera o URI original, pois ele é absoluto. Resolver o URI relativo (2) acima em relação ao URI de base relativa (1) produz o URI normalizado, mas ainda relativo

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

A relativização, por fim, é o inverso da resolução: para qualquer duas URIs normalizadas u e  v,

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

Essa operação geralmente é útil ao construir um documento que contenha URIs que devem ser feitas em relação ao URI base do documento sempre que possível. Por exemplo, relativizando o URI

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

em relação ao URI base

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

produz o URI docs/guide/index.htmlrelativo.

<categorias de caractere h4></h4>

RFC  2396 especifica precisamente quais caracteres são permitidos nos vários componentes de uma referência de URI. As seguintes categorias, a maioria das quais são retiradas dessa especificação, são usadas abaixo para descrever essas restrições:

<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'  por  'Z' e 'a'  por  'z'</td></tr><tr><th valign=top>digit</th><td>The US-ASCII decimal digit characters, '0'  por  '9'</td></tr><tr><th valign=top>alphanum</th><td>Todos os caracteresalfa e </td></tr><tr><th valign=top>unreserved       </th><td>Todos os caracteres alfanum junto com aqueles na cadeia "_-!.~'()*"<de caracteres /td></tr><tr><th valign=top>punct</th><td>Os caracteres na cadeia",;:$&+="< de caracteres /td></tr><tr><th valign=top> reserved</th><td>Todos os caracteres pontuais junto com aqueles na cadeia "?/[]@"<de caracteres /td></tr><tr><th valign=top>escaped</th><td>Octets escaped, ou seja, trigêmeos que consistem no caractere percentual ('%') seguido por dois dígitos hexadecimal ('0'-'9'e 'A'-'F''a'-'f')</td></tr><tr><th valign=top> other</th><td>Os caracteres Unicode que não estão no conjunto de caracteres US-ASCII, não são caracteres de controle (de acordo com o java.lang.Character#isISOControl(char) Character.isISOControl método) e não são caracteres de espaço (de acordo com o java.lang.Character#isSpaceChar(char) Character.isSpaceChar método)    (<b>Desvio do RFC 2396</b>, que é limitado a US-ASCII)</td></tr></table></blockquote>

"legal-chars"> O conjunto de todos os caracteres de URI legais consiste nos caracteres não reservados, reservados, escapados e outros .

<octetos escapados h4> , aspas, codificação e decodificação </h4>

O RFC 2396 permite que octetos com escape apareçam nos componentes de dados do usuário, caminho, consulta e fragmento. O escape serve a duas finalidades em URIs:

<ul>

<li>

Para codificar caracteres nãoUS-ASCII quando um URI é necessário para estar em conformidade estritamente com RFC  2396 não contendo nenhum outro caractere.

</li>

<li>

Para citar caracteres que de outra forma são ilegais em um componente. Os componentes de informações do usuário, caminho, consulta e fragmento diferem ligeiramente em termos dos quais os caracteres são considerados legais e ilegais.

</li>

</ul>

Essas finalidades são atendidas nesta classe por três operações relacionadas:

<ul>

<li>

"codificar"> Um caractere é codificado substituindo-o pela sequência de octetos com escape que representam esse caractere no conjunto de caracteres UTF-8. O símbolo da moeda euro ('\u005Cu20AC'por exemplo, é codificado como "%E2%82%AC". (<b>Desvio de RFC  2396</b>, que não especifica nenhum conjunto de caracteres específico.)

</li>

<li>

"quote"> Um caractere ilegal é citado simplesmente codificando-o. O caractere de espaço, por exemplo, é citado substituindo-o "%20"por . UTF-8 contém US-ASCII, portanto, para US-ASCII caracteres essa transformação tem exatamente o efeito exigido por RFC 2396.

</li>

<li>

"decodificar"> Uma sequência de octetos com escape é decodificada substituindo-a pela sequência de caracteres que representa no conjunto de caracteres UTF-8. UTF-8 contém US-ASCII, portanto, a decodificação tem o efeito de descodificar quaisquer caracteres de US-ASCII entre aspas, bem como o de decodificação de caracteres nãoUS-ASCII codificados. Se ocorrer um erro de decodificação ao decodificar os octetos com escape, os octetos incorretos serão substituídos pelo '\u005CuFFFD'caractere de substituição Unicode.

</li>

</ul>

Essas operações são expostas nos construtores e métodos dessa classe da seguinte maneira:

<ul>

<li>

O construtor de argumento único #URI(java.lang.String) exige que todos os caracteres ilegais em seu argumento sejam citados e preserva quaisquer octetos e outros caracteres que estejam presentes.

</li>

<li>

Os construtores de vários argumentos #URI(java.lang.String,java.lang.String,int,java.lang.String, java.lang.String, java.lang.String) citam caracteres ilegais conforme exigido pelos componentes nos quais eles aparecem. O caractere percentual ('%') é sempre citado por esses construtores. Todos os outros caracteres são preservados.

</li>

<li>

Os #getRawUserInfo() getRawUserInfométodos , #getRawPath() getRawPath, #getRawQuery() getRawQuery, #getRawFragment() getRawFragmente #getRawAuthority() getRawAuthority#getRawSchemeSpecificPart() getRawSchemeSpecificPartretornar os valores de seus componentes correspondentes em forma bruta, sem interpretar quaisquer octetos escapados. As cadeias de caracteres retornadas por esses métodos podem conter octetos de escape e outros caracteres e não conterão caracteres ilegais.

</li>

<li>

Os #getUserInfo() getUserInfométodos , #getPath() getPath, #getQuery() getQuery, #getFragment() getFragmente #getAuthority() getAuthority#getSchemeSpecificPart() getSchemeSpecificPartdecodificar quaisquer octetos escapados em seus componentes correspondentes. As cadeias de caracteres retornadas por esses métodos podem conter outros caracteres e caracteres ilegais e não conterão octetos com escape.

</li>

<li>

O #toString() toString método retorna uma cadeia de caracteres de URI com todas as aspas necessárias, mas que pode conter outros caracteres .

</li>

<li>

O #toASCIIString() toASCIIString método retorna uma cadeia de caracteres de URI totalmente entre aspas e codificada que não contém nenhum outro caractere.

</li>

</ul>

<Identidades >h4< /h4>

Para qualquer URI u, é sempre o caso que

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

Para qualquer URI u que não contenha sintaxe redundante, como duas barras antes de uma autoridade vazia (como em file:///tmp/ ) ou dois-pontos seguindo um nome de host, mas nenhuma porta (como em http://java.sun.com: ), e que não codifica caracteres exceto aqueles que devem ser citados, as seguintes identidades também contêm:

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

em todos os casos,

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

se u é hierárquico, e

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

se u for hierárquico e não tiver autoridade ou autoridade baseada em servidor.

<URIs, URLs e URNs >h4< /h4>

Um URI é um identificador de recurso uniforme, enquanto uma URL é um localizador de recursos uniforme. Portanto, cada URL é um URI, falando abstratamente, mas nem todo URI é uma URL. Isso ocorre porque há outra subcategoria de URIs, URNs ( nomes de recursos uniformes), que nomeia recursos, mas não especifica como localizá-los. Os mailtoURIs e news os isbnURIs mostrados acima são exemplos de URNs.

A distinção conceitual entre URIs e URLs é refletida nas diferenças entre essa classe e a URL classe.

Uma instância dessa classe representa uma referência de URI no sentido sintactico definido por RFC 2396. Um URI pode ser absoluto ou relativo. Uma cadeia de caracteres de URI é analisada de acordo com a sintaxe genérica sem considerar o esquema, se houver, especificado. Nenhuma pesquisa do host, se houver, é executada e nenhum manipulador de fluxo dependente de esquema é construído. Igualdade, hash e comparação são definidos estritamente em termos do conteúdo do caractere da instância. Em outras palavras, uma instância de URI é pouco mais do que uma cadeia de caracteres estruturada que dá suporte às operações sintacticas e independentes de esquema de comparação, normalização, resolução e relativização.

Uma instância da URL classe, por outro lado, representa os componentes sintacticos de uma URL junto com algumas das informações necessárias para acessar o recurso descrito. Uma URL deve ser absoluta, ou seja, deve sempre especificar um esquema. Uma cadeia de caracteres de URL é analisada de acordo com seu esquema. Um manipulador de fluxo sempre é estabelecido para uma URL e, na verdade, é impossível criar uma instância de URL para um esquema para o qual nenhum manipulador está disponível. A igualdade e o hash dependem do esquema e do endereço da Internet do host, se houver; a comparação não está definida. Em outras palavras, uma URL é uma cadeia de caracteres estruturada que dá suporte à operação sintactica de resolução, bem como às operações de E/S de rede de procurar o host e abrir uma conexão com o recurso especificado.

Adicionado em 1.4.

Java documentação para java.net.URI.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.