anon.client

Class AnonClient

java.lang.Object

anon.client.AnonClient

All Implemented Interfaces:

AnonService, DataChainErrorListener, IntegrityErrorListener, java.util.Observer

public class AnonClient
extends java.lang.Object
implements AnonService, java.util.Observer, DataChainErrorListener, IntegrityErrorListener

This class implements an AnonService using mix cascades to ensure anonymous communication.

Author:

Stefan Lieske

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_BLOCK_TIMEOUT
static int	DEFAULT_LOGIN_TIMEOUT

Fields inherited from interface anon.AnonService

ANONLIB_VERSION

Constructor Summary

Constructors

Constructor and Description
AnonClient()
AnonClient(DirectProxy a_directProxy)
AnonClient(DirectProxy a_directProxy, anon.transport.connection.IStreamConnection a_theConnection, MixCascade a_currentService)

Method Summary

Modifier and Type	Method and Description
void	addEventListener(AnonServiceEventListener a_eventListener) Adds an AnonServiceEventListener.
AnonChannel	createChannel(int a_type) Creates a new AnonChannel, which could be used for transmitting data.
void	dataChainErrorSignaled(AnonServiceException a_e)
SocketHandler	getConnectionToMixCascade() Return the TCP connection used to connect to the cascade.
MixCascade	getCurrentService()
static int	getLoginTimeout()
void	initialize(AnonServerDescription a_mixCascade, IServiceContainer a_serviceContainer, TermsAndConditionConfirmation termsConfirmation, boolean a_bIsReconnect) Initializes the underlying AnonService, using a subclass of AnonServerDescription to give specific details.
void	integrityErrorSignaled(int a_iErrorCode)
static boolean	isBlockedOnHttpConnectionError()
boolean	isConnected() Returns true if this Anon Service is connected, e.g. initialized and usable
boolean	isSendingControlMessage()
static boolean	isTestInstance()
void	removeEventListener(AnonServiceEventListener a_eventListener) Removes an AnonServiceEventListener.
void	removeEventListeners()
static void	setBlockOnHttpConnectionError(boolean a_bBlock)
void	setDebug(boolean bDebug) if bDebug==true this client operates in debug modes.
void	setDNSResolver(HTTPClient.IHTTPClientDNSResolver a_dnsResolver)
void	setDummyTraffic(int a_interval) Set the interval after which a dummy is sent
void	setInterfaceBlockTimout(long msTimeOut) Sets the time [in ms] an interface of a Cascade is block, if a connection error occurs)
static void	setLoginTimeout(int a_loginTimeoutMS)
int	setProxy(IMutableProxyInterface a_proxyInterface) Sets the settings for the proxy, which should be used to establish network connections
void	setSocketFactory(HTTPClient.HTTPClientSocketFactory socketFactory) Sets the socket factory to be used in creating sockets to connect to the AnonService.
static void	setTestInstance(boolean a_bTestInstance)
void	shutdown(boolean a_bResetTransferredBytes) Disconnects form the server.
static void	tearDown() Only for internal cleanup!
void	update(java.util.Observable a_object, java.lang.Object a_argument)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_LOGIN_TIMEOUT

public static final int DEFAULT_LOGIN_TIMEOUT

See Also:

Constant Field Values

DEFAULT_BLOCK_TIMEOUT

public static final long DEFAULT_BLOCK_TIMEOUT

See Also:

Constant Field Values

Constructor Detail

AnonClient

public AnonClient()

AnonClient

public AnonClient(DirectProxy a_directProxy)

AnonClient

public AnonClient(DirectProxy a_directProxy,
                  anon.transport.connection.IStreamConnection a_theConnection,
                  MixCascade a_currentService)

Method Detail

setDebug

public void setDebug(boolean bDebug)

if bDebug==true this client operates in debug modes. Which means for instance, that all keys are set to zero!

setTestInstance

public static void setTestInstance(boolean a_bTestInstance)

isTestInstance

public static boolean isTestInstance()

getCurrentService

public MixCascade getCurrentService()

initialize

public void initialize(AnonServerDescription a_mixCascade,
                       IServiceContainer a_serviceContainer,
                       TermsAndConditionConfirmation termsConfirmation,
                       boolean a_bIsReconnect)
                throws AnonServiceException

Description copied from interface: AnonService

Initializes the underlying AnonService, using a subclass of AnonServerDescription to give specific details. This method must be called before any Channels can be created.

Specified by:

initialize in interface AnonService

Parameters:

a_mixCascade - Parameters describing the service configuration.

Throws:

AnonServiceException

setLoginTimeout

public static void setLoginTimeout(int a_loginTimeoutMS)

setBlockOnHttpConnectionError

public static void setBlockOnHttpConnectionError(boolean a_bBlock)

isBlockedOnHttpConnectionError

public static boolean isBlockedOnHttpConnectionError()

getLoginTimeout

public static int getLoginTimeout()

setProxy

public int setProxy(IMutableProxyInterface a_proxyInterface)

Description copied from interface: AnonService

Sets the settings for the proxy, which should be used to establish network connections

Specified by:

setProxy in interface AnonService

Returns:

E_SUCCESS, if ok

shutdown

public void shutdown(boolean a_bResetTransferredBytes)

Description copied from interface: AnonService

Disconnects form the server.

Specified by:

shutdown in interface AnonService

isConnected

public boolean isConnected()

Description copied from interface: AnonService

Returns true if this Anon Service is connected, e.g. initialized and usable

Specified by:

isConnected in interface AnonService

isSendingControlMessage

public boolean isSendingControlMessage()

createChannel

public AnonChannel createChannel(int a_type)
                          throws java.net.ConnectException

Description copied from interface: AnonService

Creates a new AnonChannel, which could be used for transmitting data. There is a limit of 50 channels per AnonService-connection, in order to prevent Denial of Service-attacks

Specified by:

createChannel in interface AnonService

Parameters:

a_type - the type of the created channel; See AnonChannel

Returns:

AnonChannel, useful for data transmission

Throws:

java.net.ConnectException

addEventListener

public void addEventListener(AnonServiceEventListener a_eventListener)

Description copied from interface: AnonService

Adds an AnonServiceEventListener. This listener will receive events like: ... For more information see AnonServiceEventListener.

Specified by:

addEventListener in interface AnonService

Parameters:

a_eventListener - Listener to add

removeEventListeners

public void removeEventListeners()

Specified by:

removeEventListeners in interface AnonService

removeEventListener

public void removeEventListener(AnonServiceEventListener a_eventListener)

Description copied from interface: AnonService

Removes an AnonServiceEventListener. This Listener will not receive any Events anymore.

Specified by:

removeEventListener in interface AnonService

Parameters:

a_eventListener - Listener, which will be removed

update

public void update(java.util.Observable a_object,
                   java.lang.Object a_argument)

Specified by:

update in interface java.util.Observer

dataChainErrorSignaled

public void dataChainErrorSignaled(AnonServiceException a_e)

Specified by:

dataChainErrorSignaled in interface DataChainErrorListener

integrityErrorSignaled

public void integrityErrorSignaled(int a_iErrorCode)

Specified by:

integrityErrorSignaled in interface IntegrityErrorListener

setDummyTraffic

public void setDummyTraffic(int a_interval)

Set the interval after which a dummy is sent

Parameters:

a_interval - The new dummy traffic interval in milliseconds or @see DummyTrafficControlChannel.DT_DISABLE, if dummy traffic shall be disabled.

setInterfaceBlockTimout

public void setInterfaceBlockTimout(long msTimeOut)

Sets the time [in ms] an interface of a Cascade is block, if a connection error occurs)

Parameters:

ms - block timeout in ms

getConnectionToMixCascade

public SocketHandler getConnectionToMixCascade()

Return the TCP connection used to connect to the cascade. Needed in certain applications (e.g. VPN scenarios) to make sure that this connection is not routed over the MixCascade...

Returns:

Socket used for connection to MixCascade

setSocketFactory

public void setSocketFactory(HTTPClient.HTTPClientSocketFactory socketFactory)

Description copied from interface: AnonService

Sets the socket factory to be used in creating sockets to connect to the AnonService.

Specified by:

setSocketFactory in interface AnonService

Parameters:

socketFactory - socket factory used to create sockets, if NULL the default socket factory of the JRE is used.

setDNSResolver

public void setDNSResolver(HTTPClient.IHTTPClientDNSResolver a_dnsResolver)

tearDown

public static void tearDown()

Only for internal cleanup!