Processador de Correcção Rápida

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

Desde:
Ponto de extensão a partir de 3.0. Elemento handledMarkerTypes a partir de 3.2.

Descrição:
Este ponto de extensão permite adicionar um processador de Correcções Rápidas para facultar novas Correcções Rápidas em problemas JavaScript.

A partir de 3.2, uma extensão pode especificar quais os tipos de marcadores de problemas que consegue gerir. Obterá apenas problemas destes tipos para processar. Se não for especificado nenhum tipo de marcador gerido, o processador irá ter apenas problemas de tipo org.eclipse.wst.jsdt.core.problem, org.eclipse.wst.jsdt.core.buildpath_problem e org.eclipse.wst.jsdt.core.task (compatíveis com o comportamento antes de 3.2).

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 (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+)>

    Especifica os tipos de marcador dos problemas que este processador de correcção rápida consegue gerir. Se não for especificado nenhum tipo de marcador gerido, o processo irá ter apenas problemas de tipo org.eclipse.wst.jsdt.core.problem, org.eclipse.wst.jsdt.core.buildpath_problem e 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)*>

    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 Correcção Rápida:

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

    Informação da API:
    A classe contribuída tem de implementar org.eclipse.wst.jsdt.ui.text.java.IQuickFixProcessor


    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