FetchOptions (Google App Engine API para Java)

com.google.appengine.api.urlfetch

Classe FetchOptions

  • java.lang.Object
    • com.google.appengine.api.urlfetch.FetchOptions
  • Todas as interfaces implementadas:
    java.io.Serializable


    public final class FetchOptions
    extends java.lang.Object
    implements java.io.Serializable
    Permite aos usuários personalizar o comportamento das operações URLFetchService.

    Se allowTruncate() for chamado, o URLFetchService truncará respostas grandes e as retornará sem erros.

    Se disallowTruncate() for chamado, ResponseTooLargeException será gerada se a resposta for muito grande.

    Se followRedirects() for chamado, a operação URLFetchService seguirá os redirecionamentos.

    Se doNotFollowRedirects() for chamado, a operação de URLFetchService não seguirá os redirecionamentos.

    Se validateCertificate() for chamado, a operação URLFetchService, se estiver usando uma conexão HTTPS, instruirá o aplicativo a enviar uma solicitação ao servidor somente se o certificado for válido e estiver assinado por uma autoridade de certificação (CA, na sigla em inglês) confiável, e também inclui um nome de host que corresponde ao certificado. Se a validação do certificado falhar, uma exceção SSLHandshakeException será gerada. As conexões HTTP não são afetadas por esta opção.

    Se doNotValidateCertificate() for chamado, URLFetchService não validará o certificado SSL do servidor de qualquer maneira. Esse é o comportamento padrão. Observe, no entanto, que a validação será ativada por padrão em um futuro próximo. Se você depende de fazer solicitações para um site com um certificado inválido ou não confiável, chame doNotValidateCertificate() explicitamente para evitar erros em futuras versões.

    Observações sobre o uso:
    A maneira recomendada de instanciar um objeto FetchOptions é importar estaticamente o FetchOptions.Builder* e invocar um método de criação estático seguido de um mutador de instância (se necessário):

     import static com.google.appengine.api.urlfetch.FetchOptions.Builder.*;
    
     ...
     URL url = getURLToFetch();
     urlFetchService.fetch(new HTTPRequest(url, HTTPMethod.GET,
         allowTruncate()));
    
     urlFetchService.fetch(new HTTPRequest(url, HTTPMethod.GET,
         allowTruncate().doNotFollowRedirects()));
     
    Consulte também:
    Formulário serializado
    • Detalhes dos campos

      • DEFAULT_DEADLINE

        public static final java.lang.Double DEFAULT_DEADLINE
        O prazo padrão é de cinco segundos.
    • Detalhes dos métodos

      • allowTruncate

        public FetchOptions allowTruncate()
        Ativa o truncamento de resposta. Leia o javadoc da classe para uma explicação sobre como allowTruncate é usado.
        Retorna:
        this (para encadeamento)
      • disallowTruncate

        public FetchOptions disallowTruncate()
        Desativa o truncamento de resposta. Leia o javadoc da classe para uma explicação sobre como allowTruncate é usado.
        Retorna:
        this (para encadeamento)
      • followRedirects

        public FetchOptions followRedirects()
        Ativa o processo de seguir redirecionamentos. Leia o javadoc da classe para uma explicação sobre como followRedirects é usado.
        Retorna:
        this (para encadeamento)
      • validateCertificate

        public FetchOptions validateCertificate()
        Ativa a validação de certificados em conexões HTTPS por meio do mecanismo normal baseado em CA. Leia o javadoc da classe para uma explicação de como essa opção afeta o comportamento de validação de certificados.
        Retorna:
        this (para encadeamento)
      • doNotValidateCertificate

        public FetchOptions doNotValidateCertificate()
        Desativa a validação de certificados em conexões HTTPS. Leia o javadoc da classe para uma explicação de como essa opção afeta o comportamento de validação de certificados.
        Retorna:
        this (para encadeamento)
      • setDeadline

        public FetchOptions setDeadline(java.lang.Double deadline)
        Define o prazo, em segundos, para a solicitação de busca.
        Retorna:
        this (para encadeamento)
        Resultado:
        java.lang.IllegalArgumentException: se o prazo não for positivo
      • doNotFollowRedirects

        public FetchOptions doNotFollowRedirects()
        Desativa o processo de seguir redirecionamentos. Leia o javadoc da classe para uma explicação sobre como doNotFollowRedirects é usado.
        Retorna:
        this (para encadeamento)
      • getAllowTruncate

        public boolean getAllowTruncate()
      • getFollowRedirects

        public boolean getFollowRedirects()
      • getDeadline

        public java.lang.Double getDeadline()
      • getValidateCertificate

        public boolean getValidateCertificate()
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Java