Участники компиляции

Идентификатор:

org.eclipse.jdt.core.validationParticipant

Версия:

3.2

Описание:

Эта точка расширения позволяет клиентам принимать участие в процессе проверки и согласования путем перехвата уведомлений на разных этапах компоновки. Для этого применяется класс org.eclipse.jdt.core.compiler.validationParticipant.

Описание конфигурации:

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

пример участника компиляции. Данное определение позволяет заказывать участников. Участники выполняются группами. Сначала выполняется группа участников, изменяющих среду, затем группа участников, которые служат источниками неполадок, и затем выполняются все остальные участники. В пределах группы участники упорядочиваются в соответствии с системой взаимосвязи, установленной значениями атрибутов 'requires'. Если атрибут 'requires' указывает на участника, не входящего в группу, такой участник игнорируется.

class - класс, реализующий данного участника компиляции. Должен быть открытым производным классом класса org.eclipse.jdt.core.compiler.validationParticipant с открытым конструктором с нулевыми параметрами.
id - уникальный идентификатор участника.
modifiesEnvironment - с помощью этого необязательного параметра можно указать, что данный участник компиляции изменяет среду и, как следствие, влияет на разбор привязок. Если этот параметр не указан, предполагается, что ему присвоено значение false.
createsProblems - с помощью этого необязательного параметра можно указать, может ли данный участник компиляции быть источником неполадок. Если этот параметр не указан, предполагается, что ему присвоено значение false.
requiredSourceLevel - уровень исходного кода, необходимый этому участнику (одна из констант JavaCore.VERSION* constants). Если уровень исходного кода ниже указанного значения, данный участник не будет использоваться. Если этот параметр не указан, участник будет вызываться независимо от уровня исходного кода.

<!ELEMENT requires EMPTY>

<!ATTLIST requires

id CDATA #REQUIRED

участник, необходимый для выполнения данного участника компиляции

id - уникальный идентификатор необходимого участника

<!ELEMENT managedMarker EMPTY>

<!ATTLIST managedMarker

markerType CDATA #REQUIRED

Управляемый маркер, создаваемый из записей о неполадках (BuildContext#recordNewProblems(CategorizedProblem[])) и удаляемый при повторной компоновке исходного файла или при очистке проекта.

markerType - тип управляемого маркера

Примеры:

Пример объявления 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 и другие компании.
Все права защищены. Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на веб-сайте http://www.eclipse.org/legal/epl-v10.html