Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
SDO_DAS_Relational::createRootDataObject

SDO_DAS_Relational::createRootDataObject

(no version information, might be only in CVS)

SDO_DAS_Relational::createRootDataObject --  Returns the special root object in an otherwise empty data graph. Used when creating a data graph from scratch.

Description

SDODataObject SDO_DAS_Relational::createRootDataObject ( void )

Warning

This function is EXPERIMENTAL. The behaviour of this function, the name of this function, and anything else documented about this function may change without notice in a future release of PHP. Use this function at your own risk.

Returns the special root object at the top of an otherwise empty data graph. This call is used when the application wants to create a data graph from scratch, without having called executeQuery() to create a data graph.

The special root object has one multi-valued containment property, with a name of the application root type that was passed when the Relational DAS was constructed. The property can take values of only that type. The only thing that the application can usefully do with the root type is to call createDataObject() on it, passing the name of the application root type, in order to create a data object of their own application type.

Parameters

None.

Return Values

The root object.

Errors/Exceptions

None.

Examples

Please see the Examples section in the general information about the Relational DAS for many examples of calling this method.