Processador de Assistência Rápida

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

Desde:
3.0

Descrição:
Este ponto de extensão permite incluir um processador de Ajuda Rápida para oferecer novas Ajudas Rápidas no editor de JavaScript. Ele suporta a tag enablement. As propriedades para teste são:
  • compilationUnit: tipo ICompilationUnit; a unidade de compilação com a qual a assistência rápida é aplicada
  • projectNatures: tipo Collection; naturezas de todos os projetos do projeto atual
  • sourceLevel: tipo String; a conformidade da origem do projeto atual
  • Marcação da Configuração:

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

    Um elemento de raiz genérico. O elemento pode ser utilizado dentro de um ponto de extensão para definir sua expressão de ativação. O filho de uma expressão de ativação é combinado utilizando o operador "and".



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

    Este elemento representa uma operação NOT no resultado da avaliação de suas expressões de subelemento.



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

    Este elemento representa uma operação AND no resultado da avaliação de todas as suas expressões de subelementos.



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

    Este elemento representa uma operação OR no resultado da avaliação de todas as suas expressões de subelementos.



    <!ELEMENT instanceof EMPTY>

    <!ATTLIST instanceof

    value CDATA #REQUIRED

    >

    Este elemento é utilizado para executar uma instância de verificação do objeto em foco. A expressão retornará EvaluationResult.TRUE se o tipo do objeto for um subtipo do tipo especificado pelo valor do atributo. Do contrário, EvaluationResult.FALSE será retornado.



    <!ELEMENT test EMPTY>

    <!ATTLIST test

    property              CDATA #REQUIRED

    args                  CDATA #IMPLIED

    value                 CDATA #IMPLIED

    forcePluginActivation (true | false)

    >

    Esse elemento é usado para avaliar o estado da propriedade do objeto em foco. O conjunto de propriedades testáveis pode ser estendido utilizando o ponto de extensão org.eclipse.core.expressions.propertyTesters. A expressão de teste retornará EvaluationResult.NOT_LOADED se o testador de propriedade que realiza o teste real ainda não estiver carregado e o atributo forcePluginActivation estiver configurado como false. Se forcePluginActivation estiver configurado como true e o contexto de avaliação utilizado para avaliar a ativação dessa expressão suportar a ativação de plug-in, a avaliação da propriedade resultará na ativação do plug-in que define o testador.



    <!ELEMENT systemTest EMPTY>

    <!ATTLIST systemTest

    property CDATA #REQUIRED

    value    CDATA #REQUIRED

    >

    Testa uma propriedade do sistema ao chamar o método System.getProperty e compara o resultado com o valor especificado por meio do atributo de valor.



    <!ELEMENT equals EMPTY>

    <!ATTLIST equals

    value CDATA #REQUIRED

    >

    Este elemento é usado para executar uma verificação de igualdade do objeto em foco. A expressão retorna EvaluationResult.TRUE se o objeto for igual ao valor fornecido pelo valor do atributo. Do contrário, EvaluationResult.FALSE será retornado.



    <!ELEMENT count EMPTY>

    <!ATTLIST count

    value CDATA #REQUIRED

    >

    Esse elemento é usado para testar o número de elementos em uma coleta.



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

    <!ATTLIST with

    variable CDATA #REQUIRED

    >

    O elemento altera o objeto, a ser inspecionado para todos os seus elementos filho, para o objeto referido pela variável fornecida. Se a variável não puder ser resolvida, a expressão lançará uma ExpressionException ao avaliá-la. O filho de uma expressão with é combinado utilizando o operador "and".



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

    <!ATTLIST resolve

    variable CDATA #REQUIRED

    args     CDATA #IMPLIED

    >

    O elemento altera o objeto, a ser inspecionado para todos os seus elementos filho, para o objeto referido pela variável fornecida. Se a variável não puder ser resolvida, a expressão lançará uma ExpressionException ao avaliá-la. O filho de uma expressão resolve é combinado utilizando o operador "and".



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

    <!ATTLIST adapt

    type CDATA #REQUIRED

    >

    Esse elemento é usado para adaptar o objeto em foco ao tipo especificado pelo tipo de atributo. A expressão retorna EvaluationResult.NOT_LOADED se o adaptador ou o tipo referenciado ainda não estiver carregado. Isso lança uma ExpressionException durante a avaliação se o nome do tipo não existir. O filho de uma expressão adapt é combinado utilizando o operador "and".



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

    <!ATTLIST iterate

    operator (or|and)

    ifEmpty  (true | false)

    >

    Este elemento é usado para iterar sobre uma variável do tipo java.util.Collection ou uma variável que se adapta a org.eclipse.core.expressions.IIterable. Se o objeto em foco não for um dos mencionados acima, será lançada uma CoreException com um ExpressionStatus ao avaliar a expressão. As expressões-filhas de uma expressão de iteração são combinadas utilizando o operador "and".



    <!ELEMENT reference EMPTY>

    <!ATTLIST reference

    definitionId IDREF #REQUIRED

    >

    Este elemento é utilizado para fazer referência a uma expressão do ponto de extensão org.eclipse.core.expressions.definitions. A definição da expressão será avaliada no elemento da expressão atual que usa o contexto de avaliação atual.



    Exemplos:
    Segue um exemplo de uma contribuição do processador de Assistência Rápida:

    
     <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>
    

    Informações sobre a API:
    A classe de contribuição deve implementar org.eclipse.wst.jsdt.ui.text.java.IQuickAssistProcessor


    Copyright (c) 2007 IBM Corporation e outros.
    Todos os direitos reservados. Este programa e os materiais fornecidos com ele são disponibilizados sob os termos da Licença Pública do Eclipse v1.0 que acompanha esta distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html