\Horde_Kolab_Server_Structure_Interface

The interface definition for the handlers dealing with the Kolab Server object tree structure.

Copyright 2009-2017 Horde LLC (http://www.horde.org/)

See the enclosed file LICENSE for license information (LGPL). If you did not receive this file, see http://www.horde.org/licenses/lgpl21.

Summary

Methods
Constants
find()
findBelow()
setComposite()
getSupportedObjects()
getSearchOperations()
mapExternalToInternalAttribute()
getExternalAttributes()
getInternalAttributes()
getExternalAttribute()
determineType()
generateServerGuid()
No constants found
No protected methods found
N/A
No private methods found
N/A

Methods

find()

find(\Horde_Kolab_Server_Query_Element  $criteria, array  $params = array()) : \Horde_Kolab_Server_Result

Finds object data matching a given set of criteria.

Parameters

\Horde_Kolab_Server_Query_Element $criteria

The criteria for the search.

array $params

Additional search parameters.

Throws

\Horde_Kolab_Server_Exception

Returns

\Horde_Kolab_Server_Result —

The result object.

findBelow()

findBelow(\Horde_Kolab_Server_Query_Element  $criteria, string  $parent, array  $params = array()) : \Horde_Kolab_Server_Result

Finds all object data below a parent matching a given set of criteria.

Parameters

\Horde_Kolab_Server_Query_Element $criteria

The criteria for the search.

string $parent

The parent to search below.

array $params

Additional search parameters.

Throws

\Horde_Kolab_Server_Exception

Returns

\Horde_Kolab_Server_Result —

The result object.

setComposite()

setComposite(\Horde_Kolab_Server_Composite  $composite) : NULL

Set the composite server reference for this object.

Parameters

\Horde_Kolab_Server_Composite $composite

A link to the composite server handler.

Returns

NULL

getSupportedObjects()

getSupportedObjects() : array

Returns the set of objects supported by this structure.

Returns

array —

An array of supported objects.

getSearchOperations()

getSearchOperations() : array

Returns the set of search operations supported by this object type.

Returns

array —

An array of supported search operations.

mapExternalToInternalAttribute()

mapExternalToInternalAttribute(string  $external) : string

Maps the external attribute name to its internal counterpart.

Parameters

string $external

The external attribute name.

Returns

string —

The internal attribute name.

getExternalAttributes()

getExternalAttributes(\Horde_Kolab_Server_Object  $object) : array

Return the external attributes supported by the given object class.

Parameters

\Horde_Kolab_Server_Object $object

Determine the external attributes for this class.

Throws

\Horde_Kolab_Server_Exception

If the schema analysis fails.

Returns

array —

The supported attributes.

getInternalAttributes()

getInternalAttributes(\Horde_Kolab_Server_Object  $object) : array

Return the internal attributes supported by the given object class.

Parameters

\Horde_Kolab_Server_Object $object

Determine the internal attributes for this class.

Throws

\Horde_Kolab_Server_Exception

If the schema analysis fails.

Returns

array —

The supported attributes.

determineType()

determineType(string  $guid) : string

Determine the type of an object by its tree position and other parameters.

Parameters

string $guid

The GUID of the object to examine.

Throws

\Horde_Kolab_Server_Exception

If the object type is unknown.

Returns

string —

The class name of the corresponding object type.

generateServerGuid()

generateServerGuid(string  $type, string  $id, array  $info) : string

Generates a UID for the given information.

Parameters

string $type

The class name of the object to create.

string $id

The id of the object.

array $info

Any additional information about the object to create.

Throws

\Horde_Kolab_Server_Exception

If the given type is unknown.

Returns

string —

The GUID.