Stedsoversikt over oppdateringsserver

Standard Eclipse-oppdateringsserver er en hvilken som helst URL-tilgjengelig server. Standardimplementeringen forutsetter en server med fast layout. Serverinnholdet (i form av tilgjengelige funksjoner og plugin-moduler) er beskrevet i en stedsoversiktfil, site.xml. Denne filen kan vedlikeholdes manuelt, eller den kan beregnet dynamisk av serveren.

Stedsoversikt

Oppdateringsserver-URLen kan oppgis som en fullstendig URL for stedsoversiktfilen, eller en URL for en katalogbane som inneholder stedsoversiktfilen (på samme måte som index.html-behandling). Formatet på site.xml-stedsoversikten er definert av 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
>

Dette er definisjonene av elementene og attributtene:

Legg merke til at feature.xml-manifestdokumentene generelt skal oppgi UTF-8-koding. Eksempel:

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

Tekst som kan oversettes, som ligger i site.xml, kan deles inn i site<_locale>.properties-filer ved hjelp av konvensjoner for Java-egenskapsbunter. Legg merke til at strenger som kan oversettes, blir brukt under installering (det vil si at de ikke bruker kjøretidsmekanismen for plugin-fragmentet). Egenskapsbuntene er plassert relativt til site.xml-plasseringen.

Standard sideutforming

<site root>/
    site.xml
    features/
        funksjonsarkiver   (for eksempel org.eclipse.javatools_1.0.1.jar)
        <featureId>_<featureVersion>/    (valgfri)
            ikke-plugin-filer for funksjon
    plugins/
        plugin-arkiver    (for eksempel org.eclipse.ui_1.0.3.jar)

Speilingsfil

Oppdateringsspeilingsfilen (den som pekes på av mirrorsURL-attributtet i <site>) inneholder definisjoner for speiling av oppdateringssteder. Formatet er definert av følgende DTD:

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

<!ELEMENT mirrors (mirror*))>
 

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

Konsentratfil

Konsentratfiler (som attributtet digestURL for <stedet> peker på) er en zippet XML-fil med følgende DDT:

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

<!ELEMENT digest (feature*)>

der funksjonsdefinisjonen er den samme som i funksjonsmanifesten.

Tilknyttede stedsfiler

De tilhørende stedsfilene (den som attributtet associateSitesURL for et <sted> peker på) inneholder definisjon av tilknyttede steder. Formatet er definert ved følgende DTD:

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

<!ELEMENT associateSites (associateSite*)>
 

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

Styre tilgang

Standard Eclipse-stedsimplementering støtter http-tilgang med grunnleggende brukerautentisering (bruker-ID og passord).

Tilpassede tilgangskontrollmekanismer kan legges til det grunnleggende Eclipse-systemet på to måter:

Eclipse har et eksempel som demonstrerer en implementering av en tilgangsmekanisme basert på funksjonsnøkkelfiler.