Processador de Assistência Rápida

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

Desde:
3.0

Descrição:
Este ponto de extensão permite adicionar um Processador de Assistência Rápida para proporcionar Assistências Rápidas no editor JavaScript. Este ponto de extensão faculta apoio para o separador activação. As propriedades onde serão efectuados os testes são:
  • compilationUnit: tipo ICompilationUnit; a unidade de compilação em que é aplicada a assistência rápida
  • projectNatures: tipo Collection; todas as naturezas dos projectos do projecto actual
  • sourceLevel: tipo String; a conformidade de origem do projecto actual
  • 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

    classe               CDATA #IMPLIED

    requiredSourceLevel CDATA #IMPLIED

    >


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

    Um elemento raiz genérico. Este elemento pode ser utilizado dentro de um ponto de extensão para definir a sua expressão de activação. Os elementos descendentes de uma expressão de activação são combinados através da utilização do 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 de avaliação da expressão de subelemento respectiva.



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

    Este elemento representa uma operação AND no resultado de avaliação de todas as respectivas expressões de subelemento.



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

    Este elemento representa uma operação OR no resultado de avaliação de todas as respectivas expressões de subelemento.



    <!ELEMENT instanceof EMPTY>

    <!ATTLIST instanceof

    value CDATA #REQUIRED

    >

    Este elemento é utilizado para desempenhar uma verificação instanceof do objecto em questão. A expressão devolve EvaluationResult.TRUE se o tipo do objecto for um subtipo do tipo especificado pelo valor do atributo. De outro modo, devolve EvaluationResult.FALSE.



    <!ELEMENT test EMPTY>

    <!ATTLIST test

    property              CDATA #REQUIRED

    args                  CDATA #IMPLIED

    value                 CDATA #IMPLIED

    forcePluginActivation (true | false)

    >

    Este elemento é utilizado para avaliar o estado de propriedade do objecto em questão. O conjunto de propriedades verificáveis pode ser alargado através da utilização do ponto de extensão org.eclipse.core.expressions.propertyTesters. A expressão do teste devolve EvaluationResult.NOT_LOADED se o dispositivo de teste de propriedades que realiza o teste ainda não estiver carregado e o atributo forcePluginActivation estiver definido como false. Caso forcePluginActivation esteja definido como verdadeiro e o contexto de avaliação usado para avaliar a expressão suportar a activação de plug-ins, a avaliação da propriedade resultará na activação do plug-in que o dispositivo de teste definir.



    <!ELEMENT systemTest EMPTY>

    <!ATTLIST systemTest

    property CDATA #REQUIRED

    value    CDATA #REQUIRED

    >

    Testa uma propriedade de sistema solicitando o método System.getProperty e compara o resultado com o valor especificado através do atributo value.



    <!ELEMENT equals EMPTY>

    <!ATTLIST equals

    value CDATA #REQUIRED

    >

    Este elemento é utilizado para desempenhar uma verificação equals do objecto em questão. A expressão devolve EvaluationResult.TRUE se o objecto for igual ao valor fornecido pelo atributo value. De outro modo, devolve EvaluationResult.FALSE.



    <!ELEMENT count EMPTY>

    <!ATTLIST count

    value CDATA #REQUIRED

    >

    Este elemento é utilizado para testar o número de elementos numa recolha.



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

    <!ATTLIST with

    variable CDATA #REQUIRED

    >

    Este elemento altera o objecto a ser inspeccionado em todos os elementos descendentes, para o objecto referenciado pela dada variável. Se a variável não puder ser processada, a expressão irá lançar uma ExpressionException quando estiver a avaliá-la. Os elementos descendentes de uma expressão with são combinados com recurso ao 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

    >

    Este elemento altera o objecto a ser inspeccionado em todos os elementos descendentes, para o objecto referenciado pela dada variável. Se a variável não puder ser processada, a expressão irá lançar uma ExpressionException quando estiver a avaliá-la. Os elementos descendentes de uma expressão resolve são combinados com recurso ao operador "and".



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

    <!ATTLIST adapt

    type CDATA #REQUIRED

    >

    Este elemento é utilizado para adaptar o objecto em questão ao tipo especificado pelo tipo do atributo. A expressão devolve EvaluationResult.NOT_LOADED se o adaptador ou o tipo referenciados ainda não estiverem carregados. E lança uma ExpressionException durante a avaliação se o nome de tipo não existir. Os elementos descendentes de uma expressão adapt são combinados através da utilização do 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 é utilizado para iterar numa variável que seja de tipo java.util.Collection ou numa variável que se adapte a org.eclipse.core.expressions.IIterable. Se o objecto em questão não for nenhum dos anteriormente indicados, então, uma CoreException com um ExpressionStatus será lançada durante a avaliação da expressão. Os elementos descendentes de uma expressão "iterate" são combinados através do operador "and".



    <!ELEMENT reference EMPTY>

    <!ATTLIST reference

    definitionId IDREF #REQUIRED

    >

    Este elemento é utilizado para referenciar uma expressão do ponto de extensão org.eclipse.core.expressions.definitions. A definição de expressão será avaliada no elemento de expressão actual, usando o contexto de avaliação actual.



    Exemplos:
    A seguir apresenta-se 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ção da API:
    A classe contribuída tem de 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 que o acompanham estão disponíveis sob os termos da Eclipse Public License v1.0 que acompanha esta distribuição e está disponível em http://www.eclipse.org/legal/epl-v10.html