info.guardianproject.netcipher.client

Class StrongConnectionBuilder

java.lang.Object

info.guardianproject.netcipher.client.StrongBuilderBase<StrongConnectionBuilder,java.net.HttpURLConnection>

info.guardianproject.netcipher.client.StrongConnectionBuilder

All Implemented Interfaces:

StrongBuilder<StrongConnectionBuilder,java.net.HttpURLConnection>

public class StrongConnectionBuilder
extends StrongBuilderBase<StrongConnectionBuilder,java.net.HttpURLConnection>

Builds an HttpUrlConnection that connects via Tor through Orbot.

Nested Class Summary

Nested classes/interfaces inherited from interface info.guardianproject.netcipher.client.StrongBuilder

StrongBuilder.Callback<C>

Field Summary

Fields inherited from class info.guardianproject.netcipher.client.StrongBuilderBase

context, proxyType, sslContext, TOR_CHECK_URL, useWeakCiphers, validateTor

Constructor Summary

Constructors

Constructor and Description
StrongConnectionBuilder(android.content.Context context) Creates a builder instance.
StrongConnectionBuilder(StrongConnectionBuilder original) Copy constructor.

Method Summary

Modifier and Type	Method and Description
java.net.HttpURLConnection	build(android.content.Intent status) Builds a connection, applying the configuration already specified in the builder.
StrongConnectionBuilder	connectTo(java.lang.String url) Sets the URL to build a connection for.
StrongConnectionBuilder	connectTo(java.net.URL url) Sets the URL to build a connection for.
static StrongConnectionBuilder	forMaxSecurity(android.content.Context context) Creates a StrongConnectionBuilder using the strongest set of options for security.
protected java.lang.String	get(android.content.Intent status, java.net.HttpURLConnection connection, java.lang.String url) Performs an HTTP GET request using the supplied connection to a supplied URL, returning the String response or throws an Exception (e.g., cannot reach the server).
static java.lang.String	slurp(java.io.InputStream is)

Methods inherited from class info.guardianproject.netcipher.client.StrongBuilderBase

build, buildProxy, buildSocketFactory, checkTor, getHttpPort, getSocksPort, getSSLContext, supportsHttpProxy, supportsSocksProxy, withBestProxy, withHttpProxy, withSocksProxy, withTorValidation, withTrustManagers, withWeakCiphers

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StrongConnectionBuilder

public StrongConnectionBuilder(android.content.Context context)

Creates a builder instance.

Parameters:

context - any Context will do; builder will hold onto Application context

StrongConnectionBuilder

public StrongConnectionBuilder(StrongConnectionBuilder original)

Copy constructor.

Parameters:

original - builder to clone

Method Detail

forMaxSecurity

public static StrongConnectionBuilder forMaxSecurity(android.content.Context context)
                                              throws java.lang.Exception

Creates a StrongConnectionBuilder using the strongest set of options for security. Use this if the strongest set of options is what you want; otherwise, create a builder via the constructor and configure it as you see fit.

Parameters:

context - any Context will do

Returns:

a configured StrongConnectionBuilder

Throws:

java.lang.Exception

connectTo

public StrongConnectionBuilder connectTo(java.lang.String url)
                                  throws java.net.MalformedURLException

Sets the URL to build a connection for.

Parameters:

url - the URL

Returns:

the builder

Throws:

java.net.MalformedURLException

connectTo

public StrongConnectionBuilder connectTo(java.net.URL url)

Sets the URL to build a connection for.

Parameters:

url - the URL

Returns:

the builder

build

public java.net.HttpURLConnection build(android.content.Intent status)
                                 throws java.io.IOException

Builds a connection, applying the configuration already specified in the builder.

Parameters:

status - status Intent from OrbotInitializer

Returns:

the connection

Throws:

java.io.IOException

get

protected java.lang.String get(android.content.Intent status,
                               java.net.HttpURLConnection connection,
                               java.lang.String url)
                        throws java.lang.Exception

Description copied from class: StrongBuilderBase

Performs an HTTP GET request using the supplied connection to a supplied URL, returning the String response or throws an Exception (e.g., cannot reach the server). This is used as part of validating the Tor connection.

Specified by:

get in class StrongBuilderBase<StrongConnectionBuilder,java.net.HttpURLConnection>

Parameters:

status - the status Intent we got back from Orbot

connection - a connection of the type for the builder

url - an public Web page

Returns:

the String response from the GET request

Throws:

java.lang.Exception

slurp

public static java.lang.String slurp(java.io.InputStream is)
                              throws java.io.IOException

Throws:

java.io.IOException