Condividi tramite


URI.ParseServerAuthority Metodo

Definizione

Tenta di analizzare il componente autorità di questo URI, se definito, in componenti di porta, host e informazioni utente.

[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

Restituisce

URI

URI il cui campo dell'autorità è stato analizzato come autorità basata su server

Attributi

Eccezioni

se non è stato possibile analizzare la parte dell'autorità come autorità basata su server.

Commenti

Tenta di analizzare il componente autorità di questo URI, se definito, in componenti di porta, host e informazioni utente.

Se il componente dell'autorità di questo URI è già stato riconosciuto come basato su server, sarà già stato analizzato in componenti di porta, host e informazioni utente. In questo caso, o se questo URI non dispone di un componente di autorità, questo metodo restituisce semplicemente questo URI.

In caso contrario, questo metodo tenta ancora una volta di analizzare il componente dell'autorità in componenti di informazioni utente, host e porta e genera un'eccezione che descrive il motivo per cui non è stato possibile analizzare il componente dell'autorità in questo modo.

Questo metodo viene fornito perché la sintassi URI generica specificata in RFC 2396 non può sempre distinguere un'autorità basata su server non valida da un'autorità legittima basata sul Registro di sistema. Deve pertanto trattare alcune istanze del primo come istanze di quest'ultima. Il componente dell'autorità nella stringa "//foo:bar"URI, ad esempio, non è un'autorità legale basata su server, ma è legale come autorità basata sul Registro di sistema.

In molte situazioni comuni, ad esempio quando gli URI funzionanti che sono noti come URL o URL, gli URI gerarchici usati saranno sempre basati su server. Pertanto, devono essere analizzati come tali o considerati come un errore. In questi casi un'istruzione, ad esempio

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

può essere usato per garantire che u faccia sempre riferimento a un URI che, se dispone di un componente di autorità, dispone di un'autorità basata su server con i componenti di porta, host e informazioni utente appropriati. La chiamata di questo metodo garantisce anche che, se l'autorità non è stata analizzata in questo modo, è possibile emettere un messaggio di diagnostica appropriato in base all'eccezione generata.

Documentazione java per java.net.URI.parseServerAuthority().

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a