Frissítési kiszolgáló webhely térkép
Az alapértelmezett Eclipse frissítési kiszolgáló bármely URL-címmel
elérhető kiszolgáló. Az alapértelmezett implementáció egy rögzített elrendezésű kiszolgálót
feltételez. A kiszolgáló tartalmát (a rendelkezésre álló szolgáltatások és bedolgozók
formájában) a webhely térkép fájl, a site.xml írja le. Ez a fájl
karbantartható kézzel, vagy a kiszolgáló számíthatja ki dinamikusan.
Webhely térkép
A frissítési kiszolgáló URL-címe megadható a webhely térkép fájl teljes
URL-jeként, vagy a webhely térkép fájlt tartalmazó könyvtár elérési
útvonal URL-jeként (hasonlóan az index.html feldolgozásához). A
webhely térkép site.xml formátumát a következő dtd határozza meg:
<?xml encoding="ISO-8859-2"?>
<!ELEMENT site (description?, feature*, archive*, category-def*)>
<!ATTLIST site
type
CDATA #IMPLIED
url
CDATA #IMPLIED
mirrorsURL CDATA #IMPLIED
>
<!ELEMENT description (#PCDATA)>
<!ATTLIST description
url
CDATA #IMPLIED
>
<!ELEMENT feature (category*)>
<!ATTLIST feature
type
CDATA #IMPLIED
id
CDATA #IMPLIED
version
CDATA #IMPLIED
url
CDATA #REQUIRED
patch
(false | true) false
os CDATA #IMPLIED
nl CDATA #IMPLIED
arch CDATA #IMPLIED
ws
CDATA #REQUIRED
>
<!ELEMENT archive EMPTY>
<!ATTLIST archive
path
CDATA #REQUIRED
url
CDATA #REQUIRED
>
<!ELEMENT category EMPTY>
<!ATTLIST category
name
CDATA #REQUIRED
>
<!ELEMENT category-def (description?)>
<!ATTLIST category-def
name
CDATA #REQUIRED
label
CDATA #REQUIRED
>
Az elemek és attribútumok meghatározása a következő:
- <site> - meghatározza a webhely térképet
- type - nem kötelező webhelytípus-specifikáció Az érték egy, a telepítési keretrendszer kiterjesztési pontján keresztül
bejegyzett típus karaktersorozatra hivatkozik. Ha nincs megadva, a rendszer az alapértelmezett Eclipse helytípust
feltételezi (ahogy a jelen dokumentumban meg van adva).
- url - nem kötelező URL, amely megadja a frissítési hely alap URL-címét (az
egyedi <feature> és <archive> helyek meghatározására használják).
Relatív és abszolút is lehet.Ha relatív, akkor a site.xml-hez viszonyítva.Ha nincs megadva, az
alapértelmezés a site.xml fájl URL-helyszíne.
- mirrorsURL - elhagyható URL, amely egy frissítőhelytükör-meghatározásokat
tartalmazó fájlra mutat. Ez az URL abszolút lehet vagy a helyhez viszonyítva
relatív. A tükörfájl leírása a később következik a dokumentumban.
- <description> - rövid leírás egyszerű szövegként. Lefordítandó.
- url - nem kötelező URL-cím a teljes, HTML-formátumú leíráshoz. Abszolút és relatív URL-ként is meg lehet adva. Ha relatív, akkor az URL a site.xml-hez van viszonyítva.
Figyeljen rá, hogy az URL érték NL kezelését külön kell választani
annak engedélyezésére, hogy alternatív URL-címek legyenek megadhatók
minden nemzeti nyelvhez.
- <feature> - azonosítja a hivatkozott szolgáltatás archívumot.
- type - nem kötelező szolgáltatástípus-meghatározás. Az érték egy, a telepítési keretrendszer kiterjesztési pontján keresztül
bejegyzett típus karaktersorozatra hivatkozik. Ha nincs megadva, a rendszer a hely alapértelmezett szolgáltatástípusát
feltételezi. Ha a hely típusa az alapértelmezett Eclipse helytípus, az alapértelmezett
szolgáltatástípus a csomagolt szolgáltatás típusa (ahogy a jelen
dokumentumban meg van adva).
- id - nem kötelező szolgáltatásazonosító. Az információ
teljesítmény-optimalizálásra szolgál, a szolgáltatások keresésének
felgyorsításához. Meg kell egyeznie a hivatkozott archívum feature.xml állományában megadott
azonosítóval (az url attribútummal).
Ha meg van adva, a verzióattribútumot is meg kell adni.
- version - nem kötelező szolgáltatásverzió. Az információ
teljesítmény-optimalizálásra szolgál, a szolgáltatások keresésének
felgyorsításához. Meg kell egyeznie a hivatkozott archívum feature.xml állományában megadott
verzióval (az url attribútummal).
Ha meg van adva, az azonosító attribútumot is meg kell adni.
- url - a szolgáltatásarchívum kötelező URL-hivatkozása. Relatív és abszolút is lehet. Ha relatív, akkor a site.xml fájl helyéhez viszonyítva.
Megjegyzés: az alapértelmezett hely használata lehetővé teszi, hogy
a szolgáltatások egy <feature> bejegyzés kifejezett deklarálása nélkül
elérhetők legyenek. Egy nem deklarált szolgáltatáshivatkozás
alapértelmezésben a következőképpen kerül értelmezésre:
"szolgáltatások/<azonosító>_<verzió>.jar".
Megjegyzés: a jobb keresési teljesítmény érdekében mindig adja meg az
azonosító és verzió attribútumokat.
- patch - nem kötelező attribútum annak megjelölésére, hogy ez egy javítás
(egy speciális szolgáltatástípus).
Megjegyzés: a jobb keresési teljesítmény érdekében mindig adja meg ezt
az attribútumot.
- os - nem kötelező operációsrendszer-meghatározás. Az operációsrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform). Azt jelzi, hogy ez a szolgáltatás csak a megadott operációs rendszerek
valamelyikén telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- arch - nem kötelező gép architektúra specifikáció. Az architektúra-kijelölők vesszővel elválasztott listája az Eclipse által
meghatározva (lásd: Javadoc, org.eclipse.core.runtime.Platform). Azt jelzi, hogy ez a szolgáltatás csak a megadott rendszerek valamelyikén
telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- ws - nem kötelező ablakkezelőrendszer-meghatározás. Az ablakrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform). Azt jelzi, hogy ez a szolgáltatás csak a megadott ablakrendszerek
egyikén telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- nl - nem kötelező területi beállítás meghatározás. A területi beállítás kijelölők vesszővel elválasztott, Java által
meghatározott listája. Azt jelzi, hogy ez a szolgáltatás csak egy kompatibilis területi beállítással
futó rendszeren telepíthető (a Java területibeállítás-egyeztetési
szabályainak használatával). Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(nyelvsemleges implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- <archive> - azonosítja a hivatkozott "tároló" archívumokat (az
aktuális fájlokra a szolgáltatásleírás <plugin> vagy
<data> eleme hivatkozik). A hely egyszerűen útvonal-URL
leképezésként kezeli az archívumokat. Az alapértelmezett Eclipse helyimplementációhoz nincs szükség arra, hogy
az <archive> szegmens megtalálható legyen a helytérképben (a
site.xml-ben). Minden, nem kifejezetten egy <archive> szegmens
részeként definiált hivatkozásról feltételezi a rendszer, hogy URL-címmé
képezendő le a következő formában: "<archivePath>", a site.xml fájl
helyéhez viszonyítva.
- path - kötelező archívum elérési út azonosító. Ez egy karaktersorozat, amelyet az erre az archívumra hivatkozó
szolgáltatás határoz meg, és a rendszer nem értelmez másképp (másnak,
mint egy keresési jelsorozatnak).
- url - az archívum kötelező URL-hivatkozása. Relatív és abszolút is lehet.
Ha relatív, akkor a site.xml fájl helyéhez viszonyítva.
- <category-def> - egy kategória nem kötelező definíciója, amelyet a
telepítés- és frissítéstámogatás használhat a szolgáltatások hierarchikus
rendszerezésére.
- name - kategórianév. Név-jelsorokként van megadva, / karakterekkel
elválasztva.
- label - megjelenítendő címke. Lefordítandó.
- <category> - egy szolgáltatásleírás tényleges kategóriameghatározása.
Figyeljen rá, hogy a feature.xml leíró dokumentumoknak általában UTF-8
kódolást kell megadniuk. Például:
<?xml version="1.0" encoding="UTF-8"?>
A site.xml-ben található lefordítandó szövegeket a Java
tulajdonságköteg-megállapodások használatával szét kell szedni
site<_locale>.properties fájlokba. Ne felejtse el, hogy telepítéskor a lefordított karaktersorozatokat
telepítéskor kell használni (vagyis ne alkalmazza a futásidejű
bedolgozó-töredék mechanizmust). A tulajdonságkötegek helye a site.xml fájl helyéhez van viszonyítva.
Alapértelmezett hely-elrendezés
<site root>/
site.xml
features/
feature archives
(eg. org.eclipse.javatools_1.0.1.jar)
<featureId>_<featureVersion>/
(optional)
non-plug-in files for feature
plugins/
plug-in archives
(például org.eclipse.ui_1.0.3.jar)
Tükörfájl
A frissítőtükörfájl (amelyre a <site> mirrorsURL attribútuma mutat)
frissítőhelytükrök definícióját tartalmazza. A formátumát a következő dtd
határozza meg:
<?xml encoding="ISO-8859-1"?>
<!ELEMENT mirrors (mirror*))>
<!ELEMENT mirror EMPTY>
<!ATTLIST mirror
url
CDATA #REQUIRED
label
CDATA #REQUIRED
>
- <mirrors> - az elérhető frissítőhelytükröket határozza meg
- <mirror> - megad egy tükörhelyet
- url - a tükörhely URL címe
- label - megjelenítendő címke. Lefordítandó.
Hozzáférés-felügyelet
Az alapértelmezett Eclipse hely-implementáció támogatja a http-elérést az
alapszintű felhasználói hitelesítési adatok (felhasználói azonosító és
jelszó) használatával.
Az alapszintű Eclipse mechanizmusok saját hozzáférés-felügyeleti
eszközökkel is kiegészíthetők a következő kétféle módszer valamelyikének
használatával:
-
kiszolgáló-oldali logika megadásával a frissítési kiszolgálón (például a
site.xml térképet kiszámító kiszolgáló kisalkalmazások implementálásával,
és az egyedi archívumok hozzáférésének felügyeletével bizonyos
felhasználói feltételek alapján)
-
a hely objektum egyedi konkrét megvalósításásával (az ügyfélgépen
telepítve, a frissítési kiszolgáló megadásával: <site type="">).
Az egyéni, konkrét helyimplementáció bármely kiszolgáló-oldali logikával
együtt támogatja a kívánt felügyeleti mechanizmust.
Az Eclipse egy példát is kínál, bemutatva egy szolgáltatási kulcs fájlokra
épülő hozzáférési mechanizmus implementálását.