Instructions pour développer des composants Java
Le meilleur moyen de développer des composants pour la palette de BeanMachine est de suivre la spécification JavaBeans de Sun Microsystems. Pour plus d'informations sur JavaBeans, visitez le site www.javasoft.com. Dans cette section, vous trouverez un certain nombre d'informations d'ordre technique concernant la structure et le style spécifiques au code Java.
D'abord, vous devez avoir un constructeur public qui ne comporte aucun paramètre, de manière à pouvoir insérer automatiquement le composant dans l'Editeur de liens. La classe doit être déclarée publique.
L'Assistant BeanMachine lit votre classe Java ou applet Java et recherche les propriétés présentant une correspondance avec les méthodes Get et Set. Si vous avez une propriété nommée myVar qui correspond à un entier, les méthodes Get et Set doivent respecter la syntaxe suivante :
int getMyVar()
void setMyVar(int)
Le propriétés marquées dans l'Assistant BeanMachine seront affichées dans la fenêtre Détails de l'onglet Propriétés et de l'onglet Connexions. Nous vous recommandons de définir vos méthodes Get et Set car si un utilisateur définit des propriétés dans la fenêtre Détails, l'ordre importera peu.
L'assistant permet également de définir les méthodes à faire figurer dans la liste des actions de l'onglet Connexions. Les méthodes sélectionnées pour les actions ne doivent pas comporter de paramètres, et doivent fonctionner de manière autonome sans attendre la création de plusieurs connexions ou la définition de plusieurs propriétés. A titre d'exemple, si vous développez un composant audio, vous voulez que l'action de diffusion gère toutes les étapes, de l'ouverture du fichier audio en passant par toutes les configurations nécessaires, jusqu'à la diffusion de la séquence. Pareillement, l'action démarrer doit fonctionner même si la séquence sonore n'est pas en cours de diffusion.
L'Editeur de liens constitue un outil d'édition intégré pour tous les composants. Pour activer l'édition directe de votre composant, il suffit de vérifier si la propriété définie par défaut est de type String. Par défaut, l'Editeur de liens utilise une zone de texte pour éditer directement votre propriété string par défaut. Pour définir votre propriété sur plusieurs lignes, indiquez dans l'Assistant BeanMachine la classe d'éditeur de propriété personnalisé "ibm.appauthor.IBMMLEStringEditor". L'Editeur de liens utilisera alors une zone de texte pour la saisie directe.
Il est également très important que le fonctionnement de vos composants se déroule correctement pendant l'exécution au cours de laquelle les propriétés sont susceptibles de changer à tout moment en raison des connexions. Si le changement d'une propriété modifie l'aspect visuel de votre composant, vous devez appeler
repaint();
dans la méthode Set de la propriété. Pareillement, si le changement d'une propriété modifie la taille et la position de vos composants, vous devez vous assurer de la validité des différents éléments. Nous vous recommandons d'écrire votre propre méthode
validateAll()
pour votre composant et de l'appeler dans les méthodes Set appropriées. Le source Blinking Text propose un exemple de méthode
validateAll()
que vous pouvez couper-coller dans la classe de votre propre composant.