com.google.api.gbase.client

Class AttributeHistogram

java.lang.Object

com.google.api.gbase.client.AttributeHistogram

All Implemented Interfaces:

Extension

public class AttributeHistogram
extends Object
implements Extension

Histogram information for one attribute, described in an entry using attributes in the gm: namespace. Make sure the current feed is an histogram feed and then get the AttributeHistogram for the entry using: GoogleBaseEntry.getGoogleBaseMetadata().getAttributeHistogram().

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AttributeHistogram.UniqueValue A value, as a string, and the number of times the value appears in the result set for the current query.

Constructor Summary

Constructors

Constructor and Description
AttributeHistogram() Creates an unitialized AttributeHistogram.
AttributeHistogram(GoogleBaseAttributeId attributeId) Creates and initializes an AttributeHistogram.
AttributeHistogram(String attributeName, GoogleBaseAttributeType attributeType) Creates and initializes an AttributeHistogram.

Method Summary

Methods

Modifier and Type	Method and Description
void	addValue(int count, String stringRepresentation) Adds a new value into the histogram.
void	generate(XmlWriter w, ExtensionProfile extProfile) Generates the XML representation for this tag.
GoogleBaseAttributeId	getAttributeId() Gets the name and type of the attribute this histogram describes.
String	getAttributeName() Gets the name of the attribute this histogram describes.
GoogleBaseAttributeType	getAttributeType() Gets the type of the attribute this histogram describes.
XmlParser.ElementHandler	getHandler(ExtensionProfile extProfile, String namespace, String localName, Attributes attrs) Creates a handler for this gdata extension tag.
int	getTotalValueCount() Gets the total number of values found for this attribute in the result set for the query.
List<? extends AttributeHistogram.UniqueValue>	getValues() Gets a list of unique values for the attribute and the count for these values.
List<? extends AttributeHistogram.UniqueValue>	getValues(int minimumCount) Gets a list of unique values for the attribute and the count of these values, for values repeated at least a certain number of times.
void	setAttributeId(GoogleBaseAttributeId attributeId) Sets attribute name and type.
void	setAttributeId(String name, GoogleBaseAttributeType type) Sets attribute name and type.
void	setTotalValueCount(int count) Sets the total value count.

Methods inherited from class java.lang.Object

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

Constructor Detail

AttributeHistogram

public AttributeHistogram()

Creates an unitialized AttributeHistogram.

AttributeHistogram

public AttributeHistogram(String attributeName,
                  GoogleBaseAttributeType attributeType)

Creates and initializes an AttributeHistogram.

Parameters:

attributeName - attribute name

attributeType - attribute type

AttributeHistogram

public AttributeHistogram(GoogleBaseAttributeId attributeId)

Creates and initializes an AttributeHistogram.

Parameters:

attributeId - attribute Id

Method Detail

getAttributeName

public String getAttributeName()

Gets the name of the attribute this histogram describes.

Returns:

attribute name

getAttributeType

public GoogleBaseAttributeType getAttributeType()

Gets the type of the attribute this histogram describes.

Returns:

attribute type

getAttributeId

public GoogleBaseAttributeId getAttributeId()

Gets the name and type of the attribute this histogram describes.

Returns:

attribute id

getTotalValueCount

public int getTotalValueCount()

Gets the total number of values found for this attribute in the result set for the query. This is not the total number of unique values, just the number of times this attribute was set.

Returns:

total number of values found for this attribute, always >= sum(getValues().getCount())

getValues

public List<? extends AttributeHistogram.UniqueValue> getValues()

Gets a list of unique values for the attribute and the count for these values. Not all unique values might be available. For some types, no values are ever available.

Returns:

a list of values and the number of time they were found in the result set, never null

getValues

public List<? extends AttributeHistogram.UniqueValue> getValues(int minimumCount)

Gets a list of unique values for the attribute and the count of these values, for values repeated at least a certain number of times.

Parameters:

minimumCount - minimum number of times the value should have been encountered in the result set to matter

Returns:

a list of values and the number of time they were found in the result set, never null

addValue

public void addValue(int count,
            String stringRepresentation)

Adds a new value into the histogram.

Parameters:

count - number of time the value was found

stringRepresentation -

Throws:

IllegalArgumentException - unless count is greater than 0

NullPointerException - if stringRepresentation is null

setTotalValueCount

public void setTotalValueCount(int count)

Sets the total value count.

setAttributeId

public void setAttributeId(String name,
                  GoogleBaseAttributeType type)

Sets attribute name and type.

setAttributeId

public void setAttributeId(GoogleBaseAttributeId attributeId)

Sets attribute name and type.

generate

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

Generates the XML representation for this tag.

Specified by:

generate in interface Extension

Parameters:

w - XML writer

extProfile - extension profile

Throws:

IOException - thrown if there was an error writing to the XmlWriter

getHandler

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

Creates a handler for this gdata extension tag.

Specified by:

getHandler in interface Extension

Parameters:

extProfile - extension profile

namespace - extension namespace

localName - tag name, without the namespace prefix

attrs - tag attributes

Returns:

an element handler

Throws:

ParseException - when an unexpected tag or badly-formatted XML is detected

IOException