Gdata/App/MediaEntry.php
inherited
+ Classes
+ 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 + +
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com) + +
- License
- New BSD License + +
- Package
- Zend_Gdata + +
- Subpackage
- App + +
- Version
- $Id: MediaEntry.php 24593 2012-01-05 20:35:02Z matthew $ + +
\Zend_Gdata_App_MediaEntry
- Parent(s)
- \Zend_Gdata_App_Entry + < + \Zend_Gdata_App_FeedEntryParent + < + \Zend_Gdata_App_Base
- Children
- \Zend_Gdata_Entry
- Category
- Zend + +
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com) + +
- License
- New BSD License + +
Properties
$_author = array()array()Details- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_author + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_author + +
$_category = array()array()Details- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_category + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_category + +
\Zend_Gdata_App_Extension_Content $_content = nullnullDetails- Type
- \Zend_Gdata_App_Extension_Content
- Inherited_from
- \Zend_Gdata_App_Entry::$$_content + +
$_contributor = array()array()Details- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_contributor + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_contributor + +
\Zend_Gdata_App_Extension_Control $_control = nullnullDetails- Type
- \Zend_Gdata_App_Extension_Control
- Inherited_from
- \Zend_Gdata_App_Entry::$$_control + +
\Zend_Gdata_App_Extension_Edited $_edited = nullnullDetails- Type
- \Zend_Gdata_App_Extension_Edited
- Inherited_from
- \Zend_Gdata_App_Entry::$$_edited + +
string $_entryClassName = 'Zend_Gdata_App_Entry''Zend_Gdata_App_Entry'Details- Type
- string
- Inherited_from
- \Zend_Gdata_App_Entry::$$_entryClassName + +
string|null $_etag = NULLUsed for optimistic +concurrency in protoco v2 or greater.
NULLDetails- Type
- string | null
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_etag + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_etag + +
array $_extensionAttributes = array()Leftover attributes which were not handled
array()Details- Type
- array
- Inherited_from
- \Zend_Gdata_App_Base::$$_extensionAttributes + +
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_extensionAttributes + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_extensionAttributes + +
array $_extensionElements = array()Leftover elements which were not handled
array()Details- Type
- array
- Inherited_from
- \Zend_Gdata_App_Base::$$_extensionElements + +
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_extensionElements + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_extensionElements + +
$_id = nullnullDetails- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_id + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_id + +
$_link = array()array()Details- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_link + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_link + +
$_majorProtocolVersion = 1At present, recognized values are either 1 or 2. However, any integer +value >= 1 is considered valid.
1Details- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_majorProtocolVersion + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_majorProtocolVersion + +
- See
- \setMajorProtocolVersion() + +
- See
- \getMajorProtocolVersion() + +
\Zend_Gdata_App_MediaSource $_mediaSource = nullnullDetails$_minorProtocolVersion = nullCan be set +to either an integer >= 0, or NULL if no minor version should be sent +to the server.
nullDetails- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_minorProtocolVersion + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_minorProtocolVersion + +
- See
- \setMinorProtocolVersion() + +
- See
- \getMinorProtocolVersion() + +
array $_namespaceLookupCache = array()Memoized results from calls to lookupNamespace() to avoid expensive calls to getGreatestBoundedValue(). The key is in the form 'prefix-majorVersion-minorVersion', and the value is the output from getGreatestBoundedValue().
+array()Details- Type
- array
- Inherited_from
- \Zend_Gdata_App_Base::$$_namespaceLookupCache + +
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_namespaceLookupCache + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_namespaceLookupCache + +
array $_namespaces = array('atom' => array(1 => array(0 => 'http://www.w3.org/2005/Atom')), 'app' => array(1 => array(0 => 'http://purl.org/atom/app#'), 2 => array(0 => 'http://www.w3.org/2007/app')))The first dimension +represents the namespace prefix, the second dimension represents the +minimum major protocol version, and the third dimension is the minimum +minor protocol version. Null keys are NOT allowed.
+ +When looking up a namespace for a given prefix, the greatest version +number (both major and minor) which is less than the effective version +should be used.
array('atom' => array(1 => array(0 => 'http://www.w3.org/2005/Atom')), 'app' => array(1 => array(0 => 'http://purl.org/atom/app#'), 2 => array(0 => 'http://www.w3.org/2007/app')))Details- Type
- array
- Inherited_from
- \Zend_Gdata_App_Base::$$_namespaces + +
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_namespaces + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_namespaces + +
- See
- \lookupNamespace() + +
- See
- \registerNamespace() + +
- See
- \registerAllNamespaces() + +
\Zend_Gdata_App_Extension_Published $_published = nullnullDetails- Type
- \Zend_Gdata_App_Extension_Published
- Inherited_from
- \Zend_Gdata_App_Entry::$$_published + +
$_rights = nullnullDetails- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_rights + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_rights + +
string $_rootElement = 'entry''entry'Details- Type
- string
- Inherited_from
- \Zend_Gdata_App_Entry::$$_rootElement + +
string $_rootNamespace = 'atom'The XML namespace prefix
'atom'Details- Type
- string
- Inherited_from
- \Zend_Gdata_App_Base::$$_rootNamespace + +
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_rootNamespace + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_rootNamespace + +
string $_rootNamespaceURI = nullThe XML namespace URI - takes precedence over lookup up the corresponding URI for $_rootNamespace
+nullDetails- Type
- string
- Inherited_from
- \Zend_Gdata_App_Base::$$_rootNamespaceURI + +
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_rootNamespaceURI + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_rootNamespaceURI + +
$_service = nullnullDetails- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_service + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_service + +
- See
- getService() + +
\Zend_Gdata_App_Extension_Source $_source = nullnullDetails- Type
- \Zend_Gdata_App_Extension_Source
- Inherited_from
- \Zend_Gdata_App_Entry::$$_source + +
\Zend_Gdata_App_Extension_Summary $_summary = nullnullDetails- Type
- \Zend_Gdata_App_Extension_Summary
- Inherited_from
- \Zend_Gdata_App_Entry::$$_summary + +
string $_text = nullXML child text node content
nullDetails- Type
- string
- Inherited_from
- \Zend_Gdata_App_Base::$$_text + +
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_text + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_text + +
$_title = nullnullDetails- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_title + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_title + +
$_updated = nullnullDetails- Type
- n/a
- Inherited_from
- \Zend_Gdata_App_FeedEntryParent::$$_updated + +
- Inherited_from
- \Zend_Gdata_App_Entry::$$_updated + +
Methods
__construct(\DOMElement $element = null, $mediaSource = null) : voidConstructs a new MediaEntry, representing XML data and optional +file to upload
| Name | Type | Description |
|---|---|---|
| $element | \DOMElement | (optional) DOMElement from which this + object should be constructed. + |
| $mediaSource |
__get(string $name) : voidMagic getter to allow access like $entry->foo to call $entry->getFoo() +Alternatively, if no getFoo() is defined, but a $_foo protected variable +is defined, this is returned.
Inherited from: + \Zend_Gdata_App_Base::__get()\Zend_Gdata_App_FeedEntryParent::__get()\Zend_Gdata_App_Entry::__get()TODO Remove ability to bypass getFoo() methods??
| Name | Type | Description |
|---|---|---|
| $name | string | The variable name sought |
__isset(string $name) : voidMagic __isset method
Inherited from: + \Zend_Gdata_App_Base::__isset()\Zend_Gdata_App_FeedEntryParent::__isset()\Zend_Gdata_App_Entry::__isset()| Name | Type | Description |
|---|---|---|
| $name | string |
__set(string $name, $val) : voidMagic setter to allow acces like $entry->foo='bar' to call +$entry->setFoo('bar') automatically.
Inherited from: + \Zend_Gdata_App_Base::__set()\Zend_Gdata_App_FeedEntryParent::__set()\Zend_Gdata_App_Entry::__set()Alternatively, if no setFoo() is defined, but a $_foo protected variable +is defined, this is returned.
+ +TODO Remove ability to bypass getFoo() methods??
| Name | Type | Description |
|---|---|---|
| $name | string | |
| $val |
__toString() : stringMagic toString method allows using this directly via echo +Works best in PHP >= 4.2.0
Inherited from: + \Zend_Gdata_App_Base::__toString()\Zend_Gdata_App_FeedEntryParent::__toString()\Zend_Gdata_App_Entry::__toString()| Type | Description |
|---|---|
| string | The text representation of this object |
__unset(string $name) : voidMagic __unset method
Inherited from: + \Zend_Gdata_App_Base::__unset()\Zend_Gdata_App_FeedEntryParent::__unset()\Zend_Gdata_App_Entry::__unset()| Name | Type | Description |
|---|---|---|
| $name | string |
delete() : voidDeletes 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.
Inherited from: + \Zend_Gdata_App_Entry::delete()| Exception | Description |
|---|---|
| \Zend_Gdata_App_Exception |
encode() : string | \Zend_Gdata_MediaMimeStreamReturn the MIME multipart representation of this MediaEntry.
Can be overridden by children to provide more complex representations +of entries.
| Type | Description |
|---|---|
| string | \Zend_Gdata_MediaMimeStream | The MIME multipart + representation of this MediaEntry. If the entry consisted only + of XML, a string is returned. |
flushNamespaceLookupCache() : voidFlush namespace lookup cache.
Inherited from: + \Zend_Gdata_App_Base::flushNamespaceLookupCache()\Zend_Gdata_App_FeedEntryParent::flushNamespaceLookupCache()\Zend_Gdata_App_Entry::flushNamespaceLookupCache()Empties the namespace lookup cache. Call this function if you have +added data to the namespace lookup table that contradicts values that +may have been cached during a previous call to lookupNamespace().
getAlternateLink() : \Zend_Gdata_App_Extension_LinkReturns the Zend_Gdata_App_Extension_Link element which represents +the URL for an alternate view of the data represented by this feed or +entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getAlternateLink()\Zend_Gdata_App_Entry::getAlternateLink()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'.
| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Link | The link, or null if not found |
getAuthor() : \Zend_Gdata_App_Extension_Author| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Author |
getCategory() : arrayReturns the array of categories that classify this feed/entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getCategory()\Zend_Gdata_App_Entry::getCategory()Each +category is represented in an atom feed by an atom:category element.
| Type | Description |
|---|---|
| array | Array of Zend_Gdata_App_Extension_Category |
getContent() : \Zend_Gdata_App_Extension_ContentGets the value of the atom:content element
Inherited from: + \Zend_Gdata_App_Entry::getContent()| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Content |
getContributor() : arrayReturns the array of contributors to this feed/entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getContributor()\Zend_Gdata_App_Entry::getContributor()Each contributor +is represented in an atom feed by an atom:contributor XML element
| Type | Description |
|---|---|
| array | An array of Zend_Gdata_App_Extension_Contributor |
getControl() : \Zend_Gdata_App_Extension_ControlGets the value of the app:control element
Inherited from: + \Zend_Gdata_App_Entry::getControl()| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Control |
getDOM(\DOMDocument $doc = null, $majorVersion = 1, $minorVersion = null) : \DOMElementRetrieves a DOMElement which corresponds to this element and all +child properties.
Inherited from: + \Zend_Gdata_App_Entry::getDOM()This is used to build an entry back into a DOM +and eventually XML text for sending to the server upon updates, or +for application storage/persistence.
| Name | Type | Description |
|---|---|---|
| $doc | \DOMDocument | The DOMDocument used to construct DOMElements |
| $majorVersion | ||
| $minorVersion |
| Type | Description |
|---|---|
| \DOMElement | The DOMElement representing this element and all +child properties. |
getEditLink() : \Zend_Gdata_App_Extension_LinkReturns the Zend_Gdata_App_Extension_Link element which represents +the URL used to edit this resource.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getEditLink()\Zend_Gdata_App_Entry::getEditLink()This link is in the atom feed/entry +as an atom:link with a rel attribute value of 'edit'.
| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Link | The link, or null if not found |
getEtag() : string | nullReturn the Etag for the current entry, or null if not set.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getEtag()\Zend_Gdata_App_Entry::getEtag()| Type | Description |
|---|---|
| string | null |
getExtensionAttributes() : arrayReturns an array of all extension attributes not transformed into data +model properties during parsing of the XML.
Inherited from: + \Zend_Gdata_App_Base::getExtensionAttributes()\Zend_Gdata_App_FeedEntryParent::getExtensionAttributes()\Zend_Gdata_App_Entry::getExtensionAttributes()Each element of the array +is a hashed array of the format: + array('namespaceUri' => string, 'name' => string, 'value' => string);
| Type | Description |
|---|---|
| array | All extension attributes |
getExtensionElements() : arrayReturns an array of all elements not matched to data model classes +during the parsing of the XML
Inherited from: + \Zend_Gdata_App_Base::getExtensionElements()\Zend_Gdata_App_FeedEntryParent::getExtensionElements()\Zend_Gdata_App_Entry::getExtensionElements()| Type | Description |
|---|---|
| array | All elements not matched to data model classes during parsing |
getHttpClient() : \Zend_Http_Client_AbstractGets the HTTP client object.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getHttpClient()\Zend_Gdata_App_Entry::getHttpClient()If none is set, a new Zend_Http_Client +will be used.
| Type | Description |
|---|---|
| \Zend_Http_Client_Abstract |
getLicenseLink() : \Zend_Gdata_App_Extension_Link| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Link |
getLink(string $rel = null) : mixedGiven a particular 'rel' value, this method returns a matching +Zend_Gdata_App_Extension_Link element.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getLink()\Zend_Gdata_App_Entry::getLink()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'.
| Name | Type | Description |
|---|---|---|
| $rel | string | The rel value of the link to be found. If null, + the array of Zend_Gdata_App_Extension_link elements is returned |
| Type | Description |
|---|---|
| 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 |
getMajorProtocolVersion() : \(int | \NULL)Get the major protocol version that is in use.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getMajorProtocolVersion()\Zend_Gdata_App_Entry::getMajorProtocolVersion()| Type | Description |
|---|---|
| \(int | \NULL) | The major protocol version in use. |
- See
- \_majorProtocolVersion + +
getMediaSource() : \Zend_Gdata_App_MediaSourceReturn the MediaSource object representing the file attached to this +MediaEntry.
| Type | Description |
|---|---|
| \Zend_Gdata_App_MediaSource | The attached MediaSource/file |
getMinorProtocolVersion() : \(int | \NULL)Get the minor protocol version that is in use.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getMinorProtocolVersion()\Zend_Gdata_App_Entry::getMinorProtocolVersion()| Type | Description |
|---|---|
| \(int | \NULL) | The major protocol version in use, or NULL if no + minor version is specified. |
- See
- \_minorProtocolVersion + +
getNextLink() : \Zend_Gdata_App_Extension_LinkReturns the Zend_Gdata_App_Extension_Link element which represents +the URL used to retrieve the next chunk of results when paging through +a feed.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getNextLink()\Zend_Gdata_App_Entry::getNextLink()This link is in the atom feed as an atom:link with a +rel attribute value of 'next'.
| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Link | The link, or null if not found |
getPreviousLink() : \Zend_Gdata_App_Extension_LinkReturns the Zend_Gdata_App_Extension_Link element which represents +the URL used to retrieve the previous chunk of results when paging +through a feed.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getPreviousLink()\Zend_Gdata_App_Entry::getPreviousLink()This link is in the atom feed as an atom:link with a +rel attribute value of 'previous'.
| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Link | The link, or null if not found |
getPublished() : \Zend_Gdata_App_Extension_PublishedSets the value of the atom:published element +This represents the publishing date for an entry
Inherited from: + \Zend_Gdata_App_Entry::getPublished()| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Published |
getRights() : \Zend_Gdata_AppExtension_Rights| Type | Description |
|---|---|
| \Zend_Gdata_AppExtension_Rights |
getSelfLink() : \Zend_Gdata_App_Extension_LinkReturns 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'.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getSelfLink()\Zend_Gdata_App_Entry::getSelfLink()| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Link | The link, or null if not found |
getService() : \Zend_Gdata_App | nullGet the active service instance for this object.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getService()\Zend_Gdata_App_Entry::getService()This will be used to +perform network requests, such as when calling save() and delete().
| Type | Description |
|---|---|
| \Zend_Gdata_App | null | The current service instance, or null if + not set. |
getSource() : \Zend_Gdata_App_Extension_SourceGets the value of the atom:source element
Inherited from: + \Zend_Gdata_App_Entry::getSource()| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Source |
getSummary() : \Zend_Gdata_App_Extension_SummaryGets the value of the atom:summary element +This represents a textual summary of this entry's content
Inherited from: + \Zend_Gdata_App_Entry::getSummary()| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Summary |
getText( $trim = true) : stringReturns the child text node of this element +This represents any raw text contained within the XML element
Inherited from: + \Zend_Gdata_App_Base::getText()\Zend_Gdata_App_FeedEntryParent::getText()\Zend_Gdata_App_Entry::getText()| Name | Type | Description |
|---|---|---|
| $trim |
| Type | Description |
|---|---|
| string | Child text node |
getTitle() : \Zend_Gdata_App_Extension_TitleReturns the title of this feed or entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getTitle()\Zend_Gdata_App_Entry::getTitle()The title is an extremely +short textual representation of this resource and is found as +an atom:title element in a feed or entry
| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Title |
getTitleValue() : stringReturns a string representation of the title of this feed or entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::getTitleValue()\Zend_Gdata_App_Entry::getTitleValue()The title is an extremely short textual representation of this +resource and is found as an atom:title element in a feed or entry
| Type | Description |
|---|---|
| string |
getUpdated() : \Zend_Gdata_App_Extension_Updated| Type | Description |
|---|---|
| \Zend_Gdata_App_Extension_Updated |
getXML() : stringAlias for saveXML() returns XML content for this element and all +children
Inherited from: + \Zend_Gdata_App_Base::getXML()\Zend_Gdata_App_FeedEntryParent::getXML()\Zend_Gdata_App_Entry::getXML()| Type | Description |
|---|---|
| string | XML content |
lookupNamespace(string $prefix, integer $majorVersion = null, integer $minorVersion = null) : stringGet the full version of a namespace prefix
Inherited from: + \Zend_Gdata_App_FeedEntryParent::lookupNamespace()\Zend_Gdata_App_Entry::lookupNamespace()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.
| Name | Type | Description |
|---|---|---|
| $prefix | string | The namespace prefix to lookup. |
| $majorVersion | integer | The major protocol version in effect. + Defaults to null (auto-select). + |
| $minorVersion | integer | The minor protocol version in effect. + Defaults to null (auto-select). + |
| Type | Description |
|---|---|
| string |
registerAllNamespaces(array $namespaceArray) : voidAdd an array of namespaces to the registered list.
Inherited from: + \Zend_Gdata_App_Base::registerAllNamespaces()\Zend_Gdata_App_FeedEntryParent::registerAllNamespaces()\Zend_Gdata_App_Entry::registerAllNamespaces()Takes an array in the format of: +namespace prefix, namespace URI, major protocol version, +minor protocol version and adds them with calls to ->registerNamespace()
| Name | Type | Description |
|---|---|---|
| $namespaceArray | array | An array of namespaces. |
registerNamespace(string $prefix, string $namespaceUri, integer $majorVersion = 1, integer $minorVersion = 0) : voidAdd a namespace and prefix to the registered list
Inherited from: + \Zend_Gdata_App_Base::registerNamespace()\Zend_Gdata_App_FeedEntryParent::registerNamespace()\Zend_Gdata_App_Entry::registerNamespace()Takes a prefix and a full namespace URI and adds them to the +list of registered namespaces for use by +$this->lookupNamespace().
+ +WARNING: Currently, registering a namespace will NOT invalidate any + memoized data stored in $_namespaceLookupCache. Under normal + use, this behavior is acceptable. If you are adding + contradictory data to the namespace lookup table, you must + call flushNamespaceLookupCache().
| Name | Type | Description |
|---|---|---|
| $prefix | string | The namespace prefix |
| $namespaceUri | string | The full namespace URI |
| $majorVersion | integer | The major protocol version in effect. + Defaults to '1'. + |
| $minorVersion | integer | The minor protocol version in effect. + Defaults to null (use latest). + |
reload(string | null $uri = null, string | null $className = null, array $extraHeaders = array()) : mixedReturns a new copy of the entry as returned +by the server, or null if no changes exist. This does not +modify the current entry instance.
| Name | Type | Description |
|---|---|---|
| $uri | string | null | The URI to send requests to, or null if $data + contains the URI. + |
| $className | string | null | The name of the class that should we deserializing + the server response. If null, then 'Zend_Gdata_App_Entry' will + be used. + |
| $extraHeaders | array | Extra headers to add to the request, as an + array of string-based key/value pairs. + |
| Type | Description |
|---|---|
| mixed | A new instance of the current entry with updated data, or + null if the server reports that no changes have been made. |
| Exception | Description |
|---|---|
| \Zend_Gdata_App_Exception |
save(string | null $uri = null, string | null $className = null, array $extraHeaders = array()) : \Zend_Gdata_App_EntryUploads changes in this entry to the server using Zend_Gdata_App
Inherited from: + \Zend_Gdata_App_Entry::save()| Name | Type | Description |
|---|---|---|
| $uri | string | null | The URI to send requests to, or null if $data + contains the URI. + |
| $className | string | null | The name of the class that should we + deserializing the server response. If null, then + 'Zend_Gdata_App_Entry' will be used. + |
| $extraHeaders | array | Extra headers to add to the request, as an + array of string-based key/value pairs. + |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Entry | The updated entry. |
| Exception | Description |
|---|---|
| \Zend_Gdata_App_Exception |
saveXML() : stringConverts this element and all children into XML text using getDOM()
Inherited from: + \Zend_Gdata_App_Base::saveXML()\Zend_Gdata_App_FeedEntryParent::saveXML()\Zend_Gdata_App_Entry::saveXML()| Type | Description |
|---|---|
| string | XML content |
setAuthor(array $value) : \Zend_Gdata_App_FeedEntryParentSets the list of the authors of this feed/entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setAuthor()\Zend_Gdata_App_Entry::setAuthor()In an atom feed, each +author is represented by an atom:author element
| Name | Type | Description |
|---|---|---|
| $value | array |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
setCategory(array $value) : \Zend_Gdata_App_FeedEntryParentSets the array of categories that classify this feed/entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setCategory()\Zend_Gdata_App_Entry::setCategory()Each +category is represented in an atom feed by an atom:category element.
| Name | Type | Description |
|---|---|---|
| $value | array | Array of Zend_Gdata_App_Extension_Category |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
setContent(\Zend_Gdata_App_Extension_Content $value) : \Zend_Gdata_App_EntrySets the value of the atom:content element
Inherited from: + \Zend_Gdata_App_Entry::setContent()| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Content |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Entry | Provides a fluent interface |
setContributor(array $value) : \Zend_Gdata_App_FeedEntryParentSets the array of contributors to this feed/entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setContributor()\Zend_Gdata_App_Entry::setContributor()Each contributor +is represented in an atom feed by an atom:contributor XML element
| Name | Type | Description |
|---|---|---|
| $value | array |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
setControl(\Zend_Gdata_App_Extension_Control $value) : \Zend_Gdata_App_EntrySets the value of the app:control element
Inherited from: + \Zend_Gdata_App_Entry::setControl()| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Control |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Entry | Provides a fluent interface |
setEtag(string | null $value) : \Zend_Gdata_App_EntrySet the Etag for the current entry to $value.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setEtag()\Zend_Gdata_App_Entry::setEtag()Setting $value to null +unsets the Etag.
| Name | Type | Description |
|---|---|---|
| $value | string | null |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Entry | Provides a fluent interface |
setExtensionAttributes(array $value) : \Zend_Gdata_App_BaseSets an array of all extension attributes not transformed into data +model properties during parsing of the XML.
Inherited from: + \Zend_Gdata_App_Base::setExtensionAttributes()\Zend_Gdata_App_FeedEntryParent::setExtensionAttributes()\Zend_Gdata_App_Entry::setExtensionAttributes()Each element of the array +is a hashed array of the format: + array('namespaceUri' => string, 'name' => string, 'value' => string); +This can be used to add arbitrary attributes to any data model element
| Name | Type | Description |
|---|---|---|
| $value | array | All extension attributes |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Base | Returns an object of the same type as 'this' to provide a fluent interface. |
setExtensionElements(array $value) : \Zend_Gdata_App_BaseSets an array of all elements not matched to data model classes +during the parsing of the XML.
Inherited from: + \Zend_Gdata_App_Base::setExtensionElements()\Zend_Gdata_App_FeedEntryParent::setExtensionElements()\Zend_Gdata_App_Entry::setExtensionElements()This method can be used to add arbitrary +child XML elements to any data model class.
| Name | Type | Description |
|---|---|---|
| $value | array | All extension elements |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Base | Returns an object of the same type as 'this' to provide a fluent interface. |
setHttpClient(\Zend_Http_Client $httpClient) : \Zend_Gdata_App_FeedEntryParentSet the HTTP client instance
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setHttpClient()\Zend_Gdata_App_Entry::setHttpClient()Sets the HTTP client object to use for retrieving the feed.
| Name | Type | Description |
|---|---|---|
| $httpClient | \Zend_Http_Client |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
setId(\Zend_Gdata_App_Extension_Id $value) : \Zend_Gdata_App_FeedEntryParent| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Id |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
setLink(array $value) : \Zend_Gdata_App_FeedEntryParent| Name | Type | Description |
|---|---|---|
| $value | array | The array of Zend_Gdata_App_Extension_Link elements |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
setMajorProtocolVersion(\(int | \NULL) $value) : voidSet the major protocol version that should be used.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setMajorProtocolVersion()\Zend_Gdata_App_Entry::setMajorProtocolVersion()Values < 1 +(excluding NULL) will cause a Zend_Gdata_App_InvalidArgumentException +to be thrown.
| Name | Type | Description |
|---|---|---|
| $value | \(int | \NULL) | The major protocol version to use. |
| Exception | Description |
|---|---|
| \Zend_Gdata_App_InvalidArgumentException |
- See
- \_majorProtocolVersion + +
setMediaSource(\Zend_Gdata_App_MediaSource $value) : \Zend_Gdata_App_MediaEntrySet the MediaSource object (file) for this MediaEntry
| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_MediaSource | The attached MediaSource/file + |
| Type | Description |
|---|---|
| \Zend_Gdata_App_MediaEntry | Provides a fluent interface |
setMinorProtocolVersion(\(int | \NULL) $value) : voidSet the minor protocol version that should be used.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setMinorProtocolVersion()\Zend_Gdata_App_Entry::setMinorProtocolVersion()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.
| Name | Type | Description |
|---|---|---|
| $value | \(int | \NULL) | The minor protocol version to use. |
| Exception | Description |
|---|---|
| \Zend_Gdata_App_InvalidArgumentException |
- See
- \_minorProtocolVersion + +
setPublished(\Zend_Gdata_App_Extension_Published $value) : \Zend_Gdata_App_EntrySets the value of the atom:published element +This represents the publishing date for an entry
Inherited from: + \Zend_Gdata_App_Entry::setPublished()| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Published |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Entry | Provides a fluent interface |
setRights(\Zend_Gdata_App_Extension_Rights $value) : \Zend_Gdata_App_FeedEntryParent| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Rights |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
setService(\Zend_Gdata_App $instance) : \Zend_Gdata_App_FeedEntryParentSet the active service instance for this object.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setService()\Zend_Gdata_App_Entry::setService()This will be used to +perform network requests, such as when calling save() and delete().
| Name | Type | Description |
|---|---|---|
| $instance | \Zend_Gdata_App | The new service instance. |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface. |
setSource(\Zend_Gdata_App_Extension_Source $value) : \Zend_Gdata_App_EntrySets the value of the atom:source element
Inherited from: + \Zend_Gdata_App_Entry::setSource()| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Source |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Entry | Provides a fluent interface |
setSummary(\Zend_Gdata_App_Extension_Summary $value) : \Zend_Gdata_App_EntrySets the value of the atom:summary element +This represents a textual summary of this entry's content
Inherited from: + \Zend_Gdata_App_Entry::setSummary()| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Summary |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Entry | Provides a fluent interface |
setText(string $value) : \Zend_Gdata_App_BaseSets the child text node of this element +This represents any raw text contained within the XML element
Inherited from: + \Zend_Gdata_App_Base::setText()\Zend_Gdata_App_FeedEntryParent::setText()\Zend_Gdata_App_Entry::setText()| Name | Type | Description |
|---|---|---|
| $value | string | Child text node |
| Type | Description |
|---|---|
| \Zend_Gdata_App_Base | Returns an object of the same type as 'this' to provide a fluent interface. |
setTitle(\Zend_Gdata_App_Extension_Title $value) : \Zend_Gdata_App_FeedEntryParentReturns the title of this feed or entry.
Inherited from: + \Zend_Gdata_App_FeedEntryParent::setTitle()\Zend_Gdata_App_Entry::setTitle()The title is an extremely +short textual representation of this resource and is found as +an atom:title element in a feed or entry
| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Title |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
setUpdated(\Zend_Gdata_App_Extension_Updated $value) : \Zend_Gdata_App_FeedEntryParent| Name | Type | Description |
|---|---|---|
| $value | \Zend_Gdata_App_Extension_Updated |
| Type | Description |
|---|---|
| \Zend_Gdata_App_FeedEntryParent | Provides a fluent interface |
takeAttributeFromDOM(\DOMNode $attribute) : voidGiven a DOMNode representing an attribute, tries to map the data into +instance members.
Inherited from: + \Zend_Gdata_App_Base::takeAttributeFromDOM()\Zend_Gdata_App_FeedEntryParent::takeAttributeFromDOM()\Zend_Gdata_App_Entry::takeAttributeFromDOM()If no mapping is defined, the name and value are +stored in an array.
| Name | Type | Description |
|---|---|---|
| $attribute | \DOMNode | The DOMNode attribute needed to be handled |
takeChildFromDOM(\DOMNode $child) : voidGiven a child DOMNode, tries to determine how to map the data into +object instance members.
Inherited from: + \Zend_Gdata_App_Entry::takeChildFromDOM()If no mapping is defined, Extension_Element +objects are created and stored in an array.
| Name | Type | Description |
|---|---|---|
| $child | \DOMNode | The DOMNode needed to be handled |
transferFromDOM(\DOMNode $node) : voidTransfers each child and attribute into member variables.
Inherited from: + \Zend_Gdata_App_Base::transferFromDOM()\Zend_Gdata_App_FeedEntryParent::transferFromDOM()\Zend_Gdata_App_Entry::transferFromDOM()This is called when XML is received over the wire and the data +model needs to be built to represent this XML.
| Name | Type | Description |
|---|---|---|
| $node | \DOMNode | The DOMNode that represents this object's data + |
transferFromXML(string $xml) : voidParses the provided XML text and generates data model classes for +each know element by turning the XML text into a DOM tree and calling +transferFromDOM($element).
Inherited from: + \Zend_Gdata_App_Base::transferFromXML()\Zend_Gdata_App_FeedEntryParent::transferFromXML()\Zend_Gdata_App_Entry::transferFromXML()The first data model element with the same +name as $this->_rootElement is used and the child elements are +recursively parsed.
| Name | Type | Description |
|---|---|---|
| $xml | string | The XML text to parse |