Re: [hybi] interop tests - fragments

[Greg Wilkins <[e-mail]>]

Since not everybody doing interop will be familiar with Java,  I
thought I'd post some more explicit instructions of how to run the
jetty test client/server, plus descriptions of the test protocols that
they are using.

You can get the latest jetty aggregate jar with:
  wget -O jetty-all.jar
https://oss.sonatype.org/content/groups/jetty-with-staging/org/eclipse/jetty/aggregate/jetty-all/7.3.2-SNAPSHOT/jetty-all-7.3.2-20110314.133648-9.jar

you also need a servlet jar:
  wget --user-agent=something
http://repo2.maven.org/maven2/javax/servlet/servlet-api/2.5/servlet-api-2.5.jar


The server can then be run with

  java -cp jetty-all.jar:servlet-api-2.5.jar
org.eclipse.jetty.websocket.TestServer --port 8080


And the client with:

  java -cp jetty-all.jar:servlet-api-2.5.jar
org.eclipse.jetty.websocket.TestClient --help
  ERROR: [--help]
  USAGE: java -cp CLASSPATH class
org.eclipse.jetty.websocket.TestClient [ OPTIONS ]
    -h|--host HOST  (default localhost)
    -p|--port PORT  (default 8080)
    -b|--binary
    -v|--verbose
    -c|--count n    (default 10)
    -s|--size n     (default 64)
    -f|--fragment n (default 4000)
    -P|--protocol echo|echo-assemble|echo-fragment|echo-broadcast


The protocols supported are the ones I proposed earlier:

    org.ietf.websocket.test-echo
        Websocket messages are sent by the client and the server will
echo every frame.

    org.ietf.websocket.test-echo-broadcast
        Websocket messages are sent by the client and the server will
echo every frame to every connection.

    org.ietf.websocket.test-echo-assemble
        Websocket messages are sent by the client and the server will
echo assembled messages as a single frame.

    org.ietf.websocket.test-echo-fragment
        Websocket messages are sent and the server will echo each
message fragmented into 2 frames.


If there is no interest in making these common, then I'll drom the
org.ietf prefix

An example of running the test client is

[558] java -cp jetty-all.jar:servlet-api-2.5.jar
org.eclipse.jetty.websocket.TestClient --port 8080 --binary --count 3
--size 120 --fragment 40 --protocol echo-fragment
Jetty WebSocket PING localhost:8080 (localhost/127.0.0.1:8080) 120
bytes of data.
handshake OK for protocol 'org.ietf.websocket.test-echo-fragment'
120 bytes from localhost: frames=2 req=1 time=52.0ms opcode=0x05
120 bytes from localhost: frames=2 req=2 time=38.2ms opcode=0x05
120 bytes from localhost: frames=2 req=3 time=37.4ms opcode=0x05
--- localhost websocket ping statistics using 1 connection ---
9 frames transmitted, 6 received, 3 messages transmitted, 3 received,
time 3009ms
rtt min/ave/max = 37.448/42.534/51.974 ms

So 3x120B binary messages were sent in 3x40B fragments, for a total of
9 frames sent.  The echo-fragment protocol received these 3 messages
and echoed each back in 2 fragments, for 6 frames received.


cheers