Mapa serwisu serwera aktualizacji

Domyślny serwer aktualizacji Eclipse może być dowolnym serwerem dostępnym przez podanie adresu URL. W domyślnej implementacji założono ustalony układ serwera. Cała treść serwera (czyli dostępne składniki i moduły dodatkowe) jest opisana w pliku mapy serwisu o nazwie site.xml. Plik ten może być obsługiwany ręcznie lub tworzony dynamicznie przez serwer.

Mapa serwisu

Adres URL serwera aktualizacji można podać jako pełny adres URL pliku mapy serwisu lub adres URL ścieżki katalogu zawierającego ten plik (podobnie jak w przypadku przetwarzania pliku index.html). Format pliku site.xml zawierającego mapę serwisu jest definiowany przez następującą definicję 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
>

Definicje elementów i atrybutów są następujące:

Należy zauważyć, że w przypadku dokumentów manifestów feature.xml należy zwykle używać kodowania UTF-8. Na przykład:

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

Zawarte w pliku site.xml teksty podlegające tłumaczeniu można umieścić w pliku site<_ustawienia narodowe>.properties przy użyciu konwencji pakunków właściwości języka Java. Przetłumaczone łańcuchy są używane podczas instalacji - nie należy używać wykonawczego mechanizmu fragmentu modułu dodatkowego. Położenie pakunków właściwości jest określane względem położenia pliku site.xml.

Domyślny układ serwisu

<katalog główny serwisu>/
    site.xml
    features/
        archiwa składników   (np. org.eclipse.javatools_1.0.1.jar)
        <IdSkładnika>_<WersjaSkładnika>/    (opcjonalne)
            pliki składnika inne niż moduły dodatkowe
    plugins/
        archiwa modułów dodatkowych    (np. org.eclipse.ui_1.0.3.jar)

Plik kopii lustrzanych

Plik kopii lustrzanych aktualizacji (wskazywany przez atrybut mirrorsURL <serwisu>) zawiera definicję kopii lustrzanych serwisów aktualizacji. Jego format jest zdefiniowany przez następujący plik DTD:

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

<!ELEMENT mirrors (mirror*))>
 

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

Kontrola dostępu

W ramach domyślnej implementacji serwisu platformy Eclipse jest udostępniona obsługa protokołu dostępu HTTP z podstawowym uwierzytelnianiem użytkowników (identyfikator użytkownika i hasło).

Do platformy Eclipse można dodać niestandardowe mechanizmy kontroli dostępu w jeden z poniższych sposobów:

Platforma Eclipse udostępnia przykład ilustrujący implementację mechanizmu kontroli dostępu w oparciu o pliki kluczy składników.