Invocation:
FitServer is invoked by a simple console command.
java fit.FitServer

Command Line Arguments:
Java usage: java fit.FitServer [-v] host port socketTicket


Execution:

• Connecting
1. Use the socketTicket to build an HTTP request of the form:
• GET /?responder=socketCatcher&ticket=socketTicket HTTP/1.1\r\n\r\n
2. open socket connection to the given host and port.
3. write the http request over the socket (do not precede with size)
4. receive STATUS as INTEGER.
• Transactions - loops until a 0 INTEGER is read as the size of a document.
1. READ document from socket
2. process document and WRITE processed document to socket.
• the processes document may be written in 1 to many chunks.
3. write 0 to socket an an INTEGER.
4. WRITE COUNTS for document to socket
• Closing - invoked by reading a document size of 0.
1. close the socket.
2. exit execution with a value of (wrongs + exceptions)
• Extra
• INTEGER : A integer value in the form of a 10 byte string
• 0000000000 = 0
• 0000000005 = 5
• 0000000123 = 123
• READ : Reading a value involves two step.
1. read an INTEGER value
2. read n bytes where n is the integer previously read.
• this is the value intended to be used. The integer value is now useless.
• WRITE : Writing a value involves two steps
1. count the bytes in value and write the size as an INTEGER
2. write the value as bytes
• WRITE COUNTS : Write the counts as 4 INTEGERs
1. right
2. wrong
3. ignores
4. exceptions
• STATUS : Length of Error Message. If it is zero, the connection has been established.

If not, it is followed by the error description.


Errors and Exceptions:
- Connection Error: If the STATUS recieved at connection is not zero, then somehitng has gone wrong. The value of STATUS is the length of the error message the FitNesse will send. Before exiting FitServer should read the error message and print it to standard error.
- Transaction Error: If an exception is thrown during the processing of transactions then the exception should be wrapped in an HTML table and written back over the socket as though it were the test results. An exception thrown at any other point is considered fatal and may invoke abnormal termination.