Palvelimen sivustokartan päivitys

Eclipse-päivityksen oletuspalvelin voi olla mikä tahansa URL-käyttöinen palvelin. Oletustoteutuksessa palvelimen asettelu on kiinteä. Palvelimen sisältö (käytettävissä olevat tuoteominaisuudet ja lisäosat) kuvataan sivustokarttatiedostossa, jonka nimi on site.xml. Tiedostoa voidaan ylläpitää manuaalisesti, tai palvelin voi laskea sen dynaamisesti.

Sivustokartta

Päivityspalvelimen URL-osoite voidaan määrittää täydellisenä URL-osoitteena sivustokarttatiedostoon tai sivustokarttatiedoston sisältävän hakemistopolun URL-osoitteena (kuten index.html-tiedoston käsittelyssä). Sivustokartan site.xml-tiedoston muodon DTD-määritys on seuraava:

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

Elementin ja määritteen määritykset ovat seuraavat:

Huomaa, että feature.xml-manifest-asiakirjoissa on yleensä määritettävä UTF-8-koodaus. Esimerkiksi:

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

Käännettävä teksti site.xml-tiedostossa voidaan erottaa site<_locale>.properties-tiedostoiksi, joissa käytetään Javan ominaisuustiedostoryhmäkäytäntöjä. Huomaa, että käännettyjä merkkijonoja käytetään asennuksen aikana (älä siis käytä lisäosafragmentin ajonaikaista mekanismia). Ominaisuustiedostoryhmät sijaitsevat suhteessa site.xml-tiedoston sijaintiin.

Sivuston oletusasettelu

<site root>/
    site.xml
    features/
        feature archives   (esimerkiksi org.eclipse.javatools_1.0.1.jar)
        <featureId>_<featureVersion>/    (valinnainen)
            tuoteominaisuuden muut kuin lisäosatiedostot
    plugins/
        plug-in archives    (esimerkiksi org.eclipse.ui_1.0.3.jar)

Kahdennussivustotiedosto

Päivityksen kahdennussivustotiedosto (johon <site>-määritteen kahdennussivustojen URL-määrite viittaa) sisältää päivityksen kahdennussivustojen määritykset. Sen muodon DTD-määritys on seuraava:

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

<!ELEMENT mirrors (mirror*))>
 

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

Koostetiedosto

Koostetiedostot (joihin <site>-määritteen digestURL osoittaa) pakataan xml-tiedostoksi, jossa on seuraava DTD-määritys:

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

<!ELEMENT digest (feature*)>

missä tuoteominaisuuden määrittely on sama kuin tuoteominaisuuden manifest-tiedostossa.

Liitesivustotiedosto

Liitesivustotiedosto (johon <site>-määritteen associateSitesURL-määrite viittaa) sisältää liitesivustojen määrityksen. Sen muodon DTD-määritys on seuraava:

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

<!ELEMENT associateSites (associateSite*)>
 

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

Käyttöoikeuden tarkistus

Eclipse-ympäristön oletussivuston toteutus tukee HTTP-yhteyttä, jossa on käyttäjän perustodennus (käyttäjätunnus ja salasana).

Eclipse-perusympäristöön voidaan lisätä mukautettuja käyttöoikeuden tarkistusmekanismeja kahdella tavalla:

Eclipse-ympäristö on esimerkki tuoteominaisuuden avaintiedostoihin perustuvan käyttöoikeusmekanismin toteutuksesta.