File indexing completed on 2025-05-04 05:27:54

 <?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 App
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  * @version    $Id$
  */
 
 /**
  * @see Zend_Gdata_App_Extension_Element
 */
 // require_once 'Zend/Gdata/App/Extension/Element.php';
 
 /**
  * @see Zend_Gdata_App_Extension_Author
 */
 // require_once 'Zend/Gdata/App/Extension/Author.php';
 
 /**
  * @see Zend_Gdata_App_Extension_Category
 */
 // require_once 'Zend/Gdata/App/Extension/Category.php';
 
 /**
  * @see Zend_Gdata_App_Extension_Contributor
 */
 // require_once 'Zend/Gdata/App/Extension/Contributor.php';
 
 /**
  * @see Zend_Gdata_App_Extension_Id
  */
 // require_once 'Zend/Gdata/App/Extension/Id.php';
 
 /**
  * @see Zend_Gdata_App_Extension_Link
  */
 // require_once 'Zend/Gdata/App/Extension/Link.php';
 
 /**
  * @see Zend_Gdata_App_Extension_Rights
  */
 // require_once 'Zend/Gdata/App/Extension/Rights.php';
 
 /**
  * @see Zend_Gdata_App_Extension_Title
  */
 // require_once 'Zend/Gdata/App/Extension/Title.php';
 
 /**
  * @see Zend_Gdata_App_Extension_Updated
  */
 // require_once 'Zend/Gdata/App/Extension/Updated.php';
 
 /**
  * Zend_Version
  */
 // require_once 'Zend/Version.php';
 
 /**
  * Abstract class for common functionality in entries and feeds
  *
  * @category   Zend
  * @package    Zend_Gdata
  * @subpackage App
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  */
 abstract class Zend_Gdata_App_FeedEntryParent extends Zend_Gdata_App_Base
 {
     /**
      * Service instance used to make network requests.
      *
      * @see setService(), getService()
      */
     protected $_service = null;
 
     /**
      * The HTTP ETag associated with this entry. Used for optimistic
      * concurrency in protoco v2 or greater.
      *
      * @var string|null
      */
     protected $_etag = NULL;
 
     protected $_author = array();
     protected $_category = array();
     protected $_contributor = array();
     protected $_id = null;
     protected $_link = array();
     protected $_rights = null;
     protected $_title = null;
     protected $_updated = null;
 
     /**
       * Indicates the major protocol version that should be used.
       * At present, recognized values are either 1 or 2. However, any integer
       * value >= 1 is considered valid.
       *
       * @see setMajorProtocolVersion()
       * @see getMajorProtocolVersion()
       */
     protected $_majorProtocolVersion = 1;
 
     /**
       * Indicates the minor protocol version that should be used. Can be set
       * to either an integer >= 0, or NULL if no minor version should be sent
       * to the server.
       *
       * @see setMinorProtocolVersion()
       * @see getMinorProtocolVersion()
       */
     protected $_minorProtocolVersion = null;
 
     /**
      * Constructs a Feed or Entry
      */
     public function __construct($element = null)
     {
         if (!($element instanceof DOMElement)) {
             if ($element) {
                 $this->transferFromXML($element);
             }
         } else {
             $this->transferFromDOM($element);
         }
     }
 
     /**
      * Set the HTTP client instance
      *
      * Sets the HTTP client object to use for retrieving the feed.
      *
      * @deprecated Deprecated as of Zend Framework 1.7. Use
      *             setService() instead.
      * @param  Zend_Http_Client $httpClient
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setHttpClient(Zend_Http_Client $httpClient)
     {
         if (!$this->_service) {
             $this->_service = new Zend_Gdata_App();
         }
         $this->_service->setHttpClient($httpClient);
         return $this;
     }
 
     /**
      * Gets the HTTP client object. If none is set, a new Zend_Http_Client
      * will be used.
      *
      * @deprecated Deprecated as of Zend Framework 1.7. Use
      *             getService() instead.
      * @return Zend_Http_Client_Abstract
      */
     public function getHttpClient()
     {
         if (!$this->_service) {
             $this->_service = new Zend_Gdata_App();
         }
         $client = $this->_service->getHttpClient();
         return $client;
     }
 
     /**
      * Set the active service instance for this object. This will be used to
      * perform network requests, such as when calling save() and delete().
      *
      * @param Zend_Gdata_App $instance The new service instance.
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface.
      */
     public function setService($instance)
     {
         $this->_service = $instance;
         return $this;
     }
 
     /**
      * Get the active service instance for this object. This will be used to
      * perform network requests, such as when calling save() and delete().
      *
      * @return Zend_Gdata_App|null The current service instance, or null if
      *         not set.
      */
     public function getService()
     {
         return $this->_service;
     }
 
     public function getDOM($doc = null, $majorVersion = 1, $minorVersion = null)
     {
         $element = parent::getDOM($doc, $majorVersion, $minorVersion);
         foreach ($this->_author as $author) {
             $element->appendChild($author->getDOM($element->ownerDocument));
         }
         foreach ($this->_category as $category) {
             $element->appendChild($category->getDOM($element->ownerDocument));
         }
         foreach ($this->_contributor as $contributor) {
             $element->appendChild($contributor->getDOM($element->ownerDocument));
         }
         if ($this->_id != null) {
             $element->appendChild($this->_id->getDOM($element->ownerDocument));
         }
         foreach ($this->_link as $link) {
             $element->appendChild($link->getDOM($element->ownerDocument));
         }
         if ($this->_rights != null) {
             $element->appendChild($this->_rights->getDOM($element->ownerDocument));
         }
         if ($this->_title != null) {
             $element->appendChild($this->_title->getDOM($element->ownerDocument));
         }
         if ($this->_updated != null) {
             $element->appendChild($this->_updated->getDOM($element->ownerDocument));
         }
         return $element;
     }
 
     protected function takeChildFromDOM($child)
     {
         $absoluteNodeName = $child->namespaceURI . ':' . $child->localName;
         switch ($absoluteNodeName) {
         case $this->lookupNamespace('atom') . ':' . 'author':
             $author = new Zend_Gdata_App_Extension_Author();
             $author->transferFromDOM($child);
             $this->_author[] = $author;
             break;
         case $this->lookupNamespace('atom') . ':' . 'category':
             $category = new Zend_Gdata_App_Extension_Category();
             $category->transferFromDOM($child);
             $this->_category[] = $category;
             break;
         case $this->lookupNamespace('atom') . ':' . 'contributor':
             $contributor = new Zend_Gdata_App_Extension_Contributor();
             $contributor->transferFromDOM($child);
             $this->_contributor[] = $contributor;
             break;
         case $this->lookupNamespace('atom') . ':' . 'id':
             $id = new Zend_Gdata_App_Extension_Id();
             $id->transferFromDOM($child);
             $this->_id = $id;
             break;
         case $this->lookupNamespace('atom') . ':' . 'link':
             $link = new Zend_Gdata_App_Extension_Link();
             $link->transferFromDOM($child);
             $this->_link[] = $link;
             break;
         case $this->lookupNamespace('atom') . ':' . 'rights':
             $rights = new Zend_Gdata_App_Extension_Rights();
             $rights->transferFromDOM($child);
             $this->_rights = $rights;
             break;
         case $this->lookupNamespace('atom') . ':' . 'title':
             $title = new Zend_Gdata_App_Extension_Title();
             $title->transferFromDOM($child);
             $this->_title = $title;
             break;
         case $this->lookupNamespace('atom') . ':' . 'updated':
             $updated = new Zend_Gdata_App_Extension_Updated();
             $updated->transferFromDOM($child);
             $this->_updated = $updated;
             break;
         default:
             parent::takeChildFromDOM($child);
             break;
         }
     }
 
     /**
      * @return Zend_Gdata_App_Extension_Author
      */
     public function getAuthor()
     {
         return $this->_author;
     }
 
     /**
      * Sets the list of the authors of this feed/entry.  In an atom feed, each
      * author is represented by an atom:author element
      *
      * @param array $value
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setAuthor($value)
     {
         $this->_author = $value;
         return $this;
     }
 
     /**
      * Returns the array of categories that classify this feed/entry.  Each
      * category is represented in an atom feed by an atom:category element.
      *
      * @return array Array of Zend_Gdata_App_Extension_Category
      */
     public function getCategory()
     {
         return $this->_category;
     }
 
     /**
      * Sets the array of categories that classify this feed/entry.  Each
      * category is represented in an atom feed by an atom:category element.
      *
      * @param array $value Array of Zend_Gdata_App_Extension_Category
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setCategory($value)
     {
         $this->_category = $value;
         return $this;
     }
 
     /**
      * Returns the array of contributors to this feed/entry.  Each contributor
      * is represented in an atom feed by an atom:contributor XML element
      *
      * @return array An array of Zend_Gdata_App_Extension_Contributor
      */
     public function getContributor()
     {
         return $this->_contributor;
     }
 
     /**
      * Sets the array of contributors to this feed/entry.  Each contributor
      * is represented in an atom feed by an atom:contributor XML element
      *
      * @param array $value
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setContributor($value)
     {
         $this->_contributor = $value;
         return $this;
     }
 
     /**
      * @return Zend_Gdata_App_Extension_Id
      */
     public function getId()
     {
         return $this->_id;
     }
 
     /**
      * @param Zend_Gdata_App_Extension_Id $value
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setId($value)
     {
         $this->_id = $value;
         return $this;
     }
 
     /**
      * Given a particular 'rel' value, this method returns a matching
      * Zend_Gdata_App_Extension_Link element.  If the 'rel' value
      * is not provided, the full array of Zend_Gdata_App_Extension_Link
      * elements is returned.  In an atom feed, each link is represented
      * by an atom:link element.  The 'rel' value passed to this function
      * is the atom:link/@rel attribute.  Example rel values include 'self',
      * 'edit', and 'alternate'.
      *
      * @param string $rel The rel value of the link to be found.  If null,
      *     the array of Zend_Gdata_App_Extension_link elements is returned
      * @return mixed Either a single Zend_Gdata_App_Extension_link element,
      *     an array of the same or null is returned depending on the rel value
      *     supplied as the argument to this function
      */
     public function getLink($rel = null)
     {
         if ($rel == null) {
             return $this->_link;
         } else {
             foreach ($this->_link as $link) {
                 if ($link->rel == $rel) {
                     return $link;
                 }
             }
             return null;
         }
     }
 
     /**
      * Returns the Zend_Gdata_App_Extension_Link element which represents
      * the URL used to edit this resource.  This link is in the atom feed/entry
      * as an atom:link with a rel attribute value of 'edit'.
      *
      * @return Zend_Gdata_App_Extension_Link The link, or null if not found
      */
     public function getEditLink()
     {
         return $this->getLink('edit');
     }
 
     /**
      * Returns the Zend_Gdata_App_Extension_Link element which represents
      * the URL used to retrieve the next chunk of results when paging through
      * a feed.  This link is in the atom feed as an atom:link with a
      * rel attribute value of 'next'.
      *
      * @return Zend_Gdata_App_Extension_Link The link, or null if not found
      */
     public function getNextLink()
     {
         return $this->getLink('next');
     }
 
     /**
      * Returns the Zend_Gdata_App_Extension_Link element which represents
      * the URL used to retrieve the previous chunk of results when paging
      * through a feed.  This link is in the atom feed as an atom:link with a
      * rel attribute value of 'previous'.
      *
      * @return Zend_Gdata_App_Extension_Link The link, or null if not found
      */
     public function getPreviousLink()
     {
         return $this->getLink('previous');
     }
 
     /**
      * @return Zend_Gdata_App_Extension_Link
      */
     public function getLicenseLink()
     {
         return $this->getLink('license');
     }
 
     /**
      * Returns the Zend_Gdata_App_Extension_Link element which represents
      * the URL used to retrieve the entry or feed represented by this object
      * This link is in the atom feed/entry as an atom:link with a
      * rel attribute value of 'self'.
      *
      * @return Zend_Gdata_App_Extension_Link The link, or null if not found
      */
     public function getSelfLink()
     {
         return $this->getLink('self');
     }
 
     /**
      * Returns the Zend_Gdata_App_Extension_Link element which represents
      * the URL for an alternate view of the data represented by this feed or
      * entry.  This alternate view is commonly a user-facing webpage, blog
      * post, etc.  The MIME type for the data at the URL is available from the
      * returned Zend_Gdata_App_Extension_Link element.
      * This link is in the atom feed/entry as an atom:link with a
      * rel attribute value of 'self'.
      *
      * @return Zend_Gdata_App_Extension_Link The link, or null if not found
      */
     public function getAlternateLink()
     {
         return $this->getLink('alternate');
     }
 
     /**
      * @param array $value The array of Zend_Gdata_App_Extension_Link elements
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setLink($value)
     {
         $this->_link = $value;
         return $this;
     }
 
     /**
      * @return Zend_Gdata_AppExtension_Rights
      */
     public function getRights()
     {
         return $this->_rights;
     }
 
     /**
      * @param Zend_Gdata_App_Extension_Rights $value
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setRights($value)
     {
         $this->_rights = $value;
         return $this;
     }
 
     /**
      * Returns the title of this feed or entry.  The title is an extremely
      * short textual representation of this resource and is found as
      * an atom:title element in a feed or entry
      *
      * @return Zend_Gdata_App_Extension_Title
      */
     public function getTitle()
     {
         return $this->_title;
     }
 
     /**
      * Returns a string representation of the title of this feed or entry.
      * The title is an extremely short textual representation of this
      * resource and is found as an atom:title element in a feed or entry
      *
      * @return string
      */
     public function getTitleValue()
     {
         if (($titleObj = $this->getTitle()) != null) {
             return $titleObj->getText();
         } else {
             return null;
         }
     }
 
     /**
      * Returns the title of this feed or entry.  The title is an extremely
      * short textual representation of this resource and is found as
      * an atom:title element in a feed or entry
      *
      * @param Zend_Gdata_App_Extension_Title $value
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setTitle($value)
     {
         $this->_title = $value;
         return $this;
     }
 
     /**
      * @return Zend_Gdata_App_Extension_Updated
      */
     public function getUpdated()
     {
         return $this->_updated;
     }
 
     /**
      * @param Zend_Gdata_App_Extension_Updated $value
      * @return Zend_Gdata_App_FeedEntryParent Provides a fluent interface
      */
     public function setUpdated($value)
     {
         $this->_updated = $value;
         return $this;
     }
 
     /**
      * Set the Etag for the current entry to $value. Setting $value to null
      * unsets the Etag.
      *
      * @param string|null $value
      * @return Zend_Gdata_App_Entry Provides a fluent interface
      */
     public function setEtag($value) {
         $this->_etag = $value;
         return $this;
     }
 
     /**
      * Return the Etag for the current entry, or null if not set.
      *
      * @return string|null
      */
     public function getEtag() {
         return $this->_etag;
     }
 
     /**
      * Set the major protocol version that should be used. Values < 1
      * (excluding NULL) will cause a Zend_Gdata_App_InvalidArgumentException
      * to be thrown.
      *
      * @see _majorProtocolVersion
      * @param (int|NULL) $value The major protocol version to use.
      * @throws Zend_Gdata_App_InvalidArgumentException
      */
     public function setMajorProtocolVersion($value)
     {
         if (!($value >= 1) && ($value !== null)) {
             // require_once('Zend/Gdata/App/InvalidArgumentException.php');
             throw new Zend_Gdata_App_InvalidArgumentException(
                     'Major protocol version must be >= 1');
         }
         $this->_majorProtocolVersion = $value;
     }
 
     /**
      * Get the major protocol version that is in use.
      *
      * @see _majorProtocolVersion
      * @return (int|NULL) The major protocol version in use.
      */
     public function getMajorProtocolVersion()
     {
         return $this->_majorProtocolVersion;
     }
 
     /**
      * Set the minor protocol version that should be used. If set to NULL, no
      * minor protocol version will be sent to the server. Values < 0 will
      * cause a Zend_Gdata_App_InvalidArgumentException to be thrown.
      *
      * @see _minorProtocolVersion
      * @param (int|NULL) $value The minor protocol version to use.
      * @throws Zend_Gdata_App_InvalidArgumentException
      */
     public function setMinorProtocolVersion($value)
     {
         if (!($value >= 0)) {
             // require_once('Zend/Gdata/App/InvalidArgumentException.php');
             throw new Zend_Gdata_App_InvalidArgumentException(
                     'Minor protocol version must be >= 0 or null');
         }
         $this->_minorProtocolVersion = $value;
     }
 
     /**
      * Get the minor protocol version that is in use.
      *
      * @see _minorProtocolVersion
      * @return (int|NULL) The major protocol version in use, or NULL if no
      *         minor version is specified.
      */
     public function getMinorProtocolVersion()
     {
         return $this->_minorProtocolVersion;
     }
 
     /**
      * Get the full version of a namespace prefix
      *
      * Looks up a prefix (atom:, etc.) in the list of registered
      * namespaces and returns the full namespace URI if
      * available. Returns the prefix, unmodified, if it's not
      * registered.
      *
      * The current entry or feed's version will be used when performing the
      * namespace lookup unless overridden using $majorVersion and
      * $minorVersion. If the entry/fee has a null version, then the latest
      * protocol version will be used by default.
      *
      * @param string $prefix The namespace prefix to lookup.
      * @param integer $majorVersion The major protocol version in effect.
      *        Defaults to null (auto-select).
      * @param integer $minorVersion The minor protocol version in effect.
      *        Defaults to null (auto-select).
      * @return string
      */
     public function lookupNamespace($prefix,
                                     $majorVersion = null,
                                     $minorVersion = null)
     {
         // Auto-select current version
         if ($majorVersion === null) {
             $majorVersion = $this->getMajorProtocolVersion();
         }
         if ($minorVersion === null) {
             $minorVersion = $this->getMinorProtocolVersion();
         }
 
         // Perform lookup
         return parent::lookupNamespace($prefix, $majorVersion, $minorVersion);
     }
 
 }