1 /* 2 * $Header: /cvshome/build/org.osgi.service.cm/src/org/osgi/service/cm/ConfigurationListener.java,v 1.10 2006/06/16 16:31:28 hargrave Exp $ 3 * 4 * Copyright (c) OSGi Alliance (2004, 2006). All Rights Reserved. 5 * 6 * Licensed under the Apache License, Version 2.0 (the "License"); 7 * you may not use this file except in compliance with the License. 8 * You may obtain a copy of the License at 9 * 10 * http://www.apache.org/licenses/LICENSE-2.0 11 * 12 * Unless required by applicable law or agreed to in writing, software 13 * distributed under the License is distributed on an "AS IS" BASIS, 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15 * See the License for the specific language governing permissions and 16 * limitations under the License. 17 */ 18 package org.osgi.service.cm; 19 20 /** 21 * Listener for Configuration Events. When a <code>ConfigurationEvent</code> 22 * is fired, it is asynchronously delivered to a 23 * <code>ConfigurationListener</code>. 24 * 25 * <p> 26 * <code>ConfigurationListener</code> objects are registered with the 27 * Framework service registry and are notified with a 28 * <code>ConfigurationEvent</code> object when an event is fired. 29 * <p> 30 * <code>ConfigurationListener</code> objects can inspect the received 31 * <code>ConfigurationEvent</code> object to determine its type, the pid of 32 * the <code>Configuration</code> object with which it is associated, and the 33 * Configuration Admin service that fired the event. 34 * 35 * <p> 36 * Security Considerations. Bundles wishing to monitor configuration events will 37 * require <code>ServicePermission[ConfigurationListener,REGISTER]</code> to 38 * register a <code>ConfigurationListener</code> service. 39 * 40 * @version $Revision: 1.10 $ 41 * @since 1.2 42 */ 43 public interface ConfigurationListener { 44 /** 45 * Receives notification of a Configuration that has changed. 46 * 47 * @param event The <code>ConfigurationEvent</code>. 48 */ 49 public void configurationEvent(ConfigurationEvent event); 50 } 51