public interface

IAtom

com.google.gdata.data.IAtom
Known Indirect Subclasses

Class Overview

Base interface for Atom resource types. Contains a common set of methods across both entries and feeds and a can also be used as a parameter type in contexts where either a feed or an entry is acceptable.

See Also

Summary

Public Methods
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.

Public Methods

public abstract ILink addLink (String rel, String type, String href)

Adds a link with the given rel, type, and href.

Parameters
rel
type
href

public abstract List<? extends IPerson> getAuthors ()

Returns the list of all authors on this resource.

public abstract Set<? extends ICategory> getCategories ()

Returns a set of categories on this resource.

public abstract String getEtag ()

Gets the value of the gd:etag attribute for this resource. See RFC 2616, Section 3.11.

public abstract String getId ()

Get the unique id for this resource. Represents the atom:id element.

public abstract String getKind ()

Returns the value of the gd:kind attribute for this resource. Returns null if the kind attribute is missing.

public 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.

Parameters
rel
type

public abstract List<? extends ILink> getLinks ()

Returns a list of atom:link elements on this resource. If there are no links, an empty list will be returned.

public abstract ILink getSelfLink ()

Returns the self link for the resource.

public abstract ITextConstruct getTitle ()

Returns the atom:title element of this resource.

public abstract DateTime getUpdated ()

Get a DateTime instance representing the last time this resource was updated. Represents the atom:updated element.

public abstract String getVersionId ()

Version ID. This is a unique number representing this particular resource. Every update changes the version ID (unless the update doesn't modify anything, in which case it's permissible for version ID to stay the same). Services are free to interpret this string in the most convenient way. Some services may choose to use a monotonically increasing sequence of version IDs. Other services may compute a hash of entry properties or feed content and use that.

This property is only used for services to communicate the current version ID back to the servlet. It is NOT set when resources are parsed (either from requests or from arbitrary XML).

public abstract void removeLinks (String relToMatch, String typeToMatch)

Remove all links that match the given rel and type values.

Parameters
relToMatch rel value to match or null to match any rel value.
typeToMatch type value to match or null to match any type value.

public abstract void removeLinks ()

Removes all links from the this resource.

public abstract void setEtag (String etag)

Sets the value of the gd:etag attribute for this resource.

Parameters
etag

public abstract void setId (String id)

Sets the unique id for this resource.

Parameters
id

public abstract void setKind (String kind)

Sets the value of the gd:kind attribute for this resource. A value of null will remove the kind attribute.

Parameters
kind

public abstract void setService (Service s)

Sets the service that this resource is being used with.

Parameters
s

public abstract void setUpdated (DateTime updated)

Sets the last time this resource was updated.

Parameters
updated

public abstract void setVersionId (String versionId)

Sets the versionId. See getVersionId() for a description of what the versionId is used for.

Parameters
versionId