Package com.sun.javatest.exec
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:
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic interface
Root interface for all events happened when state of Session changed.static class
Exception signaling of the problem happened while dealing with Session.static interface
Interface for observers of the Session state.static interface
Root interface for all updates to Session. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Registers the observer.void
dispose()
Disposes configuration.Data required to execute tests.Returns the config property namesboolean
isReady()
void
Delivers events to the all registered observersvoid
Unregisters the observer.void
Restores the config state from the mapvoid
Saves the config state to the mapvoid
Method to be invoked from outside to change the state of the Session.void
update
(Session.Update u, boolean updateConfig) Method to be invoked from outside to change the state of the Session.
-
Method Details
-
update
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
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
Registers the observer. Does nothing if the observer is null or already registered.- Parameters:
obs
- - observer
-
removeObserver
Unregisters the observer. Does nothing if the observer is null or not registered.- Parameters:
obs
- - observer
-
notifyObservers
Delivers events to the all registered observers- Parameters:
evn
- - event to be sent out.
-
save
Saves the config state to the map -
restore
Restores the config state from the map- Parameters:
map
-- Throws:
Session.Fault
-
dispose
void dispose()Disposes configuration. Critical when heavy objects were used. -
getPropertyNames
Returns the config property names- Returns:
- Configuration property name List
-
getValue
- 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.
-