Resurssien merkinnät

org.eclipse.core.resources.markers

Työtila tukee tiettyjen resurssien merkintöjä. Merkinnät ovat (ominaisuuksien kaltaisia) metatietoja, joiden avulla käyttäjä voi lisätä resursseihin tietoja. Työtila voi määrittää merkinnät pysyviksi, kun työtila tallennetaan tai siitä otetaan tilannevedos.

Käyttäjät voivat määrittää tietyn lajin merkintöjä ja tehdä niistä kyselyjä. Merkintälajit määritetään hierarkiaan, joka tukee moniperintää. Merkintälajien määrityksiin voidaan myös määrittää pakollisia ja valinnaisia määritteitä, joita kyseisen lajin merkinnöillä voi olla. Lisäksi voidaan määrittää, tallennetaanko kyseisen lajin merkinnät pysyviksi.

Merkintöjen laajennuspisteen avulla merkintöjen kirjoittajat voivat rekisteröidä merkintälajilleen symbolisen nimen, jota voidaan käyttää työtilassa merkintöjen luontiin ja kyselyyn. Symbolinen nimi on merkintälaajennuksen tunnus. Merkintälaajennusten name-määritteelle kannattaa antaa arvo, sillä se kuvaa merkintää ja se saatetaan näyttää käyttäjille.

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


Seuraavassa on esimerkki merkinnän kokoonpanosta:

   

<extension id=

"com.xyz.coolMarker"

point=

"org.eclipse.core.resources.markers"

name=

"Hieno merkintä"

>

<persistent value=

"true"

/>

<super type=

"org.eclipse.core.resources.problemmarker"

/>

<super type=

"org.eclipse.core.resources.textmarker"

/>

<attribute name=

"owner"

/>

</extension>

Kaikki merkinnät ovat lajista riippumatta org.eclipse.core.resources.IMarker-ilmentymiä.

Käyttöympäristö sisältää joukon valmiiksi määritettyjä merkintälajeja. Joissakin tuoteasennuksissa voi olla muita merkintöjä.