Mappe du site du serveur de mise à jour

Tout serveur accessible par URL peut servir de serveur de mise à jour Eclipse par défaut. L'implémentation par défaut considère que le serveur utilisé est un serveur à présentation fixe. Le contenu du serveur (en termes de plug-in et de fonctions disponibles) est décrit dans le fichier de mappe de site site.xml. Ce fichier peut-être édité manuellement ou généré dynamiquement par le serveur.

Mappe du site

L'URL du serveur de mise à jour peut être spécifiée comme URL complète du fichier de mappe du site ou comme URL d'un chemin de répertoire contenant le fichier de mappe du site (revient à traiter index.html). Le format site.xml de la mappe de site est défini par le dtd suivant :

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

Les définitions d'élément et d'attribut sont les suivantes :

En général, les documents du manifeste feature.xml doivent spécifier un encodage UTF-8. Exemple :

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

Le texte traduisible du fichier site.xml peut être séparé en fichiers site<_locale>.properties à l'aide des conventions de regroupement des propriétés Java. Les chaînes traduites sont utilisées lors de l'installation (n'utilisez donc pas le mécanisme d'exécution des fragments de plug-in). L'emplacement des groupes de propriétés est relatif à l'emplacement du fichier site.xml.

Présentation par défaut du site

<site root>/
    site.xml
    features/
        feature archives   (comme org.eclipse.javatools_1.0.1.jar)
        <featureId>_<featureVersion>/    (facultatif)
            non-plug-in files for feature
    plugins/
       archives de plug-ins     (eg. org.eclipse.ui_1.0.3.jar)

Fichiers miroir

Le fichier miroir de mise à jour (sur lequel pointe l'attribut mirrorsURL du <site>) contient une définition des miroirs du site de mise à jour. Son format est définit par la DTD suivante :

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

<!ELEMENT mirrors (mirror*))>
 

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

Fichier de prétraitement

Les fichiers de prétraitement (ceux désignés par l'attribut digestURL du <site>) sont des fichiers XML zippés avec le DDT suivant :

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

<!ELEMENT digest (feature*)>

Où la définition de la fonction est identique à celle du manifeste de la fonction.

Fichiers de site associés

Le fichier de site associé (celui désigné par l'attribut associateSitesURL du <site>) contient la définition des sites associés. Son format est défini par le dtd suivant :

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

<!ELEMENT associateSites (associateSite*)>
 

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

Contrôle des accès

L'implémentation par défaut du site Eclipse prend en charge les accès http avec l'authentification de base des utilisateurs (ID utilisateur et mot de passe).

Des mécanismes de contrôle d'accès personnalisés peuvent être ajoutés à la plateforme Eclipse de base de deux manières différentes :

Eclipse fournit un exemple illustrant l'implémentation d'un mécanisme d'accès en fonction des fichiers de clés de fonction.