Defines the Kolab data handler.
Copyright 2011-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.
Methods summary
public
string
|
#
getPath( )
Return the folder path for this data handler.
Return the folder path for this data handler.
Returns
string The folder path.
Since
Horde_Kolab_Storage 1.1.0
|
public
string
|
#
getAuth( )
Return the ID of the current user.
Return the ID of the current user.
Returns
string The current user.
Since
Horde_Kolab_Storage 1.1.0
|
public
string
|
#
getId( )
Return the ID of this data handler.
Return the ID of this data handler.
Returns
string The ID.
|
public
array
|
#
getIdParameters( )
Return the ID parameters for this data handler.
Return the ID parameters for this data handler.
Returns
array The ID parameters.
|
public
string
|
#
getType( )
Return the data type represented by this object.
Return the data type represented by this object.
Returns
string The type of data this instance handles.
|
public
string
|
#
getVersion( )
Return the data version.
Returns
string The data version.
|
public
Horde_Kolab_Storage_Folder_Stamp
|
#
getStamp( )
Report the status of this folder.
Report the status of this folder.
Returns
|
public
string
|
#
create( array & $object, boolean $raw = false )
Create a new object.
Parameters
- $object
- $object The array that holds the object data.
- $raw
- <p>True if the data to be stored has been provided in
raw format.</p>
Returns
string The ID of the new object or true in case the backend does
not support this return value.
Throws
|
public
null
|
#
modify( array $object, boolean $raw = false )
Modify an existing object.
Modify an existing object.
Parameters
- $object
- The array that holds the updated object data.
- $raw
- <p>True if the data to be stored has been provided in
raw format.</p>
Returns
null
Throws
|
public
array
|
#
fetch( array $uids )
Retrieves the objects for the given UIDs.
Retrieves the objects for the given UIDs.
Parameters
Returns
array An array of objects.
|
public
array
|
#
fetchComplete( string $uid )
Retrieves the complete message for the given UID.
Retrieves the complete message for the given UID.
Parameters
Returns
array The message encapsuled as an array that contains a
Horde_Mime_Headers and a Horde_Mime_Part object.
|
public
string
|
#
getBackendId( string $object_id )
Return the backend ID for the given object ID.
Return the backend ID for the given object ID.
Parameters
- $object_id
- $object_uid The object ID.
Returns
string The backend ID for the object.
|
public
string
|
#
generateUid( )
Generate a unique object ID.
Generate a unique object ID.
Returns
string The unique ID.
|
public
boolean
|
#
objectIdExists( string $object_id )
Check if the given object ID exists.
Check if the given object ID exists.
Parameters
- $object_id
- The object ID.
Returns
boolean True if the ID was found, false otherwise.
|
public
array
|
#
getObject( string $object_id )
Return the specified object.
Return the specified object.
Parameters
- $object_id
- The object id.
Returns
array The object data as an array.
|
public
resource
|
#
getAttachment( string $attachment_id )
Return the specified attachment.
Return the specified attachment.
Parameters
- $attachment_id
- The attachment id.
Returns
resource An open stream to the attachment data.
|
public
array
|
#
getObjectIds( )
Retrieve all object ids in the current folder.
Retrieve all object ids in the current folder.
Returns
array The object ids.
|
public
array
|
#
getObjects( )
Retrieve all objects in the current folder.
Retrieve all objects in the current folder.
Returns
array An array of all objects.
|
public
array
|
#
getObjectsByBackendId( )
Retrieve all objects in the current folder by backend id.
Retrieve all objects in the current folder by backend id.
Returns
array An array of all objects.
Since
Horde_Kolab_Storage 1.1.0
|
public
array
|
#
getObjectByBackendId( string $uid )
Retrieve an object in the current folder by backend id.
Retrieve an object in the current folder by backend id.
Parameters
- $uid
- Backend id of the object to be returned.
Returns
array An array of all objects.
Since
Horde_Kolab_Storage 1.1.0
|
public
array
|
#
getObjectToBackend( )
Return the mapping of object IDs to backend IDs.
Return the mapping of object IDs to backend IDs.
Returns
array The object to backend mapping.
Since
Horde_Kolab_Storage 1.1.0
|
public
array
|
#
getDuplicates( )
Retrieve the list of object duplicates.
Retrieve the list of object duplicates.
Returns
array The list of duplicates.
Since
Horde_Kolab_Storage 1.1.0
|
public
array
|
#
getErrors( )
Retrieve the list of object errors.
Retrieve the list of object errors.
Returns
array The list of errors.
Since
Horde_Kolab_Storage 1.1.0
|
public
null
|
#
move( string $object_id, string $new_folder )
Move the specified message from the current folder into a new
folder.
Move the specified message from the current folder into a new
folder.
Parameters
- $object_id
- ID of the message to be moved.
- $new_folder
- Target folder.
Returns
null
|
public
null
|
#
delete( array|string $object_ids )
Delete the specified objects from this data set.
Delete the specified objects from this data set.
Parameters
- $object_ids
- Id(s) of the object to be deleted.
Returns
null
|
public
null
|
#
deleteAll( )
Delete all objects from this data set.
Delete all objects from this data set.
Returns
null
|
public
null
|
#
deleteBackendIds( array|string $uids )
Delete the specified messages from this folder.
Delete the specified messages from this folder.
Parameters
- $uids
- Backend id(s) of the message to be deleted.
Returns
null
Since
Horde_Kolab_Storage 1.1.0
|