1: <?php
 2: /**
 3:  * Defines a parser interface for converters that turn Kolab data objects into
 4:  * arrays.
 5:  *
 6:  * PHP version 5
 7:  *
 8:  * @category Kolab
 9:  * @package  Kolab_Storage
10:  * @author   Gunnar Wrobel <wrobel@pardus.de>
11:  * @license  http://www.horde.org/licenses/lgpl21 LGPL 2.1
12:  * @link     http://pear.horde.org/index.php?package=Kolab_Storage
13:  */
14: 
15: /**
16:  * Defines a parser interface for converters that turn Kolab data objects into
17:  * arrays.
18: er.
19:  *
20:  * Copyright 2011-2012 Horde LLC (http://www.horde.org/)
21:  *
22:  * See the enclosed file COPYING for license information (LGPL). If you
23:  * did not receive this file, see http://www.horde.org/licenses/lgpl21.
24:  *
25:  * @category Kolab
26:  * @package  Kolab_Storage
27:  * @author   Gunnar Wrobel <wrobel@pardus.de>
28:  * @license  http://www.horde.org/licenses/lgpl21 LGPL 2.1
29:  * @link     http://pear.horde.org/index.php?package=Kolab_Storage
30:  */
31: interface Horde_Kolab_Storage_Data_Parser
32: {
33:     /**
34:      * Fetches the objects for the specified backend IDs.
35:      *
36:      * @param string $folder  The folder to access.
37:      * @param array  $obids   The object backend IDs to fetch.
38:      * @param array  $options Additional options for fetching.
39:      *
40:      * @return array The parsed objects.
41:      */
42:     public function fetch($folder, $obids, $options = array());
43: 
44:     /**
45:      * Return the format handler.
46:      *
47:      * @return Horde_Kolab_Storage_Data_Format The data object <-> format
48:      *                                         bridge.
49:      */
50:     public function getFormat();
51: }
52: