it.polimi.dima.mediatracker.fragments

Class FormAbstractFragment

java.lang.Object

it.polimi.dima.mediatracker.fragments.FormAbstractFragment

Direct Known Subclasses:

FormCategoryFragment, FormMediaItemAbstractFragment

public abstract class FormAbstractFragment
extends java.lang.Object

Abstract fragment that manages a form to add/edit "something" in the database

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	FormAbstractFragment.FormExitListener Listener for exiting from the form
static interface	FormAbstractFragment.OnObjectSaveListener Listener that receives an event each time a media item is saved in the form

Method Summary

Modifier and Type	Method and Description
protected abstract boolean	canExitForm() Checks if the user can exit the form (no unsaved changes)
protected abstract int	getContentLayout() Returns the form content layout
void	manageExitFromForm(FormAbstractFragment.FormExitListener formExitListener) Called whenever the user tries to exit from a form (e.g.
View	onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
boolean	onMenuItemClick(MenuItem item)
protected abstract void	resetInputUpdatedByUserFlags() Resets the "wasChangedByUser" flags in all the form inputs
protected abstract void	saveObject() Saves the model object somewhere.
protected abstract void	setObjectValuesFromInputs() Retrieves all values from the inputs and sets them in the model object
void	setOnObjectSaveListener(FormAbstractFragment.OnObjectSaveListener onObjectSaveListener) Setter
protected abstract java.lang.String	validateObject() Checks if the form object is correct.

Methods inherited from class java.lang.Object

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

Method Detail

onCreateView

public View onCreateView(LayoutInflater inflater,
                         ViewGroup container,
                         Bundle savedInstanceState)

onMenuItemClick

public boolean onMenuItemClick(MenuItem item)

manageExitFromForm

public void manageExitFromForm(FormAbstractFragment.FormExitListener formExitListener)

Called whenever the user tries to exit from a form (e.g. back pressed). Checks if unsaved changed were made

Parameters:

formExitListener - the listener receiving the exit result

canExitForm

protected abstract boolean canExitForm()

Checks if the user can exit the form (no unsaved changes)

Returns:

true if the user can exit the form

resetInputUpdatedByUserFlags

protected abstract void resetInputUpdatedByUserFlags()

Resets the "wasChangedByUser" flags in all the form inputs

getContentLayout

protected abstract int getContentLayout()

Returns the form content layout

Returns:

content layout resource id

setObjectValuesFromInputs

protected abstract void setObjectValuesFromInputs()

Retrieves all values from the inputs and sets them in the model object

validateObject

protected abstract java.lang.String validateObject()

Checks if the form object is correct. Called after setObjectValuesFromInputs() so that the model object already has all the fields set

Returns:

null if the object is ok, a string containing the error message otherwise

saveObject

protected abstract void saveObject()

Saves the model object somewhere. Called after setObjectValuesFromInputs() (the model object already has all the fields set) and only if validateObject() returns null

setOnObjectSaveListener

public void setOnObjectSaveListener(FormAbstractFragment.OnObjectSaveListener onObjectSaveListener)

Setter

Parameters:

onObjectSaveListener - the listener that receives the save events