public abstract class

MediaEntry

extends BaseEntry<E extends BaseEntry>
implements IMediaEntry

java.lang.Object
↳	com.google.gdata.data.AbstractExtension
	↳	com.google.gdata.data.ExtensionPoint
		↳	com.google.gdata.data.BaseEntry<E extends com.google.gdata.data.BaseEntry>
			↳	com.google.gdata.data.media.MediaEntry<E extends com.google.gdata.data.BaseEntry<E>>

Known Direct Subclasses

BaseContentEntry<E extends BaseContentEntry<E>>, CaptionTrackEntry, DocumentEntry, DocumentListEntry, GlossaryEntry, GoogleBaseMediaEntry, GphotoEntry<E extends GphotoEntry<E>>, MailItemEntry, MapEntry, TranslationMemoryEntry, VideoEntry

Known Indirect Subclasses

AlbumEntry, AnnouncementEntry, AnnouncementsPageEntry, AttachmentEntry, AudioEntry, BaseDocumentListEntry<E>, BasePageEntry<E extends BasePageEntry<E>>, BrixEntry, ChangelogEntry, CommentEntry, ContentEntry, DocumentEntry, DrawingEntry, FavoriteEntry, FileCabinetPageEntry, and 15 others.

Class Overview

The MediaEntry class is an abstract base class for GData services that support media content.

Summary

[Expand]

Inherited Fields

From class com.google.gdata.data.BaseEntry

From class com.google.gdata.data.ExtensionPoint

From class com.google.gdata.data.AbstractExtension

Protected Constructors
	MediaEntry() Constructs a new BaseEntry instance.
	MediaEntry(BaseEntry<?> sourceEntry) Copy constructor that initializes a new BaseEntry instance to have identical contents to another instance, using a shared reference to the same entry state.

Public Methods
Link	getMediaEditLink() Retrieves the media resource edit link.
MediaSource	getMediaSource() Returns the `MediaSource` that contains the media data for the entry.
void	setMediaSource(MediaSource mediaSource) Sets the `MediaSource` that contains the media data for the entry.
void	setService(Service v) Sets the service that this resource is being used with.
E	updateMedia(boolean updateEntry) Updates the media content associated with this entry by sending the data contained in the `MediaSource` of the entry to the associated GData service.

Protected Methods
Content.ChildHandlerInfo	getContentHandlerInfo(ExtensionProfile extProfile, Attributes attrs) Returns information about the content element processing.

[Expand]

Inherited Methods

From class com.google.gdata.data.BaseEntry

From class com.google.gdata.data.ExtensionPoint

From class com.google.gdata.data.AbstractExtension

From class java.lang.Object

From interface com.google.gdata.data.Extension

From interface com.google.gdata.data.IAtom

abstract ILink	addLink(String rel, String type, String href) Adds a link with the given rel, type, and href.
abstract List<? extends IPerson>	getAuthors() Returns the list of all authors on this resource.
abstract Set<? extends ICategory>	getCategories() Returns a set of categories on this resource.
abstract String	getEtag() Gets the value of the gd:etag attribute for this resource.
abstract String	getId() Get the unique id for this resource.
abstract String	getKind() Returns the value of the gd:kind attribute for this resource.
abstract ILink	getLink(String rel, String type) Returns a particular atom:link element with the given rel and type, or null if one was not found.
abstract List<? extends ILink>	getLinks() Returns a list of atom:link elements on this resource.
abstract ILink	getSelfLink() Returns the self link for the resource.
abstract ITextConstruct	getTitle() Returns the atom:title element of this resource.
abstract DateTime	getUpdated() Get a `DateTime` instance representing the last time this resource was updated.
abstract String	getVersionId() Version ID.
abstract void	removeLinks(String relToMatch, String typeToMatch) Remove all links that match the given `rel` and `type` values.
abstract void	removeLinks() Removes all links from the this resource.
abstract void	setEtag(String etag) Sets the value of the gd:etag attribute for this resource.
abstract void	setId(String id) Sets the unique id for this resource.
abstract void	setKind(String kind) Sets the value of the gd:kind attribute for this resource.
abstract void	setService(Service s) Sets the service that this resource is being used with.
abstract void	setUpdated(DateTime updated) Sets the last time this resource was updated.
abstract void	setVersionId(String versionId) Sets the versionId.

From interface com.google.gdata.data.IEntry

abstract boolean	getCanEdit() Returns `true` if the entry can be modified by a client.
abstract IContent	getContent() Gets the content of this entry.
abstract ILink	getEditLink() Gets the edit link, which is the link to PUT an updated version of the entry to.
abstract DateTime	getEdited() Get a `DateTime` instance representing the last time this entry was edited.
abstract ILink	getMediaEditLink() Gets the media-edit link, which is the link to PUT an updated version of the media content to.
abstract DateTime	getPublished() Get a `DateTime` instance representing the time that this entry was created.
abstract ILink	getResumableEditMediaLink() Gets the resumable-edit-media link, which is the link to PUT an updated version of the media content to using Resumable Upload IO.
abstract String	getSelectedFields() Returns the set of selected fields for the entry if the entry contains a partial representation or `null` if it is a full representation.
abstract ITextConstruct	getSummary() Returns the atom:summary element of this entry.
abstract void	setCanEdit(boolean canEdit) Sets whether the server allows this entry to be modified by the client.
abstract void	setEdited(DateTime edited) Set the last time this entry was edited using the app:edited element.
abstract void	setPublished(DateTime published) Sets the date of publishing for this entry.
abstract void	setSelectedFields(String fields) Sets the current fields selection for this partial entry.

From interface com.google.gdata.data.Kind.Adaptable

From interface com.google.gdata.data.Kind.Adaptor

From interface com.google.gdata.data.media.IMediaEntry

Protected Constructors

protected MediaEntry ()

Constructs a new BaseEntry instance.

protected MediaEntry (BaseEntry<?> sourceEntry)

Copy constructor that initializes a new BaseEntry instance to have identical contents to another instance, using a shared reference to the same entry state. Kind.Adaptor subclasses of BaseEntry can use this constructor to create adaptor instances of an entry that share state with the original.

Parameters

sourceEntry

Public Methods

public Link getMediaEditLink ()

Retrieves the media resource edit link.

public MediaSource getMediaSource ()

Returns the MediaSource that contains the media data for the entry.

public void setMediaSource (MediaSource mediaSource)

Sets the MediaSource that contains the media data for the entry.

Parameters

mediaSource

public void setService (Service v)

Sets the service that this resource is being used with.

Parameters

v

public E updateMedia (boolean updateEntry)

Updates the media content associated with this entry by sending the data contained in the MediaSource of the entry to the associated GData service. Can optionally update the entry content at the same time.

Parameters

updateEntry	Set to {code boolean} true if the current entry content should be updated with the media.

Returns

the updated entry returned by the Service.

Throws

ServiceException	If there is no associated GData service or the service is unable to perform the update.
InvalidEntryException	If the entry does not contain `MediaContent` or there is no `MediaSource` associated with the content.
UnsupportedOperationException	If update is not supported for the target entry.
IOException	If there is an error communicating with the GData service.

Protected Methods

protected Content.ChildHandlerInfo getContentHandlerInfo (ExtensionProfile extProfile, Attributes attrs)

Returns information about the content element processing.

Parameters

extProfile
attrs

Throws

ParseException
IOException

Interfaces

Classes

MediaEntry

Class Overview

Summary

Protected Constructors

protected MediaEntry ()

protected MediaEntry (BaseEntry<?> sourceEntry)

Parameters

Public Methods

public Link getMediaEditLink ()

public MediaSource getMediaSource ()

public void setMediaSource (MediaSource mediaSource)

Parameters

public void setService (Service v)

Parameters

public E updateMedia (boolean updateEntry)

Parameters

Returns

Throws

Protected Methods

protected Content.ChildHandlerInfo getContentHandlerInfo (ExtensionProfile extProfile, Attributes attrs)

Parameters

Throws