X-Git-Url: http://git.euphorik.ch/?p=euphorik.git;a=blobdiff_plain;f=doc%2Fprotocole2.txt;h=f691780ba752bafd23a3a1a8ba48a05dc06cfe3b;hp=6449cd9b41fa20085bd809af9275f6b32b00dbb0;hb=13ea96f3600d1c42b22b6ea91dc75055555f72b7;hpb=e1c21cd05116920e07d1ab2b3b11d895edd9afb8

diff --git a/doc/protocole2.txt b/doc/protocole2.txt
index 6449cd9..f691780 100644
--- a/doc/protocole2.txt
+++ b/doc/protocole2.txt
@@ -1,69 +1,69 @@
-Euphorik - minichat - Protocole v2
-----------------------------------
-
-A. Introduction
----------------
-
-Ce document a pour but de décrire la communication client-serveur du site euphorik.
-Ce document remplace 'protocole.txt' qui était la première version du protocol.
-
-B. Principe
------------
-
-Enregistrement:
-
-Authentification:
-
-Rafraichissement:
- * Le client envoie une demande au serveur avec l'id du dernier message (via XMLHttpRequest ou un function de JQuery)
- * Le serveur maintient la connexion bloqué si le client est à jour.
- * Dès qu'un nouveau message arrive, le serveurs débloque la connexion est envoie le ou les messages manquants.
+Euphorik - minichat - Protocole v2
+----------------------------------
+
+A. Introduction
+---------------
+
+Ce document a pour but de décrire la communication client-serveur du site euphorik.
+Ce document remplace 'protocole.txt' qui était la première version du protocol.
+
+B. Principe
+-----------
+
+Enregistrement:
+
+Authentification:
+
+Rafraichissement:
+ * Le client envoie une demande au serveur avec l'id du dernier message (via XMLHttpRequest ou un function de JQuery)
+ * Le serveur maintient la connexion bloqué si le client est à jour.
+ * Dès qu'un nouveau message arrive, le serveurs débloque la connexion est envoie le ou les messages manquants.
  
-
-C. Protocole
-------------
-c : client
-s : server
-Chaque message est numéroté #<num>.
-Les messages client vers serveur sont envoyé par HTTP-POST
-
-
-C.1. Login
-----------
-
-c -> s
+
+C. Protocole
+------------
+c : client
+s : server
+Chaque message est numéroté #<num>.
+Les messages client vers serveur sont envoyé par HTTP-POST
+
+
+C.1. Login
+----------
+
+c -> s
 #1
  <action name="login">
    <login>Paul</login>
    <password>IJKJDHHSAD9081238</password>
  </action>
-
-ou
+
+ou
 #2 (<login> et <password> peuvent être omis)
  <action name="register">
    <login>Paul</login>
    <password>IJKJDHHSAD9081238</password>
- </action>
-   
-s -> c
-#3 (<information> et <pseudo> pas obligatoire)
- <reponse name="login">
-   <statut>enregistre|identifie|erreur</statut>
-   <cookie>LKJDLAKSJBFLKASN</cookie>
-   <id>7ZS</id> <!-- l'id est en base 36 -->
+ </action>
+   
+s -> c
+#3 (<information> et <pseudo> pas obligatoire)
+ <reponse name="login">
+   <statut>enregistre|identifie|erreur</statut>
+   <cookie>LKJDLAKSJBFLKASN</cookie>
+   <id>7ZS</id> <!-- l'id est en base 36 -->
    <pseudo>Paul</pseudo>
    <login>paul49</login>
    <email>paul@pierre.com</email>
-   <css>css/lite.css</css>
-   <information>blabla</information>
- </reponse>
- 
- 
-C.2. Logout
------------
-c -> s
- <action name="logout">
-   <cookie>LKJDLAKSJBFLKASN</cookie> 
+   <css>css/lite.css</css>
+   <information>blabla</information>
+ </reponse>
+ 
+ 
+C.2. Logout
+-----------
+c -> s
+ <action name="logout">
+   <cookie>LKJDLAKSJBFLKASN</cookie> 
  </action>
  
 C.3. Profile
@@ -84,78 +84,82 @@ s -> c
  <reponse name="profile">
    <statut>ok|pas ok</statut>
    <information>balbla></information>
- </reponse>
-
-
-C.4. Attente evenement
-----------------------
-
-Si dernierMessageId est absent alors le client ne possède pas de message.
-Page peut être omis, il a alors la valeur 1 (première page)
+ </reponse>
+
+
+C.4. Refresh messages
+---------------------
+
+Si dernierMessageId est absent alors le client ne possède pas de message.
+Page peut être omis, il a alors la valeur 1 (première page)
 dernierMessageId est en base 36 (l'histoire de rigoler un peu)
-
-c -> s
- <action name="attenteEvenement">
-  <cookie>LKJDLAKSJBFLKASN</cookie>
-  <dernierMessageId>6ZR</dernierMessageId>
-  <nombreMessage>10</nombreMessage>
-  <page>1</page>
- </action>
- 
-s -> c
- <reponse name="attenteEvenement" evenement="nouveauxMessages">
-  <nbPage>4</nbPage> <!-- le nombre de page total -->
-  <message id="1F5">
-   <date>Hier 17:26:54</date>
-   <systeme></system> <!-- est-ce un message système ? -->
-   <proprietaire></proprietaire> <!-- est-ce que le message appartient à l'utilisateur courant ? "true" ou "false" -->
-   <repondu></repondu>  <!-- est-ce que l'utilisateur courant a répondu à ce message ? "true" ou "false" -->
-   <reponse></reponse> <!-- est-ce que c'est une réponse à un message de l'utilisateur courant ? "true" ou "false" -->
-   <pseudo>Paul</pseudo>
-   <login>paul_22</login>
-   <contenu>Salut</contenu>
-   <repondA>
-      <!-- id est l'id d'un message -->
-      <id id="DE2" pseudo="Pierre" login="pierre_45"> 
-      <!-- [..] -->
-   </repondA>
-  </message>
-  <!-- [..] -->
- </reponse>
- 
-ou
- <reponse name="attenteEvenement" evenement="modificationMessage">
- TODO
- </reponse>
-
-ou
- <reponse name="refreshMessages">
-  <erreur>raison</erreur>
- </reponse>
-
-C.5. Envoie message
--------------------
-
-Un client envoie un message, le message peut répondre à un certain nombre d'autres messages.
-<reponses> n'est pas obligatoire.
-c -> s
- <action name="message">
-  <cookie>LKJDLAKSJBFLKASN</cookie>
-  <pseudo>Paul</pseudo> <!-- il est possible que la personne change de pseudo -->
-  <contenu>Bonjour</contenu>
-  <reponses>
-   <reponse id="RT5" />
-   <reponse id="39K" />
-   <!-- [..] -->
-  </reponses>
- </action>
- 
-s -> c
- <reponse name="message">
-   <statut>ok|pas ok</statut>
- </reponse>
- 
-
-C.5. Envoie message
--------------------
- 
+
+c -> s
+ <action name="refreshMessages">
+  <cookie>LKJDLAKSJBFLKASN</cookie>
+  <nombreMessage>10</nombreMessage>
+  <conversation num="0">
+   <racine>RE</racine> <!-- pas présent pour la conversation numéro 0 -->
+   <dernierMessageId>6ZR</dernierMessageId>
+   <page>1</page>
+  </converation>
+  <!-- [..] -->
+ </action>
+ 
+s -> c
+   <reponse name="refreshMessages">
+      <conversation num="0"> <!-- num : le numéro de la conversation 0 = conversation principale -->
+         <autresPages>true</autresPages> <!-- possède une ou plusieurs autres pages ? "true" ou "false" -->
+         <message id="1F5">
+            <date>Hier 17:26:54</date> <!-- date du message (format non formel) -->
+            <systeme></system> <!-- est-ce un message système ? "true" ou "false" -->
+            <proprietaire></proprietaire> <!-- est-ce que le message appartient à l'utilisateur courant ? "true" ou "false" -->
+            <repondu></repondu>  <!-- est-ce que l'utilisateur courant a répondu à ce message ? "true" ou "false" -->
+            <reponse></reponse> <!-- est-ce que c'est une réponse à un message de l'utilisateur courant ? "true" ou "false" -->
+            <pseudo>Paul</pseudo>
+            <login>paul_22</login>
+            <contenu>Salut</contenu>
+            <repondA>
+               <!-- id est l'id d'un message -->
+               <id id="DE2" pseudo="Pierre" login="pierre_45"> 
+               <!-- [..] -->
+            </repondA>
+         </message>
+         <!-- [..] -->
+      <conversation>
+      <!-- [..] -->
+   </reponse>
+ou
+   <!-- modification d'un message -->
+   <reponse name="modMessage">
+   TODO
+   </reponse>
+ou
+   <reponse name="refreshMessages">
+      <erreur>raison</erreur>
+   </reponse>
+
+
+C.5. Envoie message
+-------------------
+
+Un client envoie un message, le message peut répondre à un certain nombre d'autres messages.
+<reponses> n'est pas obligatoire.
+c -> s
+ <action name="message">
+  <cookie>LKJDLAKSJBFLKASN</cookie>
+  <pseudo>Paul</pseudo> <!-- il est possible que la personne change de pseudo -->
+  <contenu>Bonjour</contenu>
+  <reponses>
+   <reponse id="RT5" />
+   <reponse id="39K" />
+   <!-- [..] -->
+  </reponses>
+ </action>
+ 
+s -> c
+ <reponse name="message">
+   <statut>ok|pas ok</statut>
+ </reponse>
+ 
+