Ανάπτυξη Plugins για το AgentSheets

Ανάπτυξη Plugins για το AgentSheets Thought Amplifier AgentSheets

Ανάπτυξη Plugins AgentSheets 2.5 Συγγραφείς Τεκµηρίωσης: Alexander Repenning και Ronald Sudomo Εξελληνισµός Τεκµηρίωσης: Λίνος Βίγκλας, Χαράλαµπος Σπυρόπουλος, και Άντρη Ιωαννίδου 1. ΦΙΛΟΣΟΦΊΑ... 1 2. ΑΝΑΠΤΎΣΣΟΝΤΑΣ PLUGINS... 1 2.1. ΟΡΙΣΜΌΣ ΔΡΆΣΕΩΝ... 2 2.2. ΟΡΙΣΜΌΣ ΣΥΝΘΗΚΏΝ... 3 3. ΜΕΤΑΓΛΏΤΤΙΣΗ PLUGINS... 4 4. ΧΡΉΣΗ ΤΩΝ PLUGINS... 4 5. ΕΞΑΡΤΉΣΕΙΣ ΒΙΒΛΙΟΘΉΚΗΣ... 5 6. PLUGIN ΔΙΑΛΌΓΟΥ: ΈΝΑ ΟΛΟΚΛΗΡΩΜΈΝΟ ΠΑΡΆΔΕΙΓΜΑ... 6 6.1 ΚΏΔΙΚΑΣ PLUGIN... 8

1. Φιλοσοφία Ο κύριος στόχος της αρχιτεκτονικής των plugins είναι η απλότητα στη χρήση. Ακόµα και η πιο περίτεχνη αρχιτεκτονική έχει µικρή αξία αν τελικά είναι πολύ λίγοι αυτοί που µπορούν να την αξιοποιήσουν λόγω της υπερβολικής της συνθετότητας. Τα plugins πρέπει να είναι απλά τόσο στη δηµιουργία τους όσο και στη διάθεσή τους. Τα plugins στην αρχιτεκτονική του AgentSheets απαιτούν µόνο τις άκρως απαραίτητες πληροφορίες στον κώδικα σε αντίθεση µε άλλα περιβάλλοντα που απαιτούν τη χρήση κάποιου Advanced Programming Interface (API) που περιέχει σύνθετες κλάσεις, ιεραρχίες και τρόπους επικοινωνίας. Με άλλα λόγια η αρχιτεκτονική στο AgentSheets προσαρµόζεται στον χρήστη που αναπτύσσει και δεν τον οδηγεί σε δρόµους που δεν έχουν άµεση σχέση µε το πρόβληµα που προσπαθεί να επιλύσει. Το AgentSheets χρησιµοποιώντας µηχανισµούς αυτοανάλυσης και αυτοελέγχου αναλύει τα plugins που αναπτύσσονται από τον χρήστη και δηµιουργεί τελικά κώδικα µε τις αντίστοιχες εντολές της Visual AgenTalk (VAT). 2. Αναπτύσσοντας Plugins Για την ανάπτυξη ενός Plugin πρέπει να γράψετε κώδικα σε Java και να χρησιµοποιήσετε τον µεταγλωττιστή Java. Το αρχείο του πηγαίου κώδικα που αναπτύσσεται για το Plugin ορίζει µια κλάση Java όπως οποιοδήποτε αρχείο Java. Ο διαχειριστής Plugins του AgentSheets είναι ικανός να αναγνωρίσει οποιοδήποτε µεταγλωττισµένο Java αρχείο (class αρχείο) ως Plugin εάν ισχύουν τα ακόλουθα: Το Plugin αρχείο βρίσκεται µέσα στο φάκελο Plugins. Ο ορισµός της κλάσης είναι καθολικός (public). Ο ορισµός της κλάσης µπορεί να περιέχει οποιοδήποτε αριθµό µεθόδων που θέλετε να ορίσετε. Για τη δηµιουργία νέων εντολών VAT οι µέθοδοι πρέπει να περιέχουν µια προκαθορισµένη δοµή. Το AgentSheets αναλύει τα plugins και ελέγχει αυτές τις δοµές. Εάν βρει τις σωστές δοµές τότε: Δηµιουργεί µια νέα VAT εντολή συµπεριλαµβανοµένης και της γραφικής της aπεικόνισης για την τελική της χρήση. Αυτή η εντολή πλέον µπορεί να χρησιµοποιηθεί σε οποιοδήποτε Έργο, όπως οποιαδήποτε άλλη εντολή µε ένα απλό 1

σύρσιµο της από τη Συλλογή Δράσεων και Συνθηκών στον Επεξεργαστή Συµπεριφοράς οποιουδήποτε πράκτορα. Επεκτείνει το µεταγλωττιστή της γλώσσας VAT, έτσι οι νέες Δράσεις και Συνθήκες µπορούν να χρησιµοποιηθούν από οποιοδήποτε Πράκτορα. 2.1. Ορισµός Δράσεων Η Δράση πρέπει να ακολουθεί την δοµή. public static void commandname_action (parameters). commandname είναι το όνοµα της δράσης όπως αυτό θα εµφανίζεται στη συλλογή δράσεων. parameters: Η µέθοδος µπορεί να έχει από καµία έως πολλές παραµέτρους των τύπων int, float ή string. Οι τύποι int και float αντιστοιχίζονται µε τον τύπο Αριθµητική Παράσταση της γλώσσας VAT. Ο τύπος Αριθµητική Παράσταση εµφανίζεται ως πεδίο κειµένου που µπορεί να περιέχει οποιαδήποτε VAT παράσταση. Όταν το AgentSheets εκτελεί τη νέα εντολή που περιέχει τον τύπο Αριθµητική Παράσταση πρώτα υπολογίζει την παράσταση και µετά καλεί τη µέθοδο µε την τιµή που έχει δώσει ως αποτέλεσµα η υπολογισµένη παράσταση. Για παράδειγµα εάν η Δράση περιέχει τον τύπο radius * 2 * pi, θα υπολογίσει αρχικά την τιµή της παράστασης πολλαπλασιάζοντας την ιδιότητα radius µε το 2 και την σταθερά pi δίνοντας στο αποτέλεσµα τον τύπο float ή integer και µετά θα µεταφέρει το αποτέλεσµα στην Java µέθοδο. Κάθε παράµετρος τύπου String αντιστοιχίζεται στον τύπο Ακολουθία Χαρακτήρων του AgentSheets. 2

Παράδειγµα: Public static void Show-Message-Action (String message) Αυτή η µέθοδος ορίζει µια Δράση µε το όνοµα Show Message. Περιέχει µια παράµετρο τύπου String που αντιστοιχίζεται στον τύπο Ακολουθία Χαρακτήρων του AgentSheets. Η νέα Δράση προστίθεται στη συλλογή Δράσεων κάτω από την κατηγορία «επεκτάσεις χρήστη». 2.2. Ορισµός συνθηκών Οι Συνθήκες σε αντίθεση µε τις Δράσεις πρέπει να επιστρέφουν µια τιµή τύπου boolean δίνοντας ως αποτέλεσµα της Συνθήκης, Αληθής ή Ψευδής. Η Συνθήκη πρέπει να ακολουθεί την δοµή. public static boolean commandname-condition (parameters). commandname είναι το όνοµα της Συνθήκης που θα εµφανίζεται στην συλλογή συνθηκών. parameters: Η Μέθοδος µπορεί να έχει από καµία έως πολλές παραµέτρους των τύπων int, float ή string. Οι τύποι int και float αντιστοιχίζονται µε τον τύπο Αριθµητική Παράσταση της γλώσσας VAT. Ο τύπος Αριθµητική Παράσταση εµφανίζεται ως πεδίο κειµένου που µπορεί να περιέχει οποιαδήποτε VAT παράσταση. Όπως και µε τις δράσεις, όταν το AgentSheets εκτελεί τη νέα εντολή που περιέχει τον τύπο Αριθµητική Παράσταση πρώτα υπολογίζει την παράσταση και µετά καλεί τη µέθοδο µε την τιµή που έχει δώσει ως αποτέλεσµα η υπολογισµένη παράσταση. Κάθε παράµετρος τύπου String αντιστοιχίζεται στον τύπο Ακολουθία χαρακτήρων του AgentSheets. 3

Παράδειγµα: Public static boolean User-Confirm-Condition (String question). Η µέθοδος αυτή ορίζει την Συνθήκη µε το όνοµα User Confirm. Η Συνθήκη αυτή προστίθεται στη συλλογή συνθηκών και έχει µία παράµετρο τύπου String η οποία αντιστοιχίζεται στον τύπο Ακολουθία Χαρακτήρων του AgentSheets. 3. Μεταγλώττιση Plugins Αφού γραφτεί ο κώδικας µπορεί να µεταγλωττιστεί όπως κάθε άλλο πρόγραµµα σε Java. Το plugin µπορεί να γραφτεί ακόµα και σε C/C++, σε µια τέτοια περίπτωση όµως θα πρέπει να υποστηριχθεί από ένα Java wrapper. Η έκδοση της Java που θα χρησιµοποιηθεί για την µεταγλώττιση πρέπει να είναι η ίδια που χρησιµοποιείται αυτή τη στιγµή για το AgentSheets, που είναι η Java 1.4.2. 4. Χρήση των Plugins Για να χρησιµοποιηθούν τα plugins πρέπει να τοποθετηθούν τα δυαδικά αρχεία των plugins (δηλαδή τα αρχεία µε κατάληξη.class και όχι τα πηγαία αρχεία) στο φάκελο Plugins της εφαρµογής. Όταν φορτώσουµε το AgentSheets αυτόµατα ψάχνει στο φάκελο Plugins και ενσωµατώνει τις νέες Δράσεις και Συνθήκες στις αντίστοιχες συλλογές. Από αυτό το σηµείο και µετά οι Δράσεις και οι Συνθήκες µπορούν να χρησιµοποιηθούν για την ανάπτυξη οποιουδήποτε Έργου. Όταν µετατρέπετε ένα Έργο σε applet µε το Ristretto, τότε το Ristretto αυτόµατα αντιγράφει τα απαραίτητα για το applet plugins. Επίσης, όταν διανέµετε κάποιο Έργο πρέπει να ελεγχθεί 4

αν υπάρχουν πάντα και τα κατάλληλα plugins που χρησιµοποιεί, διαφορετικά όταν φορτώνεται το Έργο θα προκαλέσει Java σφάλµα. 5. Εξαρτήσεις Βιβλιοθήκης Οι προσοµοιώσεις που φτιάχνονται µε το AgentSheets µπορούν να τρέξουν σε φυλλοµετρητές σε οποιοδήποτε λειτουργικό σύστηµα (Windows, MacOS και UNIX) εάν υποστηρίζει τουλάχιστον τη Java 1.1. Το πρόγραµµα εκτέλεσης της προσοµοίωσης ονοµάζεται µagentsheets και βασίζεται στο πλαίσιο AWT που είναι τµήµα της Java 1.1. Προβλήµατα µπορεί να προκύψουν εάν τα plugins χρησιµοποιούν επιπρόσθετες βιβλιοθήκες. Εάν αυτές οι βιβλιοθήκες δεν υπάρχουν στον υπολογιστή «πελάτη» τότε η εκτέλεση της προσοµοίωσης θα αποτύχει. Ο µηχανισµός Ristretto αντιγράφει τα απαραίτητα plugins αλλά δεν είναι δυνατόν να ανιχνεύσει εξαρτήσεις από άλλες βιβλιοθήκες. Ένα απλό παράδειγµα αυτού του προβλήµατος είναι η ανάπτυξη plugins τα οποία βασίζονται στο πλαίσιο Swing. Οι χρήστες που χρησιµοποιούν το Έργο θα πρέπει να έχουν εγκατεστηµένο το Swing. Είναι δύσκολο γενικά να προβλεφθεί ποιες βιβλιοθήκες µπορεί να έχουν οι τελικοί χρήστες, κάτι που εξαρτάται από το φυλλοµετρητή τους και το λειτουργικό τους σύστηµα. Για παράδειγµα στον Internet Explorer 5 του λειτουργικού MacOS η Java είναι ενεργοποιηµένη αλλά δεν συµπεριλαµβάνει το Swing. Στα Windows XP η προκαθορισµένη εγκατάσταση δεν περιέχει καθόλου τη Java. Έτσι, δυστυχώς, υπάρχει η περίπτωση η απουσία µιας βιβλιοθήκης να εµποδίσει την εκτέλεση της προσοµοίωσης και µε ένα γενικού τύπου µήνυµα της Java, να απογοητεύσει τον χρήστη χωρίς να τον πληροφορήσει για το πρόβληµα, µε αποτέλεσµα να µη ξαναπροσπαθήσει να χρησιµοποιήσει τα applets που δηµιούργησε. Δυστυχώς, πολύ λίγα µπορούν να γίνουν για την αποφυγή τέτοιων περιπτώσεων. Ωστόσο µια καλή τακτική είναι να ξοδέψουµε λίγο παραπάνω χρόνο γράφοντας πιο σύνθετο κώδικα που βασίζεται στις συναρτήσεις του πλαισίου AWT αντί να χρησιµοποιούµε έτοιµες τύπου Swing ή Java 2D. 5

6. Plugin Διαλόγου: Ένα ολοκληρωµένο παράδειγµα Τα δύο παραδείγµατα κώδικα για µια Συνθήκη και µια Δράση είναι τµήµα ενός πλήρους παραδείγµατος (ο κώδικας ακολουθεί στην επόµενη παράγραφο) επέκτασης των δυνατοτήτων του AgentSheets στο τοµέα του διαλόγου µε τον χρήστη. Η Δράση Show Message σταµατάει την εκτέλεση της προσοµοίωσης και εµφανίζει ένα modal παράθυρο διαλόγου µε ένα µήνυµα, περιµένοντας τον χρήστη να πατήσει το OK. Διαλέγοντας τη Δράση από τη Συλλογή και πατώντας το πλήκτρο Δοκιµή µπορείτε να την δοκιµάσετε. Η Συνθήκη User Confirm επιτρέπει στον χρήστη να ελέγξει τη προσοµοίωση µέσα από την απάντηση ΝΑΙ/ΟΧΙ. Μπορείτε να δοκιµάσετε αυτή τη νέα Συνθήκη διαλέγοντας την από τη συλλογή συνθηκών και πατώντας το πλήκτρο Δοκιµή. 6

Ακολουθεί ο πλήρης κώδικας για τις δύο νέες εντολές. 7

6.1 Κώδικας Plugin 8