URI.ParseServerAuthority Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Tenta analisar o componente de autoridade desse URI, se definido, em informações do usuário, host e componentes de porta.
[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.URIRetornos
Um URI cujo campo de autoridade foi analisado como uma autoridade baseada em servidor
- Atributos
Exceções
se a parte de autoridade não puder ser analisada como uma autoridade baseada em servidor.
Comentários
Tenta analisar o componente de autoridade desse URI, se definido, em informações do usuário, host e componentes de porta.
Se o componente de autoridade desse URI já tiver sido reconhecido como sendo baseado em servidor, ele já terá sido analisado em componentes de informações do usuário, host e porta. Nesse caso, ou se esse URI não tiver nenhum componente de autoridade, esse método simplesmente retorna esse URI.
Caso contrário, esse método tenta mais uma vez analisar o componente de autoridade em componentes de informações do usuário, host e porta, e lança uma exceção descrevendo por que o componente de autoridade não pôde ser analisado dessa maneira.
Esse método é fornecido porque a sintaxe de URI genérica especificada no RFC 2396 nem sempre pode distinguir uma autoridade baseada em servidor malformada de uma autoridade legítima baseada no Registro. Deve, portanto, tratar alguns casos do primeiro como exemplos do segundo. O componente de autoridade na cadeia de caracteres "//foo:bar"de URI, por exemplo, não é uma autoridade legal baseada em servidor, mas é legal como uma autoridade baseada em registro.
Em muitas situações comuns, por exemplo, ao trabalhar URIs que são conhecidos por serem URNs ou URLs, os URIs hierárquicos que estão sendo usados sempre serão baseados em servidor. Por conseguinte, devem ser analisados como tal ou tratados como um erro. Nestes casos, uma declaração como
<blockquote>URIu= new URI(str).parseServerAuthority();</blockquote>
pode ser usado para garantir que u sempre se refira a um URI que, se tiver um componente de autoridade, tenha uma autoridade baseada em servidor com informações de usuário, host e componentes de porta adequados. Invocar esse método também garante que, se a autoridade não puder ser analisada dessa maneira, uma mensagem de diagnóstico apropriada possa ser emitida com base na exceção lançada.
Documentação Java para java.net.URI.parseServerAuthority().
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.