Referència de la Classe controladors.CtrlPresentacio

Representa el controlador de presentació. Més...

Diagrama de col·laboració per a controladors.CtrlPresentacio:

Mètodes públics
void	launchApp ()
	Inicialitza l'aplicació creant les instàncies del controlador de domini i de partida, i mostrant la vista principal del menú.

Mètodes Públics Estàtics
static CtrlPresentacio	getInstancia ()
	Retorna la instancia del controlador de domini.
static int	iniciarSessio (String nom, String contrasenya) throws IOException
	Inicia una sessió amb l'usuari especificat.
static boolean	crearPerfil (String nom, String contrasenya)
	Crea un nou perfil d'usuari amb el nom i la contrasenya proporcionats.
static boolean	eliminarPerfil () throws IOException
	Elimina el perfil de l'usuari actiu.
static void	tancarSessio ()
	Tanca la sessió de l'usuari actual i retorna a la vista principal.
static boolean	crearAvatar (String nom, String rutaImatge) throws IOException
	Crea un nou avatar amb el nom i la imatge especificats.
static boolean	eliminarAvatar (String avatar_a_eliminar)
	Elimina un avatar del sistema.
static HashMap< Integer, Jugador >	getJugadorsRegistrats ()
	Retorna el conjunt de jugadors registrats al sistema.
static String	getNomUsuariActiu ()
	Retorna el nom de l'usuari que té la sessió iniciada.
static boolean	crearPartida (String nomJ1, String nomJ2, String idioma, int mida)
	Crea una nova partida amb els paràmetres indicats.
static void	reprendrePartida (int idSeleccionat)
	Reprèn una partida existent identificada pel seu ID.
static boolean	passarTornPartida ()
	Passa el torn a l'altre jugador de la partida actual.
static int	canviarFitxesPartida (List< String > totesFitxes, int num, boolean b, String lletra1, String lletra2)
	Canvia fitxes del jugador segons les especificacions donades.
static int	colocarParaulaPartida (String palabra, int fila, int columna, boolean horizontal)
	Col·loca una paraula al tauler de la partida actual.
static void	abandonarPartida ()
	Abandona la partida actual en curs.
static boolean	finalitzarPerLletresEsgotadesPartida ()
	Finalitza la partida si ja no queden fitxes disponibles per continuar.
static void	guardarPartida () throws IOException
	Desa l'estat actual de la partida en curs.
static void	ferJugadaMaquinaPartida ()
	Executa una jugada automàtica per part de la màquina.
static void	canviRankingPartida ()
	Canvia la vista a la pantalla de rànquing final un cop acabada la partida.
static void	canviarCrearPerfil ()
	Canvia la vista actual a la vista de creació de perfil.
static void	canviarIniciarSessio ()
	Canvia la vista actual a la vista d'inici de sessió.
static void	canviarCrearAvatar ()
	Canvia la vista actual a VistaCrearAvatar.
static void	canviarConsultarAvatars ()
	Canvia la vista actual a VistaConsultarAvatars.
static void	canviarConsultarEstadistiques ()
	Canvia la vista actual a VistaConsultarEstadistiques.
static void	canviarConsultarRanking ()
	Canvia la vista actual a VistaConsultarRanking.
static void	canviarCrearPartida ()
	Canvia la vista actual a VistaCrearPartida.
static void	canviarCrearPerfilDesdeIniciarSessio ()
	Canvia la vista des de VistaIniciarSessio a VistaCrearPerfil.
static void	canviarCanviTorn ()
	Canvia a la vista de canvi de torn entre jugadors.
static void	sortir ()
	Tanca la sessió de l'usuari, allibera els recursos gràfics i finalitza l'execució de l'aplicació.
static void	tornar ()
	Torna a la vista anterior a l'actual.
static void	consultarNormes ()
	Mostra la vista de consulta de normes del joc.
static List< Avatar >	getRanking (int limit)
	Obté el rànquing global d'avatares limitat a un cert nombre.
static List< Fitxa >	getLletresJugadorTornPartida ()
	Obté les fitxes del jugador al qual li toca el torn actual.
static void	tornarPartida ()
	Torna a mostrar la vista actual de la partida després d’una acció temporal.
static Partida	getPartida ()
	Retorna la instància de la partida actual en curs.

Atributs Privats Estàtics
static CtrlPresentacio	instancia
static CtrlDomini	ctrlDomini
static CtrlPartida	ctrlPartida
static JFrame	vistaPrevia
static JFrame	vistaActual

Descripció Detallada

Representa el controlador de presentació.

El controlador de presentació fa d'intermediari entres la GUI (Grafic User Interface) amb la resta de controladors de l'aplicació.

Documentació de les Funcions Membre

abandonarPartida()

static void controladors.CtrlPresentacio.abandonarPartida ( )

inlinestatic

Abandona la partida actual en curs.

Gràfic de crides a aquesta funció:

canviarCanviTorn()

static void controladors.CtrlPresentacio.canviarCanviTorn ( )

inlinestatic

Canvia a la vista de canvi de torn entre jugadors.

Es mostra una finestra que indica quin jugador ha de jugar a continuació.

Gràfic de crides d'aquesta funció:

Gràfic de crides a aquesta funció:

canviarConsultarAvatars()

static void controladors.CtrlPresentacio.canviarConsultarAvatars ( )

inlinestatic

Canvia la vista actual a VistaConsultarAvatars.

Oculta la vista actual i mostra una nova finestra amb els avatars disponibles.

Gràfic de crides a aquesta funció:

canviarConsultarEstadistiques()

static void controladors.CtrlPresentacio.canviarConsultarEstadistiques ( )

inlinestatic

Canvia la vista actual a VistaConsultarEstadistiques.

Oculta la vista actual i mostra una nova finestra amb les estadístiques de l'usuari.

Gràfic de crides a aquesta funció:

canviarConsultarRanking()

static void controladors.CtrlPresentacio.canviarConsultarRanking ( )

inlinestatic

Canvia la vista actual a VistaConsultarRanking.

Oculta la vista actual i mostra una nova finestra amb el rànquing de jugadors.

Gràfic de crides a aquesta funció:

canviarCrearAvatar()

static void controladors.CtrlPresentacio.canviarCrearAvatar ( )

inlinestatic

Canvia la vista actual a VistaCrearAvatar.

Oculta la vista actual i en mostra una nova per a crear l'avatar.

Gràfic de crides a aquesta funció:

canviarCrearPartida()

static void controladors.CtrlPresentacio.canviarCrearPartida ( )

inlinestatic

Canvia la vista actual a VistaCrearPartida.

Oculta la vista actual i mostra una nova finestra per a configurar una nova partida.

Gràfic de crides a aquesta funció:

canviarCrearPerfil()

static void controladors.CtrlPresentacio.canviarCrearPerfil ( )

inlinestatic

Canvia la vista actual a la vista de creació de perfil.

Oculta la vista actual però no la tanca, i crea una nova instància de VistaCrearPerfil.

Gràfic de crides a aquesta funció:

canviarCrearPerfilDesdeIniciarSessio()

static void controladors.CtrlPresentacio.canviarCrearPerfilDesdeIniciarSessio ( )

inlinestatic

Canvia la vista des de VistaIniciarSessio a VistaCrearPerfil.

Elimina la vista actual i crea una nova instància de VistaCrearPerfil amb la vista prèvia com a paràmetre.

Gràfic de crides a aquesta funció:

canviarFitxesPartida()

static int controladors.CtrlPresentacio.canviarFitxesPartida ( List< String > totesFitxes, int num, boolean b, String lletra1, String lletra2 )

inlinestatic

Canvia fitxes del jugador segons les especificacions donades.

Paràmetres

totesFitxes	Llista de totes les fitxes disponibles.
num	Nombre de fitxes a canviar.
b	Booleà auxiliar per alguna lògica interna.
lletra1	Primera lletra seleccionada.
lletra2	Segona lletra seleccionada.

Retorna

Codi que indica el resultat de l'operació.

Gràfic de crides a aquesta funció:

canviarIniciarSessio()

static void controladors.CtrlPresentacio.canviarIniciarSessio ( )

inlinestatic

Canvia la vista actual a la vista d'inici de sessió.

Oculta la vista actual però no la tanca, i crea una nova instància de VistaIniciarSessio.

Gràfic de crides a aquesta funció:

canviRankingPartida()

static void controladors.CtrlPresentacio.canviRankingPartida ( )

inlinestatic

Canvia la vista a la pantalla de rànquing final un cop acabada la partida.

Es mostren els noms i puntuacions dels dos jugadors.

Gràfic de crides d'aquesta funció:

Gràfic de crides a aquesta funció:

colocarParaulaPartida()

static int controladors.CtrlPresentacio.colocarParaulaPartida ( String palabra, int fila, int columna, boolean horizontal )

inlinestatic

Col·loca una paraula al tauler de la partida actual.

Paràmetres

palabra	Paraula a col·locar.
fila	Fila on comença la paraula.
columna	Folumna on comença la paraula.
horizontal	Cert si la paraula s'ha de col·locar en horitzontal; fals per vertical.

Retorna

Codi de resultat de la jugada (0 si és vàlida, altres valors per errors).

Gràfic de crides a aquesta funció:

consultarNormes()

static void controladors.CtrlPresentacio.consultarNormes ( )

inlinestatic

Mostra la vista de consulta de normes del joc.

Oculta la vista actual però no la tanca. Depenent del context (menú principal o joc), s'instancia la vista corresponent.

Gràfic de crides a aquesta funció:

crearAvatar()

static boolean controladors.CtrlPresentacio.crearAvatar ( String nom, String rutaImatge ) throws IOException

inlinestatic

Crea un nou avatar amb el nom i la imatge especificats.

Paràmetres

nom	El nom de l'avatar.
rutaImatge	La ruta de la imatge associada.

Retorna

Cert si l'avatar s'ha creat correctament.

Excepcions

IOException

Si es produeix un error d'entrada/sortida.

Gràfic de crides a aquesta funció:

crearPartida()

static boolean controladors.CtrlPresentacio.crearPartida ( String nomJ1, String nomJ2, String idioma, int mida )

inlinestatic

Crea una nova partida amb els paràmetres indicats.

Paràmetres

nomJ1	Nom del jugador 1.
nomJ2	Nom del jugador 2.
idioma	Idioma de la partida.
mida	Mida del tauler.

Retorna

Cert si la partida s'ha creat correctament.

Gràfic de crides a aquesta funció:

crearPerfil()

static boolean controladors.CtrlPresentacio.crearPerfil ( String nom, String contrasenya )

inlinestatic

Crea un nou perfil d'usuari amb el nom i la contrasenya proporcionats.

Paràmetres

nom	El nom d'usuari a crear.
contrasenya	La contrasenya associada al nou usuari.

Retorna

true si la creació ha estat satisfactòria; false en cas contrari.

Gràfic de crides a aquesta funció:

eliminarAvatar()

static boolean controladors.CtrlPresentacio.eliminarAvatar ( String avatar_a_eliminar )

inlinestatic

Elimina un avatar del sistema.

Paràmetres

avatar_a_eliminar

El nom de l'avatar a eliminar.

Retorna

Cert si s'ha eliminat correctament, fals en cas contrari.

Gràfic de crides a aquesta funció:

eliminarPerfil()

static boolean controladors.CtrlPresentacio.eliminarPerfil ( ) throws IOException

inlinestatic

Elimina el perfil de l'usuari actiu.

Retorna

Cert si l'eliminació ha estat satisfactòria, fals en cas contrari.

Excepcions

IOException

Si es produeix un error d'entrada/sortida.

Gràfic de crides a aquesta funció:

ferJugadaMaquinaPartida()

static void controladors.CtrlPresentacio.ferJugadaMaquinaPartida ( )

inlinestatic

Executa una jugada automàtica per part de la màquina.

Gràfic de crides a aquesta funció:

finalitzarPerLletresEsgotadesPartida()

static boolean controladors.CtrlPresentacio.finalitzarPerLletresEsgotadesPartida ( )

inlinestatic

Finalitza la partida si ja no queden fitxes disponibles per continuar.

Retorna

Cert si la partida ha estat finalitzada per falta de fitxes.

Gràfic de crides a aquesta funció:

getInstancia()

static CtrlPresentacio controladors.CtrlPresentacio.getInstancia ( )

inlinestatic

Retorna la instancia del controlador de domini.

Retorna

Ctrl_Domini

Gràfic de crides a aquesta funció:

getJugadorsRegistrats()

static HashMap< Integer, Jugador > controladors.CtrlPresentacio.getJugadorsRegistrats ( )

inlinestatic

Retorna el conjunt de jugadors registrats al sistema.

Retorna

Un mapa amb els identificadors i els jugadors corresponents.

Gràfic de crides a aquesta funció:

getLletresJugadorTornPartida()

static List< Fitxa > controladors.CtrlPresentacio.getLletresJugadorTornPartida ( )

inlinestatic

Obté les fitxes del jugador al qual li toca el torn actual.

Retorna

Llista de fitxes del jugador en torn.

Gràfic de crides a aquesta funció:

getNomUsuariActiu()

static String controladors.CtrlPresentacio.getNomUsuariActiu ( )

inlinestatic

Retorna el nom de l'usuari que té la sessió iniciada.

Retorna

El nom de l'usuari actiu.

Gràfic de crides a aquesta funció:

getPartida()

static Partida controladors.CtrlPresentacio.getPartida ( )

inlinestatic

Retorna la instància de la partida actual en curs.

Retorna

L'objecte Partida actiu.

Gràfic de crides a aquesta funció:

getRanking()

static List< Avatar > controladors.CtrlPresentacio.getRanking ( int limit )

inlinestatic

Obté el rànquing global d'avatares limitat a un cert nombre.

Paràmetres

limit

El nombre màxim d'elements a retornar.

Retorna

Llista d'avatares ordenats pel rànquing.

Gràfic de crides d'aquesta funció:

Gràfic de crides a aquesta funció:

guardarPartida()

static void controladors.CtrlPresentacio.guardarPartida ( ) throws IOException

inlinestatic

Desa l'estat actual de la partida en curs.

Excepcions

IOException

Si es produeix un error d'entrada/sortida durant el procés de desament.

Gràfic de crides a aquesta funció:

iniciarSessio()

static int controladors.CtrlPresentacio.iniciarSessio ( String nom, String contrasenya ) throws IOException

inlinestatic

Inicia una sessió amb l'usuari especificat.

Si l'autenticació és correcta, canvia la vista al menú del joc.

Paràmetres

nom	El nom d'usuari.
contrasenya	La contrasenya de l'usuari.

Excepcions

IOException

Si hi ha un error durant l'accés a dades.

Retorna

Un codi d'estat: 0 si l'inici de sessió ha tingut èxit, altre valor en cas d'error.

Gràfic de crides a aquesta funció:

launchApp()

void controladors.CtrlPresentacio.launchApp ( )

inline

Inicialitza l'aplicació creant les instàncies del controlador de domini i de partida, i mostrant la vista principal del menú.

Gràfic de crides d'aquesta funció:

Gràfic de crides a aquesta funció:

passarTornPartida()

static boolean controladors.CtrlPresentacio.passarTornPartida ( )

inlinestatic

Passa el torn a l'altre jugador de la partida actual.

Retorna

Cert si el canvi de torn s'ha fet correctament.

Gràfic de crides a aquesta funció:

reprendrePartida()

static void controladors.CtrlPresentacio.reprendrePartida ( int idSeleccionat )

inlinestatic

Reprèn una partida existent identificada pel seu ID.

Paràmetres

idSeleccionat

L'identificador de la partida a reprendre.

Gràfic de crides d'aquesta funció:

Gràfic de crides a aquesta funció:

sortir()

static void controladors.CtrlPresentacio.sortir ( )

inlinestatic

Tanca la sessió de l'usuari, allibera els recursos gràfics i finalitza l'execució de l'aplicació.

Si no hi ha sessió iniciada o hi ha un error d'entrada/sortida, s'escriu l'error a la consola.

Gràfic de crides a aquesta funció:

tancarSessio()

static void controladors.CtrlPresentacio.tancarSessio ( )

inlinestatic

Tanca la sessió de l'usuari actual i retorna a la vista principal.

Gràfic de crides a aquesta funció:

tornar()

static void controladors.CtrlPresentacio.tornar ( )

inlinestatic

Torna a la vista anterior a l'actual.

Es descarta la vista actual i es mostra la vista prèvia.

Gràfic de crides a aquesta funció:

tornarPartida()

static void controladors.CtrlPresentacio.tornarPartida ( )

inlinestatic

Torna a mostrar la vista actual de la partida després d’una acció temporal.

Documentació de les Dades Membre

ctrlDomini

CtrlDomini controladors.CtrlPresentacio.ctrlDomini

staticprivate

ctrlPartida

CtrlPartida controladors.CtrlPresentacio.ctrlPartida

staticprivate

instancia

CtrlPresentacio controladors.CtrlPresentacio.instancia

staticprivate

vistaActual

JFrame controladors.CtrlPresentacio.vistaActual

staticprivate

vistaPrevia

JFrame controladors.CtrlPresentacio.vistaPrevia

staticprivate

---

La documentació d'aquesta classe es va generar a partir del següent fitxer:

• FONTS/controladors/CtrlPresentacio.java