com.mareksebera.simpledilbert.preferences

Class DilbertPreferences

java.lang.Object

com.mareksebera.simpledilbert.preferences.DilbertPreferences

public final class DilbertPreferences
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static org.joda.time.format.DateTimeFormatter	DATE_FORMATTER
static org.joda.time.format.DateTimeFormatter	NICE_DATE_FORMATTER
static org.joda.time.DateTimeZone	TIME_ZONE

Constructor Summary

Constructors

Constructor and Description
DilbertPreferences(android.content.Context context)

Method Summary

Modifier and Type	Method and Description
boolean	deleteDateForWidgetId(int widgetId) Removing widget from launcher will cause deleting it's save date from preferences
void	downloadImageViaManager(android.app.Activity activity, java.lang.String downloadUrl, org.joda.time.LocalDate stripDate) Tries to launch DownloadManager with visible notification to download file from URL to downloadble path or user selected
java.util.List<FavoritedItem>	getCachedDates() Gets list of FavoritedItem where it's not really favorites, but dates for which we already have parsed URL
java.lang.String	getCachedTitle(org.joda.time.LocalDate dateKey) Returns cached strip title for provided date
java.lang.String	getCachedUrl(org.joda.time.LocalDate dateKey) Returns cached URL for provided date
org.joda.time.LocalDate	getCurrentDate() Retrieves last viewed strip date
org.joda.time.LocalDate	getDateForWidgetId(int appWidgetId) Returns saved date for specific widget id
int	getDefaultZoomLevel()
java.util.List<FavoritedItem>	getFavoritedItems() Retrieves list of favorited items, which is stored in as plain in local preferences
static org.joda.time.LocalDate	getFirstStripDate() First strip was published on 16.4.1989
int	getLandscapeOrientation()
static org.joda.time.LocalDate	getRandomDate() Generated random date within range of Dilbert existence
java.lang.String	getScheduledTargetPath(java.lang.String downloadDate) Retrieves requested target path, to which the downloaded file should be moved
boolean	isDarkLayoutEnabled()
boolean	isFavorited(org.joda.time.LocalDate currentDay) Verifies if the date is associated with favorited flag
boolean	isForceLandscape() Checks, if user preference is to force landscape orientation
boolean	isSharingImage()
boolean	isToolbarsHidden()
boolean	isWidgetAlwaysShowLatest()
boolean	isWidgetShowTitle()
boolean	removeCache(org.joda.time.LocalDate currentDate) Removes cached URL for provided date
boolean	saveCurrentDate(org.joda.time.LocalDate currentDate) Saves last viewed date in preferences
boolean	saveCurrentTitle(java.lang.String date, java.lang.String s) Saves retrieved strip title for date
boolean	saveCurrentUrl(java.lang.String date, java.lang.String s) Saves retrieved URL for date
boolean	saveDateForWidgetId(int appWidgetId, org.joda.time.LocalDate date) Saves date for widget, after user made change to it
boolean	setIsToolbarsHidden(boolean hidden)
boolean	setWidgetShowTitle(boolean showTitle)
boolean	toggleIsFavorited(org.joda.time.LocalDate currentDay) Toggles favorite state for provided date

Methods inherited from class java.lang.Object

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

Field Detail

TIME_ZONE

public static final org.joda.time.DateTimeZone TIME_ZONE

DATE_FORMATTER

public static final org.joda.time.format.DateTimeFormatter DATE_FORMATTER

NICE_DATE_FORMATTER

public static final org.joda.time.format.DateTimeFormatter NICE_DATE_FORMATTER

Constructor Detail

DilbertPreferences

public DilbertPreferences(android.content.Context context)

Method Detail

getRandomDate

public static org.joda.time.LocalDate getRandomDate()

Generated random date within range of Dilbert existence

Returns:

validated random date

getFirstStripDate

public static org.joda.time.LocalDate getFirstStripDate()

First strip was published on 16.4.1989

Returns:

LocalDate date of first Dilbert comics strip

See Also:

Wikipedia

getCurrentDate

public org.joda.time.LocalDate getCurrentDate()

Retrieves last viewed strip date

Returns:

LocalDate of last viewed strip

saveCurrentDate

public boolean saveCurrentDate(org.joda.time.LocalDate currentDate)

Saves last viewed date in preferences

Parameters:

currentDate - date of last viewed strip

Returns:

if saving was successfull

saveCurrentUrl

public boolean saveCurrentUrl(java.lang.String date,
                              java.lang.String s)

Saves retrieved URL for date

Parameters:

date - string identifier of comics strip

s - url of strip

Returns:

if saving was successfull

saveCurrentTitle

public boolean saveCurrentTitle(java.lang.String date,
                                java.lang.String s)

Saves retrieved strip title for date

Parameters:

date - string identifier of comics strip

s - title of strip

Returns:

if saving was successful

getCachedUrl

public java.lang.String getCachedUrl(org.joda.time.LocalDate dateKey)

Returns cached URL for provided date

Parameters:

dateKey - LocalDate of item

Returns:

cached URL or null

getCachedTitle

public java.lang.String getCachedTitle(org.joda.time.LocalDate dateKey)

Returns cached strip title for provided date

Parameters:

dateKey - LocalDate of item

Returns:

cached title or null

removeCache

public boolean removeCache(org.joda.time.LocalDate currentDate)

Removes cached URL for provided date

Parameters:

currentDate - date for which the cache should be deleted

Returns:

if the removal was successfull

isFavorited

public boolean isFavorited(org.joda.time.LocalDate currentDay)

Verifies if the date is associated with favorited flag

Parameters:

currentDay - date of favorited item

Returns:

whether the date is favorited or not

toggleIsFavorited

public boolean toggleIsFavorited(org.joda.time.LocalDate currentDay)

Toggles favorite state for provided date

Parameters:

currentDay - date of favorited item

Returns:

final state of toggling (last value inverted)

getCachedDates

public java.util.List<FavoritedItem> getCachedDates()

Gets list of FavoritedItem where it's not really favorites, but dates for which we already have parsed URL

Returns:

list of FavoritedItem for each cached date-URL pair

getFavoritedItems

public java.util.List<FavoritedItem> getFavoritedItems()

Retrieves list of favorited items, which is stored in as plain in local preferences

Returns:

List of favorited items (not null but may be empty)

downloadImageViaManager

public void downloadImageViaManager(android.app.Activity activity,
                                    java.lang.String downloadUrl,
                                    org.joda.time.LocalDate stripDate)

Tries to launch DownloadManager with visible notification to download file from URL to downloadble path or user selected

Parameters:

activity - Activity context to access system services and Toast notifications

downloadUrl - url from which the image is downloaded

stripDate - date of strip being downloaded

getScheduledTargetPath

public java.lang.String getScheduledTargetPath(java.lang.String downloadDate)

Retrieves requested target path, to which the downloaded file should be moved

Parameters:

downloadDate - date in format YYYY-MM-DD

Returns:

local target path (from Uri.toString()

saveDateForWidgetId

public boolean saveDateForWidgetId(int appWidgetId,
                                   org.joda.time.LocalDate date)

Saves date for widget, after user made change to it

Parameters:

appWidgetId - id of widget

date - date which is currently selected

Returns:

boolean if save was successfull

getDateForWidgetId

public org.joda.time.LocalDate getDateForWidgetId(int appWidgetId)

Returns saved date for specific widget id

Parameters:

appWidgetId - id of widget

Returns:

Date which is saved or todays day if there is no such

deleteDateForWidgetId

public boolean deleteDateForWidgetId(int widgetId)

Removing widget from launcher will cause deleting it's save date from preferences

Parameters:

widgetId - id of widget

Returns:

boolean whether delete was successfull or not

isForceLandscape

public boolean isForceLandscape()

Checks, if user preference is to force landscape orientation

Returns:

boolean whether user requires landscape orientation

isDarkLayoutEnabled

public boolean isDarkLayoutEnabled()

isToolbarsHidden

public boolean isToolbarsHidden()

setIsToolbarsHidden

public boolean setIsToolbarsHidden(boolean hidden)

isSharingImage

public boolean isSharingImage()

isWidgetAlwaysShowLatest

public boolean isWidgetAlwaysShowLatest()

setWidgetShowTitle

public boolean setWidgetShowTitle(boolean showTitle)

isWidgetShowTitle

public boolean isWidgetShowTitle()

getDefaultZoomLevel

public int getDefaultZoomLevel()

getLandscapeOrientation

public int getLandscapeOrientation()