Publication d'applications AJAX - 1re partie

Il s'agit ici de faire appel à une méthode projet 4D en utilisant l'URL spécifique /4DACTION/nom de la méthode.


Prototype de fonction permettant d'exécuter une requête :

function Call4D(method4D)
{
    var req = HTTPRequestObject ();
    if (req)
    {
        req.open("GET", '/4daction/'+method4D+'/'+Math.random(), false);
        req.onreadystatechange=function()
        {
            if (req.readyState==4)
            {
                if(req.status!=200)
                {
                    req =false;
                }
            }
        }
        req.send("");
    }
    return req;
}

Après traitement, la méthode retourne la réponse en utilisant les commandes ENVOYER TEXTE HTML, ENVOYER BLOB HTML ou ENVOYER FICHIER HTML. Cette information est alors disponible via les propriétés responseText ou responseXML de l'objet XMLHttpRequest appelant.


Prototype de la méthode NombreEnregistrements retournant le nombre d'enregistrements d'une table :

   $nb := chaine(Enregistrements dans table([inscriptions]))ENVOYER TEXTE HTML($nb)

Exemple d'utilisation depuis JavaScript :

var resultat = Call4D('NombreEnregistrements' )
Alert(resultat.responseText+' enregistrements')

Il s'agit ici d'envoyer des données à une méthode projet 4D en utilisant le mécanisme standard des formulaires Web (POST).


Prototype de fonction envoyant des données à une méthode 4D :

function Post4D(method4D, valeurs)
{
    var req = HTTPRequestObject ();
    if (req)
    {
        req.setRequestHeader('Content-Type','application/xwww-form-urlencoded');
        req.open("POST",'/4daction/'+method4D+'/'+Math.random() ,false);
        req.onreadystatechange = function()
        {
            if (req.readyState==4)
            {
                if(req.status!=200)
                {
                    req = false;
                }
            }
        }
        req.send(valeurs);
    }
    return req;
}

Exemple d'utilisation depuis JavaScript :

var Req = Post4D('SearchUser', 'WebNom=czwiklinski&WebPrenom=gérald')

Lors de l'appel, 4e Dimension analyse les champs HTML de la requête, récupère leurs valeurs et remplit automatiquement des variables 4D avec leur contenu.


Prototype de la méthode SearchUser retournant l'ID d'un client dont le nom et prénom est passé en paramètre :

C_BLOB($rep)Chercher([Clients] ;[Clients]Nom=WebNom ;*)Chercher([Clients] ;& [Clients]Prenom=WebPrenom)
   $ID := chaine(numero enregistrement[Clients])TEXTE VERS BLOB($ID;$rep;Texte sans longueur )ENVOYER blob HTML($rep;"text/plain")

Afin de garantir une exécution systématique par le serveur des requêtes http, on prendra soin de désactiver la mise en cache assuré par les navigateurs ou les proxys en précisant dans l'entête HTTP.

TABLEAU TEXTE($field;2)
Tableau TEXTE($value;2)
$$field {1}:="Cache-Control"
$value {1}:="private, must-revalidate, max-age=0"
$$field {2}:="Expires"
$value {2}:="-1"
FIXER ENTETE HTTP($field;$value)

Une solution alternative (voire complémentaire) est d'ajouter une information aléatoire dans l'URL d'appel favorisant ainsi son unicité.

req.open("GET",url+'/'+Math.random() ,false);

Les exemples proposés précédemment reposent sur un mode synchrone. C'est-à-dire que le traitement est interrompu tant que le résultat de la requête n'est pas encore reçu.

Pour certains traitements ou pour offrir plus de confort à l'utilisateur, il est possible de continuer sans attendre la réponse du serveur.


Ce mode s'active grâce au troisième paramètre de la méthode open de l'objet XMLHttpRequest :

req.open("GET", url ,true);

Prototype de fonction permettant d'exécuter une requête en mode asynchrone :

var req = HTTPRequestObject ();

function Call4D(method4D)
{
    if (req)
    {
        req.open("GET", '/4daction/'+method4D+'/'+Math.random(), true);
        req.onreadystatechange = callback();
        req.send("");
    }
    return req;
}

function CallBack()
{
    if (req.readyState==4) && (req.status!=200)
    {
        // Traitement du résultat
    }
}

Le langage de 4e Dimension est doté d'un jeu de commandes permettant la création de documents XML selon les deux méthodologies :

· DOM (Document Object Model) permet la construction et manipulation de l'arbre XML en mémoire avant sa mise à disposition ;

· SAX (Simple API XML) permet l'écriture directe et séquentiel permettant notamment la gestion de fichiers volumineux.


Prototype de méthode générant une réponse XML :

$refID:=DOM Creer ref XML("Reponse4D")
$client:=DOM Creer element XML($refID;"Client";"ID";"1")
$ID:=DOM Creer element XML($client;"Nom")
DOM ECRIRE VALEUR ELEMENT XML($;"Czwiklinski")
$ID:=DOM Creer element XML($client;"Prenom")
DOM ECRIRE VALEUR ELEMENT XML($ID;"Gerald")
DOM EXPORTER VERS VARIABLE($refID;Reponse)
DOM FERMER XML($refID)
ENVOYER BLOB HTML(Reponse;"text/xml")

4e Dimension dispose en standard d'un traducteur XSLT permettant la transformation à la volée de documents XML.

Le serveur Web interne de 4e Dimension permet de diffuser des documents XML dynamiquement alimentés par les données de la base de données.

Le lien entre le document externe et les données se fait simplement en encapsulant des références sous forme de commentaires HTML ce système assurant ainsi une compatibilité parfaite.


Exemple de document XML dynamique :

<?xml version="1.0" encoding="UTF-8" ?>
<CLIENT ID= < !--4DVAR [Clients]ID-->>
<NOM>< !--4DVAR [Clients]Nom--></NOM>
<PRENOM>< !--4DVAR [Clients]Prenom--></PRENOM>
</CLIENT>

Il est possible de gérer des droits utilisateurs à travers le mécanisme standard d'authentification HTTP permettant le transport du couple utilisateur/mot de passe.

La méthode basée sur Authentification Web s'effectuera avant tous autres traitements, permettant d'effectuer un ensemble de contrôles afin d'autoriser ou non l'exécution de la requête.

Les échanges HTTP entre le client et le serveur peuvent être sécurisés en utilisant la sécurisation SSL (Socket Secure Layer) intégrée au serveur Web de 4e Dimension. Les requêtes et leurs contenus sont alors, cryptés.

L'intégration fine de toutes les composantes nécessaires à la publication d'une application WEB 2.0 (serveur Web, langage, protocoles et base de données) au sein d'un même environnement de développement offre de nombreux avantages en matière de sécurité.


Les conséquences d'une intrusion en utilisant le serveur Web comme porte d'entrée est réduit au minimum, car :

· 4e Dimension est indépendant vis-à-vis du système : il est alors impossible de lancer des traitements illicites sur la machine (.BAT ou Apple Script) ;

· la base de données n'est pas accessible en direct par SQL : il est alors, impossible d'accéder aux données ;

· par défaut toutes les méthodes sont inaccessibles de l'extérieur : seules les méthodes explicitement citées comme étant publiées seront exécutables par une requête HTTP.