Package org.apache.felix.bundlerepository.impl

Class ObrURLStreamHandlerService

java.lang.Object

java.net.URLStreamHandler

org.osgi.service.url.AbstractURLStreamHandlerService

org.apache.felix.bundlerepository.impl.ObrURLStreamHandlerService

All Implemented Interfaces:

org.osgi.service.url.URLStreamHandlerService

public class ObrURLStreamHandlerService
extends org.osgi.service.url.AbstractURLStreamHandlerService

Simple URLStreamHandler which is able to handle obr urls. The urls must be conform the following schema: obr:/// Example: obr://org.apache.felix.javax.servlet/1240305961998 Update to the bundle is done

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	ObrURLStreamHandlerService.NewestSelectionStrategy	Strategy returning the newest entry.
private static class	ObrURLStreamHandlerService.ResourceSelectionStrategy	Abstract class for Resource Selection Strategies
(package private) static class	ObrURLStreamHandlerService.SameSelectionStrategy	Strategy returning the current version.

Field Summary

Fields

Modifier and Type	Field	Description
private org.osgi.framework.BundleContext	m_bundleContext	The BundleContext to search for the bundles.
private org.apache.felix.utils.log.Logger	m_logger	Logger to use.
private RepositoryAdmin	m_reRepositoryAdmin	The RepositoryAdmin to query for the actual url for a bundle.
private java.lang.String	m_updateStrategy	The update strategy to use.
static java.lang.String	OBR_UPDATE_STRATEGY	Property defining the obr update strategy
private static java.lang.String	SYNTAX	Syntax for the url; to be shown on exception messages.

Fields inherited from class org.osgi.service.url.AbstractURLStreamHandlerService

realHandler

Constructor Summary

Constructors

Constructor	Description
ObrURLStreamHandlerService(org.osgi.framework.BundleContext context, RepositoryAdmin admin)	Constructor

Method Summary

Modifier and Type	Method	Description
private java.net.URL	getRemoteObrInstallUrl(java.lang.String path)	Assume the URL is a query URL and try to find a matching resource.
private java.net.URL	getRemoteUrlForBundle(org.osgi.framework.Bundle bundle)	Determines the remote url for the given bundle according to the configured ObrURLStreamHandlerService.ResourceSelectionStrategy.
private ObrURLStreamHandlerService.ResourceSelectionStrategy	getStrategy(java.lang.String strategy)
java.net.URLConnection	openConnection(java.net.URL u)	This implementation looks up the bundle with the given url set as location String within the current BundleContext.
private boolean	validateFilter(java.lang.String filter)

Methods inherited from class org.osgi.service.url.AbstractURLStreamHandlerService

equals, getDefaultPort, getHostAddress, hashCode, hostsEqual, parseURL, sameFile, setURL, setURL, toExternalForm

Methods inherited from class java.net.URLStreamHandler

openConnection, parseURL

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SYNTAX

private static final java.lang.String SYNTAX

Syntax for the url; to be shown on exception messages.

See Also:

Constant Field Values

OBR_UPDATE_STRATEGY

public static final java.lang.String OBR_UPDATE_STRATEGY

Property defining the obr update strategy

See Also:

Constant Field Values

m_bundleContext

private final org.osgi.framework.BundleContext m_bundleContext

The BundleContext to search for the bundles.

m_reRepositoryAdmin

private final RepositoryAdmin m_reRepositoryAdmin

The RepositoryAdmin to query for the actual url for a bundle.

m_logger

private final org.apache.felix.utils.log.Logger m_logger

Logger to use.

m_updateStrategy

private java.lang.String m_updateStrategy

The update strategy to use. Default: newest

Constructor Detail

ObrURLStreamHandlerService

public ObrURLStreamHandlerService(org.osgi.framework.BundleContext context,
                                  RepositoryAdmin admin)

Constructor

Parameters:

context - context to use

admin - admin to use

Method Detail

openConnection

public java.net.URLConnection openConnection(java.net.URL u)
                                      throws java.io.IOException

This implementation looks up the bundle with the given url set as location String within the current BundleContext. The real url for this bundle is determined afterwards via the RepositoryAdmin.

Specified by:

openConnection in interface org.osgi.service.url.URLStreamHandlerService

Specified by:

openConnection in class org.osgi.service.url.AbstractURLStreamHandlerService

Throws:

java.io.IOException

getRemoteObrInstallUrl

private java.net.URL getRemoteObrInstallUrl(java.lang.String path)
                                     throws java.io.IOException,
                                            org.osgi.framework.InvalidSyntaxException

Assume the URL is a query URL and try to find a matching resource. Note: the code from the below method comes from OPS4j Pax URL handler

Parameters:

path - the OBR url path

Returns:

the remote URL of the resolved bundle

Throws:

java.io.IOException - if an error occurs

org.osgi.framework.InvalidSyntaxException

validateFilter

private boolean validateFilter(java.lang.String filter)

getRemoteUrlForBundle

private java.net.URL getRemoteUrlForBundle(org.osgi.framework.Bundle bundle)
                                    throws java.io.IOException,
                                           org.osgi.framework.InvalidSyntaxException

Determines the remote url for the given bundle according to the configured ObrURLStreamHandlerService.ResourceSelectionStrategy.

Parameters:

bundle - bundle

Returns:

remote url

Throws:

java.io.IOException - if something went wrong

org.osgi.framework.InvalidSyntaxException

getStrategy

private ObrURLStreamHandlerService.ResourceSelectionStrategy getStrategy(java.lang.String strategy)