Επεξεργαστής ταχείας επιδιόρθωσης

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

Από την έκδοση:
Σημείο επέκτασης από την έκδοση 3.0. Στοιχείο handledMarkerTypes από την έκδοση 3.2.

Περιγραφή:
Αυτό το σημείο επέκτασης επιτρέπει την προσθήκη ενός επεξεργαστή ταχείας επιδιόρθωσης για την προσφορά νέων επιλογών ταχείας επιδιόρθωσης για προβλήματα JavaScript.

Από την έκδοση 3.2, μια επέκταση μπορεί να προσδιορίζει τα είδη δεικτών προβλημάτων που μπορεί να χειριστεί. Θα επεξεργάζεται μόνο προβλήματα των συγκεκριμένων ειδών. Αν δεν προσδιοριστούν τα είδη δείκτη των οποίων θα γίνεται διαχείριση, ο επεξεργαστής θα λαμβάνει μόνο προβλήματα για τα είδη org.eclipse.wst.jsdt.core.problem, org.eclipse.wst.jsdt.core.buildpath_problem και org.eclipse.wst.jsdt.core.task (συμβατά με τη συμπεριφορά εκδόσεων προγενέστερων της 3.2).

Αυτό το σημείο επέκτασης υποστηρίζει το προσδιοριστικό enablement. Οι ιδιότητες προς δοκιμή είναι οι εξής:

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

    <!ELEMENT extension (quickFixProcessor+)>

    <!ATTLIST extension

    point CDATA #REQUIRED

    id    CDATA #IMPLIED

    name  CDATA #IMPLIED

    >


    <!ELEMENT quickFixProcessor (enablement? , handledMarkerTypes*)>

    <!ATTLIST quickFixProcessor

    id    CDATA #REQUIRED

    name                CDATA #IMPLIED

    class               CDATA #REQUIRED

    requiredSourceLevel CDATA #IMPLIED

    >


    <!ELEMENT handledMarkerTypes (markerType+)>

    Προσδιορίζει τα είδη δεικτών για τα προβλήματα που μπορεί να χειριστεί αυτός ο επεξεργαστής ταχείας επιδιόρθωσης. Αν δεν προσδιοριστούν τα είδη δείκτη των οποίων θα γίνεται διαχείριση, ο επεξεργαστής θα λαμβάνει προβλήματα για τα είδη org.eclipse.wst.jsdt.core.problem, org.eclipse.wst.jsdt.core.buildpath_problem και org.eclipse.wst.jsdt.core.task.



    <!ELEMENT markerType EMPTY>

    <!ATTLIST markerType

    id CDATA #REQUIRED

    >


    <!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.quickFixProcessors">
    <quickFixProcessor
       id="AdvancedQuickFixProcessor"
       name="Advanced Quick Fix Processor"
       requiredSourceLevel="1.5"
       class="com.example.AdvancedQuickFixProcessor">
       <handledMarkerTypes>
          <markerType id="org.eclipse.myplugin.audits"/>
       </handledMarkerTypes>
       <enablement>
          <with variable="projectNatures">
             <iterate operator="or">
                <equals value="org.eclipse.wst.jsdt.core.javanature"/>
                   </iterate>
                 </with>
             </enablement>
      </quickFixProcessor>
     </extension>
    

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


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