Class Horde_Kolab_Server_Objects_Base
This class provides methods to deal with Kolab objects stored in
the Kolab object db.
Copyright 2008-2012 Horde LLC (http://www.horde.org/)
See the enclosed file COPYING for license information (LGPL). If you
did not receive this file, see http://www.horde.org/licenses/lgpl21.
-
Horde_Kolab_Server_Objects_Base
implements
Horde_Kolab_Server_Objects_Interface
Methods summary
public
null
|
#
setComposite( Horde_Kolab_Server_Composite $composite )
Set the composite server reference for this object.
Set the composite server reference for this object.
Parameters
- $composite
- <p>A link to the composite
server handler.</p>
Returns
null
Implementation of
|
public
Kolab_Object
|
#
fetch( string $guid = null, string $type = null )
Fetch a Kolab object.
This method will not retrieve any data from the server
immediately. Instead it will simply generate a new instance for the
desired object.
The server data will only be accessed once you start reading the object
data.
This method can also be used in order to fetch non-existing objects that
will be saved later. This is however not recommended and you should
rather use the add($info) method for that.
If you do not provide the object type the server will try to determine it
automatically based on the uid. As this requires reading data from the
server it is recommended to specify the object type whenever it is known.
If you do not specify a uid the object corresponding to the user bound to
the server will be returned.
Parameters
- $guid
- The GUID of the object to fetch.
- $type
- The type of the object to fetch.
Returns
Kolab_Object The corresponding Kolab object.
Throws
Implementation of
|
public
Kolab_Object
|
#
add( array $info )
Add a Kolab object.
Parameters
- $info
- The object to store.
Returns
Kolab_Object The newly created Kolab object.
Throws
Implementation of
|
public
array
|
#
listHash( string $type, array $params = null )
Generate a hash representation for a list of objects.
Generate a hash representation for a list of objects.
The approach taken here is somewhat slow as the server data gets fetched
into objects first which are then converted to hashes again. Since a
server search will usually deliver the result as a hash the intermediate
object conversion is inefficient.
But as the object classes are able to treat the attributes returned from
the server with custom parsing, this is currently the preferred
method. Especially for large result sets it would be better if this
method would call a static object class function that operate on the
result array returned from the server without using objects.
Parameters
- $type
- The type of the objects to be listed
- $params
- Additional parameters.
Returns
array An array of Kolab objects.
Throws
Implementation of
|
public
array
|
#
listObjects( string $type, array $params = null )
List all objects of a specific type.
List all objects of a specific type.
Parameters
- $type
- The type of the objects to be listed
- $params
- Additional parameters.
Returns
array An array of Kolab objects.
Throws
Implementation of
|