Pax URL Classpath is an OSGi URL handler provides access to resources from thread classpath or all installed bundles or a specific bundle. The searched bundle are only those that are nnot protected by permissions.
The resource is searched by:

1. first look if the bundle symbolic name was specified. If that's the case and the bundle was found then the resource is searched in that bundle. If the resource is found it is returned otherwise an IOException is thrown. If the bundle is not found then an IOException is thrown.
2. look in the current thread classpath. If found the resource is returned
3. if not found in thread classpath search all the bundles available and return the first resource found
4. if still not found an IOException is thrown

Syntax ( see examples )

classpath-uri := "claspath:" [ "//" bundle-symbolic-name "/" ] path-to-resource
bundle-symbolic-name := <any> ; a valid bundle symbolic name from where the resource to be loaded
path-to-resource := <any> ; path to the resources to be loaded

Examples

Loads my-bundle.conf file by searching all the bundles installed.

classpath:my-bundle.conf

Loads my-bundle.conf from the bundle with symbolic name my-bundle

classpath:my-bundle/my-bundle.conf

Issue tracker

Issues, bugs, and feature requests can be submitted to the issue tracking system.

System requirements

• any OSGI R4 compilant framework

Manual installation

• Download the latest version from http://repository.ops4j.org/maven2/org/ops4j/pax/url/pax-url-classpath/
  • java >=5.0: 0.3.2
    older versions: 0.3.1, 0.3.0, 0.2.1
  • java 1.4: 0.3.2
    older versions: 0.3.1, 0.3.0, 0.2.1
• Deploy the downloaded bundle to your preferred OSGi framework

Pax Runner installation

Source code

https://scm.ops4j.org/repos/ops4j/projects/pax/url/pax-url-classpath ( or browse via FishEye )
This project builds with Apache Maven and uses Apache Felix's maven-bundle-plugin, and Peter Kriens bnd tool.