DataSource :: objectSpaceName - OBJECT_SPACE option
In many cases, a database consists only of the root object space and no object space must be defined.
In some cases the database is, however, build of a number of hierarchical object spaces where each object space may contain a whole universe of object instances. Object spaces are referenced in the defined hierarchy. In order to access a subordinated object space, a path to the object space must be defined in the data source.
The root object space did not get a name, i.e. object space names begin with the first subordinated object space.
Usually, this value is set in the configuration or ini-file in the OBJECT_SPACE option for the data source definition.
OBJECT_SPACE=myClient.subClient
Names can be assigned to object spaces in order to access an object space via name.
Usually, however, no names are assigned to object spaces. In order to pass no object space name, an empty string ( String() ) has to be passed.
Implementation overview
- Get object space path
DataSource :: objectSpaceName ( ) - Set path to object space
DataSource :: objectSpaceName ( sObjectSpaceName )
Implementation details
-
Get object space path
odaba::String DataSource :: objectSpaceName ( )
The function returns the object space path as being defined for the data source.
to list
-
Set path to object space
odaba::String DataSource :: objectSpaceName ( odaba::String &sObjectSpaceName )
The function allows setting the object space path for the data source. The function does not close the or reopen the object space automatically, i.e. the path should be set before opening the data source or the object space must opened (open()) by the application.
- sObjectSpaceName
- Object space name
Names can be assigned to object spaces in order to access an object space via name.
Usually, however, no names are assigned to object spaces. In order to pass no object space name, an empty string ( String() ) has to be passed.
to list
- sObjectSpaceName
- Object space name