更新服务器站点映射

缺省 Eclipse 更新服务器是可通过 URL 访问的任何服务器。缺省实现采用固定布局的服务器。服务器的内容(关于可用的功能部件和插件)在站点映射文件 site.xml 中描述。可手工维护此文件,或者由服务器动态计算。

站点映射

更新服务器 URL 可指定为站点映射文件的完整 URL,或是包含站点映射文件(类似于 index.html 处理)的目录路径的 URL。此站点映射 site.xml 格式是由下列 dtd 定义的:

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

<!ELEMENT site (description?, feature*, archive*, category-def*)>
<!ATTLIST site
    type          CDATA #IMPLIED
    url           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
>

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

可使用 Java 属性捆绑约定将包含在 site.xml 中的可翻译文本分成若干个 site<_locale>.properties 文件。注意,在安装时使用翻译的字符串(即,不要使用插件段运行时机制)。属性捆绑的位置与 site.xml 位置相对应。

缺省站点布局

<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 argives    (eg. org.eclipse.ui_1.0.3.jar)

控制访问

缺省 Eclipse 站点实现提供了对具有基本用户认证(用户标识和密码)的 http 访问的支持。

可用下列两种方法之一将定制访问控制机制添加至基本 Eclipse:

Eclipse 提供了一个示例,演示基于功能部件密钥文件的访问机制的实现。

Copyright IBM Corporation and others 2000, 2003.