Class ConfigurationListener

java.lang.Object
org.glassfish.hk2.configuration.internal.ConfigurationListener
All Implemented Interfaces:
BeanDatabaseUpdateListener

@Singleton @Visibility(LOCAL) public class ConfigurationListener extends Object implements BeanDatabaseUpdateListener
Author:
jwells
  • Constructor Details

    • ConfigurationListener

      public ConfigurationListener()
  • Method Details

    • commitDatabaseChange

      public void commitDatabaseChange(BeanDatabase reference, BeanDatabase newDatabase, Object commitMessage, List<Change> changes)
      Description copied from interface: BeanDatabaseUpdateListener
      This method is called after the change of database has already happened. If this method throws an exception subsequent listeners commit methods will be called, but the WriteableBeanDatabase.commit() method will throw an exception, indicating a possibly inconsistent state
      Specified by:
      commitDatabaseChange in interface BeanDatabaseUpdateListener
      Parameters:
      reference - The database from which the current database was derived
      newDatabase - The current bean database
      commitMessage - An object passed to the commit method in a dynamic change
      changes - The changes that were made to arrive at the current database
    • prepareDatabaseChange

      public void prepareDatabaseChange(BeanDatabase currentDatabase, BeanDatabase proposedDatabase, Object commitMessage, List<Change> changes)
      Description copied from interface: BeanDatabaseUpdateListener
      This method will be called prior to the bean database being updated. If this method throws an exception subsequent listeners prepare methods will not be called and the rollback method of any listeners that had run previously will be called and the proposedDatabase will not become the current database. If all the registered bean update listeners prepare methods return normally then the proposedDatabase will become the current database
      Specified by:
      prepareDatabaseChange in interface BeanDatabaseUpdateListener
      Parameters:
      currentDatabase - The bean database that is current in effect
      proposedDatabase - The bean database that will go into effect
      commitMessage - An object passed to the commit method in a dynamic change
      changes - The changes that were made to the current database
    • rollbackDatabaseChange

      public void rollbackDatabaseChange(BeanDatabase currentDatabase, BeanDatabase proposedDatabase, Object commitMessage, List<Change> changes)
      Description copied from interface: BeanDatabaseUpdateListener
      If any BeanDatabaseUpdateListener.prepareDatabaseChange(BeanDatabase, BeanDatabase, Object, List) throws an exception this method will be called on all listeners whose BeanDatabaseUpdateListener.prepareDatabaseChange(BeanDatabase, BeanDatabase, Object, List) had already been succesfully called. If this method throws an exception subsequent listeners rollback methods will be called and the exception will be returned in the exception thrown to the caller of WriteableBeanDatabase.commit() method
      Specified by:
      rollbackDatabaseChange in interface BeanDatabaseUpdateListener
      Parameters:
      currentDatabase - The bean database that is current in effect
      proposedDatabase - The bean database that was to go into effect (but which will not)
      commitMessage - An object passed to the commit method in a dynamic change
      changes - The changes that were proposed to be made to the current database
    • toString

      public String toString()
      Overrides:
      toString in class Object