Sivutus

Sivutukseen käytetään tietokantatasolla LIMIT-käskyä. Jos halutaan hakea tietokannasta kymmenen kissaa, mallikoodiin laitetaan:

/* Haetaan tietokannasta kasa kissoja */
Connection yhteys = Tietokanta.getYhteys();
int montako = 10;

String sql = "SELECT * FROM kissat LIMIT ?";
PreparedStatement kysely = yhteys.prepareStatement(sql);

kysely.setInt(1, montako);
ResultSet tulokset = kysely.executeQuery();

Yleensä halutaan määrän rajoittamisen lisäksi myös kertoa mistä kohtaa listaaminen aloitetaan eli monettako sivua haetaan. Tätä varten lista on pakko järjestää, sillä ilman järjestämistä SQL palauttaa tietokantarivit mielivaltaisessa järjestyksessä, mikä tietenkin tekee sivutuksesta täysin hyödyttömän.

Sivun kertomisen ja järjestämisen saa aikaan OFFSET- ja ORDER BY-käskyillä:

int montako = 10;
int sivu = 2;

String sql = "SELECT * FROM kissat ORDER by nimi LIMIT ? OFFSET ?";
PreparedStatement kysely = yhteys.prepareStatement(sql);

kysely.setInt(1, montako);
kysely.setInt(2, (sivu-1)*montako);

ResultSet tulokset = kysely.executeQuery();

ORDER BY-käskyyn voi myös laittaa useita sarakkeita, minkä lisäksi jokaisen annetun sarakkeen perään voi laittaa myös toisen avainsanoista ASC ja DESC määrittämään se halutaanko tulokset nousevassa (ascending) vai laskevassa (descending) järjestyksessä.

Malliluokkaan kannattaa koodata myös metodi, joka kertoo listauksessa olevien olioiden kokonaismäärän, näin on mahdollista laskea montako sivua listaan tulee:

public static int lukumaara() throws NamingException, SQLException {
  String sql = "SELECT count(*) as lkm FROM kissat";
  Connection yhteys = Tietokanta.getYhteys();
  PreparedStatement kysely = yhteys.prepareStatement(sql);
  ResultSet tulokset = kysely.executeQuery();

  // Tuloksia on aina yksi, mikäli kissat-taulu on olemassa.
  // Kelataan ensimmäiseen tulokseen:
  tulokset.next(); 
  int lkm = tulokset.getInt("lkm");

  //Suljetaan kaikki resurssit:
  try { tulokset.close(); } catch (Exception e) {}
  try { kysely.close(); } catch (Exception e) {}
  try { yhteys.close(); } catch (Exception e) {}

  return lkm;
}

int montakokissaasivulla = 10;
String sivuParametri = request.getParameter("sivu");
int sivu = 1;

//Tarkistetaan että parametri on olemassa, ja että se on numeromuotoinen
if (sivuParametri != null && sivuParametri.matches("\\d+")) {
  sivu = Integer.parseInt(sivuParametri);
}

//Kysytään mallilta kissoja sivulla $sivu, 
List<Kissa> kissat = Kissa.getKissatSivulla(sivu, montakokissaasivulla);

//Kissojen kokonaislukumäärä haetaan, jotta tiedetään montako sivua kissoja kokonaisuudessa on:
int kissaLkm = Kissa.lukumaara();
int sivuja = Math.ceil((double)kissaLkm/montakokissaasivulla);

<c:if test="${sivu > 1}">
<a href="kissalista.php?sivu=${sivu - 1}; ?>">Edellinen sivu</a>
</c:if>
<c:if test="${sivu < sivuja}">
<a href="kissalista.php?sivu=${sivu + 1}">Seuraava sivu</a>
</c:if>

Yhteensä ${kissaLkm} kissaa. 
Olet sivulla ${sivu}/${sivuja}.

Hakulomakkeet

• Useimmiten on parasta sijoittaa hakulomake samalle sivulle listauksen kanssa.
• Haku on kätevä toteuttaa GET-parametrina.
• Jos käytetään sekä hakua, että sivutusta, joudutaan sivutuslinkkehiin sisällyttämään hakusana, ettei sivulta toiselle siirtyminen kadottaisi hakua.
• Vastaavasti hausta huolehtivan malliluokan metodin pitää tarvittaessa tukea sivutusta.