Fork me on GitHub

Fonctionnalités modifiées

Namespaces

Toutes les classes du package jaxon-core se trouvent désormais dans le namespace Jaxon. La classe principale est un singleton, donc l'unique instance est renvoyée par la fonction jaxon(). L'URI qui était passé au constructeur de la classe dans la version précédente doit désormais être définie avec l'option de configuration core.request.uri. Donc pour commencer une application Jaxon, on écrira ceci.

$jaxon = jaxon();
$jaxon->setOption('core.request.uri', $uri);

Constantes

Les constantes ont été renommées, et sont désormais toutes définies dans la classe principale Jaxon. Le nouveau nom des constantes est obtenu en remplaçant le préfixe XAJAX_ par le nom de la classe Jaxon::, comme dans l'exemple suivant.

$jaxon->register(Jaxon::CALLABLE_OBJECT, $myObject); // Nouveau code
$jaxon->register(XAJAX_CALLABLE_OBJECT, $myObject); // Ancien code

Les exceptions à cette règle sont les constantes XAJAX_FUNCTION qui devient Jaxon::USER_FUNCTION, et XAJAX_EVENT qui devient Jaxon::BROWSER_EVENT. La constante XAJAX_DEFAULT_CHAR_ENCODING n'existe plus; il faut utiliser l'option de configuration core.encoding à la place.

Génération du code Javascript

La fonction $jaxon->getJavascript() qui renvoie le code javascript généré par la librairie a été séparée en 3 fonctions distinctes:

  • La fonction $jaxon->getCss() renvoie le code qui inclut les fichiers CSS externes.
  • La fonction $jaxon->getJs() renvoie le code qui inclut les fichiers javascript externes.
  • La fonction $jaxon->getScript() renvoie le code javascript généré pour les classes et fonctions exportées.

Cette séparation existe parce que ces codes peuvent être insérés dans des endroits différents de la page HTML. Toutefois, en appelant la fonction $jaxon->getScript(true, true), on obtient la sortie cumulée des trois fonctions.

Les options de configuration

Les fonctions et les paramètres de configuration de la librairie Jaxon ont été renommés.
Pour mettre à jour une option, il faut appeler la fonction $jaxon->setOption($name, $value), et pour lire une valeur, il faut appeler la fonction $jaxon->getOption($name). Ces deux fonctions prennent en paramètre les nouveaux noms des options.

Les fonctions $jaxon->configure($name, $value) et $jaxon->getConfiguration($name) peuvent encore être utilisée avec les anciens noms des options, mais elles sont dépréciées dans la version 1 et sont supprimées dans la version 2.