OSGI組合

使用語意版本設定

語意版本編號的商定最佳實務可在 https://semver.org/.

不要內嵌超過OSGi套件組合嚴格需要的類別和jar

通用程式庫應分解為個別的組合。 這可讓您在套件組合中重複使用它們。 包裝時 JAR 在OSGI套件組合中,請務必檢查線上來源,以檢視是否有人之前已執行此動作。 尋找現有套件組合包裝的常見位置包括:Apache Felix、Apache Sling、Apache Geronimo、Apache ServiceMix、Eclipse套件組合配方和SpringSource Enterprise套件組合存放庫。

取決於所需的最低套件組合版本

針對POM檔案中的編譯階段相依性,一律取決於公開所需API的最低所需版本。 這樣可以提供更高的回溯相容性,並使得對舊版進行反向移植修正更容易。

從OSGi套件組合匯出最小套件集

匯出套件後,系統就會建立供其他人相依的API。 請務必儘可能減少匯出次數,並確認要匯出的內容為API。 取得私密方法/類別並將其設為公用比取得先前匯出的內容並將其設為私密要容易得多。

一律將實作放在不同的位置 實作 封裝。 根據預設, maven-bundle-plugin 匯出專案中沒有 實作 在其名稱中。

一律明確定義每個匯出套件的語意版本

這可讓您API的消費者與您一同發展。 在這樣做時,請一律遵循語義版本設定最佳實務。 這可讓您API的消費者知道新版本中預期的變更型別。

在公開處包含中繼資料型別資訊

藉由指定有意義的中繼型別資訊,讓您的服務和元件在Felix主控台中更容易理解。 SCR註釋和屬性清單可在以下網址找到: https://felix.apache.org/documentation/subprojects/apache-felix-maven-scr-plugin/scr-annotations.html.

本頁內容