Маркеры ресурсов

org.eclipse.core.resources.markers

Рабочая область поддерживает понятие маркеров применительно к произвольным ресурсам. Маркер - это разновидность метаданных (схожая со свойствами), с помощью которой можно добавлять в ресурсы теги пользовательской информации. Маркеры могут сохраняться рабочей областью при сохранении рабочей области или создании моментальной копии.

Пользователи могут определять и запрашивать маркеры заданного типа. Типы маркеров определяются в иерархии, поддерживающую разнотипное наследование. В определениях типов маркеров также указываются атрибуты номеров, которые должны или могут присутствовать в маркере этого типа, а также индикаторы того, следует ли сохранять маркеры этого типа.

Точка расширения маркеров позволяет создателям маркеров регистрировать типы маркеров под символьным именем, которое затем используется в рабочей области для создания и запроса маркеров. Символьное имя - это идентификатор расширения маркера. При определении расширения маркера пользователям рекомендуется добавлять в атрибут "name" удобочитаемое значение, которое будет обозначать маркер и может быть представлено другим пользователям.

<!ELEMENT extension (super* , persistent? , attribute*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT super EMPTY>

<!ATTLIST super

type CDATA #REQUIRED>


<!ELEMENT persistent EMPTY>

<!ATTLIST persistent

value (true | false) >


<!ELEMENT attribute EMPTY>

<!ATTLIST attribute

name CDATA #REQUIRED>


Ниже приведен пример конфигурации маркера:

   

<extension id=

"com.xyz.coolMarker"

point=

"org.eclipse.core.resources.markers"

name=

"Cool Marker"

>

<persistent value=

"true"

/>

<super type=

"org.eclipse.core.resources.problemmarker"

/>

<super type=

"org.eclipse.core.resources.textmarker"

/>

<attribute name=

"owner"

/>

</extension>

Все маркеры, независимо от их типа, являются экземплярами org.eclipse.core.resources.IMarker.

Платформа содержит ряд предопределенных типов маркеров. В конкретных устанавливаемых версиях продукта могут содержаться необходимые дополнительные маркеры.