From Ape Wiki

[edit] Introduction à APE

Ce tutoriel explique comment fonctionne APE et ce que vous avez besoin de savoir avant de commencer à lire d'autres tutoriels.

[edit] Qu'est-ce qu'APE?

APE, Ajax Push Engine (Moteur de Push Ajax), est une solution Open-Souce riche en fonctionnalités destinée au Push Ajax. Elle inclut un serveur et un framework Javascript. APE permet d'implémenter toute sorte de streaming de données en temps réel vers un navigateur web sans avoir à installer quoique ce soit côté client.

APE est composé d'un serveur (serveur APE) et d'un client (le Framework Javascript APE)

[edit] Comment le serveur APE et le client APE échangent des données?

Le serveur APE et le APE JSF communiquent avec raw (données brutes) et command.

• Quand le serveur envoie des données à un client, c'est raw.
• Quand le cllient envoie des données au serveur, c'est command.

Les Raws and Commands sont des objets JSON. Chaque raw et command est identifié par un nom et contient un objet avec les données que vous envoyez ou que vous recevez. Consultez la page Protocol pour davantage d'information.

[edit] Système de Communication

Dans APE, les données entre les utilisateurs sont échangées via un pipe (tuyau). Un Pipe est un conduit de communication pour échanger des données de différentes manières.

• Multi Pipe ou Channel : Un Channel (canal) vous permet d'émettre des données vers un groupe d'utilisateurs (broadcast). Quand vous rejoignez un canal, le serveur vous envoie des informations sur le canal et sur la liste d'utilisateurs connectés à lui. Quand vous envoyez un message à un canal, ce message est envoyé à tous les utilisateurs connectés à lui.
• Uni Pipe ou User : Chaque client connecté est un utilisateur. Vous pouvez échanger des données d'un utilisateur vers un autre.

Exemple concret : Démo Chat APE. Quand la démo démarre, vous pouvez discuter avec tous les utilisateurs via un Multi Pipe (multi-tuyau). Si vous cliquez sur un utilisateur dans la liste, vous échangerez des données via un Uni Pipe (mono-tuyau).

Les Pipes (tuyaux) vous permettent bien d'autres choses :

• Paramétrer les propriétés d'un Pipe (canal ou utilisateur)
• Pipe non interactif
• Proxy Pipe (vous permet de vous connecter à un client via un IP:Port)
• ...

Lisez le tutoriel Comprendre les pipes pour davantage d'informations.