web/lib/Zend/Gdata/Gbase/ItemEntry.php
changeset 64 162c1de6545a
parent 19 1c2f13fd785c
child 68 ecaf28ffe26e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/web/lib/Zend/Gdata/Gbase/ItemEntry.php	Fri Mar 11 15:05:35 2011 +0100
@@ -0,0 +1,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:
+     * &lt;g:[$name] type='[$type]'&gt;[$value]&lt;/g:[$name]&gt;
+     *
+     * @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();
+        }
+    }
+
+}