X-Git-Url: http://git.euphorik.ch/?p=euphorik.git;a=blobdiff_plain;f=modules%2Ferl%2Feuphorik_requests.erl;h=1cd460ad20517a1216561fda416f2c7b88f192e2;hp=8c46b7bd53b38ae06c0f6c2320fb0c334d4e2e85;hb=ba4387c6afaaa2964c28292e7fbd1c35b3404ce5;hpb=a5e1d507f9b4172924e63d3333610b13747a2582

diff --git a/modules/erl/euphorik_requests.erl b/modules/erl/euphorik_requests.erl
index 8c46b7b..1cd460a 100755
--- a/modules/erl/euphorik_requests.erl
+++ b/modules/erl/euphorik_requests.erl
@@ -16,14 +16,14 @@
 % You should have received a copy of the GNU General Public License
 % along with Euphorik.  If not, see <http://www.gnu.org/licenses/>.
 % 
-% Ce module est fait pour répondre à des requêtes 'AJAX'.
-% Il est définit comme 'appmods' pour l'url "request" dans yaws.
+% Ce module est fait pour répondre à des requêtes JSON via 'AJAX'.
+% Il est définit comme 'appmods' pour l'url "request" dans Yaws.
 % Par exemple http://www.euphorik.ch/request abouti sur la fonction out/1 de ce module.
 % @author G.Burri
 
 
 -module(euphorik_requests).
--export([out/1, traiter_donnees/2]).
+-export([out/1]).
 -include_lib("yaws/include/yaws_api.hrl").
 -include("../include/euphorik_defines.hrl").
 
@@ -38,12 +38,13 @@ out(A) ->
    % keepalive -> true, evite que des firewalls coupe la connexion TCP sans prévenir
    inet:setopts(A#arg.clisock, [{active, true}, {keepalive, true}]),
    {value, {_, Contenu}} = lists:keysearch("action", 1, yaws_api:parse_post(A)),
-   Ret = traiter_donnees(Contenu, IP),
+   Ret = traiter_message(Contenu, IP),
    {content, "application/json", Ret}.
 
 
-% Décode les données JSON.
-traiter_donnees(Contenu, IP) ->
+% Décode le message JSON.
+traiter_message(Contenu, IP) ->
+   % extrait l'entête obligatoire des messages JSON
    {ok, {struct, [{header, {struct, [{action, Action}, {version, Version_client}]}} | Reste]}} = json:decode_string(Contenu),
    json:encode(
       if Version_client =:= ?VERSION_PROTOCOLE ->
@@ -56,40 +57,40 @@ traiter_donnees(Contenu, IP) ->
    ).
    
 
-% authentification d'un client
+% Authentification d'un client.
 traiter_action("authentification", JSON, IP) ->
    euphorik_protocole:login(JSON, IP);
-% un client s'enregistre : (pseudo + password) ou de manière anonyme
+% Un client s'enregistre : (pseudo + password) ou de manière anonyme.
 traiter_action("register", JSON, IP) ->
    euphorik_protocole:register(JSON, IP);
-% modification du profile
+% Modification du profile.
 traiter_action("set_profile", JSON, _) ->
    euphorik_protocole:profile(JSON);
-% un utilisateur attend un événement (par exemple l'arrivé d'un nouveau message)
+% Un utilisateur attend un événement (par exemple l'arrivée d'un nouveau message).
 traiter_action("wait_event", JSON, _) ->
    euphorik_protocole:wait_event(JSON);
-% un utilisateur envoie un message
+% Un utilisateur envoie un message.
 traiter_action("put_message", JSON, _) ->
    euphorik_protocole:put_message(JSON);
-% un ekMaster bannie un utilisateur (ip)
+% Un ekMaster bannie un utilisateur (ip).
 traiter_action("ban", JSON, _) ->
    euphorik_protocole:ban(JSON);
-% un ekMaster slap un utilisateur
+% Un ekMaster slap un utilisateur.
 traiter_action("slap", JSON, _) ->
    euphorik_protocole:slap(JSON);
-% un ekMaster envoie un nouveau troll
+% Un ekMaster envoie un nouveau troll.
 traiter_action("put_troll", JSON, _) ->
    euphorik_protocole:put_troll(JSON);
-% un ekMaster modifie un troll
+% Un ekMaster modifie un troll.
 traiter_action("mod_troll", JSON, _) ->
    euphorik_protocole:mod_troll(JSON);
-% un ekMaster supprime un troll
+% Un ekMaster supprime un troll.
 traiter_action("del_troll", JSON, _) ->
    euphorik_protocole:del_troll(JSON);
-% un ekMaster demande la liste des ips bannies
+% Un ekMaster demande la liste des ips bannies.
 traiter_action("list_banned_ips", JSON, _) ->
    euphorik_protocole:list_banned_ips(JSON);
-% un ekMaster débannie une ip
+% Un ekMaster débannie une ip.
 traiter_action("unban", JSON, _) ->
    euphorik_protocole:unban_ip(JSON).
  
\ No newline at end of file