01: /*
02: * This software is released under a licence similar to the Apache Software Licence.
03: * See org.logicalcobwebs.proxool.package.html for details.
04: * The latest version is available at http://proxool.sourceforge.net
05: */
06: package org.logicalcobwebs.proxool;
07:
08: import java.util.Properties;
09:
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(
35: ConnectionPoolDefinitionIF connectionPoolDefinition,
36: Properties completeInfo, Properties changedInfo);
37:
38: }
39:
40: /*
41: Revision history:
42: $Log: ConfigurationListenerIF.java,v $
43: Revision 1.5 2003/03/03 11:11:56 billhorsman
44: fixed licence
45:
46: Revision 1.4 2003/02/26 16:05:52 billhorsman
47: widespread changes caused by refactoring the way we
48: update and redefine pool definitions.
49:
50: Revision 1.3 2003/02/08 00:35:30 billhorsman
51: doc
52:
53: Revision 1.2 2003/01/23 11:41:56 billhorsman
54: doc
55:
56: Revision 1.1 2003/01/18 15:12:23 billhorsman
57: renamed ConfiguratorIF to ConfigurationListenerIF to better reflect role
58:
59: Revision 1.3 2002/12/15 19:21:42 chr32
60: Changed @linkplain to @link (to preserve JavaDoc for 1.2/1.3 users).
61:
62: Revision 1.2 2002/12/12 10:49:43 billhorsman
63: now includes properties in definitionChanged event
64:
65: Revision 1.1 2002/12/04 13:19:43 billhorsman
66: draft ConfigurationListenerIF stuff for persistent configuration
67:
68: */
|