1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Gdata
* @subpackage Gbase
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id: ItemEntry.php 20096 2010-01-06 02:05:09Z bkarwin $
*/
/**
* @see Zend_Gdata_Gbase_Entry
*/
require_once 'Zend/Gdata/Gbase/Entry.php';
/**
* Concrete class for working with Item entries.
*
* @link http://code.google.com/apis/base/
*
* @category Zend
* @package Zend_Gdata
* @subpackage Gbase
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
*/
class Zend_Gdata_Gbase_ItemEntry extends Zend_Gdata_Gbase_Entry
{
/**
* The classname for individual item entry elements.
*
* @var string
*/
protected $_entryClassName = 'Zend_Gdata_Gbase_ItemEntry';
/**
* Set the value of the itme_type
*
* @param Zend_Gdata_Gbase_Extension_ItemType $value The desired value for the item_type
* @return Zend_Gdata_Gbase_ItemEntry Provides a fluent interface
*/
public function setItemType($value)
{
$this->addGbaseAttribute('item_type', $value, 'text');
return $this;
}
/**
* Adds a custom attribute to the entry in the following format:
* <g:[$name] type='[$type]'>[$value]</g:[$name]>
*
* @param string $name The name of the attribute
* @param string $value The text value of the attribute
* @param string $type (optional) The type of the attribute.
* e.g.: 'text', 'number', 'floatUnit'
* @return Zend_Gdata_Gbase_ItemEntry Provides a fluent interface
*/
public function addGbaseAttribute($name, $text, $type = null) {
$newBaseAttribute = new Zend_Gdata_Gbase_Extension_BaseAttribute($name, $text, $type);
$this->_baseAttributes[] = $newBaseAttribute;
return $this;
}
/**
* Removes a Base attribute from the current list of Base attributes
*
* @param Zend_Gdata_Gbase_Extension_BaseAttribute $baseAttribute The attribute to be removed
* @return Zend_Gdata_Gbase_ItemEntry Provides a fluent interface
*/
public function removeGbaseAttribute($baseAttribute) {
$baseAttributes = $this->_baseAttributes;
for ($i = 0; $i < count($this->_baseAttributes); $i++) {
if ($this->_baseAttributes[$i] == $baseAttribute) {
array_splice($baseAttributes, $i, 1);
break;
}
}
$this->_baseAttributes = $baseAttributes;
return $this;
}
/**
* Uploads changes in this entry to the server using Zend_Gdata_App
*
* @param boolean $dryRun Whether the transaction is dry run or not.
* @param string|null $uri The URI to send requests to, or null if $data
* contains the URI.
* @param string|null $className The name of the class that should we
* deserializing the server response. If null, then
* 'Zend_Gdata_App_Entry' will be used.
* @param array $extraHeaders Extra headers to add to the request, as an
* array of string-based key/value pairs.
* @return Zend_Gdata_App_Entry The updated entry
* @throws Zend_Gdata_App_Exception
*/
public function save($dryRun = false,
$uri = null,
$className = null,
$extraHeaders = array())
{
if ($dryRun == true) {
$editLink = $this->getEditLink();
if ($uri == null && $editLink !== null) {
$uri = $editLink->getHref() . '?dry-run=true';
}
if ($uri === null) {
require_once 'Zend/Gdata/App/InvalidArgumentException.php';
throw new Zend_Gdata_App_InvalidArgumentException('You must specify an URI which needs deleted.');
}
$service = new Zend_Gdata_App($this->getHttpClient());
return $service->updateEntry($this,
$uri,
$className,
$extraHeaders);
} else {
parent::save($uri, $className, $extraHeaders);
}
}
/**
* Deletes this entry to the server using the referenced
* Zend_Http_Client to do a HTTP DELETE to the edit link stored in this
* entry's link collection.
*
* @param boolean $dyrRun Whether the transaction is dry run or not
* @return void
* @throws Zend_Gdata_App_Exception
*/
public function delete($dryRun = false)
{
$uri = null;
if ($dryRun == true) {
$editLink = $this->getEditLink();
if ($editLink !== null) {
$uri = $editLink->getHref() . '?dry-run=true';
}
if ($uri === null) {
require_once 'Zend/Gdata/App/InvalidArgumentException.php';
throw new Zend_Gdata_App_InvalidArgumentException('You must specify an URI which needs deleted.');
}
parent::delete($uri);
} else {
parent::delete();
}
}
}
|
