Mapa del sitio del servidor de actualizaciones

El servidor de actualizaciones por omisión de Eclipse es cualquier servidor accesible por URL. La implementación por omisión presupone un servidor de diseño fijo. El contenido del servidor (en términos de características y conectores disponibles) se describe en un archivo de mapa del sitio, site.xml. El archivo se puede mantener de forma manual, pero el servidor también lo puede calcular dinámicamente.

Mapa del sitio

El URL del servidor de actualizaciones se puede especificar como URL completo del archivo de mapa del sitio, o bien como URL de una vía de acceso del directorio que contiene el archivo de mapa del sitio (parecido al proceso de index.html). El formato del archivo site.xml de mapa del sitio está definido por la siguiente dtd:

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

Las definiciones de los elementos y atributos son las siguientes:

Observe que, en general, los documentos del manifiesto feature.xml deben especificar la codificación UTF-8. Por ejemplo:

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

El texto traducible contenido en el archivo site.xml se puede separar en archivos site<_entornoLocal>.properties siguiendo los convenios de los paquetes compuestos de propiedades Java. Fíjese en que las series traducidas se emplean en tiempo de instalación (es decir, no emplean el mecanismo de tiempo de ejecución de los fragmentos de conector). La ubicación de los paquetes compuestos de propiedades es relativa a la ubicación del archivo site.xml.

Diseño de sitio por omisión

<directorio_raíz_sitio>/
    site.xml
    features/
        archivados de característica   (por ejemplo, org.eclipse.javatools_1.0.1.jar)
        <idCaracterística>_<versiónCaracterística>/    (opcional)
            archivos no de conector de la característica
    plugins/
        archivadores de conectores    (eg. org.eclipse.ui_1.0.3.jar)

Archivo de sitios duplicados

El archivo de sitios duplicados de actualización (al que apunta el atributo mirrorsURL de <sitio>) contiene una definición de sitios duplicados de actualización. Su formato se define mediante la dtd siguiente:

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

<!ELEMENT mirrors (mirror*))>
 

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

Controlar el acceso

La implementación de sitios por omisión de Eclipse proporciona soporte para el acceso http con autenticación básica de los usuarios (ID de usuario y contraseña).

Es posible añadir mecanismos de control de acceso personalizados al producto Eclipse básico siguiendo uno de estos dos procedimientos:

Eclipse proporciona un ejemplo que hace una demostración de la implementación de un mecanismo de acceso basándose en los archivos de clave de característica.