Mapa do sítio da Web do servidor de actualizações

O servidor de actualizações predefinido do Eclipse é qualquer servidor acessível por URL. A implementação predefinida pressupõe um servidor de esquematização fixa. O conteúdo do servidor (em termos de funções e plug-ins disponíveis) é descrito num ficheiro do mapa do sítio da Web, site.xml. Este ficheiro pode ser mantido manualmente ou pode ser calculada dinamicamente pelo servidor.

Mapa do Sítio da Web

O URL do servidor de actualizações pode ser especificar como um URL completo para o ficheiro do mapa do sítio da Web ou um URL de um caminho de directório que contém o ficheiro do mapa do sítio da Web (semelhante ao processamento do ficheiro index.html). O formato do ficheiro site.xml do mapa do sítio da Web é definido pela seguinte 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
>

As definições de elemento e atributo são as seguintes:

Note que, de uma forma geral, os documentos do manifesto do ficheiro feature.xml devem especificar a codificação UTF-8. Por exemplo:

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

O texto traduzível contido no ficheiro site.xml pode ser separado em ficheiros site<_locale>.properties utilizando as convenções de agrupamentos compostos de propriedade de Java. Note que as cadeias traduzidas são utilizadas no momento da instalação (ou seja, não empregue o mecanismo de ambiente de execução de fragmentos do plug-in). Os agrupamentos compostos de propriedades estão localizados em relação à localização do ficheiro site.xml.

Esquema de Sítio da Web Predefinido

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

Ficheiro de Sítios da Web Duplicados

O ficheiro de sítios da Web duplicados de actualizações (o indicado pelo atributo mirrorsURL de <site>) contém a definição de sítios da Web duplicados de actualização. O formato é definido pela DTD que se segue:

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

<!ELEMENT mirrors (mirror*))>
 

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

Ficheiro de Síntese

Os ficheiros de síntese (indicados pelo atributo digestURL do <site>) são ficheiros xml compactados com a seguinte DDT:

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

<!ELEMENT digest (feature*)>

Nos quais a definição de função é a mesma do manifesto da função.

Ficheiros de Sítios da Web Associados

O ficheiro de sítios da Web associados (o indicado pelo atributo associateSitesURL de <site>) contém a definição de sítios da Web associados. O formato é definido pela seguinte dtd:

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

<!ELEMENT associateSites (associateSite*)>
 

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

Controlar o Acesso

A implementação predefinida de sítios da Web do Eclipse fornece suporte para o acesso a http com a autenticação básica de utilizador (ID de utilizador e palavra-passe).

Os mecanismos de controlo de acesso personalizados podem ser adicionados ao Eclipse base usando uma das duas formas que se seguem:

O Eclipse fornece um exemplo que demonstra uma implementação de um mecanismo de acesso com base nos ficheiros de chave de função.