com.google.gdata.data.photos

Class ExifTags

java.lang.Object

com.google.gdata.data.AbstractExtension

com.google.gdata.data.ExtensionPoint

com.google.gdata.data.photos.ExifTags

All Implemented Interfaces:

Extension, Extensible

public class ExifTags
extends ExtensionPoint
implements Extensible, Extension

A photo's exif tags. Exif tags are represented as a collection element with nested elements, because that way clients can iterate over the exif tags without having to know ahead of time exactly what is in it. We also support retrieval of particular exif tags if the client knows what they want. Some standard tags are supported with helper methods to retrieve them by name.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.gdata.data.ExtensionPoint

ExtensionPoint.CumulativeBlobHandler, ExtensionPoint.ExtensionHandler

Nested classes/interfaces inherited from class com.google.gdata.data.AbstractExtension

AbstractExtension.AttributesHandler

Field Summary

Fields inherited from class com.google.gdata.data.ExtensionPoint

xmlBlob

Fields inherited from class com.google.gdata.data.AbstractExtension

localName, namespace

Constructor Summary

Constructors

Constructor and Description
ExifTags()

Method Summary

Methods

Modifier and Type	Method and Description
void	declareExtensions(ExtensionProfile extProfile) Declares the set of expected Extension types for an ExtensionPoint within the target extension profile.
void	generate(XmlWriter w, ExtensionProfile extProfile) Generates an XML representation for the extension.
Float	getApetureFNumber()
String	getCameraMake()
String	getCameraModel()
static ExtensionDescription	getDefaultDescription()
Float	getDistance()
ExifTag	getExifTag(String exifName) Get a particular exif tag by name.
Collection<ExifTag>	getExifTags() Gets the exif tags as a collection of ExifTag.
String	getExifTagValue(String exifName) Gets the value of a particular exif tag, or null if it doesn't exist.
Float	getExposureTime()
Boolean	getFlashUsed()
Float	getFocalLength()
XmlParser.ElementHandler	getHandler(ExtensionProfile extProfile, String namespace, String localName, Attributes attrs) The default implementation uses the AbstractExtension.AttributesHandler to handle parsing the extension.
String	getImageUniqueID()
Integer	getIsoEquivalent()
Date	getTime()
void	setApetureFNumber(Float fstop) Set the fstop value used.
void	setCameraMake(String make) Set the make of the camera used.
void	setCameraModel(String model) Set the model of the camera used.
void	setDistance(Float distance) Set the distance to the subject.
void	setExifTagValue(String name, Number value) Convenience method to set an exif tag based on a float value.
void	setExifTagValue(String name, String value) Sets the value of a particular exif tag by name.
void	setExposureTime(Float exposure) Set the exposure time used.
void	setFlashUsed(Boolean flash) Set whether the flash was used.
void	setFocalLength(Float focalLength) Set the focal length used.
void	setImageUniqueID(String imageUniqueID) Set the unique image id for the photo.
void	setIsoEquivalent(Integer iso) Set the iso equivalent value used.
void	setTime(Date time) Set the date/time the photo was taken.

Methods inherited from class com.google.gdata.data.ExtensionPoint

addExtension, addExtension, addRepeatingExtension, addRepeatingExtension, checkRequiredExtensions, createExtensionInstance, generate, generateCumulativeXmlBlob, generateExtensions, generateStartElement, getExtension, getExtensionDescription, getExtensionHandler, getExtensions, getManifest, getRepeatingExtension, getRepeatingExtensions, getXmlBlob, hasExtension, hasRepeatingExtension, initializeArbitraryXml, parseCumulativeXmlBlob, removeExtension, removeExtension, removeRepeatingExtension, setExtension, setXmlBlob, visit, visitChild, visitChildren

Methods inherited from class com.google.gdata.data.AbstractExtension

consumeAttributes, disableStrictValidation, enableStrictValidation, eq, generateAttributes, getExtensionLocalName, getExtensionNamespace, isImmutable, isStrictValidation, putAttributes, sameClassAs, setImmutable, throwExceptionForMissingAttribute, throwExceptionIfImmutable, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.google.gdata.data.photos.Extensible

addExtension, addRepeatingExtension, removeExtension, removeExtension, removeRepeatingExtension, setExtension

Constructor Detail

ExifTags

public ExifTags()

Method Detail

declareExtensions

public void declareExtensions(ExtensionProfile extProfile)

Description copied from class: ExtensionPoint

Declares the set of expected Extension types for an ExtensionPoint within the target extension profile. The base implementation does not declare any extensions, but can be overridden by specific types of ExtensionPoints that always contain a well-defined set of extensions.

Specified by:

declareExtensions in interface Extensible

Overrides:

declareExtensions in class ExtensionPoint

Parameters:

extProfile - the ExtensionProfile to initialize.

getDefaultDescription

public static ExtensionDescription getDefaultDescription()

getExifTags

public Collection<ExifTag> getExifTags()

Gets the exif tags as a collection of ExifTag.

getExifTag

public ExifTag getExifTag(String exifName)

Get a particular exif tag by name. This will retrieve the proper exif tag based on the name.

getExifTagValue

public String getExifTagValue(String exifName)

Gets the value of a particular exif tag, or null if it doesn't exist.

setExifTagValue

public void setExifTagValue(String name,
                   Number value)

Convenience method to set an exif tag based on a float value.

setExifTagValue

public void setExifTagValue(String name,
                   String value)

Sets the value of a particular exif tag by name.

getCameraMake

public String getCameraMake()

Returns:

the make of the camera, i.e. Nikon, Canon, Sony.

setCameraMake

public void setCameraMake(String make)

Set the make of the camera used.

getCameraModel

public String getCameraModel()

Returns:

the model of the camera used.

setCameraModel

public void setCameraModel(String model)

Set the model of the camera used.

getIsoEquivalent

public Integer getIsoEquivalent()
                         throws ParseException

Returns:

the iso equivalent value used.

Throws:

ParseException - if the value was not parsable as an integer.

setIsoEquivalent

public void setIsoEquivalent(Integer iso)

Set the iso equivalent value used.

getExposureTime

public Float getExposureTime()
                      throws ParseException

Returns:

the exposure time used.

Throws:

ParseException

setExposureTime

public void setExposureTime(Float exposure)

Set the exposure time used.

getApetureFNumber

public Float getApetureFNumber()
                        throws ParseException

Returns:

the fstop value used.

Throws:

ParseException - if the value is not a valid floating point number.

setApetureFNumber

public void setApetureFNumber(Float fstop)

Set the fstop value used.

getDistance

public Float getDistance()
                  throws ParseException

Returns:

the distance to the subject.

Throws:

ParseException - if the value is not a valid floating point number.

setDistance

public void setDistance(Float distance)

Set the distance to the subject.

getTime

public Date getTime()
             throws ParseException

Returns:

the time the photo was taken.

Throws:

ParseException - if the value is not a number, represented as a long.

setTime

public void setTime(Date time)

Set the date/time the photo was taken.

getFocalLength

public Float getFocalLength()
                     throws ParseException

Returns:

the focal length used.

Throws:

ParseException - if the value is not a valid floating point number.

setFocalLength

public void setFocalLength(Float focalLength)

Set the focal length used.

getFlashUsed

public Boolean getFlashUsed()

Returns:

Boolean.TRUE if the flash was used.

setFlashUsed

public void setFlashUsed(Boolean flash)

Set whether the flash was used.

getImageUniqueID

public String getImageUniqueID()

Returns:

the unique image id for the photo.

setImageUniqueID

public void setImageUniqueID(String imageUniqueID)

Set the unique image id for the photo.

generate

public void generate(XmlWriter w,
            ExtensionProfile extProfile)
              throws IOException

Description copied from interface: Extension

Generates an XML representation for the extension.

Specified by:

generate in interface Extension

Overrides:

generate in class AbstractExtension

Parameters:

w - XML writer

extProfile - extension profile

Throws:

IOException

getHandler

public XmlParser.ElementHandler getHandler(ExtensionProfile extProfile,
                                  String namespace,
                                  String localName,
                                  Attributes attrs)

Description copied from class: AbstractExtension

The default implementation uses the AbstractExtension.AttributesHandler to handle parsing the extension.

Specified by:

getHandler in interface Extension

Overrides:

getHandler in class ExtensionPoint

Parameters:

extProfile - extension profile

namespace - extension namespace

localName - tag name, without the namespace prefix

attrs - tag attributes

Returns:

an element handler