diff --git a/readme.txt b/readme.txt index 3f82fd0ce7..8e01aaee1a 100644 --- a/readme.txt +++ b/readme.txt @@ -28,4 +28,22 @@ To build the JavaDoc, do the following from within the root directory: ./gradlew :docs:api The result will be available in 'docs/build/api'. + +###### OSGI Notes ###### + +1. Dependency on Third Party Bundles + Some adapters depend on third party libraries (bundles). + Spring hosts Enterprise Bundle Repository (EBR) https://ebr.springsource.com/repository/app/ + where you can download many third party JARs as valid OSGi bundles. + If a particular bundle is not available in Spring's EBR, there are tools that can convert regular + JAR to a bundle JAR. One of them is Bundlor http://www.springsource.org/bundlor which can auto-generate + MANIFEST as part of standard project lifecycle or simply convert non-bundle JAR to a bundle JAR. +2. Boot delegation + Some adapters depend on extension packages that are available to the boot class loader. + For example; Feed Adapter depends on com.sun.syndication.feed. Since by default OSGi only + loads java.* from the boot class loader, other packages that must be loaded from the boot class loader + can therefore be specified with the 'org.osgi.framework.bootdelegation' System property. + For example: + org.osgi.framework.bootdelegation=com.sun.*,org.w3c.*. . . . + =============================================================================== \ No newline at end of file