Platsavbildning för uppdateringsservern

Standarduppdateringsservern för Eclipse är valfri server med URL-åtkomst. I en standardimplementering antas en server med fast layout. Innehållet i servern (i termer av tillgängliga funktioner och insticksprogram) beskrivs i en platsavbildningsfil, site.xml. Den här filen kan hanteras manuellt eller så kan den beräknas dynamiskt av servern.

Platsavbildning

Uppdateringsserver-URL-adressen kan anges som en fullständig URL-adress till platsavbildningsfilen eller som en URL-adress för en katalogsökväg som innehåller platsavbildningsfilen (liknande index.html-bearbetning). Formatet för site.xml för platsavbildningen definieras av följande 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- och attributdefinitionerna är de följande:

Observera att feature.xml-manifestetdokumenten i allmänhet bör ange UTF-8-kodning. Exempel:

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

Översättningsbar text i site.xml kan delas upp i site<_locale>.properties-filer med hjälp av Java-konventioner för egenskapssamlingspaket. Observera att de översatta strängarna används vid installation (dvs. använd inte Runtime-mekanismen för insticksprogramsfragment). Egenskapssamlingspaket finns relativt platsen för site.xml.

Standardplatslayout

<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    (eg. org.eclipse.ui_1.0.3.jar)

Speglingsfil

Speglingsfilen för uppdatering (den som mirrorsURL-attributet för <site> pekar på) innehåller en definition av speglingar för uppdateringsplats. Formatet definieras av följande dtd:

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

<!ELEMENT mirrors (mirror*))>
 

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

Sammandragsfil

Sammandragsfiler (de som attributet digestURL för <site> pekar på) är zippade xml-filer med följande DDT:

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

<!ELEMENT digest (feature*)>

Där funktionsdefinitionerna är densamma som i funktionsmanifestet.

Fil med associerade webbplatser

Fil med associerade webbplatser (den som attributet associateSitesURL för <site> pekar på) innehåller definitioner av associerade webbplatser. Formatet för den definieras av följande dtd:

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

<!ELEMENT associateSites (associateSite*)>
 

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

Kontrollera åtkomst

Standardplatsimplementeringen för Eclipse har funktioner för http-åtkomst med allmän användarautentisering (användar-ID och lösenord).

Anpassade åtkomstkontrollmekanismer kan läggas till i bas-Eclipse på något av följande två sätt:

I Eclipse kan du visa en exempeldemonstration av implementering av en åtkomstmekanism baserat på funktionsnyckelfiler.