BeanShellEditor

Si BSHEDITOR est votre répertoire d'installation, vous devrez avoir :

+BSHEDITOR
   BeanShellEditor.bat (launcher for windows)
   +LIB
      bsheditor.jar
      beanshell.jar
      buoy.jar

Si BeanShellEditor.bat n'est pas présent dans votre distribution, vous devrez simplement créer un fichier contenant la ligne suivante :

java -cp "LIB/bsheditor.jar;beanshell.jar;buoy.jar"
         fr.michaelm.bsheditor.BeanShellEditor

ou

start java -cp "LIB/bsheditor.jar;beanshell.jar;buoy.jar"
      fr.michaelm.bsheditor.BeanShellEditor

si vous voulez cacher la console DOS après le lancement de la JVM.

Pour lancer l'application, double-cliquez sur BeanShellEditor.bat.

Sur une configuration Windows récente, vous devriez également pouvoir lancer BeanShellEditor en double-cliquant sur le fichier .jar de ce nom, après avoir placé les 3 fichiers jar (BeanShellEditor, BeanShell et Buoy) dans un même répertoire.

Les expériences d'utilisation de BeanShellEditor sous Linux, Mac ou autres sont les bienvenues.

Installer BeanShellEditor en tant que PlugIn d'une autre application est très simple :

Placez bsheditor.jar, beanshell.jar et buoy.jar dans votre classpath.

Créez un bouton ou un élément de menu dans votre application, qui crée une nouvelle instance de BeanShellEditor.

Vous devez utiliser le constructeur qui prend une table (Map) en paramètre. La table permettra de passer à l'éditeur un ou des noms de variables (les clés de la table) pointant sur des objets de votre application (les valeurs la table).

Par exemple, (méthode appelée par votre application pour créer une instance de BeanShellEditor.

public void createBeanShellEditor() {
   Map map = new HashMap();
   map.put("MyApplication", this); // MyApplication can be used
                                   // in your script editor to
                                   // access your application
   map.put("TA", textArea);        // TA can be used to access
                                   // the textArea attribute defined
                                   // in your MyApplication instance
   BeanShellEditor bsh = new BeanShellEditor(map);
}

Le menu fichier inclut :

Les options de BeanShellEditor incluent :

Aucune aide pour l'instant. La seule documentation est celle que vous êtes en train de lire.

Utilisez le bouton (RUN) pour exécuter le script courant (celui qui apparaît dans l'éditeur).

C'est un sélectionneur de fichier dont la racine est un répertoire défini dans le menu options (et sauvegardé dans le fichier BeanShellEditor.properties file. Ce n'est rien d'autre qu'un moyen d'accès facile à vos scripts favoris.

Ce panneau contient une liste des bibliothèques (fichiers jar) contenues dans le répertoire défini à cet effet grâce au menu options. Le nom de ce répertoire est également sauvegardé dans le fichier BeanShellEditor.properties.

Un click droit sur le nom d'une bibliothèque vous permet d'ajouter l'instruction addClassPath() qui convient à votre script (la ligne est insérée au niveau du curseur). Le menu contextuel vous propose également les packages contenus dans la bibliothèque et vous pouvez procéder à l'import des packages que vous voulez utiliser de la même façon.

Liste des variables et méthodes disponibles en ligne de commandes. Elle inclut les variables et méthodes définie dans l'application BeanShellEditor elle-même comme bsh et bshEditor ainsi que les variables et méthodes définies lors de l'exécution du dernier script. Elle n'inclut pas les commande propres à BeanShell comme la commande print() (pour ces méthodes, reportez vous à la documentation BeanShell).

Si vous cliquez sur un nom de variable ou de méthode, celle-ci sera automatiquement ajoutée à votre ligne de commande.

name = "Michaël";
dir = "D:/DATA/MYBOOKS/";

Une nouvelle méthode peut ressembler à cela :

dist(double x1, double y1, double x2, double y2) {
    dist = Math.sqrt((x2-x1)*(x2-x1)+(y2-y1)*(y2-y1));
    print("Distance from ("+x1+","+y1+") to ("+x2+","+y2+") = " + dist);
    return dist;
}

Vous pouvez utiliser cette méthode définie dans le script en y ajoutant la ligne :

dist(0,0,1,1);

et exécuter la ligne à l'aide du bouton RUN.

Vous pouvez également exécuter le script sans aucun appel à la méthode que vous venez de définir, et appeler celle-là à partir de la ligne de commandes.

Vous pouvez implémenter une interface comme dans l'exemple suivant :

panel = new JPanel();
frame(panel);
background = new Color(127*256*256);

panel.addMouseWheelListener(new MouseWheelListener(){
    public void mouseWheelMoved(MouseWheelEvent e) {
        background = new Color(background.getRGB() + e.getWheelRotation()*1000);
        panel.setBackground(background);
    }
});

Avec BeanShell, vous pouvez créer de nouvelles classes d'objets comme si vous étiez en pur java :

public class Country {
    String name;
    int population;
    String capital;
    public Country(String name, int population, String capital) {
        this.name = name;
        this.population = population;
        this.capital = capital;
    }
    public String toString() {
        return name + "\n\tpopulation : " + population + "\n\tcapiatl : " + capital;
    }
}
// Now you can call the class constructor...
print(new Country("France",60000000,"Paris").toString());