擴充插件範例詳解
教程將以擴充插件範本提供的範例為主。
在範例中,你可以看到一個module下有兩個module,分別是 API Module 和 Plugin Module,他們分別是 API 模組 及 伺服器插件模組。 而伺服器插件模組是依賴於 API 模組的,因此伺服器插件建置的時候會包裝 API 模組以創建完整的伺服器插件。
架構大致如下
API Module - itself
Plugin Module - itself + API Module
API Module 詳解
API Module 內的檔案很少,此取決於你提供多少服務 (API) 予你的使用者。以 API Module 為例,此模組只提供了一個服務給使用者,它就是 ExampleService
。
如果你需要加自定義參數,或者需要返回一個自定義的類型,請務必使用 interface 作為其類。 那是因為在 API Module 這個提供接口的模組,你應確保檔案內沒有任何實作的類別,以確保遵從依賴反轉原則。
除此之外,它還有一個 class,但這個並不是對外服務,而是安裝器。
關於這個我們將在後頁講解。
Plugin Module 詳解
Plugin Module 是實作 API Module 內所有 服務的 模組,因此需要依賴於 API Module。 它是實現服務運作的核心,因此他也是最後建置成伺服器插件的模組。
在 v0.1.1 之後,出現了幾個除實例和ELD三個組件以外的 class。關於這點我們將在後頁進行講解。
ExampleServiceImpl
是實現 ExampleService
的 class。
剩下的三個 classes, 分別是註冊為 ELD 插件所需的三個組件。
當你建置完成後,會有兩個 jar , 分別是 API Module 的 jar 及 Plugin Module jar 。他們的職責如下:
API Module 生成的 jar: 給予 其他插件師 進行掛接與使用
Plugin Module 生成的 jar: 給予 服主 放入伺服器運行
為什麼要分開模組進行開發?
這是遵從了 基於介面編程 中一句重要的名言:
此方式在一定程度上確保了插件的可維護性,以及讓插件師專注於接口使用而非實作本身。
以範例為例,由於 Plugin Module 是 實現 API Module 所有服務 的 模組,因此當你需要修改實作程式碼的時候將不需要更改由其他插件師掛接並使用的 API Module , 提高可維護性。
最后更新于