co.uk.wxApp.models

Class Data

java.lang.Object

co.uk.wxApp.models.Data

public final class Data
extends java.lang.Object

The 'M' (Model)in the MVC design pattern (but with some Controller-ness). Also uses the Singleton concept.
It stores and sets the application settings, and any globally needed constants. A unit conversion method is placed here for convenience.

Author:

Ben Lee-Rodgers

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Data.textSizes Text sizes used where scaling based on screen size is necessary

Field Summary

Fields

Modifier and Type	Field and Description
static int	CITY_LIMIT Number of cities displayed at one time
static java.lang.String[][]	DATA_COLOURS Background colours of tiles
static boolean[][]	DATA_TEXT_ISWHITES Foreground text-colour on tiles
static double[][]	DATA_THRESHOLDS Limits for each colour band
static java.lang.String	DB_NAME Local SQLite database name
static int	SERVER_FREQ Frequency in minutes used by the web server to update its database
static java.lang.String[]	VARIABLE_NAMES Names of all the weather variables
static int	VARIABLE_NUM Number of different weather variables
static java.lang.String[]	WX_ICON_LABELS Labels for each icon used by the 'condition' weather variable
static int[]	WX_ICONS Icons used by the 'condition' weather variable

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	convert(double value, int type) Convert a weather variable value from default units (UK Met Office standard system) to one of a range of other common units, and tidy up the formatting.
java.lang.String	getCity(int index) Return one of the user-defined cities (0-8)
static Data	getInstance() Implementation of singleton design pattern (useful in Android as it is difficult to pass references to objects between activities
int[]	getOrders() Return the arrangement of tiles on the screen
float	getTextSize(Data.textSizes type)
java.lang.String	getUnitW()
int	getUpdateFreq()
boolean	isUnitPisMetric()
boolean	isUnitRisMetric()
boolean	isUnitTisMetric()
boolean	isUnitWisKnots()
boolean	isUnitWisMetric()
boolean	isUpdated() Whether there been a change to the user-defined city collection
boolean	isWifiOnly()
static java.lang.String	round(double value, int places) Round a value to a set number of decimal places
void	setCity(java.lang.String city, int index) Set one of the user-defined cities (0-8)
void	setOrders(int[] orders) Set the arrangement of tiles on the screen
void	setTextSize(Data.textSizes type, float size)
void	setToastable(boolean showToasts)
void	setUnitPisMetric(boolean unitPisMetric)
void	setUnitRisMetric(boolean unitRisMetric)
void	setUnitTisMetric(boolean unitTisMetric)
void	setUnitW(java.lang.String unitW)
void	setUnitWisKnots(boolean unitWisKnots)
void	setUnitWisMetric(boolean unitWisMetric)
void	setUpdated(boolean updated) Inform the updaterService there been a change to the user-defined city collection
void	setUpdateFreq(int updateFreq)
void	setWifiOnly(boolean wifiOnly)
boolean	toastable()
void	updateSettings(android.content.Context c) Update the global application settings

Methods inherited from class java.lang.Object

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

Field Detail

DATA_COLOURS

public static final java.lang.String[][] DATA_COLOURS

Background colours of tiles

DATA_TEXT_ISWHITES

public static final boolean[][] DATA_TEXT_ISWHITES

Foreground text-colour on tiles

DATA_THRESHOLDS

public static final double[][] DATA_THRESHOLDS

Limits for each colour band

DB_NAME

public static final java.lang.String DB_NAME

Local SQLite database name

See Also:

Constant Field Values

SERVER_FREQ

public static final int SERVER_FREQ

Frequency in minutes used by the web server to update its database

See Also:

Constant Field Values

CITY_LIMIT

public static final int CITY_LIMIT

Number of cities displayed at one time

See Also:

Constant Field Values

VARIABLE_NAMES

public static final java.lang.String[] VARIABLE_NAMES

Names of all the weather variables

VARIABLE_NUM

public static final int VARIABLE_NUM

Number of different weather variables

WX_ICONS

public static final int[] WX_ICONS

Icons used by the 'condition' weather variable

WX_ICON_LABELS

public static final java.lang.String[] WX_ICON_LABELS

Labels for each icon used by the 'condition' weather variable

Method Detail

getInstance

public static Data getInstance()

Implementation of singleton design pattern (useful in Android as it is difficult to pass references to objects between activities

isUnitTisMetric

public boolean isUnitTisMetric()

setUnitTisMetric

public void setUnitTisMetric(boolean unitTisMetric)

isUnitRisMetric

public boolean isUnitRisMetric()

setUnitRisMetric

public void setUnitRisMetric(boolean unitRisMetric)

isUnitWisMetric

public boolean isUnitWisMetric()

setUnitWisMetric

public void setUnitWisMetric(boolean unitWisMetric)

isUnitWisKnots

public boolean isUnitWisKnots()

setUnitWisKnots

public void setUnitWisKnots(boolean unitWisKnots)

isUnitPisMetric

public boolean isUnitPisMetric()

setUnitPisMetric

public void setUnitPisMetric(boolean unitPisMetric)

getUnitW

public java.lang.String getUnitW()

setUnitW

public void setUnitW(java.lang.String unitW)

getCity

public java.lang.String getCity(int index)

Return one of the user-defined cities (0-8)

setCity

public void setCity(java.lang.String city,
           int index)

Set one of the user-defined cities (0-8)

getUpdateFreq

public int getUpdateFreq()

setUpdateFreq

public void setUpdateFreq(int updateFreq)

toastable

public boolean toastable()

setToastable

public void setToastable(boolean showToasts)

isWifiOnly

public boolean isWifiOnly()

setWifiOnly

public void setWifiOnly(boolean wifiOnly)

getOrders

public int[] getOrders()

Return the arrangement of tiles on the screen

setOrders

public void setOrders(int[] orders)

Set the arrangement of tiles on the screen

isUpdated

public boolean isUpdated()

Whether there been a change to the user-defined city collection

setUpdated

public void setUpdated(boolean updated)

Inform the updaterService there been a change to the user-defined city collection

getTextSize

public float getTextSize(Data.textSizes type)

setTextSize

public void setTextSize(Data.textSizes type,
               float size)

updateSettings

public void updateSettings(android.content.Context c)

Update the global application settings

convert

public java.lang.String convert(double value,
                       int type)

Convert a weather variable value from default units (UK Met Office standard system) to one of a range of other common units, and tidy up the formatting.

Parameters:

value - the variable to convert

type - the conversion type (0 Temp, 1 Rain, 2 Wind, 3 Relative Humidity, 4 Atmospheric Pressure)

Returns:

the converted value with its measurement unit

round

public static java.lang.String round(double value,
                     int places)

Round a value to a set number of decimal places

Parameters:

value -

places -

Returns:

the rounded value