Lajittelu
Lajittelun avulla käyttäjät voivat järjestää sarakkeiden tietoja, mikä helpottaa tietojen lukemista ja analysointia. Tästä on hyötyä, kun käyttäjien on löydettävä nopeasti tietyn sarakkeen suurimmat tai pienimmät arvot.
Lisätietoja Repository-mallin käyttämisestä kokoelmien hallintaan ja niistä tehtäviin kyselyihin on Repository-artikkeleissa.
Saraketta ei oletusarvoisesti voi lajitella, ellei lajittelua ole erikseen otettu käyttöön. Voit sallia tietyn sarakkeen lajittelun käyttämällä setSortable(true)-metodia:
table.getColumn("Age").setSortable(true);
Monisarakelajittelu
25.00 -versiossaEnnen webforj 25.00 -versiota taulukot tukivat oletusarvoisesti usean sarakkeen lajittelua. Versiosta 25.00 alkaen tämä muuttui: kehittäjien on nyt otettava usean sarakkeen lajittelu erikseen käyttöön.
Jos monisarakelajittelua tarvitaan, taulukossa on kutsuttava setMultiSorting(true)-metodia. Näin käyttäjät voivat lajitella useita sarakkeita peräkkäin:
table.setMultiSorting(true);
Kun monisarakelajittelu on käytössä, useiden sarakeotsikoiden napsauttaminen lajittelee sarakkeet peräkkäin. Lajittelun prioriteetti näkyy taulukon käyttöliittymässä.
Voit myös määrittää lajittelun prioriteetin ohjelmallisesti palvelinpuolen lajittelua varten. Kutsu setSortIndex()-metodia niille sarakkeille, jotka haluat lajitella, prioriteettijärjestyksessä:
// Server-side sort order
nameColumn.setSortIndex(1);
ageColumn.setSortIndex(2);
Ellei setSortIndex()-metodia käytetä, taulukko lajittelee oletusarvoisesti sarakkeiden määritysjärjestyksessä.
Lajittelusuunta
Sarakkeen lajittelusuunnalle on kolme mahdollista asetusta:
SortDirection.ASC: lajittelee sarakkeen nousevaan järjestykseen.SortDirection.DESC: lajittelee sarakkeen laskevaan järjestykseen.SortDirection.NONE: saraketta ei lajitella.
Kun sarakkeen lajittelu on käytössä, sarakeotsikon yläosassa näkyy pystysuuntainen nuolipari. Näiden nuolten avulla käyttäjä voi vaihtaa lajittelusuuntaa.
Kun valittuna on nouseva järjestys, näkyvissä on ^, ja laskevassa järjestyksessä näkyvissä on v.
Asiakas- ja palvelinpuolen lajittelu
Tietojen lajittelu voidaan jakaa kahteen pääasialliseen lähestymistapaan: asiakaspuolen lajitteluun ja palvelinpuolen lajitteluun.
Asiakaspuolen lajittelu
Asiakaspuolen lajittelussa tiedot järjestetään ja näytetään suoraan asiakassovelluksen käyttöliittymässä. Kyseessä on lajittelu, jota käyttäjät käyttävät napsauttaessaan sarakeotsikoita. Se vaikuttaa tietojen visuaaliseen esitystapaan näytöllä.
Kehittäjä ei voi hallita asiakaspuolen lajittelua suoraan, vaan se määräytyy Javassa määritetyn saraketyypin mukaan. Tällä hetkellä tuetaan seuraavia tyyppejä:
- TEXT
- NUMBER
- BOOLEAN
- DATE
- DATETIME
- TIME
Asiakaspuolen lajittelu ei toimi, jos asiakkaan käytettävissä on vain osa tiedoista.
Palvelinpuolen lajittelu
Asiakaspuolen lajittelusta poiketen palvelinpuolen lajittelussa tiedot järjestetään palvelimella ennen niiden lähettämistä asiakkaalle. Tämä lähestymistapa on erityisen hyödyllinen käsiteltäessä suuria tietojoukkoja, joiden siirtäminen kokonaisuudessaan asiakkaalle voi olla epäkäytännöllistä.
Kehittäjillä on enemmän mahdollisuuksia hallita palvelinpuolen lajittelun logiikkaa. Näin voidaan toteuttaa monimutkaisia lajittelualgoritmeja ja optimointeja, mikä sopii laajojen tietojoukkojen käsittelyyn. Tällöin asiakas saa valmiiksi lajitellut tiedot, mikä vähentää laajan asiakaspuolen käsittelyn tarvetta.
Palvelinpuolen lajittelu on suorituskykyyn keskittyvä strategia sellaisten tietojoukkojen käsittelyyn, joiden koko ylittää tehokkaan asiakaspuolen käsittelyn mahdollisuudet. Se on Table-komponentin oletusarvoinen lajittelutapa.
Sarakkeen ominaisuuden nimi
Oletusarvoisesti Table käyttää sarakkeen tunnusta ominaisuuden nimenä muodostaessaan lajitteluehtoja taustajärjestelmän repositorylle. Kun sarakkeen näyttötunnus ei vastaa tietojen taustalla olevan ominaisuuden nimeä tai kun sarake näyttää lasketun arvon, kerro setPropertyName()-metodilla Table-komponentille, minkä ominaisuuden mukaan lajitellaan.
// Column ID is "Full Name", but the backend property is "fullName"
table.addColumn("Full Name", Person::getFullName)
.setSortable(true)
.setPropertyName("fullName");
Ominaisuuden nimi välitetään OrderCriteria-oliolle lajittelutapahtuman yhteydessä. Näin taustajärjestelmän repositoryt, kuten Spring Data JPA tai REST-sovittimet, voivat muodostaa oikean ORDER BY -lausekkeen.
Jos setPropertyName()-metodia ei käytetä, Table käyttää sarakkeen tunnusta. Jos se ei vastaa kelvollista taustajärjestelmän ominaisuutta, lajittelu epäonnistuu huomaamatta tai palauttaa väärässä järjestyksessä olevat tiedot.
Myös sisäkkäisiä ominaisuuspolkuja tuetaan piste-erottimella:
table.addColumn("City", Person::getCity)
.setSortable(true)
.setPropertyName("address.city");
Vertailijat
Column-komponentin avulla kehittäjät voivat käyttää Javan Comparator-vertailijoita dynaamiseen ja mukautettuun lajitteluun. Comparator on mekanismi, jolla järjestetään kaksi saman luokan oliota, vaikka luokka olisi käyttäjän määrittämä. Tämän toiminnon ansiosta kehittäjät voivat mukauttaa tietojen lajittelua ja hallita luonnolliseen järjestykseen perustuvaa oletuslajittelua tarkemmin.
Voit ottaa Comparator-lajittelun käyttöön Column-komponentissa käyttämällä setComparator()-metodia. Sen avulla voit määrittää mukautetun Comparator-funktion, joka määrää lajittelulogiikan.
Yllä olevassa esimerkissä määritetään mukautettu vertailijafunktio, joka ottaa kaksi alkiota (a ja b) ja määrittää lajittelujärjestyksen Number-määritteen jäsennettyjen kokonaislukuarvojen perusteella.
Vertailijoiden käyttö sarakkeiden lajittelussa on erityisen hyödyllistä käsiteltäessä muita kuin numeerisia arvoja. Niistä on hyötyä myös monimutkaisten lajittelualgoritmien toteuttamisessa.
Oletusarvoisesti Table käyttää palvelinpuolen lajittelua ja lajittelee ei-primitiiviset arvot Object-luokan toString()-metodilla muuntamalla ne merkkijonoiksi ja lajittelemalla sitten niiden mukaan.
