org.netbeans.lib.cvsclient

Class PseudoCvsServer

java.lang.Object

org.netbeans.lib.cvsclient.PseudoCvsServer

All Implemented Interfaces:

java.lang.Runnable

public final class PseudoCvsServer
extends java.lang.Object
implements java.lang.Runnable

Unit testing CVS server implementation that provides constant replies coming from prepared files and simulates network and server overload failures.

Typical server usage in unit test sequence:

   InputStream in = getClass().getResourceAsStream("...");
   PseudoCvsServer cvss = new PseudoCvsServer(in);
   new Thread(cvss).start();
   String cvsRoot = cvss.getCvsRoot();
   <client operations>
   cvss.stop();  // check test failure
   <tested client asserts>
 

Fake input and output streams can be on Unix systems catched using nc program. To catch command line cvs:

• outgoing requests stream use

  nc -l -p $3000 | tee $requests.log

  and

  cvs -d :pserver:$ano@127.0.0.1:$3000/$cvs -z0 $whateEverCommand

• incoming responses stream use

  nc $cvs.netbeans.org $2401 | tee $reponses.log

Author:

Petr Kuzel

Constructor Summary

Constructors

Constructor and Description
PseudoCvsServer(java.io.InputStream in) Creates new server that replies with given data.
PseudoCvsServer(java.lang.String name)

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getCvsRoot() Utility method returning typical CVSRoot sutable for local CVSClient testing.
int	getPort() returns port that accepts client requests.
void	ignoreProbe() Enters ignore very first connect mode (connection probe).
void	logRequests(java.io.OutputStream out) Logs server input intu specified stream.
void	run() Entry point, starts listening at port and sends out predefined replies.
void	simulateNetworkFailure(int write, int read) Enters hard network failure simulation mode, silentry dropping down connection after specified number of in/outgoing bytes.
void	simulateServerOverload(int write, int read) Enters server overload simulation mode.
void	simulateSlowNetwork(int write, int read)
void	stop() Stops server and optionaly rethrows internal server exception if any.
java.lang.String	toString() For diagnostics purpoes only.

Methods inherited from class java.lang.Object

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

Constructor Detail

PseudoCvsServer

public PseudoCvsServer(java.lang.String name)
                throws java.io.IOException

Throws:

java.io.IOException

PseudoCvsServer

public PseudoCvsServer(java.io.InputStream in)
                throws java.io.IOException

Creates new server that replies with given data.

Parameters:

in - input stream that is consumend and closed once server runnable terminates.

Throws:

java.io.IOException - if cannot create server socket

Method Detail

getPort

public int getPort()

returns port that accepts client requests.

getCvsRoot

public java.lang.String getCvsRoot()

Utility method returning typical CVSRoot sutable for local CVSClient testing.

Returns:

":pserver:anoncvs@127.0.0.1:" + getPort() + "/cvs"

simulateNetworkFailure

public void simulateNetworkFailure(int write,
                          int read)

Enters hard network failure simulation mode, silentry dropping down connection after specified number of in/outgoing bytes.

Parameters:

write - specifies number of bytes send before closing socket output stream. -1 for unlimited.

read - specifies number of bytes received before closing socket input stream. -1 for unlimited.

simulateServerOverload

public void simulateServerOverload(int write,
                          int read)

Enters server overload simulation mode. Server properly closes streams sending TCP signals to client.

Parameters:

write - specifies number of bytes send before shuting down socket output stream. -1 for unlimited.

read - specifies number of bytes received before shuting down socket input stream. -1 for unlimited.

simulateSlowNetwork

public void simulateSlowNetwork(int write,
                       int read)

ignoreProbe

public void ignoreProbe()

Enters ignore very first connect mode (connection probe). It means that actual data are send out to second requestor.

logRequests

public void logRequests(java.io.OutputStream out)

Logs server input intu specified stream.

Parameters:

out - log stream. The stream is closed on server termination.

run

public void run()

Entry point, starts listening at port and sends out predefined replies. HAndles only first request.

Specified by:

run in interface java.lang.Runnable

stop

public void stop()
          throws java.lang.Exception

Stops server and optionaly rethrows internal server exception if any.

Throws:

java.lang.Exception

toString

public java.lang.String toString()

For diagnostics purpoes only.

Overrides:

toString in class java.lang.Object