it.polimi.dima.mediatracker.inputs

Class AbstractInput<T>

java.lang.Object

it.polimi.dima.mediatracker.inputs.AbstractInput<T>

Type Parameters:

T - the model object

Direct Known Subclasses:

ColorPickerInput, DatePickerInput, EditTextInput, SelectDialogInput, SwitchInput

public abstract class AbstractInput<T>
extends java.lang.Object

Represents an abstract form input. Automatically manages creation, listeners, etc. on the input and, thanks to the callback passed by the caller (see subclasses constructor), the translation between the input value and the model object (e.g. media item, category) fields and vice versa

Method Summary

Modifier and Type	Method and Description
void	addDependentInput(AbstractInput input) Adds an input to the dependent inputs list.
boolean	areValueChangeListenersDisabled() Getter
abstract void	dismiss() Method used to "close" the input, useful e.g.
boolean	isUpdatedByExternalService() Getter
void	restoreInstance(Bundle inState) Restores this input previously saved instance from the given bundle
protected abstract void	restoreSpecificInstance(Bundle inState) Called by restoreInstance(Bundle) for restoring the implementation instance
void	saveInstance(Bundle outState) Saves this input instance in the given bundle, in order to be able to restore it later
protected abstract void	saveSpecificInstance(Bundle outState) Called by saveInstance(Bundle) for saving the implementation instance
void	setAreValueChangeListenersDisabled(boolean areValueChangeCallbacksDisabled) Setter
abstract void	setInputFromModelObject(T modelObject) Sets the input value equal to the corresponding model object value, calling the callback passed to the input constructor
abstract void	setModelObjectFromInput(T modelObject) Sets the model object value equal to the corresponding input value, calling the callback passed to the input constructor
abstract void	setVisibility(int visibility)
void	setWasChangedByUser(boolean wasChangedByUser) Setter
boolean	wasChangedByUser() Getter

Methods inherited from class java.lang.Object

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

Method Detail

setInputFromModelObject

public abstract void setInputFromModelObject(T modelObject)

Sets the input value equal to the corresponding model object value, calling the callback passed to the input constructor

Parameters:

modelObject - the model object that will be queried for the input value

setModelObjectFromInput

public abstract void setModelObjectFromInput(T modelObject)

Sets the model object value equal to the corresponding input value, calling the callback passed to the input constructor

Parameters:

modelObject - the model object that will be updated with the input value

saveInstance

public void saveInstance(Bundle outState)

Saves this input instance in the given bundle, in order to be able to restore it later

Parameters:

outState - the bundle where the state will be saved

saveSpecificInstance

protected abstract void saveSpecificInstance(Bundle outState)

Called by saveInstance(Bundle) for saving the implementation instance

Parameters:

outState - the bundle where the state will be saved

restoreInstance

public void restoreInstance(Bundle inState)

Restores this input previously saved instance from the given bundle

Parameters:

inState - the bundle containing the saved instance of this input

restoreSpecificInstance

protected abstract void restoreSpecificInstance(Bundle inState)

Called by restoreInstance(Bundle) for restoring the implementation instance

Parameters:

inState - the bundle containing the saved instance of this input

isUpdatedByExternalService

public boolean isUpdatedByExternalService()

Getter

Returns:

true if this input can be updated by an external service

dismiss

public abstract void dismiss()

Method used to "close" the input, useful e.g. on orientation change to avoid problems

setVisibility

public abstract void setVisibility(int visibility)

See Also:

android.view.View#setVisibility(int)

areValueChangeListenersDisabled

public boolean areValueChangeListenersDisabled()

Getter

Returns:

true if value change listeners should be disabled, i.e. no value change callbacks are to be called, "wasChangedByUser" is updated, etc.

setAreValueChangeListenersDisabled

public void setAreValueChangeListenersDisabled(boolean areValueChangeCallbacksDisabled)

Setter

Parameters:

areValueChangeCallbacksDisabled - true if value change listeners should be disabled, i.e. no value change callbacks are to be called, "wasChangedByUser" is updated, etc.

wasChangedByUser

public boolean wasChangedByUser()

Getter

Returns:

true if the input was changed by the user in this session

setWasChangedByUser

public void setWasChangedByUser(boolean wasChangedByUser)

Setter

Parameters:

wasChangedByUser - true if the input was changed by the user in this session

addDependentInput

public void addDependentInput(AbstractInput input)

Adds an input to the dependent inputs list. These inputs will be visible only if this one is set (e.g. for a SwitchInput only if the switch is checked)

Parameters:

input - the dependent input to add