Salta el contingut

1. Classe ResultSet.

Ara que estem connectats a la base de dades, és hora de començar a demanar informació al DBMS. Aquesta informació es proporcionarà en forma de consultes (SQL) o altres mètodes, però gairebé el 90% de les vegades, com en el cas de les consultes SQL, la informació retornada es troba en un format tabular. Els formats tabulars són ben coneguts perquè programes com MySQL Workbench o DBeaver mostren les dades d'aquesta manera.

En Java, la classe que permet treballar amb dades en format tabular provinents de bases de dades es diu Resultset. Un Resultset està compost per una taula (files i columnes) i un punter a una fila, anomenat cursor.

Resultset

  1. Quan recuperem dades de les bases de dades, la informació es guarda a la taula i el cursor apunta a una fila imaginària buida anomenada beforeFirst.
  2. Resultset conté un mètode especial anomenat next(), que fa dues accions:
  3. Retorna true si hi ha una fila de dades després de la fila actual apuntada pel cursor i false en cas contrari.
  4. Avança el cursor i apunta a la següent fila, sols si hi havia una.
  5. Quan el cursor d'un Resultset retorna false, significa que s'han visitat totes les files i ara el cursor apunta a una altra fila imaginària anomenada afterLast.

Quan el cursor apunta a una fila real, és quan podem recuperar les dades de les columnes de la fila actual. Podem utilitzar un mètode especial i sobrecarregat, de la següent manera:

  • getXXX(int posicióColumna) \(\rightarrow\) retorna les dades, on XXX és un tipus de dades (Int, Float, Double, String, etc.) de la posició de la columna, començant per 1.
  • getXXX(String nomColumna) \(\rightarrow\) retorna les dades, on XXX és un tipus de dades (Int, Float, Double, String, etc.) de la columna amb el nom proporcionat.

Perill

Tingueu en compte:

  • Les columnes comencen en 1 en lloc de 0, a diferència dels arrays.
  • Si no coneixeu el tipus de dades d'una columna, podeu utilitzar getObject i aquest retornarà un Object genèric.
  • Aquests mètodes poden generar una SQLException si el rang o el nom de la columna està fora de rang o no existeix.

1.1. ResulSetMetaData

Els ResultSets d'una consulta també tenen un conjunt de metadades. Aquestes metadades es poden obtenir utilitzant ResultSetMetaData. Els mètodes més rellevants d'aquesta classe són:

  • int getColumnCount() \(\rightarrow\) Obté el nombre de columnes al ResultSet.
  • String getColumnName(index) \(\rightarrow\) Obté el nom de la columna indicada en l'índex (recorda que el primer és 1).
  • String getColumnTypeName(index) \(\rightarrow\) Obté el tipus de la columna.

ResulSetMetaData s'obté de cada ResultSet generat prèviament, amb el mètode getMetaData().

1.2. Algorisme ResultSet

Independentment del contingut de dades del teu ResultSet, la manera en què hem de treballar és la següent:

Java
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
// Connect to DB
Connection conn = ...;

// recover data
ResultSet rst= conn...

// while data available exists
while (rst.next()){
    //process the current row
}

Sigues conscient de que:

  • Dins del bucle while no cal cridar next() de nou. Es salta una fila en cas contrari.
  • Quan s'han processat les darreres files, next() retorna false i el bucle finalitza.

1.3. Exemple

En aquest bloc de codi, anem a veure un exemple breu per executar una consulta (Select * from table). Veurem altres consultes en les seccions següents.

Java
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
//with a previous connection
String taula="Jocs";
ResultSet rst = con.createStatement().executeQuery("SELECT * FROM " +taula);
System.out.println(Colors.Cyan);
System.out.println("");
System.out.println("Contingut de " + taula);
System.out.println("******************************");

ResultSetMetaData rsmdQuery = rst.getMetaData();

// print the columns name
for (int i = 1; i <= rsmdQuery.getColumnCount(); i++)
  System.out.print(String.format("%-25.25s",rsmdQuery.getColumnName(i)));

System.out.println();
System.out.println(Colors.Reset);

// print the values
while (rs.next()) {
  for (int i = 1; i <= rsmdQuery.getColumnCount(); i++)
  System.out.print(String.format("%-25.25s ",rst.getString(i)));
  System.out.println();
}