Author: jcouteau Date: 2010-05-05 10:50:11 +0200 (Wed, 05 May 2010) New Revision: 1874 Url: http://nuiton.org/repositories/revision/jaxx/1874 Log: Add doc about scripting Added: trunk/src/site/rst/scripting.rst Modified: trunk/src/site/site_fr.xml Added: trunk/src/site/rst/scripting.rst =================================================================== --- trunk/src/site/rst/scripting.rst (rev 0) +++ trunk/src/site/rst/scripting.rst 2010-05-05 08:50:11 UTC (rev 1874) @@ -0,0 +1,79 @@ +=============================================== +Utiliser des scripts pour améliorer l'ordinaire +=============================================== + +Dans JAXX, le scripting c'est la capacité d'embarquer du code Java directement +dans les fichiers JAXX. Et contrairement à ce qu'on entends par script, le code +n'est pas interprété à l'exécution, mais compilé afin de ne pas souffrir d'un +défaut de performances. + +Dans JAXX, les scripts peuvent apparaitre à plein d'endroits : + + * dans des balise script + * dans le data binding + * dans les gestionnaires d'évènements + * dans l'attribut constraints + * dans les paramètres des constructeurs + +Les balises script +------------------ + +Du code Java peut être embarqué n'importe où dans les fichiers JAXX en utilisant +les balises <script>. Les balises script peuvent définir des méthodes, des +champs, des constructeurs, et peuvent aussi exécuter directement du code Java. + +Exemple:: + + <script><![CDATA[ + import javax.swing.table.JTableHeader; + + public SearchHandler getSearchHandler() { + return getContextValue(SearchHandler.class); + } + ]]> + </script> + +Le data-binding +--------------- + +Le code Java peut être placé en valeur d'attributs XML quand il est échappé par +des accolades ({ }). La valeur de l'attribut est ensuite calculée en utilisant +le code Java, et recalculée quand ses dépendances (s'il y en a) changent. Cette +utilisation des script est appelée data-binding_ + +.. _data-binding::dataBinding.html + +Exemple:: + + <JPanel layout='{new BorderLayout()}'> + +Gestionnaires d'évènements +-------------------------- + +Dans les balises de classes, les attributs dont le nom commence par 'on' suivi +d'une majuscule (e.g. onMousePressed, onActionPerformed) sont des gestionnaires +d'évènement. La valeur de l'attribut est du code Java qui est exécuté lorsque +l'évènement est lancé. + +Exemple:: + + <JButton onActionPerformed='myAction()'/> + +Attribut constraints +-------------------- + +Sur les composants, l'attribut constraints spécifie les contraintes du layout +(e.g. BorderLayout.NORTH, GridBagConstraints) qui devraient être utilisées +lorsque le composant est ajouté dans son conteneur parent. La valeur de cet +attribut est du code Java qui est évalué à la création du composant. + +Exemple:: + + <JButton constraints='BorderLayout.SOUTH'/> + +Paramètres des constructeurs +---------------------------- + +Dans les balises de classe, l'attribut constructorParams spécifie les +paramètres, séparés par des virgules, du constructeur de l'objet. Ces paramètres +sont interprétés comme du code Java. Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2010-05-04 19:48:38 UTC (rev 1873) +++ trunk/src/site/site_fr.xml 2010-05-05 08:50:11 UTC (rev 1874) @@ -55,6 +55,7 @@ <item name="Utiliser les objets Swing" href="useSwingObjects.html"/> <item name="Utiliser des styles" href="useStylesheets.html"/> <item name="Le data-binding" href="dataBinding.html"/> + <item name="Les scripts JAXX" href="scripting.html"/> </item> <item name="Migration JAXX 2.0" href="migration.html"/> </menu>