Ressourcemarkeringer

org.eclipse.core.resources.markers

Arbejdsområdet understøtter idéen om markeringer på vilkårlige ressourcer. En markering er en slags metadata (svarer til egenskaber), der kan bruges til at kode ressourcer med brugeroplysninger. Markeringer bevares af arbejdsområdet, når arbejdsområdet gemmes, eller når der foretages et snapshot.

Brugere kan definere og forespørge på en bestemt type markeringer. Markeringstyper defineres i et hierarki, som understøtter flere overtagelser. Markeringstypedefinitioner angiver også et antal attributter, som skal eller kan være til stede på en markering af den type, samt om markeringer af den type skal opbevares.

Markeringernes udvidelsespunkt gør det muligt for markeringers skrivefunktion at registrere deres markeringstype under et symbolsk navn, som så bruges inde fra arbejdsområdet til at oprette og forespørge på markeringer. Det symbolske navn er id for markeringsudvidelsen. Når brugerne definerer en markeringsudvidelse, opfordres brugerne til at inkludere en værdi, der kan læses af mennesker, for den "name"-attribut, der identificerer deres markering, og som brugerne eventuelt får vist.

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

<!ATTLIST-udvidelse

point CDATA #REQUIRED

id    CDATA #IMPLIED

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


Følgende er et eksempel på en markeringskonfiguration:

   

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

Alle markeringer, uanset type, er forekomster af org.eclipse.core.resources.IMarker.

Selve platformen har et antal foruddefinerede markeringstyper. Visse produktinstallationer kan omfatte flere markeringer efter behov.