A bedolgozó osztály

Eddig a readme eszköz által biztosított különböző kiterjesztéseket tekintettük meg. Most nézzük meg a readme eszköz bedolgozó általános definícióját.

Bedolgozó definíció

A readme eszköz bedolgozó a MANIFEST.MF fájlban van megadva.

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: %Plugin.name
Bundle-SymbolicName: org.eclipse.ui.examples.readmetool; singleton:=true
Bundle-Version: 3.2.0.qualifier
Bundle-ClassPath: readmetool.jar
Bundle-Activator: org.eclipse.ui.examples.readmetool.ReadmePlugin
Bundle-Vendor: %Plugin.providerName
Bundle-Localization: plugin
Require-Bundle: org.eclipse.ui,
 org.eclipse.core.resources,
 org.eclipse.core.runtime,
 org.eclipse.ui.views,
 org.eclipse.ui.ide,
 org.eclipse.jface.text,
 org.eclipse.text,
 org.eclipse.ui.workbench.texteditor,
org.eclipse.ui.editors
Eclipse-AutoStart: true
Eclipse-AutoStart-comment: Use Eclipse-AutoStart instead of Eclipse-LazyStart because the readme example should run against 3.1 as well as 3.2.

A bedolgozó meghatározása tartalmazza a kötegnevet (Bundle-Name), a köteg szimbolikus nevét (Bundle-SymbolicName, a bedolgozó azonosítója), a bedolgozó kötegváltozatát (Bundle-Version), illetve kötegszállítóját (Bundle-Vendor). Ezen paraméterek nagy részét korábban a hello world bedolgozóban láthattuk. A readme eszköz egy speciális bedolgozóosztályt is megad, a ReadmePlugin osztályt.

A jar fájl neve szintén meg van adva. A Bundle-ClassPath tulajdonságban megadott fájlnevek a bedolgozó könyvtárához viszonyítottak, így a readme eszköz jar fájljának közvetlenül a bedolgozó könyvtárában kell elhelyezkednie.

A Require-Bundle elem informálja a platformot a readme eszköz függőségeiről. A munkaterület UI bedolgozók szükséges bedolgozókként kerülnek megjelenítésre a különböző központi, jface, és szöveg bedolgozókkal együtt.

AbstractUIPlugin

A ReadmePlugin a readme eszköz bedolgozót ábrázolja, és kezeli a bedolgozó életciklusát. Ahogy a Hello World példában láttuk, bedolgozóosztályt nem kell megadni. A platform biztosít egyet.  Ebben az esetben a bedolgozónak indításkor inicializálnia kell a felhasználói felülettel kapcsolatos adatokat. Az AbstractUIPlugin platformosztály egy struktúrát biztosít az UI erőforrások kezeléséhez, a ReadmePlugin pedig kiterjeszti ezt.

AbstractUIPlugin az általános indítási és leállítási metódusokat használja a képek, párbeszédablak-beállítások és a beállítástároló kezeléséhez a bedolgozó élettartama során.  A ReadmePlugin osztály jellemzőit a párbeszédablakok és beállítások kezelésekor tekintjük meg.