com.mousebird.maply

Class AttrDictionary

java.lang.Object

com.mousebird.maply.AttrDictionary

public class AttrDictionary
extends java.lang.Object

The attribute dictionary is a collection of name/value pairs. We use it to store (and modify) attributes on VectorObject structures, primarily. It's analogous to the NSDictionary class on iOS, but much simpler.

Constructor Summary

Constructors

Constructor and Description
AttrDictionary() Construct an empty attribution dictionary

Method Summary

Modifier and Type	Method and Description
void	addEntries(AttrDictionary other)
void	finalize()
java.lang.Object	get(java.lang.String attrName) Fetch an Object corresponding to the given attribute name.
AttrDictionaryEntry[]	getArray(java.lang.String attrName) Return an array of Entry objects, if the given attribute name corresponds to an array.
boolean	getBoolean(java.lang.String attrName) Convert the given attribute to a boolean or return false if it's not there.
AttrDictionary	getDict(java.lang.String attrName) Fetch a dictionary corresponding to the given attribute name.
java.lang.Double	getDouble(java.lang.String attrName) Fetch a double corresponding to the given attribute name.
AttrDictionaryEntry	getEntry(java.lang.String attrName) Return a generic dictionary entry for the given attribute.
java.lang.Long	getIdentity(java.lang.String attrName) Fetch an identity corresponding to the given name.
java.lang.Integer	getInt(java.lang.String attrName) Return an Integer corresponding to the given attribute name.
java.lang.String[]	getKeys() Return all the top level attribute names.
java.lang.String	getString(java.lang.String attrName) Return a string corresponding to the given attribute name.
boolean	hasField(java.lang.String attrName) True if there's a field with the given name.
boolean	parseFromJSON(java.lang.String json) Parse from a JSON file.
void	setArray(java.lang.String attrName, AttrDictionary[] entries) Assign the given array to the given attribute name.
void	setArray(java.lang.String attrName, AttrDictionaryEntry[] entries) Assign the given array to the given attribute name.
void	setDict(java.lang.String attrName, AttrDictionary dict) Assign the given dictionary to the given attribute name.
void	setDouble(java.lang.String attrName, double attrVal) Set a double value.
void	setInt(java.lang.String attrName, int attrVal) Set an int value.
void	setString(java.lang.String attrName, java.lang.String attrVal) Set a string value.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

AttrDictionary

public AttrDictionary()

Construct an empty attribution dictionary

Method Detail

parseFromJSON

public boolean parseFromJSON(java.lang.String json)

Parse from a JSON file. Returns false on failure.

hasField

public boolean hasField(java.lang.String attrName)

True if there's a field with the given name.

getString

public java.lang.String getString(java.lang.String attrName)

Return a string corresponding to the given attribute name.

Parameters:

attrName - Name of the attribute we're looking for.

Returns:

Returns a string for the attribute or null if there was none.

getInt

public java.lang.Integer getInt(java.lang.String attrName)

Return an Integer corresponding to the given attribute name.

Parameters:

attrName - Name of the attribute we're looking for.

Returns:

Returns an Integer for the given attribute or null if there was none.

getDouble

public java.lang.Double getDouble(java.lang.String attrName)

Fetch a double corresponding to the given attribute name.

Parameters:

attrName - Name of the attribute we're looking for.

Returns:

Returns a Double for the given attribute or null if there was none.

getIdentity

public java.lang.Long getIdentity(java.lang.String attrName)

Fetch an identity corresponding to the given name.

Parameters:

attrName - Name of the attribute we're looking for.

Returns:

Returns a 64 bit identity the system uses for cataloging assets.

getBoolean

public boolean getBoolean(java.lang.String attrName)

Convert the given attribute to a boolean or return false if it's not there.

get

public java.lang.Object get(java.lang.String attrName)

Fetch an Object corresponding to the given attribute name.

Parameters:

attrName - Name of the attribute we're looking for.

Returns:

Returns an Object for the given attribute or null if there was none.

getDict

public AttrDictionary getDict(java.lang.String attrName)

Fetch a dictionary corresponding to the given attribute name.

Parameters:

attrName - Name of the attribute we're looking for.

Returns:

Returns the dictionary for the attribute name or null if there was none.

getEntry

public AttrDictionaryEntry getEntry(java.lang.String attrName)

Return a generic dictionary entry for the given attribute. Returns null if there wasn't one.

getArray

public AttrDictionaryEntry[] getArray(java.lang.String attrName)

Return an array of Entry objects, if the given attribute name corresponds to an array.

Parameters:

attrName - Name of the attribute to get.

getKeys

public java.lang.String[] getKeys()

Return all the top level attribute names.

setString

public void setString(java.lang.String attrName,
                      java.lang.String attrVal)

Set a string value.

Parameters:

attrName - Name of the attribute to set.

attrVal - String value to set.

setInt

public void setInt(java.lang.String attrName,
                   int attrVal)

Set an int value.

Parameters:

attrName - Name of the attribute to set.

attrVal - Int value to set.

setDouble

public void setDouble(java.lang.String attrName,
                      double attrVal)

Set a double value.

Parameters:

attrName - Name of the attribute to set.

attrVal - Double value to set.

setDict

public void setDict(java.lang.String attrName,
                    AttrDictionary dict)

Assign the given dictionary to the given attribute name.

setArray

public void setArray(java.lang.String attrName,
                     AttrDictionaryEntry[] entries)

Assign the given array to the given attribute name.

setArray

public void setArray(java.lang.String attrName,
                     AttrDictionary[] entries)

Assign the given array to the given attribute name.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

addEntries

public void addEntries(AttrDictionary other)

finalize

public void finalize()

Overrides:

finalize in class java.lang.Object