Oversigt over opdateringswebsted for server

Standard Eclipse-opdateringsserveren er en vilkårlig server, der er adgang til via en URL. Standardimplementeringen forudsætter en server med fast layout. Indholdet af serveren (dvs. tilgængelige funktioner og plugins) beskrives i en oversigtsfil, site.xml. Denne fil kan vedligeholdes manuelt, eller den kan beregnes dynamisk af serveren.

Webstedskort

Opdateringsserver-URL'en kan angives som en fuldstændig URL til webstedsoversigtsfilen eller en URL på en bibliotekssti, der indeholder webstedsoversigtsfilen (det samme som behandling af index.html). Formatet på webstedsoversigtsfilen site.xml defineres af følgende dtd:

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

<!ELEMENT site (description?, feature*, archive*, category-def*)>
<!ATTLIST site
    type                CDATA #IMPLIED
    url                 CDATA #IMPLIED
    mirrorURL           CDATA #IMPLIED
    availableLocales    CDATA #IMPLIED
    digestURL           CDATA #IMPLIED
    associateSitesURL   CDATA #IMPLIED
    pack200             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
>

Element- og attributdefinitionerne er følgende:

Bemærk, at feature.xml-manifestdokumenter normalt skal angive UTF-8-kodning. Eksempel:

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

Tekst i site.xml, som kan oversættes, kan udskilles i site<_sprogkonvention>.properties-filer vha. Java-reglerne for ressourcebundter. Bemærk, at de oversatte strenge bruges på installationstidspunktet, hvilket vil sige, at de ikke anvender plugin-fragmentets runtime-mekanisme. Egenskabsbundter er placeret i forhold til placeringen af site.xml.

Layout på standardwebsted

<webstedsrod>/
    site.xml
    features/
        funktionsarkiver   (f.eks. org.eclipse.javatools_1.0.1.jar)
        <featureId>_<featureVersion>/    (valgfrit)
            ikke-plugin-filer til funktion
    plugins/
        plugin-arkiver    (f.eks. org.eclipse.ui_1.0.3.jar)

Spejlfil

Opdateringsspejlfilen (den fil, der peges på af attributten mirrorsURL til <site>) indeholder definition til opdateringswebstedsspejle. Dens format er defineret af følgende dtd:

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

<!ELEMENT mirrors (mirror*))>
 

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

Oversigtsfil (digest)

Oversigtsfiler, der udpeges af attributten digestURL for <site>, er zippede xml-filer med følgende DDT:

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

<!ELEMENT digest (feature*)>

Hvor funktionsdefinitionen er den samme som i funktionsmanifestet.

Tilknyttede webstedsfiler

Den tilknyttede webstedsfiler, (den fil, der peges på af attributten associateSitesURL til <site>) indeholder definition på tilknyttede websteder. Formatet defineres med følgende DTD:

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

<!ELEMENT associateSites (associateSite*)>
 

<!ELEMENT associateSites EMPTY>
<!ATTLIST associateSite
    url           CDATA #REQUIRED    
    label         CDATA #REQUIRED
>

Styring af adgang

Standardimplementeringen af Eclipse-webstedet understøtter http-adgang med grundlæggende brugervalidering (bruger-id og kodeord).

Tilpassede adgangskontrolmekanismer kan føjes til basis-Eclipse på en af to måder:

Eclipse indeholder et eksempel, der demonstrerer en implementering af en adgangsmekanisme baseret på funktionsnøglefiler.