Changes between Version 56 and Version 57 of WikiStart

Timestamp:

09/24/19 11:34:10 (5 years ago)

Author:

wouter

Comment:

--

WikiStart

@@ -78 +78 @@
 = Communication protocol
 
-TODO clarify what is MUST
+This section deals with the communication protocols with the runserver. These may be relevant when you need to communicate directly with it, e.g. when you build your own GUI or start up your own sessions and tournaments from a script. 
 
-This section deals with the communication protocols with the runserver. These may be relevant when you need to communicate directly with it, e.g. when you build your own GUI or start up your own sessions and tournaments from a script. Other implementations of a runserver should adhere to the same communication protocols to ensure compatibility with GeniusWeb. 
+Other implementations of a runserver should adhere to the same communication protocols to ensure compatibility with GeniusWeb. 
 
 === Run Negotiation 
 This section describes the [source:/src/main/java/geniusweb/runserver/RunNego.java RunNego] service. It is available at {{{http:..:8080//runserver/run}}}.
 This service starts up and runs a complete Nego (session or tournament) when it is accessed (http get or post).
-To start a negotiation, the http get must include a JSON-serialized [https://tracinsy.ewi.tudelft.nl/pubtrac/GeniusWeb/browser/protocol/src/main/java/geniusweb/protocol/NegoSettings.java geniusweb.protocol.NegoSettings] object. All details are in the javadocs, here we discuss it only briefly.
+To start a negotiation, the http get must include a JSON-serialized [https://tracinsy.ewi.tudelft.nl/pubtrac/GeniusWeb/browser/protocol/src/main/java/geniusweb/protocol/NegoSettings.java geniusweb.protocol.NegoSettings] header. 
 
-After session is started, popup shows the negotiation ID. The ID starts with the name of the protocol (SAOP, APP) followed by a serial number.
 
-Typically the settings looks like this (session with SAOP protocol):
+The contents of NegoSettings  depends on the type of session/tournament that is to be run and is determined by the protocol. All details are in the javadocs, see the [https://tracinsy.ewi.tudelft.nl/pubtrac/GeniusWeb main wiki page].
+
+The format of the settings are determined by the protocol.
+
+Typically the session settings looks like this:
 {{{
 {"SAOPSettings": {
@@ -101 +104 @@
 The "SAOPSettings" indicates that these settings are SAOPSettings and (see Settings.getProtocol) will be interpreted by the SAOP protocol.
 
-
 The participants is a list with PartyWithProfile items: a "party" field containing a http address on a partiesserver, and a "profile" field containing a websocket address on a profilesserver.
 
 The deadline contains the deadline for the SAOP, which is how long the negotiation can last.
 
-To run a tournament, the NegoSettings typically look like this:
+For different protocols, the contents will differ.
+
+For a tournament, the NegoSettings typically look like this:
 {{{
 {"AllPermutationsSettings":{