Επεξεργαστής ταχείας βοήθειας

Ταυτότητα:
org.eclipse.wst.jsdt.ui.quickAssistProcessors

Από την έκδοση:
3.0

Περιγραφή:
Αυτό το σημείο επέκτασης επιτρέπει την προσθήκη ενός επεξεργαστή ταχείας βοήθειας για την προσφορά νέων επιλογών ταχείας βοήθειας στη λειτουργίας επεξεργασίας JavaScript. Αυτό το σημείο επέκτασης υποστηρίζει το προσδιοριστικό enablement. Οι ιδιότητες προς δοκιμή είναι οι εξής:
  • compilationUnit: είδος ICompilationUnit; η μονάδα μεταγλώττισης στην οποία εφαρμόζεται η λειτουργία ταχείας βοήθειας
  • projectNatures: είδος Collection; όλες οι φύσεις έργου του τρέχοντος έργου
  • sourceLevel: είδος String; η συμβατότητα με τον πρωτογενή κώδικα του τρέχοντος έργου
  • Μορφοποίηση ρυθμίσεων:

    <!ELEMENT extension (quickAssistProcessor+)>

    <!ATTLIST extension

    point CDATA #REQUIRED

    id    CDATA #IMPLIED

    name  CDATA #IMPLIED

    >


    <!ELEMENT quickAssistProcessor (enablement?)>

    <!ATTLIST quickAssistProcessor

    id    CDATA #REQUIRED

    name                CDATA #IMPLIED

    class CDATA #IMPLIED

    requiredSourceLevel CDATA #IMPLIED

    >


    <!ELEMENT enablement (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    Γενικό κεντρικό στοιχείο. Το στοιχείο μπορεί να χρησιμοποιηθεί σε ένα σημείο επέκτασης για τον ορισμό της έκφρασης ενεργοποίησης. Τα θυγατρικά στοιχεία μιας έκφρασης enablement συνδυάζονται με τη χρήση του τελεστή "and".



    <!ELEMENT not (not | and | or | instanceof | test | systemTest | equals | count | with | resolve | adapt | iterate | reference)>

    Το στοιχείο αυτό εκφράζει ένα τελεστή ΝΟΤ στο αποτέλεσμα της αποτίμησης της έκφρασης του υποστοιχείου του.



    <!ELEMENT and (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    Το στοιχείο αυτό εκφράζει ένα τελεστή AND στο αποτέλεσμα της αποτίμησης όλων των εκφράσεων των υποστοιχείων του.



    <!ELEMENT or (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    Το στοιχείο αυτό εκφράζει ένα τελεστή OR στο αποτέλεσμα της αποτίμησης όλων των εκφράσεων των υποστοιχείων του.



    <!ELEMENT instanceof EMPTY>

    <!ATTLIST instanceof

    value CDATA #REQUIRED

    >

    Το στοιχείο αυτό χρησιμοποιείται για την εκτέλεση μιας χρήσης ελέγχου του εστιαζόμενου αντικειμένου. Η έκφραση επιστρέφει την τιμή EvaluationResult.TRUE αν το είδος του αντικειμένου αποτελεί υπο-είδος του είδους που προσδιορίζεται από την τιμή γνωρίσματος. Διαφορετικά, επιστρέφει EvaluationResult.FALSE.



    <!ELEMENT test EMPTY>

    <!ATTLIST test

    property              CDATA #REQUIRED

    args                  CDATA #IMPLIED

    value                 CDATA #IMPLIED

    forcePluginActivation (true | false)

    >

    Αυτό το στοιχείο χρησιμοποιείται για την αποτίμηση της κατάστασης ιδιότητας του εστιαζόμενου αντικειμένου. Το σύνολο των ιδιοτήτων που μπορούν να τεθούν υπό δοκιμή μπορεί να επεκταθεί με χρήση του σημείου επέκτασης org.eclipse.core.expressions.propertyTesters. Η έκφραση δοκιμής επιστρέφει την τιμή EvaluationResult.NOT_LOADED αν η λειτουργία δοκιμής ιδιότητας που πραγματοποιεί την πραγματική δοκιμή δεν έχει φορτωθεί και το γνώρισμα forcePluginActivation έχει οριστεί ως false. Αν το γνώρισμα forcePluginActivation οριστεί ως true και το περιβάλλον αποτίμησης που χρησιμοποιείται για την αποτίμηση αυτής της έκφρασης υποστηρίζει την ενεργοποίηση πρόσθετων λειτουργιών τότε η αποτίμηση της ιδιότητας θα έχει ως αποτέλεσμα την ενεργοποίηση της πρόσθετης λειτουργίας που καθορίζει τη λειτουργία δοκιμής.



    <!ELEMENT systemTest EMPTY>

    <!ATTLIST systemTest

    property CDATA #REQUIRED

    value    CDATA #REQUIRED

    >

    Δοκιμάζει μια ιδιότητα συστήματος καλώντας τη μέθοδο System.getProperty και συγκρίνει το αποτέλεσμα με την τιμή που καθορίζεται μέσω του γνωρίσματος value.



    <!ELEMENT equals EMPTY>

    <!ATTLIST equals

    value CDATA #REQUIRED

    >

    Αυτό το στοιχείο χρησιμοποιείται για την εκτέλεση ενός ελέγχου ισοδυναμίας (equals) του εστιαζόμενου αντικειμένου. Η έκφραση επιστρέφει EvaluationResult.TRUE αν το αντικείμενο ισούται με την τιμή που παρέχεται από την τιμή γνωρίσματος. Διαφορετικά, επιστρέφει EvaluationResult.FALSE.



    <!ELEMENT count EMPTY>

    <!ATTLIST count

    value CDATA #REQUIRED

    >

    Αυτό το στοιχείο χρησιμοποιείται για τη δοκιμή του αριθμού των στοιχείων σε μια συλλογή.



    <!ELEMENT with (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    <!ATTLIST with

    variable CDATA #REQUIRED

    >

    Αυτό το στοιχείο αλλάζει το αντικείμενο προς επιθεώρηση για όλο το θυγατρικό στοιχείο του, στο αντικείμενο στο οποίο γίνεται παραπομπή από την παρεχόμενη μεταβλητή. Εάν δεν είναι δυνατή η ανάλυση της μεταβλητής, τότε κατά την αποτίμησή της από την έκφραση θα προκύψει μια ExpressionException. Τα θυγατρικά στοιχεία μιας έκφρασης with συνδυάζονται με τη χρήση του τελεστή "and".



    <!ELEMENT resolve (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    <!ATTLIST resolve

    variable CDATA #REQUIRED

    args     CDATA #IMPLIED

    >

    Αυτό το στοιχείο αλλάζει το αντικείμενο προς επιθεώρηση για όλο το θυγατρικό στοιχείο του, στο αντικείμενο στο οποίο γίνεται παραπομπή από την παρεχόμενη μεταβλητή. Εάν δεν είναι δυνατή η ανάλυση της μεταβλητής, τότε κατά την αποτίμησή της από την έκφραση θα προκύψει μια ExpressionException. Τα θυγατρικά στοιχεία μιας έκφρασης resolve συνδυάζονται με τη χρήση του τελεστή "and".



    <!ELEMENT adapt (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    <!ATTLIST adapt

    type CDATA #REQUIRED

    >

    Αυτό το στοιχείο χρησιμοποιείται για την προσαρμογή του εστιαζόμενου στο είδος που καθορίζεται από το είδος γνωρίσματος. Η έκφραση επιστρέφει το EvaluationResult.NOT_LOADED αν ο προσαρμογέας ή το είδος στο οποίο γίνεται παραπομπή δεν έχει φορτωθεί ακόμα. Αν το όνομα είδους δεν υπάρχει, προκύπτει μια εξαίρεση ExpressionException κατά την αποτίμηση. Τα θυγατρικά στοιχεία μιας έκφρασης adapt συνδυάζονται με τη χρήση του τελεστή "and".



    <!ELEMENT iterate (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    <!ATTLIST iterate

    operator (or|and)

    ifEmpty  (true | false)

    >

    Αυτό το στοιχείο χρησιμοποιείται για την επανάληψη μιας μεταβλητής τύπου java.util.Collection ή μιας μεταβλητής που προσαρμόζεται στο org.eclipse.core.expressions.IIterable. Εάν το αντικείμενο στο οποίο έχετε εστιάσει δεν είναι ένα από τα παραπάνω, τότε θα προκύψει μια εξαίρεση CoreException με ένα ExpressionStatus κατά την αποτίμηση της έκφρασης. Οι θυγατρικές εκφράσεις μιας έκφρασης iterate συνδυάζονται με χρήση του τελεστή "and".



    <!ELEMENT reference EMPTY>

    <!ATTLIST reference

    definitionId IDREF #REQUIRED

    >

    Αυτό το στοιχείο χρησιμοποιείται για την παραπομπή μιας έκφρασης από το σημείο επέκτασης org.eclipse.core.expressions.definitions. Ο ορισμός της έκφρασης θα αποτιμηθεί εντός του τρέχοντος στοιχείου έκφρασης χρησιμοποιώντας το τρέχον περιβάλλον αποτίμησης.



    Παραδείγματα:
    Παρακάτω δίνεται ένα παράδειγμα συνεισφοράς επεξεργαστή ταχείας βοήθειας:

    
     <extension point="org.eclipse.wst.jsdt.ui.quickAssistProcessors">
    <quickAssistProcessor
       id="AdvancedQuickAssistProcessor"
       name="Advanced Quick Assist Processor"
       requiredSourceLevel="1.5"  
       class="com.example.AdvancedQuickAssistProcessor">
      </quickAssistProcessor>
       <enablement>
          <with variable="projectNatures">
             <iterate operator="or">
                <equals value="org.eclipse.wst.jsdt.core.javanature"/>
                   </iterate>
                 </with>
             </enablement>
     </extension>
    

    Πληροφορίες API:
    Η συνεισφερόμενη κλάση πρέπει να υλοποιεί το org.eclipse.wst.jsdt.ui.text.java.IQuickAssistProcessor


    Copyright (c) 2007 IBM Corporation και άλλων.
    Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση: http://www.eclipse.org/legal/epl-v10.html.