Pika-apukäsittelijä

Tunnus:
org.eclipse.wst.jsdt.ui.quickAssistProcessors

Alkaen versiosta:
3.0

Kuvaus:
Tämän laajennuspisteen avulla voi lisätä pika-apukäsittelijän, joka tuo pika-apuja JavaScript-muokkausohjelmaan. Tämä laajennuspiste tukee enablement-tunnistetta. Testattavat ominaisuudet ovat:
  • compilationUnit: ICompilationUnit-tyyppi; käännösyksikkö, jonka yhteydessä pika-apu toteutetaan
  • projectNatures: Collection-tyyppi; kaikki nykyisen projektin projektiluonteet
  • sourceLevel: String-tyyppi; nykyisen projektin lähteen yhteensopivuus
  • Merkintärakenne:

    <!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)*>

    Yleinen juurielementti. Elementtiä voidaan käyttää laajennuspisteen sisällä sen käyttöönottolausekkeen määritykseen. Käyttöönottolausekkeen aliobjektit yhdistetään and-operaattorin avulla.



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

    Tämä elementti edustaa NOT-operaatiota sen alielementin lausekkeen tuloksen arvioinnissa.



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

    Tämä elementti edustaa AND-operaatiota sen kaikkien alielementtien lausekkeiden tuloksen arvioinnissa.



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

    Tämä elementti edustaa OR-operaatiota sen kaikkien alielementtien lausekkeiden tuloksen arvioinnissa.



    <!ELEMENT instanceof EMPTY>

    <!ATTLIST instanceof

    value CDATA #REQUIRED

    >

    Tätä elementtiä käytetään toteuttamaan kohteena olevan objektin ilmentymätarkistus. Lauseke palauttaa arvon EvaluationResult.TRUE, jos objektin laji on määritteen arvossa määritetyn lajin alilaji. Muussa tapauksessa se palauttaa arvon EvaluationResult.FALSE.



    <!ELEMENT test EMPTY>

    <!ATTLIST test

    property              CDATA #REQUIRED

    args                  CDATA #IMPLIED

    value                 CDATA #IMPLIED

    forcePluginActivation (true | false)

    >

    Tämän elementin avulla arvioidaan kohteena olevan objektin ominaisuustila. Testattavien ominaisuuksien joukon voi laajentaa käyttämällä org.eclipse.core.expressions.propertyTesters-laajennuspistettä. Testilauseke palauttaa arvon EvaluationResult.NOT_LOADED, jos varsinaisen testauksen toteuttavaa ominaisuuksien testaustoimintoa ei ole vielä ladattu, ja määritteen forcePluginActivation arvoksi on määritetty false. Jos määritteen forcePluginActivation arvoksi on määritetty true ja lausekkeen arviointiin käytettävä arviointikonteksti tukee lisäosien aktivointia, ominaisuuden arviointi aktivoi testaustoiminnon määrittävän lisäosan.



    <!ELEMENT systemTest EMPTY>

    <!ATTLIST systemTest

    property CDATA #REQUIRED

    value    CDATA #REQUIRED

    >

    Testaa järjestelmän ominaisuutta kutsumalla metodia System.getProperty ja vertaa tulosta arvoon, joka on määritetty arvomääritteen avulla.



    <!ELEMENT equals EMPTY>

    <!ATTLIST equals

    value CDATA #REQUIRED

    >

    Tätä elementtiä käytetään toteuttamaan kohteena olevan objektin yhtäsuuruustarkistus. Lauseke palauttaa arvon EvaluationResult.TRUE, jos objektin arvo on yhtä suuri kuin määritteen arvon mukainen arvo. Muussa tapauksessa se palauttaa arvon EvaluationResult.FALSE.



    <!ELEMENT count EMPTY>

    <!ATTLIST count

    value CDATA #REQUIRED

    >

    Tämän elementin avulla testataan kokoelman elementtien määrä.



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

    <!ATTLIST with

    variable CDATA #REQUIRED

    >

    Tämä elementti muuttaa tarkastettavan objektin kaikkien sen aliobjektien osalta annetun muuttujan viittaamaksi objektiksi. Jos muuttujan selvitys ei onnistu, lauseke aiheuttaa ExpressionException-poikkeuksen, kun sitä arvioidaan. With-lausekkeen aliobjektit yhdistetään and-operaattorin avulla.



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

    <!ATTLIST resolve

    variable CDATA #REQUIRED

    args     CDATA #IMPLIED

    >

    Tämä elementti muuttaa tarkastettavan objektin kaikkien sen aliobjektien osalta annetun muuttujan viittaamaksi objektiksi. Jos muuttujan selvitys ei onnistu, lauseke aiheuttaa ExpressionException-poikkeuksen, kun sitä arvioidaan. Resolve-lausekkeen aliobjektit yhdistetään and-operaattorin avulla.



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

    <!ATTLIST adapt

    type CDATA #REQUIRED

    >

    Tämän elementin avulla mukautetaan kohteena oleva objekti määritelajin määrittämään lajiin. Lauseke palauttaa arvon EvaluationResult.NOT_LOADED, jos sovitinta tai viitattua lajia ei ole vielä ladattu. Lauseke aiheuttaa ExpressionException-poikkeuksen arvioinnin aikana, jos lajin nimeä ei ole lainkaan. Adapt-lausekkeen aliobjektit yhdistetään and-operaattorin avulla.



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

    <!ATTLIST iterate

    operator (or|and)

    ifEmpty  (true | false)

    >

    Tätä elementtiä käytetään iteroimaan java.util.Collection-tyypin muuttujia tai muuttujia, joita rajapinta org.eclipse.core.expressions.IIterable voi käyttää. Jos kohteena oleva objekti ei kuulu edellä mainittuihin tyyppeihin, lausekkeen tulkinta aiheuttaa luokan ExpressionStatus sisältävän CoreException-poikkeuksen. Iterointilausekkeen alilausekkeet yhdistetään and-operaattorin avulla.



    <!ELEMENT reference EMPTY>

    <!ATTLIST reference

    definitionId IDREF #REQUIRED

    >

    Tätä elementtiä käytetään viittaamaan lausekkeeseen org.eclipse.core.expressions.definitions-laajennuspisteestä. Lausekemääritys arvioidaan nykyisessä lauseke-elementissä nykyisen arviointikontekstin avulla.



    Esimerkkejä:
    Seuraavassa on esimerkki pika-apukäsittelijän lisäyksestä:

    
     <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-tiedot:
    Lisätyn luokan on toteutettava org.eclipse.wst.jsdt.ui.text.java.IQuickAssistProcessor-rajapinta


    Copyright (c) 2007 IBM Corporation and others.
    All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html