com.subgraph.orchid.circuits

Class ExitCircuitImpl

java.lang.Object

com.subgraph.orchid.circuits.CircuitImpl

com.subgraph.orchid.circuits.ExitCircuitImpl

All Implemented Interfaces:

Circuit, DashboardRenderable, ExitCircuit

public class ExitCircuitImpl
extends CircuitImpl
implements ExitCircuit

Field Summary

Fields inherited from class com.subgraph.orchid.circuits.CircuitImpl

logger, prechosenPath

Fields inherited from interface com.subgraph.orchid.dashboard.DashboardRenderable

DASHBOARD_CIRCUITS, DASHBOARD_CONNECTIONS, DASHBOARD_CONNECTIONS_VERBOSE, DASHBOARD_PREDICTED_PORTS, DASHBOARD_STREAMS

Method Summary

Modifier and Type	Method and Description
boolean	canHandleExitTo(ExitTarget target) Return true if the final node of this circuit is believed to be able to connect to the specified ExitTarget.
boolean	canHandleExitToPort(int port)
protected List<Router>	choosePathForCircuit(CircuitPathChooser pathChooser)
protected String	getCircuitTypeLabel()
Stream	openExitStream(IPv4Address address, int port, long timeout) Open an exit stream from the final node in this circuit to the specified target address and port.
Stream	openExitStream(String target, int port, long timeout) Open an exit stream from the final node in this circuit to the specified target hostname and port.
void	recordFailedExitTarget(ExitTarget target) Records the specified ExitTarget as a failed connection so that ExitCircuit.canHandleExitTo(ExitTarget) will no longer return true for this exit destination.

Methods inherited from class com.subgraph.orchid.circuits.CircuitImpl

appendNode, createNewStream, createNewStream, createRelayCell, dashboardRender, deliverControlCell, deliverRelayCell, destroyCircuit, getActiveStreams, getCircuitId, getConnection, getFinalCircuitNode, getSecondsDirty, isClean, isConnected, isMarkedForClose, isPending, markForClose, pathToString, processStreamOpenException, receiveRelayCell, removeStream, sendRelayCell, sendRelayCellToFinalNode, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.subgraph.orchid.Circuit

appendNode, createRelayCell, deliverControlCell, deliverRelayCell, destroyCircuit, getActiveStreams, getCircuitId, getConnection, getFinalCircuitNode, getSecondsDirty, isClean, isConnected, isMarkedForClose, isPending, markForClose, receiveRelayCell, sendRelayCell

Method Detail

openExitStream

public Stream openExitStream(IPv4Address address,
                             int port,
                             long timeout)
                      throws InterruptedException,
                             TimeoutException,
                             StreamConnectFailedException

Description copied from interface: ExitCircuit

Open an exit stream from the final node in this circuit to the specified target address and port.

Specified by:

openExitStream in interface ExitCircuit

Parameters:

address - The network address of the exit target.

port - The port of the exit target.

Returns:

The status response returned by trying to open the stream.

Throws:

InterruptedException

TimeoutException

StreamConnectFailedException

openExitStream

public Stream openExitStream(String target,
                             int port,
                             long timeout)
                      throws InterruptedException,
                             TimeoutException,
                             StreamConnectFailedException

Description copied from interface: ExitCircuit

Open an exit stream from the final node in this circuit to the specified target hostname and port.

Specified by:

openExitStream in interface ExitCircuit

Parameters:

target - The network hostname of the exit target.

port - The port of the exit target.

Returns:

The status response returned by trying to open the stream.

Throws:

InterruptedException

TimeoutException

StreamConnectFailedException

recordFailedExitTarget

public void recordFailedExitTarget(ExitTarget target)

Description copied from interface: ExitCircuit

Records the specified ExitTarget as a failed connection so that ExitCircuit.canHandleExitTo(ExitTarget) will no longer return true for this exit destination.

Specified by:

recordFailedExitTarget in interface ExitCircuit

Parameters:

target - The ExitTarget to which a connection has failed through this circuit.

canHandleExitTo

public boolean canHandleExitTo(ExitTarget target)

Description copied from interface: ExitCircuit

Return true if the final node of this circuit is believed to be able to connect to the specified ExitTarget. Returns false if the target destination is not permitted by the exit policy of the final node in this circuit or if the target has been previously recorded to have failed through this circuit.

Specified by:

canHandleExitTo in interface ExitCircuit

Parameters:

target - The exit destination.

Returns:

Return true if is likely that the final node of this circuit can connect to the specified exit target.

canHandleExitToPort

public boolean canHandleExitToPort(int port)

Specified by:

canHandleExitToPort in interface ExitCircuit

choosePathForCircuit

protected List<Router> choosePathForCircuit(CircuitPathChooser pathChooser)
                                     throws InterruptedException,
                                            PathSelectionFailedException

Specified by:

choosePathForCircuit in class CircuitImpl

Throws:

InterruptedException

PathSelectionFailedException

getCircuitTypeLabel

protected String getCircuitTypeLabel()

Specified by:

getCircuitTypeLabel in class CircuitImpl