Entitats.Persistencia
Class Persistencia

java.lang.Object
  extended by Entitats.Persistencia.Persistencia

public class Persistencia
extends java.lang.Object

Classe que implementa el codi necessari per tal de consultar informacio de la BBDD, aixi com tambe modificar aquella informacio que desitjem o afegir-ne de nova. La classe esta pensada per fer de "missatger" entre l'aplicacio i la BBDD, la qual cosa significa que, per exemple, no es comprova que els camps que es volen consultar d'una determinada taula existeixin. Posem per cas que volem fer una consulta: A traves d'un objecte ObjectePersistencia les demes classes de l'aplicacio li comuniquen a aquesta els elements que es volen consultar. Persistencia llegeix d'aquest objecte un nom de camp i un valor associat a aquest i executa una sentencia SQL sense saber si aquell camp realment existeix o si el valor es valid per aquell camp. Un cop s'executa una alta,baixa o modificacio d'una actuacio, els canvis realitzats s'executen a la BBDD. Per tant, la possibilitat de desfer canvis depen exclusivament del sistema de gestio de BBDD amb que es treballa. En qualsevol cas, aquesta classe no implementa aquesta possibilitat.


Constructor Summary
Persistencia(java.lang.String baseDeDades, java.lang.String taula)
          Constructor de la classe.
 
Method Summary
 boolean actualitzaCampNumeric(java.lang.String camp, int valorAntic, int valorNou)
          Metode que ens permet actualitzar un camp numeric d'un element de la BBDD.
 boolean actualitzaCampText(java.lang.String camp, java.lang.String valorAntic, java.lang.String valorNou)
          Metode que ens permet actualitzar un camp text d'un element de la BBDD.
 boolean actualitzaDiversosCampsPerCampNumeric(java.lang.String camp, int valorAntic, ObjectePersistencia dadesActualitzadesObjecte)
          Metode que ens permet actualitzar diversos camps d'un element de la BBDD.
 boolean actualitzaDiversosCampsPerCampText(java.lang.String camp, java.lang.String valorAntic, ObjectePersistencia dadesActualitzadesObjecte)
          Metode que ens permet actualitzar diversos camps d'un element de la BBDD.
 int afegeixElement(ObjectePersistencia dadesNouObjecte)
          Metode que ens permet afegir un element.
 void destructorPersistencia()
          Destructor de la classe Metode que elimina les referencies als objectes manipulats per un objecte Persistencia per tal de que l'objecte "Gargabe Collector" del Java n'alliberi la memoria assignada quan descobreixi que l'objecte ja no te cap referencia.
 boolean eliminaPerCampNumeric(java.lang.String camp, int valor)
          Metode que ens permet eliminar elements de la BBDD a partir d'un camp numeric.
 boolean eliminaPerCampText(java.lang.String camp, java.lang.String valor)
          Metode que ens permet eliminar elements de la BBDD a partir d'un camp de text.
 java.util.Vector obteMajorsQue(java.lang.String camp, int valor)
          Metode que ens permet buscar valors superiors a un valor donat.
 java.util.Vector obteMenorsQue(java.lang.String camp, int valor)
          Metode que ens permet buscar valors inferiors a un valor donat.
 java.util.Vector obtePerAny(java.lang.String camp, int any)
          Metode que ens permet obtenir elements de la BBDD a partir de l'any d'un camp data.
 java.util.Vector obtePerAnyAPartirDe(java.lang.String camp, int any)
          Metode que ens permet obtenir elements de la BBDD a partir de l'any d'un camp data.
 java.util.Vector obtePerAnyMenorOIgualQue(java.lang.String camp, int any)
          Metode que ens permet obtenir elements de la BBDD a partir de l'any d'un camp data.
 java.util.Vector obtePerCampData(java.lang.String camp, int dia, int mes, int any)
          Metode que ens permet recuperar elements de la BBDD a partir d'un camp data determinat que especifiquem.
 java.util.Vector obtePerCampData(java.lang.String camp, java.lang.String data)
          Metode que ens permet recuperar elements de la BBDD a partir d'un camp data determinat que especifiquem.
 java.util.Vector obtePerCampDataUS(java.lang.String camp, java.lang.String valor)
          Metode que ens permet recuperar elements de la BBDD a partir d'un camp data determinat que especifiquem.
 java.util.Vector obtePerCampNumeric(java.lang.String camp, int valor)
          Metode que ens permet recuperar elements de la BBDD a partir d'un camp numeric determinat que especifiquem.
 java.util.Vector obtePerCampText(java.lang.String camp, java.lang.String valor)
          Metode que ens permet recuperar elements de la BBDD a partir d'un camp de text determinat que especifiquem.
 java.util.Vector obtePerDiversosCamps(ObjectePersistencia consul)
          Metode que ens permet obtenir elements de la BBDD a partir d'un o mes camps que coneixem.
 java.util.Vector obtePerDiversosCampsAscPer(ObjectePersistencia consul, java.lang.String campOrdre)
          Metode que ens permet obtenir elements de la BBDD a partir d'un o mes camps que coneixem, ordenats ascendentment per un camp determinat El camps poden ser de qualsevol naturalesa i tants com es vulgui.
 java.util.Vector obteTots()
           
 java.util.Vector obteTotsOrdenatsAscendentment(ObjectePersistencia campsAOrdenar)
           
 java.util.Vector obteTotsOrdenatsDescendentment(ObjectePersistencia campsAOrdenar)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Persistencia

public Persistencia(java.lang.String baseDeDades,
                    java.lang.String taula)
Constructor de la classe. En aquest punt s'intenta crear conexio a la BBDD. L'objecte romandra conectat a la BBDD fins que no s'executi el destructor de la classe

Method Detail

destructorPersistencia

public void destructorPersistencia()
Destructor de la classe Metode que elimina les referencies als objectes manipulats per un objecte Persistencia per tal de que l'objecte "Gargabe Collector" del Java n'alliberi la memoria assignada quan descobreixi que l'objecte ja no te cap referencia. Tambe s'executa la desconexio de la BBDD.


obteTots

public java.util.Vector obteTots()

obteTotsOrdenatsDescendentment

public java.util.Vector obteTotsOrdenatsDescendentment(ObjectePersistencia campsAOrdenar)

obteTotsOrdenatsAscendentment

public java.util.Vector obteTotsOrdenatsAscendentment(ObjectePersistencia campsAOrdenar)

obtePerCampText

public java.util.Vector obtePerCampText(java.lang.String camp,
                                        java.lang.String valor)
Metode que ens permet recuperar elements de la BBDD a partir d'un camp de text determinat que especifiquem. Ja que els camps de text solen contenir valors repetits al llarg de la taula (EX. localitat de residencia), el metode retorna un vector amb tots els elements el camp dels quals coincideix amb el valor aportat.

Parameters:
camp - String amb el nom del camp per el qual hem de cerca l'element
valor - String amb el valor del camp
Returns:
Vector amb tots els elements que coincideixen amb els valors aportats

obtePerCampNumeric

public java.util.Vector obtePerCampNumeric(java.lang.String camp,
                                           int valor)
Metode que ens permet recuperar elements de la BBDD a partir d'un camp numeric determinat que especifiquem. Ja que a priori no sabem si els valors d'aquest camp son unics, el metode retorna un vector amb tots els elements el camp dels quals coincideix amb el valor aportat.

Parameters:
camp - String amb el nom del camp per el qual hem de cerca l'element
valor - Enter amb el valor del camp
Returns:
Vector amb tots els elements que coincideixen amb els valors aportats

obtePerCampData

public java.util.Vector obtePerCampData(java.lang.String camp,
                                        int dia,
                                        int mes,
                                        int any)
Metode que ens permet recuperar elements de la BBDD a partir d'un camp data determinat que especifiquem. Ja que a priori no sabem si els valors d'aquest camp son unics(normalment no ho son, pensem per exemple en una data de naixement), el metode retorna un vector amb tots els elements el camp dels quals coincideix amb el valor aportat.

Parameters:
camp - String amb el nom del camp per el qual hem de cerca l'element
dia - Enter amb el valor del dia
mes - Enter amb el valor del mes
any - Enter amb el valor de l'any
Returns:
Vector amb tots els elements que coincideixen amb els valors aportats

obtePerCampData

public java.util.Vector obtePerCampData(java.lang.String camp,
                                        java.lang.String data)
Metode que ens permet recuperar elements de la BBDD a partir d'un camp data determinat que especifiquem. Ja que a priori no sabem si els valors d'aquest camp son unics(normalment no ho son, pensem per exemple en una data de naixement), el metode retorna un vector amb tots els elements el camp dels quals coincideix amb el valor aportat.

Parameters:
camp - String amb el nom del camp per el qual hem de cerca l'element
data - String amb el valor de la data a cercar
Returns:
Vector amb tots els elements que coincideixen amb els valors aportats

obtePerCampDataUS

public java.util.Vector obtePerCampDataUS(java.lang.String camp,
                                          java.lang.String valor)
Metode que ens permet recuperar elements de la BBDD a partir d'un camp data determinat que especifiquem. Ja que a priori no sabem si els valors d'aquest camp son unics(normalment no ho son, pensem per exemple en una data de naixement), el metode retorna un vector amb tots els elements el camp dels quals coincideix amb el valor aportat.

Parameters:
camp - String amb el nom del camp per el qual hem de cerca l'element
valor - String amb el valor de la data a cercar, en format aaaa-mm-dd
Returns:
Vector amb tots els elements que coincideixen amb els valors aportats

obtePerAnyAPartirDe

public java.util.Vector obtePerAnyAPartirDe(java.lang.String camp,
                                            int any)
Metode que ens permet obtenir elements de la BBDD a partir de l'any d'un camp data. Aquest metode esta pensat per obtenir de manera simple informacio del tipus: Persones que van neixer a partir de l'any X.

Parameters:
camp - String amb el nom del camp a consultar
any - Enter amb el valor a partir del qual buscarem, cap endavant
Returns:
Vector amb un conjunt d'elements el camp dels quals coincideix amb els valors aportats.

obtePerAnyMenorOIgualQue

public java.util.Vector obtePerAnyMenorOIgualQue(java.lang.String camp,
                                                 int any)
Metode que ens permet obtenir elements de la BBDD a partir de l'any d'un camp data. Aquest metode esta pensat per obtenir de manera simple informacio del tipus: Persones que van neixer abans de l'any X.

Parameters:
camp - String amb el nom del camp a consultar
any - Enter amb el valor a partir del qual buscarem, cap enradera
Returns:
Vector amb un conjunt d'elements el camp dels quals coincideix amb els valors aportats.

obtePerAny

public java.util.Vector obtePerAny(java.lang.String camp,
                                   int any)
Metode que ens permet obtenir elements de la BBDD a partir de l'any d'un camp data. Aquest metode esta pensat per obtenir de manera simple informacio del tipus: Persones que van neixer l'any X.

Parameters:
camp - String amb el nom del camp a consultar
any - Enter amb el valor de l'any
Returns:
Vector amb un conjunt d'elements el camp dels quals coincideix amb els valors aportats.

obtePerDiversosCamps

public java.util.Vector obtePerDiversosCamps(ObjectePersistencia consul)
Metode que ens permet obtenir elements de la BBDD a partir d'un o mes camps que coneixem. El camps poden ser de qualsevol naturalesa i tants com es vulgui.

Parameters:
consul - ObjectePersistencia amb els valors dels camps amb els que treballar i els seus valors corresponents
Returns:
Vector amb els elements obtinguts

obtePerDiversosCampsAscPer

public java.util.Vector obtePerDiversosCampsAscPer(ObjectePersistencia consul,
                                                   java.lang.String campOrdre)
Metode que ens permet obtenir elements de la BBDD a partir d'un o mes camps que coneixem, ordenats ascendentment per un camp determinat El camps poden ser de qualsevol naturalesa i tants com es vulgui.

Parameters:
consul - ObjectePersistencia amb els valors dels camps amb els que treballar i els seus valors corresponents
campOrdre - String amb el nom del camp per el que hem d'ordenar ascendentment
Returns:
Vector amb els elements obtinguts

obteMenorsQue

public java.util.Vector obteMenorsQue(java.lang.String camp,
                                      int valor)
Metode que ens permet buscar valors inferiors a un valor donat.

Parameters:
camp - String amb el nom del camp
valor - Enter amb el valor numeric del camp
Returns:
Vector amb tot els resultats

obteMajorsQue

public java.util.Vector obteMajorsQue(java.lang.String camp,
                                      int valor)
Metode que ens permet buscar valors superiors a un valor donat.

Parameters:
camp - String amb el nom del camp
valor - Enter amb el valor del camp
Returns:
Vector amb tots els resultats

eliminaPerCampText

public boolean eliminaPerCampText(java.lang.String camp,
                                  java.lang.String valor)
Metode que ens permet eliminar elements de la BBDD a partir d'un camp de text. El sistema eliminara tots els elements el camp dels quals coincideixi amb el valor donat. Cal recordar que aquesta classe no coneix la naturalesa dels camps amb els que treballa. En altres paraules, si per exemple volem eliminar nomes un element de la BBDD a partir d'un camp text d'aquest, primer s'haura d'assegurar que en tota la taula no hi ha mes d'un element amb el mateix valor.

Parameters:
camp - String amb el nom del camp
valor - String amb el valor del camp
Returns:
boolean amb valor TRUE si s'ha realitzat correctament

eliminaPerCampNumeric

public boolean eliminaPerCampNumeric(java.lang.String camp,
                                     int valor)
Metode que ens permet eliminar elements de la BBDD a partir d'un camp numeric. El sistema eliminara tots els elements el camp dels quals coincideixi amb el valor donat. Cal recordar que aquesta classe no coneix la naturalesa dels camps amb els que treballa. En altres paraules, si per exemple volem eliminar nomes un element de la BBDD a partir d'un camp numeric d'aquest, primer s'haura d'assegurar que en tota la taula no hi ha mes d'un element amb el mateix valor.

Parameters:
camp - String amb el nom del camp
valor - Enter amb el valor del camp
Returns:
boolean amb valor TRUE si s'ha executat correctament

actualitzaCampText

public boolean actualitzaCampText(java.lang.String camp,
                                  java.lang.String valorAntic,
                                  java.lang.String valorNou)
Metode que ens permet actualitzar un camp text d'un element de la BBDD. El metode funciona de la seguent manera: el primer atribut representa el nom del camp que volem modificar, el segon el valor que la BBDD conte actualment i el darrer el nou valor que volem assignar al camp. El primer i segon camp, doncs, s'utilitzen per localitzar l'element del qual volem canviar el valor d'un camp. Cal recordar que si no assegurem que el camp amb el que treballem te valors que son unics, el sistema executara sobre tots els elements que tinguin el valor valorAntic en el camp amb nom "camp".

Parameters:
camp - String amb el nom del camp que volem modificar
valorAntic - String amb el valor actual del camp
valorNou - String amb el valor que volem assignar al camp
Returns:
boolean amb valor true si s'executa correctament

actualitzaCampNumeric

public boolean actualitzaCampNumeric(java.lang.String camp,
                                     int valorAntic,
                                     int valorNou)
Metode que ens permet actualitzar un camp numeric d'un element de la BBDD. El metode funciona de la seguent manera: el primer atribut representa el nom del camp que volem modificar, el segon el valor que la BBDD conte actualment i el darrer el nou valor que volem assignar al camp. El primer i segon camp, doncs, s'utilitzen per localitzar l'element del qual volem canviar el valor d'un camp. Cal recordar que si no assegurem que el camp amb el que treballem te valors que son unics, el sistema executara sobre tots els elements que tinguin el valor valorAntic en el camp amb nom "camp".

Parameters:
camp - String amb el nom del camp que volem modificar
valorAntic - Enter amb el valor actual del camp
valorNou - Enter amb el valor que volem assignar al camp
Returns:
boolean amb valor TRUE si s'ha realitzat correctament

actualitzaDiversosCampsPerCampText

public boolean actualitzaDiversosCampsPerCampText(java.lang.String camp,
                                                  java.lang.String valorAntic,
                                                  ObjectePersistencia dadesActualitzadesObjecte)
Metode que ens permet actualitzar diversos camps d'un element de la BBDD. El metode funciona de la seguent manera: el primer atribut representa el nom d'un camp de l'element a modificar, el segon el valor que la BBDD conte actualment i el darrer el conjunt de nous valors que volem assignar al camp. El primer i segon camp, doncs, s'utilitzen per localitzar l'element del qual volem canviar el valor d'un camp. Cal recordar que si no assegurem que el camp amb el que treballem te valors que son unics, el sistema executara sobre tots els elements que tinguin el valor valorAntic en el camp amb nom "camp".

Parameters:
camp - String amb el nom del camp que volem modificar
valorAntic - String amb el valor actual del camp
dadesActualitzadesObjecte - ObjectePersistencia amb un conjunt de noms de camp que volem actualitzar aixi com el nou valor per aquell camp
Returns:
boolean amb valor TRUE quan s'executa correctament

actualitzaDiversosCampsPerCampNumeric

public boolean actualitzaDiversosCampsPerCampNumeric(java.lang.String camp,
                                                     int valorAntic,
                                                     ObjectePersistencia dadesActualitzadesObjecte)
Metode que ens permet actualitzar diversos camps d'un element de la BBDD. El metode funciona de la seguent manera: el primer atribut representa el nom d'un camp de l'element a modificar, el segon el valor que la BBDD conte actualment i el darrer el conjunt de nous valors que volem assignar al camp. El primer i segon camp, doncs, s'utilitzen per localitzar l'element del qual volem canviar el valor d'un camp. Cal recordar que si no assegurem que el camp amb el que treballem te valors que son unics, el sistema executara sobre tots els elements que tinguin el valor valorAntic en el camp amb nom "camp".

Parameters:
camp - String amb el nom del camp que volem modificar
valorAntic - Enter amb el valor actual del camp
dadesActualitzadesObjecte - ObjectePersistencia amb un conjunt de noms de camp que volem actualitzar aixi com el nou valor per aquell camp
Returns:
boolean amb valor true si s'ha realitzat correctament

afegeixElement

public int afegeixElement(ObjectePersistencia dadesNouObjecte)
Metode que ens permet afegir un element. Cal tenir en compte que aquesta classe no fa cap comprovacio, i per tant, l'execucio pot fallar facilment si, per exemple, l'objecte dadesNouObjecte no conte cap valor per un camp que la BBDD considera que no pot ser nul.

Parameters:
dadesNouObjecte - Objecte del tipus ObjectePersistencia amb les dades del nou element a afegir en el sistema
Returns:
Enter amb el valor que el sistema ha generat automaticament per aquest element