Guide de référence de Lotus BeanMachine

Développement de votre propre code

Certaines situations exigent bien plus que les propriétés et les connexions de base fournies par BeanMachine. Si vous savez programmer en langage java, vous pouvez écrire votre code dans la fenêtre Java de BeanMachine.

Démarrez une nouvelle applet et ajoutez un composant Prompteur. Sélectionnez Java dans le menu déroulant Fenêtre. La fenêtre Java s'ouvre. La barre d'outils ancrée horizontalement dans la partie supérieure de la fenêtre sert à créer le code source Java. La liste déroulante appelée Autres méthodes affiche toutes les méthodes que vous avez développées jusqu'ici.

Vous allez développer une nouvelle méthode. Cliquez sur le bouton Nouvelle méthode pour insérer un modèle de méthode dans la fenêtre. Modifiez le texte qui s'affiche en surbrillance

newMethod

et choisissez un autre nom, comme par exemple

myMethod

A présent, amenez le curseur après la première accolade ( { ), puis cliquez sur le bouton Coller composant. Sélectionnez un composant de l'applet, comme Prompteur1, pour l'insérer dans votre méthode à l'emplacement du curseur. Comme Prompteur1 est sélectionné, cliquez sur le bouton Coller propriété, puis sélectionnez Set text. Cela permet d'insérer une expression Java pour définir la propriété du texte. Remplacez le texte mis en surbrillance par la chaîne de caractères de votre choix, puis cliquez sur le bouton Enregistrer sur la barre d'outils de la fenêtre de l'éditeur.

Maintenant, pour exécuter votre nouvelle méthode, vous devez créer une connexion. Toutes les méthodes développées dans la fenêtre Java figurent dans la liste des actions de l'applet. Sélectionnez le canevas de l'applet, et reliez l'événement démarré de l'Applet1 à l'action MyMethod de l'Applet1.

Vous pouvez choisir n'importe quel composant et événement pour créer la connexion. Testez votre applet et vérifiez si elle fonctionne correctement. Si vous avez commis des erreurs de syntaxe, elles s'afficheront dans la fenêtre Journal une fois que vous aurez cliqué sur le bouton Exécuter.

Jetons un coup d'oeil sur les exemples de script dans le répertoire des exemples (samples). D'abord, ouvrez le fichier parameters.app. Cet exemple vous explique comment écrire une méthode Java qui traite les paramètres transmis à partir de la balise HTML <applet>.

Ouvrez ensuite la fenêtre Java et analysez la méthode getHTMLParameters. Elle utilise des instructions Java plus évoluées et appelle getParameter pour obtenir des informations à partir des balises HTML. Vous pouvez configurer les valeurs par défaut à l'aide de la propriété des paramètres de l'applet, puis changer les fonctions de votre applet en modifiant uniquement votre fichier HTML au lieu de régénérer entièrement votre applet.

Si vous avez une bonne connaissance du langage Java, vous aurez remarqué que la fenêtre Java propose des fonctions avancées. La liste Autres méthodes offre trois entrées spéciales : importe, implémente et déclarations. L'option "importe" vous permet d'ajouter n'importe quel package Java spécial nécessaire à la compilation de votre méthode. L'option "implémente" vous permet de déclarer n'importe quelle interface à implémenter par votre applet. L'option "déclarations" vous permet d'ajouter vos propres variables d'instance à l'applet. Astuce : vous pouvez définir deux méthodes en une. Cette opération offre plus de souplesse dans les noms de paramètres et le type de retour de la méthode.