Documentation |   
L'interface de classe personnalisée Java
Arachnophilia est © Copyright 2015, P. Lutus.

Arachnophilia est CareWare

À l'aide de macros système, Arachnophilia peut s'interfacer avec des classes Java externes écrites par l'utilisateur ou fournies par des tiers. Cela signifie essentiellement que n’importe quelle fonction imaginable peut être ajoutée à Arachnophilia.

Voici comment procéder :

C'est l'idée générale, et la plupart des programmeurs n'auront aucun problème. Mais, juste à titre d'exemple, nous invoquerons un exemple de classe Java incluse avec Arachnophilia.

Voici une liste de la classe de test (copiez le bloc ci-dessous pour créer votre propre contenu) : 


/*
* Créé le 26 octobre 2009 à 12:06:55
*/

/* TestClass est destiné à démontrer l'utilisation
* de la fonctionnalité de lancement de classe personnalisée d'Arachnophilia.
* Compilez simplement cette classe sur place, créez
*une macro qui ressemble à ceci :
* "[RunCustomClassDoc:CustomClasses/TestClass]",
* chargez un document adapté et activez la macro.
*/

package CustomClasses ;

import java.util.*;

public class TestClass {

// il s'agit d'une méthode de recherche et de remplacement globale générique et minimale

private String searchReplace(String data,String find,String replace)
{
StringBuffer sb = new StringBuffer();
int a = 0,b;
int findLength = find.length();
while((b = data.indexOf(find,a)) != -1) {
sb.append(data.substring(a,b));
sb.append(replace);
a = b + findLength ;
}
if(a < data.length()) {
sb.append(data.substring(a));
}
return sb.toString();
}

// c'est la méthode par défaut utilisée par les classes personnalisées
 // doit travailler avec la classe d'Arachnophilia
 // fonctionnalité de lancement sauf si un nom de méthode spécifique
 // est fourni

public String processString(String s)
{
String result = "Bonjour ! Ceci est un exemple d'interface de classe personnalisée Java !

"
 + "Vous avez envoyé ceci :
"
 + "\"" + s + "\"
"
 + "Ici, tout est en majuscule :
"
 + "\"" + s.toUpperCase() + "\"
"
 + "Ici, tout est en minuscules :
"
 + "\"" + s.toLowerCase() + "\"
"
 + "Le voici avec un changement global :
"
 + "\"" + searchReplace(s,"a","(A)") + "\"
";
return result ;
}

// c'est une autre méthode pour montrer la possibilité de choisir
 // n'importe quelle méthode par nom

public String reallyBoringMethod(String s)
{
return "Le " + new Date() + ", vous avez invoqué cette méthode Java vraiment ennuyeuse.";
}
}

Cette classe de test a déjà été créée et compilée et doit se trouver dans votre répertoire utilisateur sous un sous-répertoire nommé « CustomClasses ». Voyons si c'est le cas. :)

Ouvrez un nouveau document texte et saisissez-y quelque chose. Voici notre exemple de texte : 
Ceci est une phrase de test.
Trouvez maintenant l'élément de menu Programmation... Démo de classe personnalisée et cliquez dessus. La macro derrière cet élément de menu a ce contenu par défaut : 

[RunCustomClassDoc:CustomClasses/TestClass]
Cette macro signifie "Trouvez une classe Java dans un sous-répertoire du répertoire utilisateur d'Arachnophilia nommé "CustomClasses", recherchez-y une classe nommée "TestClass" et exécutez une méthode appelée "ProcessString" avec le contenu du document actuel comme argument. "

Voici le résultat de notre exemple de phrase : 

Bonjour! Ceci est un exemple d'interface de classe personnalisée Java !
Vous avez envoyé ceci :
"C'est une phrase test."
Ici, tout est en majuscules :
"CECI EST UNE PHRASE DE TEST."
Ici, tout est en minuscules :
"c'est une phrase test."
Le voici avec un changement global :
"C'est (A) la phrase de test(A)se."

Si la macro est invoquée comme ci-dessus, elle supposera l'existence d'une méthode publique appelée "ProcessString" et vous dira si elle ne la trouve pas. Si vous souhaitez utiliser un nom de méthode différent, indiquez simplement le nom, comme ceci :

[RunCustomClassDoc:CustomClasses/TestClass.reallyBoringMethod]

Il arrive qu'il existe une méthode portant ce nom dans notre classe de test, et si elle est invoquée, elle retournera (quelque chose qui ressemble à) : 

Le vendredi 8 mars 2002 à 21:58:27 PST, vous avez invoqué cette méthode Java vraiment ennuyeuse.

Les classes personnalisées créées par l'utilisateur peuvent se trouver n'importe où dans le ou les sous-répertoires Arachnophilia de l'utilisateur, et il peut y avoir n'importe quel nombre de méthodes avec n'importe quel nom dans les classes. Les seules exigences sont que l'identifiant du package soit le même que la liste ci-dessus ("CustomClasses") et que les méthodes soient publiques et reçoivent et renvoient une chaîne.

 

Documentation |