更新伺服器網站對映

預設的 Eclipse 更新伺服器是任何可存取 URL 的伺服器。預設實作假設固定佈置的伺服器。 伺服器的內容(就是可用的特性和外掛程式),在網站對照表檔案 site.xml 中說明。 這個檔案可以手動方式維護,或利用伺服器動態的計算。

網站對照表

更新伺服器 URL 可以被指定為網站對照表檔案的完整 URL、或包含網站對照表檔案之目錄路徑的 URL(近似於 index.html 程序)。 利用下列 dtd 定義網站對照表 site.xml 格式:

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

元素和屬性定義如下:

請注意,一般來說 feature.xml Manifest 文件應該指定 big5 編碼。 比方說:

<?xml version="1.0" encoding="big5"?>

包含在 site.xml 檔中的可翻譯文字,可利用 Java 內容軟體組使用慣例將檔案依語言環境分為 site<_locale>.properties 檔。 請注意,在安裝時期使用可翻譯的字串(例如,勿使用外掛程式片段執行時期機制)。 內容軟體組位於與 site.xml 相對的位置。

預設的網站佈置

<網站根目錄>/
    site.xml
    features/
        特性保存檔   (例如, org.eclipse.javatools_1.0.1.jar)
        <featureId>_<featureVersion>/    (選用)
            特性非外掛程式 (non-plug-in) 檔案
    plugins/
        外掛程式保存檔    (例如 org.eclipse.ui_1.0.3.jar)

鏡映檔案

更新鏡映檔案(由 <site> 的 mirrorsURL 屬性所指向的檔案)包含了更新站台鏡映的定義。 其格式是由以下 dtd 所定義:

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

<!ELEMENT mirrors (mirror*))>
 

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

控制存取

預設的 Eclipse 網站實作以基礎使用者鑑別(使用者 ID 和密碼)來提供 HTTP 存取支援。

新增自訂存取控制機制至基礎 Eclipse,有兩個方法:

Eclipse 提供示範依據特性金鑰檔存取機制的實作範例。