1 /* 2 * This software is released under a licence similar to the Apache Software Licence. 3 * See org.logicalcobwebs.proxool.package.html for details. 4 * The latest version is available at http://proxool.sourceforge.net 5 */ 6 package org.logicalcobwebs.proxool; 7 8 import java.util.Properties; 9 10 /** 11 * Listens to any changes made to a {@link ConnectionPoolDefinitionIF definition}. 12 * This gives you the opportunity to persist a definition. 13 * 14 * <pre> 15 * String alias = "myPool"; 16 * ConfigurationListenerIF myConfigurationListener = new MyConfigurationListener(); 17 * ProxoolFacade.{@link ProxoolFacade#addConfigurationListener addConfigurationListener}(alias, myConfigurationListener); 18 * </pre> 19 * 20 * @version $Revision: 1.5 $, $Date: 2003/03/03 11:11:56 $ 21 * @author billhorsman 22 * @author $Author: billhorsman $ (current maintainer) 23 * @since Proxool 0.6 24 */ 25 public interface ConfigurationListenerIF { 26 27 /** 28 * Gets called once after a pool has been updated. 29 * @param connectionPoolDefinition the new definition 30 * @param completeInfo the properties that could be used to create this definition 31 * @param changedInfo only the properties that have changed since the pool was 32 * registered, or this method was las called. 33 */ 34 void definitionUpdated(ConnectionPoolDefinitionIF connectionPoolDefinition, Properties completeInfo, Properties changedInfo); 35 36 } 37 38 /* 39 Revision history: 40 $Log: ConfigurationListenerIF.java,v $ 41 Revision 1.5 2003/03/03 11:11:56 billhorsman 42 fixed licence 43 44 Revision 1.4 2003/02/26 16:05:52 billhorsman 45 widespread changes caused by refactoring the way we 46 update and redefine pool definitions. 47 48 Revision 1.3 2003/02/08 00:35:30 billhorsman 49 doc 50 51 Revision 1.2 2003/01/23 11:41:56 billhorsman 52 doc 53 54 Revision 1.1 2003/01/18 15:12:23 billhorsman 55 renamed ConfiguratorIF to ConfigurationListenerIF to better reflect role 56 57 Revision 1.3 2002/12/15 19:21:42 chr32 58 Changed @linkplain to @link (to preserve JavaDoc for 1.2/1.3 users). 59 60 Revision 1.2 2002/12/12 10:49:43 billhorsman 61 now includes properties in definitionChanged event 62 63 Revision 1.1 2002/12/04 13:19:43 billhorsman 64 draft ConfigurationListenerIF stuff for persistent configuration 65 66 */