| /* |
| * Copyright (c) OSGi Alliance (2000, 2013). All Rights Reserved. |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package org.osgi.framework; |
| |
| /** |
| * Supports a configuration object. |
| * |
| * <p> |
| * {@code 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 |
| * {@code instanceof Configurable}. |
| * |
| * @deprecated As of 1.2. Please use Configuration Admin service. |
| * @author $Id: dce95833dd076e870099385a306989959a84aafd $ |
| */ |
| public interface Configurable { |
| /** |
| * Returns this service's configuration object. |
| * |
| * <p> |
| * Services implementing {@code Configurable} should take care when |
| * returning a service configuration object since this object is probably |
| * sensitive. |
| * <p> |
| * If the Java Runtime Environment supports permissions, it is recommended |
| * that the caller is checked for some appropriate permission before |
| * returning the configuration object. |
| * |
| * @return The configuration object for this service. |
| * @throws SecurityException If the caller does not have an appropriate |
| * permission and the Java Runtime Environment supports permissions. |
| * @deprecated As of 1.2. Please use Configuration Admin service. |
| */ |
| public Object getConfigurationObject(); |
| } |