Карта сайта сервера обновления

В качестве сервера обновления Eclipse по умолчанию допустим любой сервер, к которому можно обратиться с помощью URL. Реализация по умолчанию предполагает сервер с фиксированным размещением файлов. Содержимое сервера (список доступных комплектов и модулей) описывается в файле карты сайта site.xml. Этот файл настраивается вручную, либо создается сервером в динамическом режиме.

Карта сайта

URL сервера обновления можно указать в качестве полного URL файла карты сайта, либо URL каталога, содержащего файл карты сайта (аналогично принципу обработки файла index.html). Формат файла site.xml описывается в следующем определении типа документа:

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

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

Ниже приведены определения элементов и атрибутов:

Обратите внимание на то, что в документах манифеста feature.xml следует применять кодировку UTF-8. Пример:

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

Переводимый текст, содержащийся в файле site.xml, можно распределить по файлам site<_локаль>.properties в соответствии с соглашениями о комплектах свойств Java. Обратите внимание, что переведенные строки применяются в ходе установки (без помощи динамического механизма фрагментов модулей). Комплекты свойств расположены относительно файла site.xml.

Размещение файлов по умолчанию

<корневой каталог сайта>/
    site.xml
    features/
       архивы комплектов   (например, org.eclipse.javatools_1.0.1.jar)
        <ИД-комплекта>_<версия-комплекта>/    (необязательно)
            файлы комплекта, не относящиеся к модулю
    plugins/
        plug-in archives    (например, org.eclipse.ui_1.0.3.jar)

Файл зеркальных сайтов

Файл зеркальных сайтов обновления (определяется элементом mirrorsURL атрибута <site>) определяет зеркальные сайты обновления. Формат файла:

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

<!ELEMENT mirrors (mirror*))>
 

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

Управление доступом

В реализации сайта Eclipse по умолчанию предусмотрена поддержка доступа по протоколу HTTP с простой идентификацией пользователей (ИД пользователя и пароль).

Дополнительные функции управления доступом можно добавить в Eclipse одним из приведенных ниже способов:

Вместе с платформой Eclipse поставляется пример, демонстрирующий реализацию функции управления доступом на основе файлов ключей комплектов.