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 plug-ins 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
    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
>

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 plug-in). 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 plug-in de la característica
    plugins/
        archivadores de plug-ins    (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
>

Archivo digest

Los archivos digest (aquellos a los que señala el atributo digestURL de <site>) son archivos xml comprimidos en zip con la siguiente DDT:

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

<!ELEMENT digest (feature*)>

En los que la definición de característica es la misma que en el manifiesto de característica.

Archivo de sitios asociados

El archivo de sitios asociados (al que señala el atributo associateSitesURL de <site>) contiene una definición de sitios asociados. Su formato se define mediante la dtd siguiente:

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

<!ELEMENT associateSites (associateSite*)>
 

<!ELEMENT associateSites EMPTY>
<!ATTLIST associateSite
    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.