Ivy 教程（11）：建構私有倉庫（三）—— 使用 Namespace 統一命名規範

為什麼需要 Namespace？

從公共倉庫（如 Maven Central、Ibiblio）同步成品到私有倉庫時，常面臨命名不一致問題：

• 同一組織成品分散在不同組織 ID（如 commons-lang vs org.apache.commons）
• 歷史遺留導致群組 ID 混亂
• 企業內部規範要求統一群組 ID（如全部用 com.mycorp）

Ivy 的 Namespace 機制 以正則表達式定義雙向轉換規則，解析時將倉庫命名空間映射為系統命名空間，發布時反向映射，實現「一次定義，雙向一致」。

實作範例：統一 Apache Commons 群組 ID

1. 定義 Ivy 設定檔 ivysettings-advanced.xml

<ivysettings>
  <settings defaultResolver="my-repo"/>
  <resolvers>
    <ibiblio name="libraries" root="https://repo1.maven.org/maven2/" m2compatible="true"
             namespace="maven2"/>  <!-- 關鍵：指定 namespace -->
    <filesystem name="my-repo">
      <artifact pattern="${ivy.settings.dir}/myrepository/advanced/[organisation]/[module]/[revision]/[artifact]-[revision].[ext]"/>
      <ivy pattern="${ivy.settings.dir}/myrepository/advanced/[organisation]/[module]/[revision]/ivy-[revision].xml"/>
    </filesystem>
  </resolvers>
  <namespaces>
    <namespace name="maven2">
      <rule>
        <!-- fromsystem：系統 → 倉庫（解析時） -->
        <fromsystem>
          <src organisation="apache" module=".+"/>
          <dest organisation="$m0" module="$m0"/>  <!-- apache#commons-lang → commons-lang#commons-lang -->
        </fromsystem>
        <!-- tosystem：倉庫 → 系統（安裝/發布時） -->
        <tosystem>
          <src organisation="commons-.+" module="commons-.+"/>
          <src organisation="ant.*" module="ant.*"/>
          <src organisation="xmlrpc" module="xmlrpc"/>
          <dest organisation="apache" module="$m0"/>  <!-- 統一轉為 apache#模組 -->
        </tosystem>
      </rule>
    </namespace>
  </namespaces>
</ivysettings>

2. 執行安裝指令

ant maven2-namespace
# 或
ant maven2-namespace-deps  # 含相依傳遞

輸出示範：

[ivy:install] :: installing apache#commons-lang;1.0
[ivy:install] published commons-lang to .../myrepository/advanced/apache/commons-lang/jars/commons-lang-1.0.jar
[ivy:install] published ivy to .../myrepository/advanced/apache/commons-lang/ivys/ivy-1.0.xml

3. 驗證倉庫結構與 ivy.xml

目錄結構：

myrepository/advanced/apache/commons-lang/
├── jars/commons-lang-1.0.jar
└── ivys/ivy-1.0.xml

ivy-1.0.xml 關鍵中繼資料：

<info organisation="apache" module="commons-lang" revision="1.0"
      status="integration" publication="20051124062021" namespace="ibiblio-maven2"/>

組織 ID 已統一為 apache，且保留 namespace 屬性記錄來源。

Namespace 規則語法詳解

<src> 以正則比對，<dest> 以變數重組。雙向規則分別定義於 <fromsystem>（解析依賴時）與 <tosystem>（發布/安裝時）。

最佳實踐建議

1. 集中管理：將 Namespace 定義於共用 ivysettings.xml，所有專案引用。
2. 漸進擴充：先處理高頻混亂組織（如 Apache、Google、Spring），再補充其他。
3. 文件化：維護對照表，記錄「公共倉庫 ID → 內部標準 ID」映射關係。
4. 自動化驗證：CI 流程中執行 ivy:resolve 檢查是否有未轉換的成品。

結語

Namespace 是 Ivy 區別於 Maven 的強大功能，解決「外部命名混亂、內部規範統一」的核心痛點。掌握正則雙向映射規則，即可建構乾淨、一致、可長期維護的企業級私有倉庫。

1. 上一篇文章： 使用 JAX-RS (JSR-311) 建立 RESTful Web 服務完整指南
2. 下一篇文章： Ivy 教程 (10)：建立儲存庫 (2) - 基礎儲存庫複製

Java 相關知識

Java 6 全新模態對話框 API 深度解析

前言 對話框是擁有標題與邊框的頂層彈出視窗，常用於接收用戶輸

Struts2 標簽庫配置與 IDE 自動提示完全指南

標簽庫定義文件 位於 struts2-core-xxx.ja

Hibernate Session.get vs load 深度解析：緩存機制、代理對象與異常行為

核心結論先行 特性get()load() 立即查詢數據庫是

Java 面向對象程式設計實戰詳解：從結構化到 OOP 的進階之路

前言 Java 作為一門純粹的面向對象語言，提供了強大的 O