com.fsc.cicerone.app_connector

Class AsyncDatabaseConnector<T extends BusinessEntity>

java.lang.Object

android.os.AsyncTask<java.lang.Void,java.lang.Void,java.lang.String>

com.fsc.cicerone.app_connector.AsyncDatabaseConnector<T>

All Implemented Interfaces:

DatabaseConnector

Direct Known Subclasses:

GetDataConnector, SendInPostConnector

public abstract class AsyncDatabaseConnector<T extends BusinessEntity>
extends android.os.AsyncTask<java.lang.Void,java.lang.Void,java.lang.String>
implements DatabaseConnector

Generic asynchronous connector to a database. This class gives an interface to communicate with a database. It needs the URL of the server-side script that generates and handles the data.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AsyncDatabaseConnector.Builder<B extends BusinessEntity> A utility class useful to create an AsyncDatabaseConnector.
static interface	AsyncDatabaseConnector.OnEndConnectionListener<T> An interfaced to be used to create callback functions to be used to define the connector behaviour on the connection's end.
static interface	AsyncDatabaseConnector.OnStartConnectionListener An interfaced to be used to create callback functions to be used to define the connector behaviour on the connection's start.

Nested classes/interfaces inherited from class android.os.AsyncTask

android.os.AsyncTask.Status

Field Summary

Fields

Modifier and Type	Field and Description
(package private) java.lang.String	fileUrl

Fields inherited from class android.os.AsyncTask

SERIAL_EXECUTOR, THREAD_POOL_EXECUTOR

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AsyncDatabaseConnector(AsyncDatabaseConnector.Builder<T> builder) AsyncDatabaseConnector's constructor.

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	doInBackground(java.lang.Void... voids) The function that sends and fetches the results.
protected void	executeAfterConnection(java.lang.String s) A function that will be executed after the connection ends.
void	getData() Get the data from the database.
protected void	onPostExecute(java.lang.String s) A function that will be called after the execution.
protected void	onPreExecute() A function that will be called before the execution.
protected void	setError(java.lang.Exception error) Se the AsyncDatabaseConnector's error.

Methods inherited from class android.os.AsyncTask

cancel, execute, execute, executeOnExecutor, get, get, getStatus, isCancelled, onCancelled, onCancelled, onProgressUpdate, publishProgress

Methods inherited from class java.lang.Object

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

Field Detail

fileUrl

java.lang.String fileUrl

Constructor Detail

AsyncDatabaseConnector

protected AsyncDatabaseConnector(AsyncDatabaseConnector.Builder<T> builder)

AsyncDatabaseConnector's constructor. It creates an object from a builder.

Parameters:

builder - The Builder.

See Also:

AsyncDatabaseConnector.Builder

Method Detail

onPreExecute

protected void onPreExecute()

A function that will be called before the execution.

Overrides:

onPreExecute in class android.os.AsyncTask<java.lang.Void,java.lang.Void,java.lang.String>

onPostExecute

protected void onPostExecute(java.lang.String s)

A function that will be called after the execution.

Overrides:

onPostExecute in class android.os.AsyncTask<java.lang.Void,java.lang.Void,java.lang.String>

Parameters:

s - This string will contain the result of the connection.

executeAfterConnection

protected void executeAfterConnection(java.lang.String s)

A function that will be executed after the connection ends. It should call onEndConnectionListener.onEndConnection in its body.

Parameters:

s - A string containing the connection result.

See Also:

AsyncDatabaseConnector.OnEndConnectionListener.onEndConnection(List)

doInBackground

protected java.lang.String doInBackground(java.lang.Void... voids)

The function that sends and fetches the results.

Specified by:

doInBackground in class android.os.AsyncTask<java.lang.Void,java.lang.Void,java.lang.String>

Parameters:

voids - Various parameters

Returns:

The string that contains the result of the connection.

setError

protected void setError(java.lang.Exception error)

Se the AsyncDatabaseConnector's error.

Parameters:

error - The error.

getData

public void getData()

Description copied from interface: DatabaseConnector

Get the data from the database.

Specified by:

getData in interface DatabaseConnector

See Also:

DatabaseConnector.getData()