Zend/Gdata/Exif/Entry.php

   1 <?php
   2
   3 /**
   4  * Zend Framework
   5  *
   6  * LICENSE
   7  *
   8  * This source file is subject to the new BSD license that is bundled
   9  * with this package in the file LICENSE.txt.
  10  * It is also available through the world-wide-web at this URL:
  11  * http://framework.zend.com/license/new-bsd
  12  * If you did not receive a copy of the license and are unable to
  13  * obtain it through the world-wide-web, please send an email
  14  * to license@zend.com so we can send you a copy immediately.
  15  *
  16  * @category   Zend
  17  * @package    Zend_Gdata
  18  * @subpackage Exif
  19  * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
  20  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  21
  22  */
  23
  24 /**
  25  * @see Zend_Gdata_Entry
  26  */
  27 require_once 'Zend/Gdata/Entry.php';
  28
  29 /**
  30  * @see Zend_Gdata_Exif
  31  */
  32 require_once 'Zend/Gdata/Exif.php';
  33
  34 /**
  35  * @see Zend_Gdata_Exif_Extension_Tags
  36  */
  37 require_once 'Zend/Gdata/Exif/Extension/Tags.php';
  38
  39 /**
  40  * An Atom entry containing EXIF metadata.
  41  *
  42  * @category   Zend
  43  * @package    Zend_Gdata
  44  * @subpackage Exif
  45  * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
  46  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  47  */
  48 class Zend_Gdata_Exif_Entry extends Zend_Gdata_Entry
  49 {
  50     /**
  51      * The classname for individual feed elements.
  52      *
  53      * @var string
  54      */
  55     protected $_entryClassName = 'Zend_Gdata_Exif_Entry';
  56
  57     /**
  58      * The tags that belong to the Exif group.
  59      *
  60      * @var string
  61      */
  62     protected $_tags = null;
  63
  64     /**
  65      * Create a new instance.
  66      *
  67      * @param DOMElement $element (optional) DOMElement from which this
  68      *          object should be constructed.
  69      */
  70     public function __construct($element = null)
  71     {
  72         $this->registerAllNamespaces(Zend_Gdata_Exif::$namespaces);
  73         parent::__construct($element);
  74     }
  75
  76     /**
  77      * Retrieves a DOMElement which corresponds to this element and all
  78      * child properties.  This is used to build an entry back into a DOM
  79      * and eventually XML text for sending to the server upon updates, or
  80      * for application storage/persistence.
  81      *
  82      * @param DOMDocument $doc The DOMDocument used to construct DOMElements
  83      * @return DOMElement The DOMElement representing this element and all
  84      * child properties.
  85      */
  86     public function getDOM($doc = null, $majorVersion = 1, $minorVersion = null)
  87     {
  88         $element = parent::getDOM($doc, $majorVersion, $minorVersion);
  89         if ($this->_tags != null) {
  90             $element->appendChild($this->_tags->getDOM($element->ownerDocument));
  91         }
  92         return $element;
  93     }
  94
  95     /**
  96      * Creates individual Entry objects of the appropriate type and
  97      * stores them as members of this entry based upon DOM data.
  98      *
  99      * @param DOMNode $child The DOMNode to process
 100      */
 101     protected function takeChildFromDOM($child)
 102     {
 103         $absoluteNodeName = $child->namespaceURI . ':' . $child->localName;
 104         switch ($absoluteNodeName) {
 105         case $this->lookupNamespace('exif') . ':' . 'tags':
 106             $tags = new Zend_Gdata_Exif_Extension_Tags();
 107             $tags->transferFromDOM($child);
 108             $this->_tags = $tags;
 109             break;
 110         default:
 111             parent::takeChildFromDOM($child);
 112             break;
 113         }
 114     }
 115
 116     /**
 117      * Retrieve the tags for this entry.
 118      *
 119      * @see setTags
 120      * @return Zend_Gdata_Exif_Extension_Tags The requested object
 121      *              or null if not set.
 122      */
 123     public function getTags()
 124     {
 125         return $this->_tags;
 126     }
 127
 128     /**
 129      * Set the tags property for this entry. This property contains
 130      * various Exif data.
 131      *
 132      * This corresponds to the <exif:tags> property in the Google Data
 133      * protocol.
 134      *
 135      * @param Zend_Gdata_Exif_Extension_Tags $value The desired value
 136      *              this element, or null to unset.
 137      * @return Zend_Gdata_Exif_Entry Provides a fluent interface
 138      */
 139     public function setTags($value)
 140     {
 141         $this->_tags = $value;
 142         return $this;
 143     }
 144
 145 }