Package net.i2p.util

Class SSLEepGet

  • public class SSLEepGet
extends EepGet
    HTTPS only, no retries, no min and max size options, no timeout option As of 0.9.45, supports redirect to https (redirect to http will still fail). Fails on bad certs (must have a valid cert chain) Self-signed certs or CAs not in the JVM key store must be loaded to be trusted. Since 0.8.2, loads additional trusted CA certs from $I2P/certificates/ssl/ and ~/.i2p/certificates/ssl/ Since 0.9.33, HTTP proxies (CONNECT) supported. Proxy auth not supported.
    Since:
    0.7.10
    Author:
    zzz

    • Constructor Detail

      • SSLEepGet

        public SSLEepGet​(I2PAppContext ctx,
                 OutputStream outputStream,
                 String url,
                 SSLEepGet.SSLState state)
        Parameters:
        state - an SSLState retrieved from a previous SSLEepGet with getSSLState(), or null. This makes repeated fetches from the same host MUCH faster, and prevents repeated key store loads even for different hosts.
        Since:
        0.8.2

      • SSLEepGet

        public SSLEepGet​(I2PAppContext ctx,
                 OutputStream outputStream,
                 String url,
                 long maxSize,
                 SSLEepGet.SSLState state)
        Parameters:
        maxSize - The maximum size of the response
        state - an SSLState retrieved from a previous SSLEepGet with getSSLState(), or null. This makes repeated fetches from the same host MUCH faster, and prevents repeated key store loads even for different hosts.
        Since:
        0.9.48

      • SSLEepGet

        public SSLEepGet​(I2PAppContext ctx,
                 String outputFile,
                 String url)
        A new SSLEepGet with a new SSLState
        Since:
        0.9.9

      • SSLEepGet

        public SSLEepGet​(I2PAppContext ctx,
                 String outputFile,
                 String url,
                 SSLEepGet.SSLState state)
        Parameters:
        state - an SSLState retrieved from a previous SSLEepGet with getSSLState(), or null. This makes repeated fetches from the same host MUCH faster, and prevents repeated key store loads even for different hosts.
        Since:
        0.9.9

      • SSLEepGet

        public SSLEepGet​(I2PAppContext ctx,
                 SSLEepGet.ProxyType type,
                 String proxyHost,
                 int proxyPort,
                 OutputStream outputStream,
                 String url)
        Use a proxy.
        Parameters:
        proxyHost - Must be valid hostname or literal IPv4/v6. If type is INTERNAL, set to "localhost".
        proxyPort - Must be valid, -1 disallowed, no default. If type is INTERNAL, set to 4444.
        Since:
        0.9.33

      • SSLEepGet

        public SSLEepGet​(I2PAppContext ctx,
                 SSLEepGet.ProxyType type,
                 String proxyHost,
                 int proxyPort,
                 OutputStream outputStream,
                 String url,
                 SSLEepGet.SSLState state)
        Use a proxy.
        Parameters:
        proxyHost - Must be valid hostname or literal IPv4/v6. If type is INTERNAL, set to "localhost".
        proxyPort - Must be valid, -1 disallowed, no default. If type is INTERNAL, set to 4444.
        state - an SSLState retrieved from a previous SSLEepGet with getSSLState(), or null. This makes repeated fetches from the same host MUCH faster, and prevents repeated key store loads even for different hosts.
        Since:
        0.9.33

      • SSLEepGet

        public SSLEepGet​(I2PAppContext ctx,
                 SSLEepGet.ProxyType type,
                 String proxyHost,
                 int proxyPort,
                 String outputFile,
                 String url)
        Use a proxy.
        Parameters:
        proxyHost - Must be valid hostname or literal IPv4/v6. If type is INTERNAL, set to "localhost".
        proxyPort - Must be valid, -1 disallowed, no default. If type is INTERNAL, set to 4444.
        Since:
        0.9.33

      • SSLEepGet

        public SSLEepGet​(I2PAppContext ctx,
                 SSLEepGet.ProxyType type,
                 String proxyHost,
                 int proxyPort,
                 String outputFile,
                 String url,
                 SSLEepGet.SSLState state)
        Use a proxy.
        Parameters:
        proxyHost - Must be valid hostname or literal IPv4/v6. If type is INTERNAL, set to "localhost".
        proxyPort - Must be valid, -1 disallowed, no default. If type is INTERNAL, set to 4444.
        state - an SSLState retrieved from a previous SSLEepGet with getSSLState(), or null. This makes repeated fetches from the same host MUCH faster, and prevents repeated key store loads even for different hosts.
        Since:
        0.9.33

    • Method Detail

      • main

        public static void main​(String[] args)
        SSLEepGet https://foo/bar or to save cert chain: SSLEepGet -s https://foo/bar

      • getSSLState

        public SSLEepGet.SSLState getSSLState()
        Pass this back to the next SSLEepGet constructor for faster fetches. This may be called either after the constructor or after the fetch.
        Since:
        0.8.2

      • forceDNSOverHTTPS

        public void forceDNSOverHTTPS​(boolean on)
        Override the config setting, force DNSoverHTTPS on or off Call before the fetch.
        Since:
        0.9.49

      • doFetch

        protected void doFetch​(SocketTimeout timeout)
                throws IOException
        Description copied from class: EepGet
        This reads the response to a single fetch. Call after sendRequest()
        Overrides:
        doFetch in class EepGet
        Parameters:
        timeout - may be null
        Throws:
        IOException