Uczestnicy kompilacji

Identyfikator:

org.eclipse.jdt.core.validationParticipant

Dostępne od wersji:

3.2

Opis:

Ten punkt rozszerzenia pozwala klientom na uczestniczenie w procesie sprawdzania poprawności przez otrzymywanie powiadomień o różnych etapach budowania i rozliczania za pośrednictwem klasy org.eclipse.jdt.core.compiler.validationParticipant.

Znaczniki konfiguracji:

<!ELEMENT extension (validationParticipant*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED

<!ELEMENT validationParticipant (requires* , managedMarker*)>

<!ATTLIST validationParticipant

class CDATA #REQUIRED

id CDATA #REQUIRED

modifiesEnvironment (true | false)

createsProblems (true | false)

requiredSourceLevel CDATA #IMPLIED

definicja uczestnika kompilacji. Ta definicja umożliwia porządkowanie uczestników. Uczestnicy są uruchamiani przez grupę. Najpierw jest uruchamiana grupa uczestników modyfikujących środowisko, następnie grupa uczestników tworzących problemy, a wreszcie grupa pozostałych uczestników. W każdej grupie uczestnicy są uporządkowani według atrybutów 'requires'. Jeśli atrybut 'requires' wskazuje na uczestnika, który nie należy do grupy, jest ignorowany.

class - klasa, w której ten uczestnik kompilacji jest implementowany. Ta klasa musi implementować publiczną podklasę klasy org.eclipse.jdt.core.compiler.validationParticipant z bezargumentowym konstruktorem public.
id - unikalny identyfikator tego uczestnika
modifiesEnvironment - opcjonalnie może określać, czy ten uczestnik kompilacji modyfikuje środowisko, wpływając zarazem na rozwiązanie wiązania. Jeśli nie jest określony, przyjmuje się wartość false.
createsProblems - opcjonalnie może określać, czy ten uczestnik kompilacji tworzy problemy. Jeśli nie jest określony, przyjmuje się wartość false.
requiredSourceLevel - poziom kodu źródłowego wymagany przez tego uczestnika (jedna ze stałych JavaCore.VERSION*). Jeśli poziom kodu źródłowego projektu jest niższy niż poziom wymagany, uczestnik nie zostanie wywołany. Jeśli ten atrybut nie jest określony, uczestnik będzie wywołany na każdym poziomie kodu źródłowego.

<!ELEMENT requires EMPTY>

<!ATTLIST requires

id CDATA #REQUIRED

uczestnik wymagany do uruchomienia tego uczestnika kompilacji

id - unikalny identyfikator uczestnika, który jest wymagany

<!ELEMENT managedMarker EMPTY>

<!ATTLIST managedMarker

markerType CDATA #REQUIRED

zarządzany znacznik, który jest tworzony z zarejestrowanych problemów (patrz BuildContext#recordNewProblems(CategorizedProblem[])) i usuwany po ponownym skompilowaniu pliku źródłowego lub wyczyszczeniu projektu

markerType - typ zarządzanego znacznika

Przykłady:

Przykład deklaracji klasy validationParticipant:

                                                                       
     <extension
      id="apt"
      name="%annotationProcessingName"
      point="org.eclipse.jdt.core.validationParticipant">
   <validationParticipant
         class="org.eclipse.jdt.apt.core.internal.AptvalidationParticipant"
         id="APT"
         requiredSourceLevel="1.5">
      <managedMarker markerType="org.eclipse.jdt.apt.core.compile.problem"/>
   </validationParticipant>
</extension>

Copyright (c) 2006 BEA Systems, Inc and others.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.