src/main/gov/nasa/jpf/ConfigChangeListener.java

   1 /*
   2  * Copyright (C) 2014, United States Government, as represented by the
   3  * Administrator of the National Aeronautics and Space Administration.
   4  * All rights reserved.
   5  *
   6  * The Java Pathfinder core (jpf-core) platform is licensed under the
   7  * Apache License, Version 2.0 (the "License"); you may not use this file except
   8  * in compliance with the License. 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 gov.nasa.jpf;
  19
  20 /**
  21  * listener for gov.nasa.jpf.Config changes. Implementors
  22  * can register themselves upon initialization, to react to
  23  * downstream changes even if they cache or process Config
  24  * settings for increased performance.
  25  *
  26  * the notification is per-key
  27  */
  28 public interface ConfigChangeListener {
  29
  30   /**
  31    * a JPF property was changed during runtime (e.g. by using the Verify API
  32    * or encountering annotations)
  33    */
  34   void propertyChanged (Config conf, String key, String oldValue, String newValue);
  35
  36   /**
  37    *  this can be used to let a config listener remove itself, which is
  38    *  required if the same Config object is used for several JPF runs
  39    */
  40   void jpfRunTerminated (Config conf);
  41 }