Skip to main content
summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to 'bundles/org.eclipse.equinox.common/src/org/eclipse/core/runtime/BundleFinder.java')
-rw-r--r--bundles/org.eclipse.equinox.common/src/org/eclipse/core/runtime/BundleFinder.java39
1 files changed, 39 insertions, 0 deletions
diff --git a/bundles/org.eclipse.equinox.common/src/org/eclipse/core/runtime/BundleFinder.java b/bundles/org.eclipse.equinox.common/src/org/eclipse/core/runtime/BundleFinder.java
index 810759e92..e0652d00e 100644
--- a/bundles/org.eclipse.equinox.common/src/org/eclipse/core/runtime/BundleFinder.java
+++ b/bundles/org.eclipse.equinox.common/src/org/eclipse/core/runtime/BundleFinder.java
@@ -24,6 +24,8 @@ import org.osgi.framework.Bundle;
* The class is not intended to be subclassed or instantiated by clients.
*
* @since org.eclipse.equinox.common 1.0
+ * XXX bundle finder renamed and it aggregates URLCOnverter.
+ * This is not a service! just statics.
*/
public final class BundleFinder {
@@ -131,4 +133,41 @@ public final class BundleFinder {
return FindSupport.openStream(bundle, file, false);
}
+ /**
+ * Converts a URL that uses a user-defined protocol into a URL that uses the file
+ * protocol. The contents of the URL may be extracted into a cache on the file-system
+ * in order to get a file URL.
+ * <p>
+ * If the protocol for the given URL is not recognized by this converter, the original
+ * URL is returned as-is.
+ * </p>
+ * @param url the original URL
+ * @return the converted file URL or the original URL passed in if it is
+ * not recognized by this converter
+ * @throws IOException if an error occurs during the conversion
+ */
+ public static URL toFileURL(URL url) throws IOException {
+ return null; //TODO get the code from internalplatform
+ }
+
+ /**
+ * Converts a URL that uses a client-defined protocol into a URL that uses a
+ * protocol which is native to the Java class library (file, jar, http, etc).
+ * <p>
+ * Note however that users of this API should not assume too much about the
+ * results of this method. While it may consistently return a file: URL in certain
+ * installation configurations, others may result in jar: or http: URLs.
+ * </p>
+ * <p>
+ * If the protocol is not reconized by this converter, then the original URL is
+ * returned as-is.
+ * </p>
+ * @param url the original URL
+ * @return the resolved URL or the original if the protocol is unknown to this converter
+ * @exception IOException if unable to resolve URL
+ * @throws IOException if an error occurs during the resolution
+ */
+ public static URL resolve(URL url) throws IOException {
+ return null; //TODO get the code from internalplatform
+ }
}

Back to the top