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
    mirrorsURL    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. Par 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
>

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.