Constructor Detail

• Builder

  public Builder()

Method Detail

• setProxy

  public NetHttpTransport.Builder setProxy(Proxy proxy)

  Sets the HTTP proxy or null to use the proxy settings from system properties.

  For example:

         setProxy(new Proxy(Proxy.Type.HTTP, new InetSocketAddress("127.0.0.1", 8080)))
   

• setConnectionFactory

  public NetHttpTransport.Builder setConnectionFactory(ConnectionFactory connectionFactory)

  Sets the ConnectionFactory or null to use a DefaultConnectionFactory. This value is ignored if the setProxy(java.net.Proxy) has been called with a non-null value.

  If you wish to use a Proxy, it should be included in your ConnectionFactory implementation.

  Since:

  1.20

• trustCertificatesFromJavaKeyStore

  public NetHttpTransport.Builder trustCertificatesFromJavaKeyStore(InputStream keyStoreStream,
                                                                    String storePass)
                                                             throws GeneralSecurityException,
                                                                    IOException

  Sets the SSL socket factory based on root certificates in a Java KeyStore.

  Example usage:

      trustCertificatesFromJavaKeyStore(new FileInputStream("certs.jks"), "password");
   

  Parameters:

  keyStoreStream - input stream to the key store (closed at the end of this method in a finally block)

  storePass - password protecting the key store file

  Throws:

  GeneralSecurityException

  IOException

  Since:

  1.14

• trustCertificatesFromStream

  public NetHttpTransport.Builder trustCertificatesFromStream(InputStream certificateStream)
                                                       throws GeneralSecurityException,
                                                              IOException

  Sets the SSL socket factory based root certificates generated from the specified stream using CertificateFactory.generateCertificates(InputStream).

  Example usage:

      trustCertificatesFromStream(new FileInputStream("certs.pem"));
   

  Parameters:

  certificateStream - certificate stream

  Throws:

  GeneralSecurityException

  IOException

  Since:

  1.14

• trustCertificates

  public NetHttpTransport.Builder trustCertificates(KeyStore trustStore)
                                             throws GeneralSecurityException

  Sets the SSL socket factory based on a root certificate trust store.

  Parameters:

  trustStore - certificate trust store (use for example SecurityUtils.loadKeyStore(java.security.KeyStore, java.io.InputStream, java.lang.String) or SecurityUtils.loadKeyStoreFromCertificates(java.security.KeyStore, java.security.cert.CertificateFactory, java.io.InputStream))

  Throws:

  GeneralSecurityException

  Since:

  1.14

• doNotValidateCertificate

  @Beta
  public NetHttpTransport.Builder doNotValidateCertificate()
                                                          throws GeneralSecurityException

  Beta
  Disables validating server SSL certificates by setting the SSL socket factory using SslUtils.trustAllSSLContext() for the SSL context and SslUtils.trustAllHostnameVerifier() for the host name verifier.

  Be careful! Disabling certificate validation is dangerous and should only be done in testing environments.

  Throws:

  GeneralSecurityException

• getSslSocketFactory

  public SSLSocketFactory getSslSocketFactory()

  Returns the SSL socket factory.

• setSslSocketFactory

  public NetHttpTransport.Builder setSslSocketFactory(SSLSocketFactory sslSocketFactory)

  Sets the SSL socket factory or null for the default.

• getHostnameVerifier

  public HostnameVerifier getHostnameVerifier()

  Returns the host name verifier or null for the default.

• setHostnameVerifier

  public NetHttpTransport.Builder setHostnameVerifier(HostnameVerifier hostnameVerifier)

  Sets the host name verifier or null for the default.

• build

  public NetHttpTransport build()

  Returns a new instance of NetHttpTransport based on the options.