• Home
  • Horde_Kolab_Storage_Data

PHP Interface Horde_Kolab_Storage_Data, horde

Copyright 2011-2014 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.
See link: http://pear.horde.org/index.php?package=Kolab_Storage
Author: Gunnar Wrobel ([email protected])
Inheritance: extends Horde_Kolab_Storage_Queriable
Show file Open project: horde/horde Interface Usage Examples

Public Methods

Method Description
create ( &$object, boolean $raw = false ) : string Create a new object.
delete ( array | string $object_ids ) : null Delete the specified objects from this data set.
deleteAll ( ) : null Delete all objects from this data set.
deleteBackendIds ( array | string $uids ) : null Delete the specified messages from this folder.
fetch ( array $uids ) : array Retrieves the objects for the given UIDs.
fetchComplete ( string $uid ) : array Retrieves the complete message for the given UID.
getAttachment ( string $object_id, string $attachment_id ) : resource Returns the specified attachment.
getAuth ( ) : string Return the ID of the current user.
getBackendId ( $object_id ) : string Return the backend ID for the given object ID.
getDuplicates ( ) : array Retrieve the list of object duplicates.
getErrors ( ) : array Retrieve the list of object errors.
getId ( ) : string Return the ID of this data handler.
getIdParameters ( ) : array Return the ID parameters for this data handler.
getObject ( string $object_id ) : array Return the specified object.
getObjectByBackendId ( string $uid ) : array Retrieve an object in the current folder by backend id.
getObjectIds ( ) : array Retrieve all object ids in the current folder.
getObjectToBackend ( ) : array Return the mapping of object IDs to backend IDs.
getObjects ( ) : array Retrieve all objects in the current folder.
getObjectsByBackendId ( ) : array Retrieve all objects in the current folder by backend id.
getPath ( ) : string Return the folder path for this data handler.
getStamp ( Horde_Kolab_Storage_Folder_Stamp $previous = null ) : Horde_Kolab_Storage_Folder_Stamp Report the status of this folder.
getType ( ) : string Return the data type represented by this object.
getVersion ( ) : string Return the data version.
modify ( array $object, boolean $raw = false ) : null Modify an existing object.
move ( string $object_id, string $new_folder ) : null Move the specified message from the current folder into a new folder.
objectIdExists ( string $object_id ) : boolean Check if the given object ID exists.
setLogger ( Horde_Log_Logger $logger ) Set a logger.

Method Details

create() public method

Create a new object.
public create ( &$object, boolean $raw = false ) : string
$raw boolean True if the data to be stored has been provided in raw format.
return string The ID of the new object or true in case the backend does not support this return value.

delete() public method

Delete the specified objects from this data set.
public delete ( array | string $object_ids ) : null
$object_ids array | string Id(s) of the object to be deleted.
return null

deleteAll() public method

Delete all objects from this data set.
public deleteAll ( ) : null
return null

deleteBackendIds() public method

Delete the specified messages from this folder.
public deleteBackendIds ( array | string $uids ) : null
$uids array | string Backend id(s) of the message to be deleted.
return null

fetch() public method

Retrieves the objects for the given UIDs.
public fetch ( array $uids ) : array
$uids array The message UIDs.
return array An array of objects.

fetchComplete() public method

Retrieves the complete message for the given UID.
public fetchComplete ( string $uid ) : array
$uid string The message UID.
return array The message encapsuled as an array that contains a Horde_Mime_Headers and a Horde_Mime_Part object.

getAttachment() public method

Returns the specified attachment.
public getAttachment ( string $object_id, string $attachment_id ) : resource
$object_id string The object id. @since Kolab_Storage 2.1.0
$attachment_id string The attachment id.
return resource An open stream to the attachment data.

getAuth() public method

Return the ID of the current user.
public getAuth ( ) : string
return string The current user.

getBackendId() public method

Return the backend ID for the given object ID.
public getBackendId ( $object_id ) : string
return string The backend ID for the object.

getDuplicates() public method

Retrieve the list of object duplicates.
public getDuplicates ( ) : array
return array The list of duplicates.

getErrors() public method

Retrieve the list of object errors.
public getErrors ( ) : array
return array The list of errors.

getId() public method

Return the ID of this data handler.
public getId ( ) : string
return string The ID.

getIdParameters() public method

Return the ID parameters for this data handler.
public getIdParameters ( ) : array
return array The ID parameters.

getObject() public method

Return the specified object.
public getObject ( string $object_id ) : array
$object_id string The object id.
return array The object data as an array.

getObjectByBackendId() public method

Retrieve an object in the current folder by backend id.
public getObjectByBackendId ( string $uid ) : array
$uid string Backend id of the object to be returned.
return array An array of all objects.

getObjectIds() public method

Retrieve all object ids in the current folder.
public getObjectIds ( ) : array
return array The object ids.

getObjectToBackend() public method

Return the mapping of object IDs to backend IDs.
public getObjectToBackend ( ) : array
return array The object to backend mapping.

getObjects() public method

Retrieve all objects in the current folder.
public getObjects ( ) : array
return array An array of all objects.

getObjectsByBackendId() public method

Retrieve all objects in the current folder by backend id.
public getObjectsByBackendId ( ) : array
return array An array of all objects.

getPath() public method

Return the folder path for this data handler.
public getPath ( ) : string
return string The folder path.

getStamp() public method

Report the status of this folder.
public getStamp ( Horde_Kolab_Storage_Folder_Stamp $previous = null ) : Horde_Kolab_Storage_Folder_Stamp
$previous Horde_Kolab_Storage_Folder_Stamp The previous stamp, if available.
return Horde_Kolab_Storage_Folder_Stamp The stamp that can be used for detecting folder changes.

getType() public method

Return the data type represented by this object.
public getType ( ) : string
return string The type of data this instance handles.

getVersion() public method

Return the data version.
public getVersion ( ) : string
return string The data version.

modify() public method

Modify an existing object.
public modify ( array $object, boolean $raw = false ) : null
$object array The array that holds the updated object data.
$raw boolean True if the data to be stored has been provided in raw format.
return null

move() public method

Move the specified message from the current folder into a new folder.
public move ( string $object_id, string $new_folder ) : null
$object_id string ID of the message to be moved.
$new_folder string Target folder.
return null

objectIdExists() public method

Check if the given object ID exists.
public objectIdExists ( string $object_id ) : boolean
$object_id string The object ID.
return boolean True if the ID was found, false otherwise.

setLogger() public method

Set a logger.
public setLogger ( Horde_Log_Logger $logger )
$logger Horde_Log_Logger The logger instance.