OSGi™ Service Platform
Release 2

org.osgi.framework
Interface Configurable


public interface Configurable

Supports a configuration object.

Configurable is an interface that should be used by a bundle developer in support of a configurable service. Bundles that need to configure a service may test to determine if the service object is an instanceof Configurable.


Method Summary
 java.lang.Object getConfigurationObject()
          Returns this service's configuration object.
 

Method Detail

getConfigurationObject

public java.lang.Object getConfigurationObject()
Returns this service's configuration object.

Services implementing Configurable should take care when returning a service configuration object since this object is probably sensitive.

If the Java Runtime Environment supports permissions, it is recommended that the caller is checked for the appropriate permission before returning the configuration object. It is recommended that callers possessing the appropriate AdminPermissionalways be allowed to get the configuration object.

Returns:
The configuration object for this service.
Throws:
java.lang.SecurityException - If the caller does not have an appropriate permission and the Java Runtime Environment supports permissions.

OSGi™ Service Platform
Release 2

Copyright © OSGi Alliance (2000, 2002). All Rights Reserved. Licensed under the OSGi Specification License, Version 1.0