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 componentes de porta, host e informações do usuário.
[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
Retornos
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 componentes de porta, host e informações do usuário.
Se o componente de autoridade desse URI já tiver sido reconhecido como sendo baseado em servidor, ele já terá sido analisado em componentes de porta, host e informações do usuário. Nesse caso, ou se esse URI não tiver nenhum componente de autoridade, esse método simplesmente retornará esse URI.
Caso contrário, esse método tenta mais uma vez analisar o componente de autoridade em componentes de porta, host e informações do usuário e gera uma exceção que descreve por que o componente de autoridade não pôde ser analisado dessa forma.
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 em registro. Portanto, ele deve tratar algumas instâncias do primeiro como instâncias deste último. O componente de autoridade na cadeia de caracteres de URI "//foo:bar", 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 conhecidas como URNs ou URLs, as URIs hierárquicas que estão sendo usadas sempre serão baseadas em servidor. Portanto, eles devem ser analisados como tal ou tratados como um erro. Nesses casos, uma instrução como
<blockquote>URIu= new URI(str).parseServerAuthority();</blockquote>
pode ser usado para garantir que você sempre se refira a um URI que, se ele 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 forma, uma mensagem de diagnóstico apropriada poderá ser emitida com base na exceção gerada.
Documentação Java para java.net.URI.parseServerAuthority().
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.