1: <?php
 2: /**
 3:  * The interface describing internal Kolab object attributes.
 4:  *
 5:  * PHP version 5
 6:  *
 7:  * @category Kolab
 8:  * @package  Kolab_Server
 9:  * @author   Gunnar Wrobel <wrobel@pardus.de>
10:  * @license  http://www.horde.org/licenses/lgpl21 LGPL 2.1
11:  * @link     http://pear.horde.org/index.php?package=Kolab_Server
12:  */
13: 
14: /**
15:  * The interface describing internal Kolab object attributes.
16:  *
17:  * Copyright 2009-2012 Horde LLC (http://www.horde.org/)
18:  *
19:  * See the enclosed file COPYING for license information (LGPL). If you
20:  * did not receive this file, see http://www.horde.org/licenses/lgpl21.
21:  *
22:  * @category Kolab
23:  * @package  Kolab_Server
24:  * @author   Gunnar Wrobel <wrobel@pardus.de>
25:  * @license  http://www.horde.org/licenses/lgpl21 LGPL 2.1
26:  * @link     http://pear.horde.org/index.php?package=Kolab_Server
27:  */
28: interface Horde_Kolab_Server_Structure_Attribute_Interface
29: {
30:     /**
31:      * Return the internal attribute adapter.
32:      *
33:      * @return Horde_Kolab_Server_Object_Interface The object the attribute belongs to.
34:      */
35:     public function getObject();
36: 
37:     /**
38:      * Return the name of this attribute.
39:      *
40:      * @return string The name of this attribute.
41:      */
42:     public function getName();
43: 
44:     /**
45:      * Return the value of this attribute.
46:      *
47:      * @return array The value of the attribute
48:      */
49:     public function value();
50: 
51:     /**
52:      * Return the new internal state for this attribute.
53:      *
54:      * @param array $changes The object data that should be updated.
55:      *
56:      * @return array The resulting internal state.
57:      *
58:      * @throws Horde_Kolab_Server_Exception If storing the value failed.
59:      */
60:     public function update(array $changes);
61: }