Εργαλεία αυξητικής δόμησης έργου
Ταυτότητα:
org.eclipse.core.resources.builders
Περιγραφή:
Ο χώρος εργασίας υποστηρίζει την έννοια ενός εργαλείου αυξητικής δόμησης έργου (ή "εργαλείο δόμησης" για συντομία). Εργασία ενός εργαλείου δόμησης είναι η επεξεργασία ενός συνόλου αλλαγών πόρου (παρέχονται ως τροποποιημένα στοιχεία πόρου). Για παράδειγμα, ένα εργαλείο δόμησης Java θα αναμεταγλωττίζει αρχεία Java στα οποία πραγματοποιήθηκαν αλλαγές και θα δημιουργεί νέα αρχεία κλάσης.
Η ρύθμιση των εργαλείων δόμησης πραγματοποιείται για κάθε έργο και εκτελείται αυτόματα όταν υπάρχουν αλλαγές στους πόρους του έργου. Έτσι, τα εργαλεία δόμησης θα πρέπει να είναι γρήγορα και να προσαρμόζονται ανάλογα με την ποσότητα των αλλαγών και όχι ανάλογα με το πλήθος των πόρων που περιέχονται στο έργο. Αυτό σημαίνει συνήθως ότι τα εργαλεία δόμησης έχουν τη δυνατότητα αυξητικής ενημέρωσης της "κατάστασης δόμησης" στην οποία βρίσκονται.
Το σημείο επέκτασης εργαλείων δόμησης επιτρέπει στους μεταγραφείς των εργαλείων αυτών να καταχωρούν την υλοποίηση του αντίστοιχου εργαλείου δόμησης χρησιμοποιώντας ένα συμβολικό όνομα, το οποίο στη συνέχεια χρησιμοποιείται από το χώρο εργασίας για την εύρεση και την εκτέλεση των εργαλείων δόμησης. Το συμβολικό όνομα είναι η ταυτότητα της επέκτασης του εργαλείου δόμησης. Κατά τον ορισμό μιας επέκτασης εργαλείου δόμησης, συνιστάται στους χρήστες να συμπεριλαμβάνουν μια αναγνώσιμη από τον άνθρωπο τιμή για το γνώρισμα "name", το οποίο προσδιορίζει το εργαλείο δόμησης και μπορεί να εμφανίζεται στους χρήστες.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (builder)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #REQUIRED
name CDATA #IMPLIED>
- point - μια πλήρως προσδιορισμένη ταυτότητα του σημείου επέκτασης προορισμού
- id - μια προαιρετική ταυτότητα για τη χρήση της επέκτασης
- name - ένα προαιρετικό όνομα για τη χρήση της επέκτασης
<!ELEMENT builder (run?)>>
<!ATTLIST builder
hasNature (true | false)
isConfigurable (true | false) >
- hasNature - "true" ή "false" υποδεικνύει εάν το εργαλείο δόμησης ανήκει σε συγκεκριμένη φύση έργου. Εάν έχει την τιμή "true" και δεν βρεθεί κάποια αντίστοιχη φύση, τότε αυτό το εργαλείο δόμησης δεν θα εκτελείται αλλά θα παραμένει στις προδιαγραφές δόμησης του έργου. Εάν το γνώρισμα αυτό δεν προσδιορίζεται, τότε θεωρείται ότι ισχύει η τιμή "false".
- isConfigurable - "true" ή "false" υποδεικνύει εάν το εργαλείο δόμησης επιτρέπει την προσαρμογή των ενεργειών με τις οποίες θα αποκρίνεται στην αυτόματη ενεργοποίηση δόμησης. Εάν έχει την τιμή "true", τότε οι πελάτες θα έχουν τη δυνατότητα να χρησιμοποιούν την ICommand.setBuilding API για να προσδιορίσουν εάν αυτό το εργαλείο δόμησης θα πρέπει να εκτελείται για μια συγκεκριμένη αυτόματη ενεργοποίηση δόμησης. Εάν το γνώρισμα αυτό δεν προσδιορίζεται, τότε θεωρείται ότι ισχύει η τιμή "false".
<!ELEMENT run (parameter*)>
<!ATTLIST run
class CDATA #REQUIRED>
- class - το πλήρες όνομα μιας υποκλάσης της
org.eclipse.core.resources.IncrementalProjectBuilder.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - το όνομα της παραμέτρου αυτής καθίσταται διαθέσιμο για τις χρήσεις της καθορισμένης κλάσης δόμησης
- value - μια αυθαίρετη τιμή που συσχετίζεται με το δεδομένο όνομα και καθίσταται διαθέσιμη για τις χρήσεις της καθορισμένης κλάσης δόμησης
Παραδείγματα:
Παρακάτω δίνεται ένα παράδειγμα ρυθμίσεων εργαλείου δόμησης:
<extension id=
"coolbuilder"
name=
"Cool Builder"
point=
"org.eclipse.core.resources.builders"
>
<builder hasNature=
"false"
>
<run class=
"com.xyz.builders.Cool"
>
<parameter name=
"optimize"
value=
"true"
/>
<parameter name=
"comment"
value=
"Produced by the Cool Builder"
/>
</run>
</builder>
</extension>
Εάν αυτή η επέκταση έχει οριστεί σε μια πρόσθετη λειτουργία με την ταυτότητα "com.xyz.coolplugin", το πλήρες όνομα του εργαλείου δόμησης θα είναι "com.xyz.coolplugin.coolbuilder".
Πληροφορίες API:
Η τιμή του γνωρίσματος class πρέπει να εκφράζει μια υποκλάση της
org.eclipse.core.resources.IncrementalProjectBuilder.
Παρεχόμενη υλοποίηση:
Η ίδια η πλατφόρμα δεν περιέχει προκαθορισμένα εργαλεία δόμησης. Οι εγκαταστάσεις συγκεκριμένων προϊόντων ενδέχεται να συμπεριλαμβάνουν τα απαραίτητα εργαλεία δόμησης.
Copyright (c) 2002, 2005 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση: http://www.eclipse.org/legal/epl-v10.html.