Mapa webu (site) aktualizačního serveru

Výchozí aktualizační server Eclipse je libovolný server s přístupem URL. Výchozí implementace předpokládá server s pevným rozvržením. Obsah serveru (co se týče dostupných funkcí a modulů plug-in) je popsán v souboru mapy webu (site) site.xml. Tento soubor lze udržovat ručně nebo je možné jej vytvářet dynamicky daným serverem.

Mapa webu (site)

URL aktualizačního serveru lze určit jako úplnou adresu URL k souboru mapy webu (site) nebo URL cesty k adresáři obsahujícího soubor mapy webu (site) (podobné zpracování souboru index.html). Formát mapy webu (site) site.xml definuje následující dtd:

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

Následují definice prvků a atributů:

Povšimněte si, že v obecném případě dokumenty manifestu feature.xml určují kódování UTF-8 encoding. Například:

<?xml version="1.0" encoding="UTF-8"?>

Přeložitelný text obsažený v souboru site.xml lze rozdělit do souborů site<_locale>.properties pomocí konvencí pro balíčky vlastností Java. Vezměte na vědomí, že přeložené řetězce jsou použity v době instalace (tj. nevyužívají běhový mechanizmus fragmentu modulu plug-in). Balíčky vlastností jsou umístěny relativně k umístění souboru site.xml.

Výchozí rozvržení webu (site)

<kořen webu (site)>/
    site.xml
    funkce/
        archivy funkcí   (např. org.eclipse.javatools_1.0.1.jar)
        <featureId>_<featureVersion>/    (volitelné)
            soubory (ne moduly plug-in) pro funkce
    plugins/
        archivy modulů plug-in    (např. org.eclipse.ui_1.0.3.jar)

Soubor zrcadel

Aktualizační soubor zrcadel (ten, na který odkazuje atribut mirrorsURL ze <site>) obsahuje definice zrcadel site s aktualizacemi. Jeho formát je definován následujícím dtd:

<?xml encoding="ISO-8859-2"?>

<!ELEMENT mirrors (mirror*))>
 

<!ELEMENT mirror EMPTY>
<!ATTLIST mirror
    url           CDATA #REQUIRED    
    label         CDATA #REQUIRED
>

Řízení přístupu

Výchozí implementace webu (site) Eclipse obsahuje podporu přístupu http se základním ověřením uživatele (userid a heslo).

Do základu Eclipse lze přidat vlastní mechanizmy pro řízení přístupu jedním ze dvou způsobů:

Eclipse obsahuje příklad s ukázkou implementace přístupového mechanizmu na bázi klíčových souborů funkcí.