Uno/Spec/Environment Stack
From Apache OpenOffice Wiki
state: draft
type: specification
Environment Stack
Feature
The Uno/Spec/Runtime allows to enter / leave an Uno/Spec/Environment, respectively to invoke functions in a particular Uno/Spec/Environment.
Rationale
Operations may need to be associated with the Uno/Spec/Environment(s) of a particular object. Such operations may set thread related global variables (e.g. the component- or current-context) or may acquire mutexes.
API
-
getCurrentEnvironment- Provides the current active Uno/Spec/Environment, in case no Uno/Spec/Environment has been entered, the Thread safe environment is returned. -
invoke- Invokes the passed function in the given Uno/Spec/Environment. -
enter- Enters the given Uno/Spec/Environment. Uno/Spec/Environment can be left by entering another [../
Eenvironment]].
-
isValid- Checks if the passed Uno/Spec/Environment is active, so that objects belonging to this Uno/Spec/Environment may be called.
Comment
The enter / leave functionality may not be appropriate for all environments at all times. E.g. the thread affine environment does not allow to be entered, while it already has a thread associated.
