ch.racic.caps

Class CAPServer

java.lang.Object

java.lang.Thread

ch.racic.caps.CAPServer

All Implemented Interfaces:

Runnable

public class CAPServer
extends Thread

Created by rac on 08.02.15.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROJECT_NAME
static String	PROJECT_VERSION

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
CAPServer(ICapsConfiguration configuration) CAPS main thread constructor Initialize the server with a configuration object and use the start() method to start listening.

Method Summary

Methods

Modifier and Type	Method and Description
static CAPServer	bringItUpRunning(ICapsConfiguration conf) Factory to instantiate the proxy, start it and wait until it is listening prior to returning with the CAPS instance.
Integer	getProxyListenerPort() Get the current proxy port, will be null if proxy startup is not yet finished or not initiated.
String	getProxyString() The proxy string has the form {hostname}:{port} and can be used to create a selenium proxy object.
void	run() The main loop thread which starts the server and listens for new socket connections until it gets shutdown.
void	shutdown() Initiate shutdown of the proxy server.

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

PROJECT_NAME

public static String PROJECT_NAME

PROJECT_VERSION

public static String PROJECT_VERSION

Constructor Detail

CAPServer

public CAPServer(ICapsConfiguration configuration)

CAPS main thread constructor Initialize the server with a configuration object and use the start() method to start listening. After using it, you can use the shutdown() method to initiate the shutdown of the server which interrupts all connection handler threads and closes the sockets.

     capsConf = new CapsConfiguration()
               .setTargetKeyStorePath("certs/test.p12")
               .setTargetKeyStorePassword("testPassword");
     CAPServer cs = new CAPServer(capsConf);
     cs.start();
     ... do whatever tests you want to do ...
     // Getting a proxy object to use in selenium
     String proxyString = "localhost:" + cs.getProxyListenerPort();
     org.openqa.selenium.Proxy proxy = new Proxy().setSslProxy(proxyString).setHttpProxy(proxyString)
     DesiredCapabilities caps = DesiredCapabilities.htmlUnit();
     caps.setCapability(CapabilityType.ACCEPT_SSL_CERTS, true);
     caps.setCapability(CapabilityType.PROXY, proxy);
     HtmlUnitDriver d = new HtmlUnitDriver(caps);
     ...
     cs.shutdown();
 

Parameters:

configuration -

Method Detail

bringItUpRunning

public static CAPServer bringItUpRunning(ICapsConfiguration conf)
                                  throws InterruptedException,
                                         CertificateException,
                                         UnrecoverableKeyException,
                                         NoSuchAlgorithmException,
                                         IOException,
                                         KeyManagementException,
                                         KeyStoreException,
                                         ConfigurationException

Factory to instantiate the proxy, start it and wait until it is listening prior to returning with the CAPS instance.

Parameters:

conf -

Returns:

CAPServer instance which is already listening

Throws:

InterruptedException

CertificateException

UnrecoverableKeyException

NoSuchAlgorithmException

IOException

KeyManagementException

KeyStoreException

ConfigurationException

run

public void run()

The main loop thread which starts the server and listens for new socket connections until it gets shutdown.

Specified by:

run in interface Runnable

Overrides:

run in class Thread

shutdown

public void shutdown()

Initiate shutdown of the proxy server. This will send interrupts to all processing threads and closes the sockets.

getProxyListenerPort

public Integer getProxyListenerPort()

Get the current proxy port, will be null if proxy startup is not yet finished or not initiated. Use @see bringItUpRunning for a synced start, after this getProxyListener port will return you the actual port for sure.

Returns:

port or null if proxy is not yet started

getProxyString

public String getProxyString()

The proxy string has the form {hostname}:{port} and can be used to create a selenium proxy object.

     String proxyString = cs.getProxyString();
     org.openqa.selenium.Proxy proxy = new Proxy().setSslProxy(proxyString).setHttpProxy(proxyString);
     DesiredCapabilities caps = DesiredCapabilities.htmlUnit();
     caps.setCapability(CapabilityType.ACCEPT_SSL_CERTS, true);
     caps.setCapability(CapabilityType.PROXY, proxy);
 

Returns: