com.uoc.alberto.cuentosbilingues.database
Class DAOStories

java.lang.Object
  extended by com.uoc.alberto.cuentosbilingues.database.DAOStories

public class DAOStories
extends java.lang.Object

Version:
1 (18/04/2013) Con la clase DAOStories lo que se crea es un DAO (Data Access Object) a la base de datos sqlite de los cuentos. Esta clase se encarga de crear una conexión hacia la base de datos. Con los métodos open() y close() lo que se hace es abrir y/o cerrar la conexión con la base de datos. El resto de métodos son para obtener los datos de la BBDD.
Author:
Alberto Pereira Gaviño

Constructor Summary
DAOStories(Context context)
          Constructor de la clase.
 
Method Summary
 void close()
          Cierra la comunicación con la BBDD.
 java.util.List<Game> getGames(java.lang.String[] params)
          Para este método la ordenación es aleatoria, para que cada vez que se abra un cuento y se llegue a la página del juego interactivo (al final de cada cuento) el orden siempre sea diferente.
 java.lang.CharSequence[] getGameValues(java.lang.String[] params)
          Para este método la ordenación es aleatoria, de manera que cada vez que se abra un cuento y se llegue a la página del juego interactivo (al final de cada cuento) el orden de las posibles opciones siempre sea diferente.
 java.util.List<Page> getPages(java.lang.String[] params)
           
 java.util.List<Story> getStories(java.lang.String[] params)
           
 Story getStory(java.lang.String[] params)
           
 java.lang.String getValue(java.lang.String[] params, java.lang.String separador)
           
 DAOStories open()
          Abre la comunicación con la BBDD.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DAOStories

public DAOStories(Context context)
Constructor de la clase.

Parameters:
context - es el contexto de la clase que lo crea.
Method Detail

open

public DAOStories open()
Abre la comunicación con la BBDD.

Returns:
objeto del tipo DAOStories.

close

public void close()
Cierra la comunicación con la BBDD.


getStory

public Story getStory(java.lang.String[] params)
Parameters:
params - Array de parámetros para realizar el where de la consulta [idStory, prefLanguage1, prefLanguage2]
Returns:
Story story: Objeto de la case Story, null si no existe.

getStories

public java.util.List<Story> getStories(java.lang.String[] params)
Parameters:
params - Array de parámetros para realizar el where de la consulta en el métdo getStory [idStory (null), prefLanguage1, prefLanguage2] Se hace una consulta a todos los cuentos disponibles en la BBDD, se guarda en params[0] el id del cuento leído en la BBDD y luego para cada uno de los registros se llama al método getStory con los mismos params y añadir el cuento a la ArrayList. Es decir, en este caso idStory viene vacío y se asigna el valor dentro del método. Para cada cuento de la base de datos crea el objeto de la clase Story y lo añade en la lista.
Returns:
List stories: Lista de objetos de la case Story.

getValue

public java.lang.String getValue(java.lang.String[] params,
                                 java.lang.String separador)
Parameters:
params - Array de parámetros para realizar el where de la consulta [keyString, prefLanguage1, prefLanguage2]
separador - String que hace de separador entre los dos idiomas definidos, que puede ser un guión (-), un salto de línia (\n) o cualquier otro tipo de carácter.
Returns:
String result: El valor del String en los dos idiomas definidos por el usuario con el símbolo separador entre los dos idiomas.

getPages

public java.util.List<Page> getPages(java.lang.String[] params)
Parameters:
params - Array de parámetros para realizar el where de la consulta [idStory, prefLanguage1, prefLanguage2]
Returns:
List pages: un ArrayList con las páginas del cuento (objetos del tipo Page) identificadas por idStory y ordenadas por el número de página almacenado en la base de datos.

getGames

public java.util.List<Game> getGames(java.lang.String[] params)
Para este método la ordenación es aleatoria, para que cada vez que se abra un cuento y se llegue a la página del juego interactivo (al final de cada cuento) el orden siempre sea diferente.

Parameters:
params - Array de parámetros para realizar el where de la consulta [idStory, prefLanguage2 (Idioma a aprender)]
Returns:
List games: un ArrayList con los juegos del cuento (objetos del tipo Game) identificadas por idStory y el idioma que quiere aprender el usuario.

getGameValues

public java.lang.CharSequence[] getGameValues(java.lang.String[] params)
Para este método la ordenación es aleatoria, de manera que cada vez que se abra un cuento y se llegue a la página del juego interactivo (al final de cada cuento) el orden de las posibles opciones siempre sea diferente.

Parameters:
params - Array de parámetros para realizar el where de la consulta [idStory, prefLanguage2 (Idioma a aprender)]
Returns:
CharSequence[] values: Matriz con los valores para las opciones a elegir en el juego interactivo (al final de cada cuento).