Interface Session

All Known Subinterfaces:
SessionExt
All Known Implementing Classes:
BasicSession

public interface Session
An interface that encapsulates all properties required to run tests. It's introduced to make it possible to get rid of such monsters as InterviewParameters, Template and WorkDir.

It's assumed that components will communicate Session via Update and Event classes: those components which are aware how to modify the config will apply some Update object to the config, the config in its turn will send to all registered observers the corresponding Event object. Important note: JavaTest is not ready yet to operate with Session instances, therefore one should implement the SessionExt interface or extends BasicSession class to provide its own behavior.

See Also:
  • Method Details

    • update

      void update(Session.Update u) throws Session.Fault
      Method to be invoked from outside to change the state of the Session.
      Parameters:
      u - - object encapsulating data describing the change.
      Throws:
      Session.Fault - in case of any problem
    • update

      void update(Session.Update u, boolean updateConfig) throws Session.Fault
      Method to be invoked from outside to change the state of the Session.
      Parameters:
      u - - object encapsulating data describing the change.
      updateConfig - - hint whether to reload the configuration from disk
      Throws:
      Session.Fault - in case of any problem
      Since:
      4.4.1
    • addObserver

      void addObserver(Session.Observer obs)
      Registers the observer. Does nothing if the observer is null or already registered.
      Parameters:
      obs - - observer
    • removeObserver

      void removeObserver(Session.Observer obs)
      Unregisters the observer. Does nothing if the observer is null or not registered.
      Parameters:
      obs - - observer
    • notifyObservers

      void notifyObservers(Session.Event evn)
      Delivers events to the all registered observers
      Parameters:
      evn - - event to be sent out.
    • save

      void save(Map<String,String> map)
      Saves the config state to the map
    • restore

      void restore(Map<String,String> map) throws Session.Fault
      Restores the config state from the map
      Parameters:
      map -
      Throws:
      Session.Fault
    • dispose

      void dispose()
      Disposes configuration. Critical when heavy objects were used.
    • getPropertyNames

      List<String> getPropertyNames()
      Returns the config property names
      Returns:
      Configuration property name List
    • getValue

      String getValue(String name)
      Returns:
      the value of property or null if unset
      Throws:
      IllegalArgumentException - if case of unknown name
      See Also:
    • isReady

      boolean isReady()
      Returns:
      true if configuration is ready for test execution
    • getParameters

      Parameters getParameters()
      Data required to execute tests. In future - should be replaced.
      Returns:
      The current parameters in use.