suunnitteludokumentti - cs.helsinki.fi filesuunnitteludokumentti - cs.helsinki.fi

Suunnitteludokumentti

ilpo-ryhmä

Helsinki 6.4.2005

Ohjelmistotuotantoprojekti

HELSINGIN YLIOPISTOTietojenkäsittelytieteen laitos

Kurssi581260 Ohjelmistotuotantoprojekti (6 ov)

ProjektiryhmäArttu ElorantaRisto KuusteräAntti PulkkinenTommi RajalaTuomo SaarinenJari Suominen

OhjaajaTopias Marttila

AsiakasAnni Rytkönen

VastuuhenkilöJuha Taina

Tekniset asiantuntijatJuhani HaavistoHarri LaineTurjo Tuohiniemi

Kotisivuhttp://www.cs.helsinki.fi/group/ilpo

VersiohistoriaVersio Päiväys Tehdyt muutokset0.1 25.3.2005 Ensimmäinen versio1.0 31.3.2005 Technical review:ssä käsiteltävä lopullinen versio1.0.1 4.4.2005 Osittain korjattu versio1.0.2 6.4.2005 Jäädytettäväksi tarjottava versio

i

Sisältö

1 Johdanto 1

1.1 Taustaa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.2 Yleisarkkitehtuuri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.3 Järjestelmän tekninen kuvaus . . . . . . . . . . . . . . . . . . . . . . . . 2

1.4 Termit ja määritelmät . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2 Arkkitehtuurin kuvaus 4

2.1 Sisäiset rajapinnat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.1.1 Kurssi.properties-tiedosto . . . . . . . . . . . . . . . . . . . . . 4

2.1.2 Yleinen.properties-tiedosto . . . . . . . . . . . . . . . . . . . . . 5

2.1.3 HTML-kirjoittaja . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.1.4 Keskeneräisten ryhmittelyiden käsittelijä . . . . . . . . . . . . . 6

2.2 Ulkoiset rajapinnat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.2.1 Desmond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.2.2 Ilmo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.3 Opiskelijanumerotulostin . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3 Luokkarakenne 8

3.1 Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.2 Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.3 View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.4 IO ja DB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4 Käyttöliittymä 10

Liitteet

1 Sekvenssikaaviot

2 Kurssi.properties-tiedosto

3 Yleinen.properties-tiedosto

4 Javadoc

1

1 Johdanto

Joillain kursseilla, kuten Ohjelmistotuotantoprojekti, Tieteellinen kirjoittaminen ja Opet-tajatuutorointi, opiskelijat jaetaan pienryhmiin ilmoittautumisten yhteydessä annettujentaustatietojen ja ryhmätoiveiden mukaan. Tavoitteena ryhmäjaossa on toisaalta muodos-taa mahdollisimman tarkoituksenmukaisia, tasakokoisia ja/tai täysiä ryhmiä, ja toisaaltatäyttää opiskelijoiden esittämiä toiveita niin paljon kuin mahdollista. Tarkoituksenmukai-suus voi tarkoittaa kurssista riippuen erilaisia asioita. Esimerkiksi tieteellisen kirjoittami-sen kurssilla samaan ryhmään kuuluvien opiskelijoiden erikoistumisalueiden tulisi ollayhteneviä. Toisaalta ohjelmistontuotantoprojektissa samaan ryhmään on valittava eri ta-voin suuntautuneita henkilöitä. Tällä hetkellä vastuuhenkilö tekee tämän jaottelun käsinpaperilla. Tarkoitus on tuottaa ohjelmisto, joka helpottaa jaottelijan tehtävää. Suunnittelu-dokumentti esittää tulevan ohjelmiston, jota ollaan tuottamassa ryhmiinjaottelijan avuksi.Siinä kuvataan ohjelmiston rakennetta ja suunnittelun pohjaksi aiottua luokkarakennetta.

1.1 Taustaa

Kursseilla Ohjelmistotuotantoprojekti, Tieteellinen kirjoittaminen ja Opettajatuutorointion keskenään erilaiset sisällölliset ja hallinnolliset vaatimukset. Esimerkiksi Ohjelmis-tontuotantoprojektissa ryhmän koon on oltava 4-6 opiskelijaa. Kurssilla on pakolliset esi-tietovaatimukset, ja joissain aiheissa saattaa olla lisävaatimuksiakin suoritetuista esitieto-kursseista. Opettajatuutorointiin ilmoittautuvat opiskelijat ovat eri vaiheissa opinnoissaanja suorittavat niitä eri tahtiin. Osa opiskelijoista tietää, mihin haluaa suuntautua ja suun-tautumiset vaihtelevat. Ryhmät pyritään muodostamaan siten, että opiskelu olisi opiskeli-joille mielekästä.

Ilpo on Helsingin yliopiston tietojenkäsittelytieteen laitoksella toteutettava projekti. Pro-jekti toteutetaan osana opintojaksoa Ohjelmistotuotantoprojekti. Projektin tarkoitus ontuottaa sovellus, joka auttaa opintojaksojen Opettajatuutorointi, Tieteellinen kirjoittami-nen ja Ohjelmistotuotantoprojekti vastuuhenkilöitä ryhmäjakojen teossa. Kaikki projektinaikana tuotettava materiaali tulee saataville ryhmän kotisivuilla:

http://www.cs.helsinki.fi/group/home/ilpo

1.2 Yleisarkkitehtuuri

Ohjelmisto on jaoteltu viiteen osaan. Nämä osat ovat Model, View, Control, IO ja DB.Syy jaotteluun on ohjelmiston helpompi käsiteltävyys varsinkin päivitystilanteissa. Samaajaottelua käytetään tässä dokumentissa, jotta lukijalle tulisi selkeämpi kuva tuotettavastaohjelmistosta. Model vastaa kaikkia ydinosasia, joilla muodostetaan mm. Opiskelija-oliotja Kurssi-oliot. Model:n luokilla on vastuullaan kaikki looginen toiminnallisuus. View:nluokilla luodaan käyttäjälle tarjottava käyttöliittymä. Control:n luokat huolehtivat käyttö-liittymän toiminnallisuudesta. Haluttaessa käyttää ohjelmaa, Control:n käsittelevät käyt-täjän syötteet. DB:n luokat hoitavat ohjelmiston tietokantayhteydet. Sen osasilla parsi-taan tietokannoista tuleva tieto ja huolehditaan yhteyksien luomisesta ja sulkemisesta.

2

IO:n luokat käsittelevät kaikki tulostuspyynnöt. Johtuen ilmo-järjestelmän huonosta ra-kenteesta, järjestelmän toteuttaminen on monimutkaista. Järjestelmän toteutusta on ku-vattu liitteinä olevina sekvenssikaavioina (liite 1).

1.3 Järjestelmän tekninen kuvaus

Ohjelma toimii Java-sovelluksena graafisella käyttöliittymällä terästettynä. Laitevaatimuk-sena on, että sovellus toimii tavallisessa TKTL:n pöytäkoneessa (ks. termit). Tämä tarkoit-taa implisiittisesti sitä, että järjestelmää voidaan käyttää ainoastaan TKTL:n sisäverkostakäsin. Käyttöjärjestelmistä sen verran, että ohjelma toimii ainakin Linuxissa. Windowsis-sa ohjelma ei välttämättä tule toimimaan. Java-versiona käytetään JDK 5.0:aa (eli J2SESDK 1.5.0) ja Desmond-tietokantaan ollaan yhteydessä JDBC-rajapinnan kautta. Työnalla olevat ryhmittelyt tallennetaan levylle sarjallistuvina olioina ja valmiit ryhmittelytIlmo-tietokantaan jo olemassa olevan PL/SQL-skriptin avulla.

1.4 Termit ja määritelmät

Bodbacka: TKTL:n tietokantapalvelin.

Desmond (http://ilmo.cs.helsinki.fi/desmond/): Aiempien ohjelmistotuotantoprojektientuottama opintojensuunnittelujärjestelmä. Desmondin www-selaimessa toimivalla käyttö-liittymällä opiskelijat voivat suunnitella opintojaan lukukausittain. Desmondissa on myösmuita toimintoja, jotka auttavat esimerkiksi tuutoroinnissa, mutta ne ovat projektin kan-nalta epärelevantteja.

desm_: Etuliite, jota käytetään viitattaessa Desmond-järjestelmän tietokantatauluihin.

Ilmo (http://ilmo.cs.helsinki.fi/): Kurssi-ilmoittautumisjärjestelmä opiskelijoille. Järjes-telmä on tarkoitettutietojenkäsittelytieteen laitoksen kursseille ilmoittautumiseen. Ilmollailmoittaudutaan myös matematiikan kursseille, mutta sillä ei ole tämän projektin kannaltajuuri mitään merkitystä.

Ilpo: Sovelluksen toteuttavan ohjelmistotuotantoprojektiryhmän ja lopullisen järjestel-män nimi.

JAR (Java Archive file format): JAR:n avulla voidaan pakata useita tiedostoja yhteenJAR-tiedostoon. Tyypillisesti JAR-tiedostosisältää luokkatiedostoja sekä sovelluksiin jasovelmiin liittyviä lisäresursseja.

JDBC (http://java.sun.com/products/jdbc/): Sun Microsystemsin JDBC-teknologia on Ja-va-kielelle toteutettu sovellusrajapinta (API, ApplicationProgramming Interface) joka tar-joaa liityntämahdollisuuden useiden eri valmistajien relaatiotietokantoihin ja mm. lasken-tataulukoihin (spreadsheets).

Järjestyskriteeri: Järjestyskriteerit ovat Ilmo-lomakkeen yksittäisiä vastauksia: esimer-kiksi suuntautumislinja, kieli, esitiedot, opiskelijan tila.

Kontti: ATK-osaston tietokantapalvelin.

3

Kurki: Laitoksen henkilökunnan käyttöön tarkoitettu kurssikirjanpitojärjestelmä johonmerkitään mm. opiskelijoiden tekemät laskuharjoitukset. Käyttää samaa tietokantaa kuinIlmo.

Kurssi: Kurssi on opintojakson ilmentymä. Kurssi määritellään erikseen kyseessä oleval-le periodille, lukukaudelle ja -vuodelle.

Kurssi.properties: Kurssi.properties-tiedosto sisältää yhden kurssin asetustiedostot. Tie-dostossa on tiedot, joiden avulla kurssi voidaan yksilöidä ja tiedot, joiden avulla ilpo pys-tyy parsimaan opiskelijoiden vastaukset luettavaan muotoon.

Käyttäjä: Ilpolla ryhmittelyä suorittava henkilö.

Lukitus: Yhden opiskelijan kiinnittäminen pysyvästi tiettyyn ryhmään siten, että opiske-lija ei näy enää muissa ryhmissä.

Oodi (http://www.helsinki.fi/weboodi/): Opiskelun ja opetuksen tuen tietojärjestelmä. Oo-dista löytyvät muun muassa opiskelijoiden opintosuoritukset.

Opintojakso: Opintojakso määrittelee opetettavalle aihepiirille nimen ja laajuuden sekämuut yleisetluentokerrasta riippumattomat tiedot.

Opiskelija: Kurssille ilmoittautunut henkilö, jota sijoitetaan ilpolla ryhmiin.

PL/SQL (Procedural Language/SQL): PL/SQL on laajennus SQL-kyselykieleen. Se lisääperus-SQL:ään proseduraalistenohjelmointikielten rakenteita, jolloin tuloksena on perus-SQL:ää ilmaisuvoimaisempi rakenteellinen kieli.

Ryhmittely (Ryhmiin jako): Opiskelijoiden jakaminen ryhmiin.

Ryhmä: Kokonaisuus mihin ilpolla siirretään opiskelijoita. Ryhmässä on opiskelijoita jahenkilökunnan jäseniä.

Ryhmälukitus: Ryhmän lukitseminen siten, että kaikki ryhmässä olevat opiskelijat eivätenää näy muissa ryhmissä.

Sarjallistuva olio: Ohjelmointikielen olio, jonka tila voidaan konvertoida tavuvirraksi (jatoisinpäin). Käytännössä tämä tarkoittaa, että koko olio voidaan esimerkiksi tallentaa kiin-tolevylle myöhempää käyttöä varten. Sarjallistuvia olioita on ainakin Java-ohjelmointi-kielessä.

Sisäinen tietorakenne: Oliorakenne, joka on pelkästään ilpon sisäisessä käytössä ja mi-hin on tallennettu tietoja.

Tavallinen TKTL:n pöytäkone: Käyttöjärjestelmänä Linux graafisella ikkunointiympä-ristöllä, näyttö 1280x1024 resoluutiolla sekä vähintään 1.5 GHz suoritin ja vähintään512Mt keskusmuistia.

TKTL: Helsingin yliopiston Tietojenkäsittelytieteen laitos.

Tulosryhmä: Järjestyskriteerin mukaisesti tehty järjestely jakaa opiskelijat tulosryhmiin.

Yleinen.properties: Yleinen.properties-tiedosto sisältää ohjelman tarvitsemat yleiset ase-tustiedot. Näitä ovat tietokantapalvelimen osoite ja portti sekä tietokannan nimi.

4

2 Arkkitehtuurin kuvaus

Tässä luvussa kuvataan sisäisten rajapintojen ja ulkoisten rajapintojen arkkitehtuuria. Ul-koiset järjestelmät ovat meistä riippumattomia, olemassa olevia ohjelmistoja, kuten Des-mond ja Ilmo. Niihin päästään käsiksi rajapintojen kautta. Sisäiset rakenteet ovat niitä,jotka luomme ja joilla mm. otetaan rajapintayhteydet ulkoisiin järjestelmiin. Arkkiteh-tuurin kuvaukseen kuuluu myös kuvaus Opiskelijanumerotulostimesta, jolla päivitetääntietoja Desmondiin. Kaikista kohdista on laajemmin tietoa aliluvuissa.

2.1 Sisäiset rajapinnat

Sisäiset rajapinnat liittyvät tässä yhteydessä ohjelmiston asetuksiin ja kurssi-ilmottautu-misten parsimiseen. Tässä käsitellyt Kurssi.properties-tiedosto ja Yleinen.properties-tie-dosto ovat vahvasti yhteydessä ulkoisiin rajapintoihin. Niiden tarkempi rakenne kuvataanaliluvuissa.

2.1.1 Kurssi.properties-tiedosto

Kurssi.properties-tiedosto (liite 2) sisältää ohjelman tarvitsemat kurssikohtaiset tiedot.Näitä tietoja ovat: kurssin nimi, kurssikoodi, kurssin järjestysnumero, lukukausi ja luku-vuosi. Tämän lisäksi kurssi.properties-tiedostossa kerrotaan Ilpolle, miten ohjelma parsiiyhteen kurssille ilmoittaumisen yhteydessä kysytyt kysymykset ja kurssille ilmoittautu-neet opiskelijat. Ilpon parsiessa Ilmosta haetut kysymykset luettavaan muotoon, lukee sekurssi.properties-tiedostosta ohjeet, miten sen tulisi parsia mikäkin kysymys.Kurssi.properties-tiedosto pitää myös sisällään joukon muuttujia, joilla määritellään ryh-mäjaon HTML-tulosteeseen liittyvät tekstit. Näitä ovat esimerkiksi tiedot ryhmien ensim-mäisistä kokoontumisajoista ja ohjeet ylivuotoryhmäläisille, sekä kaikki sivulla esiintyvätotsikot. kurssi.properties-tiedoston sisältö on seuraavanlainen:

Kurssin perustiedot

koodi (esim. koodi = 58110-3):Kertoo kurssin kurssikoodinumeron

kurssijärjestysnumero (esim. kurssiJarjestysnumero = 1):Kertoo kurssin järjestysnumeron, eli jos sama kurssi luennoidaan useampaan kertaan sa-man lukukauden aikana, niin tämän numeron avulla erotetaan kurssit toisistaan.

lukukausi (esim. lukukausi = k):Kertoo käydäänkö kurssi syksyllä (s), keväällä (k) vai kesällä (v).

lukuvuosi (esim. lukuvuosi = 2005):Kertoo lukuvuoden, jolloin kurssi käydään.

Parsimisessa tarvittavat tiedot Jotta opiskelijoiden vastaukset saataisiin parsittua oikein,täytyy kurssin vastuuhenkilön määrittää kurssi.properties-tiedostoon, että millä tavalla ky-symykset parsitaan.Seuraavat parsimisessa tarvittavat tiedot kirjoitetaan muotoon: kysy-

5

mys.numero.optio = arvo.

kannassa (esim. kysymys.1.kannassa = 3):Kertoo Ilpolle, mikä on Ilpon kysymyksen numero 1 numero Ilmon tietokannassa.

preferenssi (esim. kysymys.2.preferenssi = 1):Kertoo Ilpolle, että mikä järjestysnumero annetaan vastauksen osalle. Tätä optiota tarvi-taan ilmoittautumisen yhteydessä kysytyissä kysymyksissä, joissa annetaan vastaus avoi-meen tekstikenttään ja vastaus pitäisi jakaa useampaan osaan. Esimerkiksi jos opiskeli-jalta kysytään kiinnostuksen kohteita annetusta listasta ja pyydetään vastaamaan pelkäs-tään pilkuilla erotetuilla numeroilla, niin preferenssi-option avulla saadaan vastauksenkiinnostuksen kohteet eriteltyä omiksi riveikseen. Lisäksi preferenssi-optiota käyttämällämääritellään myös, että kuinka monta vaihtoehtoa opiskelijan vastauksesta huomioidaan.

csv (esim. kysymys.2.tyyppi = csv):Kertoo Ilpolle, että vastauksen tyyppi on pilkuilla erotettu arvo (=csv, comma separatedvalues). Tätä optiota tarvitaan kertomaan Ilpolle, että miten se parsii tekstikenttä-tyyppisiävastauksia. Ilpossa erotellaan vain pelkistä numeroista koostuvia vastauksia.

vv (esim. kysymys.2.p1.vv.3 = Käyttöliittymät):Kertoo Ilpolle kysymyksen vastausvaihtoehtonumeroa vastaavan tekstin. Tätä tietoa tar-vitaan joissain tekstikenttä-tyylisissä kysymyksissä.

html.otsikko (esim. html.otsikko = Kevään 2005 ohjelmistotuotantoprojektien alustavaryhmäjako):Kertoo HTML-parsijalle, mikä on ryhmienjaon lopputuloksena tehtävän html-sivun ot-sikko.

html.ingressi (esim. html.ingressi = Seuraavassa on 12.01.2005 päivätty lista kevään2005 ohjelmistotuotantoprojekteista.):Kertoo HTML-parsijalle, mikä on sivun sisältöä kuvaava teksti.

html.kokoontumisajat (esim. html.kokoontumisajat = (24.1.2005 - 28.1.2005). Projektitpäättyvät viimeistään viikolla 18 (2.5.2005 - 6.5.2005).):Kertoo HTML-parsijalle kokoontumisajat-tekstin.

html.jonotusotsikko (esim. html.jonotusotsikko = Jonotuslista):Kertoo HTML-parsijalle jonotusotsikko-tekstin.

html.jonotusohjeet (esim. html.jonotusohjeet = Seuraavat henkilöt ovat jonossa: Manta-tarms Suominen, Risto-Ville Kuusinen, Matias Torppila.):Kertoo HTML-parsijalle jonotusohjeet-tekstin.

html.spostiosoite (esim. html.spostiosoite = [email protected]):Kertoo HTML-parsijalle sähköpostiosoite-tekstin.

2.1.2 Yleinen.properties-tiedosto

Yleinen.properties-tiedosto sisältää ohjelman tarvitsemat yleiset asetustiedot.Yleisiä tie-toja ovat tietokantapalvelimen osoite ja portti sekä tietokannan nimi.

6

tk.osoite: Tietokantapalvelimen osoitetk.portti: Tietokantapalvelimen porttitk.nimi: Tietokannan nimi

Liitteenä (liite 3) esimerkki yleinen.properties-tiedostosta.

2.1.3 HTML-kirjoittaja

HTML-kirjoittaja tulostaa Ilmo-ryhmiin liitetyn ryhmittelyn HTML-sivun osana. Tulos-tiedosto vastaa osoitteessa http://www.cs.helsinki.fi/group/ohtu/k-2005/ryhmajako.htmlolevaa sivua, kuitenkin siten, että se pitää sisällään ainoastaan header loppuu- ja traileralkaa-kommenttien välisen alueen. Tiedosto kirjoitetaan käyttäjän valitsemaan paikkaanja siinä esiintyvät tekstivakiot määritellään kurssi.properties-tiedostossa. HTMLKirjoitinon yhden metodin kirjastoluokka, joka saa parametrinaan kurssi-olion ja kohdetiedoston-nimen. Kirjoituksessa käytetään apuna Tiedostokirjoittaja-luokan metodeja.

2.1.4 Keskeneräisten ryhmittelyiden käsittelijä

Keskeneräisten ryhmien käsittelijällä on kaksi toimintoa: nykyisen ryhmäjaon tallettami-nen halutulla nimellä levylle ja valitun ryhmäjaon lataaminen levyltä. Osajärjestelmäntoiminta perustuu olioiden sarjallistuvuuteen: kun sarjallistuva kurssi-olio kirjoitetaan le-vylle myös kaikki oliot joihin se viittaa kirjoitetaan talteen. Ryhmittelyn latauksen yhtey-dessä ohjelma palautetaan talletettuun tilaan.

2.2 Ulkoiset rajapinnat

Ulkoisia rajapintoja ovat Desmond ja Ilmo. Molemmat järjestelmät ovat suunniteltu omiinkäyttötarkoituksiinsa, joten niiden hyödyntäminen Ilpo-projektissa on hieman kankeaa.Desmondin tietokannan tietoja ei voida päivittää mitenkään Ilposta-käsin. Tämän takia Il-pon tulee pystyä tuottamaan lista niiden opiskelijoiden opiskelijanumeroista, joiden tiedothalutaan päivittää Desmondiin. Tekstimuotoisen tiedoston tulee sisältää yksi opiskelija-numero riviä kohti. Tämän tiedoston avulla Desmondin ylläpitäjä (tai vastaava henkilö)päivittää Desmondin tiedot ajantasaiseksi.

Desmondin palvelun käyttämisestä on kerrottu tarkemmin seuraavassa aliluvussa. Ilmo-tietokannan rakenne ei ole, ainakaan Ilpon näkökulmasta, kovin järkevästi toteutettu. Esi-merkiksi opiskelijoiden toiveet kurssijaon suhteen ovat pilkulla erotettuna yhdessä teks-timuotoisessa kentässä. Muun muassa tämän johdosta Ilpo joutuu parsimaan tietoa "tar-peettomasti". Ilmosta on kerrottu tarkemmin luvun toisessa alikappaleessa.

2.2.1 Desmond

Yhteys Desmondiin hoidetaan projektiryhmälle toimitetun Desmond.jar-paketin avulla.Paketti tarvitsee toimiakseen luokkapolun määrittelyn. Esimerkiksi:

7

java-classpath Desmond.jar:/opt/jdbc/classes12_01.zip:. OhjelmaOhjelman kääntäminen tapahtuu vastaavasti, parametrit pitää huomioida Ant-tiedostossa.Puuttuvien esitietojen tarkistamiseksi paketista kutsutaan Esitiedot luokan staattista tar-kistaEsitiedot-metodia. Metodille annetaan ensimmäisenä parametrina tarkastettavien o-piskelijoiden käyttäjätunnukset sisältävä olio, jonka tulee toteuttaa Collection-rajapinta.LinkedList-olio sopii tähän tarkoitukseen hyvin. Toisena parametrina annetaan profiloi-tavan kurssin kurssikoodi, esim. "581260-4". Metodi palauttaa opiskelijoilta puuttuvatesitiedot Collection-oliona. Palautettu olio sisältää joukon Collection-olioita. Nämä oliottaas sisältävät opiskelijan String-muotoisen käyttäjätunnuksen sekä Collection-olion, jo-ka sisältää puuttuvat kurssit os2.ljk.EsitietoKurssit-olioina. EsitietoKurssit-oliot sisältä-vät kaksi metodia: annaKurssikoodi() ja annaTaso(). Molemmat näistä palauttavat String-muotoisen arvon ja annaTaso-metodi palauttaa arvonaan joko "pakollinen", "hallittava"tai"suositeltu".

Kuvassa 1 on selvennetty tarkistaEsitiedot-metodin palauttaman Collection-olion raken-netta. Huom! Jos käyttäjätunnus-olio on olemassa, niin silloin myös sen "sisarsolmu"eliCollection on olemassa. Jos sitä ei ole olemassa niin sisarsolmuakaan ei ole olemassa.Tämä pätee myös toisin päin.

Kuva 1: tarkistaEsitiedot-metodin paluuarvon "rakenne"

2.2.2 Ilmo

Ilpo-ryhmän käyttöön on luotu kaksi teoriassa identtistä Oracle-testikantaa, toinen Kont-tiin ja toinen Bodbackaan. Ryhmä päätti käyttää projektin tuotoksena syntyvässä ohjel-massa ainoastaan Kontti-yhteyttä. Javan JDBC:n avulla toteutettava tietokantayhteys tar-vitsee toimiakseen polkumäärittelyn, joka viittaa Oraclen JDBC-tietokanta-ajuriin. Tämäonnistuu esimerkiksi komennolla:java -classpath /opt/oracle-client-10.1.0/jdbc/lib/ojdbc14.jar:. OhjelmaHuomaa myös Desmond.jar-paketin vaatimukset polkumäärittelyjen suhteen. Tietokan-nan nimi, osoite ja portti määritellään yleinen.Properties-tiedostossa. Tästä enemmän ark-kitehtuurin kuvaus-luvussa. Valmiiksi ryhmitellyt ryhmät tallennetaan Ilmo-tietokantaan.Tallentaminen tapahtuu joko PL/SQL-skriptin avulla tai sitten suoraan SQL-lauseilla.Ryhmä ei ole saanut riittävästi tietoa tästä asiasta lukuisista pyynnöistä huolimatta.

8

2.3 Opiskelijanumerotulostin

Opiskelijanumerotulostimella kirjoitetaan tiedostoon niiden opiskelijoiden opiskelijanu-merot, joiden tiedot halutaan päivitettävän Desmond-järjestelmään. Käytännössä tämä si-sältää profiloitavalle kurssille ilmoittautuneet opiskelijat. Tiedosto sisältää yhden opiskeli-janumeron riviä kohti. Luokan ilmentymä saa kirjoitusmetodilleen parametrina Collection-rajapinnan toteuttavan olion, joka sisältää Opiskelija-olioita. Kirjoituksessa käytetään apu-na Tiedostokirjoittaja-luokan metodeja.

3 Luokkarakenne

Tässä luvussa kuvataan ohjelmiston luokkarakenne. Luokat on jaoteltu pakkauksiin japakkauksia on luotu viisi kappaletta. Luokkaryhmät, joita pakkaukset pitävät sisälläänovat nimeltään Model, Control, View, IO ja DB. Kaikki ryhmät käsitellään seuraavissaaliluvuissa. Tarkempi kuvaus jokaisesta pakkauksesta löytyy API-kirjastosta, joka on liit-teenä Javadoc muodossa (liite 4).

3.1 Model

Model-luokat sijaitsevat fi.helsinki.cs.ilpo -pakkauksessa. Kyseessä on järjestelmän sisäi-seen tietorakenteeseen liittyvät luokat, joissa on myös kaikki niihin liittyvä looginen toi-minnallisuus. Kurssi ja Opiskelija luokat ovat ne millä pääsääntöisesti operoidaan. Niil-lä muodostetaan Kurssi-, Ilporyhmä- ja Opiskelija-olioita. Opiskelija-olioita sijoitellaanIlporyhmä-olioihin. Muut luokat ovat avusteisia näille luokille. Ne liittyvät kursseihin,opiskelijoihin ja ryhmiin kuuluvien tietojen käsittelyyn. Sisäinen tietorakenne on kuvattukuvassa 2.

3.2 Control

Control-luokat sijaitsevat fi.helsinki.cs.ilpo.control -pakkauksessa. Kyseessä on käyttäjänsyötteiden proseissoinnin hoitavat luokat. Suunnitteluvaiheessa eri Control-luokkia ei oleyksityiskohtaisesti suunniteltu, mutta niiden yleinen teoreettinen KontrolliPalikka-luokkakuvaa teoriassa kaikkia mahdollisia control-luokkia.

3.3 View

View-luokat sijaitsevat fi.helsinki.cs.ilpo.view -pakkauksessa. Kyseessä on graafisen käyt-töliittymän komponentit sisältävät luokat. View-luokat muodostuvat lopullisessa toteu-tuksessa kahdenlaisista luokista: valmiista Swing-komponenteista perittävistä luokista se-kä puhtaasti grafiikalla tehtävistä luokista. Varsinkaan kaikkia Swing-ratkaisuun liittyviäluokkia ei ole vielä tarkasti suunniteltu.

9

��

� � � ��

� � � � � � � � � � � � � � �� ! � � � � � � � � � � ��

� � � � � � ! � � � � � � � � � � �� " � � � #� � � � � � ! ��

� � � � � � " � � � #� � � � � � ! ��

� � ! � � � � � � � � � � � � � � � � $ � � �� ! � � � � � � � � � �� ! � � � � � � � � � � � � � � ��

� � � � � ! � � � � � � � � � �� ! � � � � � � � � � � � � � � ��

� � � � " � � � #� � � � � � " � � � #� � � �� % � � � � � � � � � ! � � � � � � � � � � $ � � �� &� � � � �� '� � � � � �� '� � � � � ��

� � � � &� �� &� �� '� � � � &� �� '� � � � � �� &� �� &� ��

()* + ,- ./ 0� � � �� 1� � ��

� � � #� � � � � � � � �� " � � � #� � � � � � � � ��

� ��

() / + ,- ./ 0� � � � � � � � � � � � � �

2* � � 34 ) �5 0��

� � � � � �� 1� � �� &� � � � � � � � � � � �

� � � � � � � � � � �

� � � � � &� � � � � � � � � �

� � � � � � � � � � �

� � � � � � � � � � � � �! � � � � � � � � � �� 1 ��

� � � ! � � � � � � � � � � � � �� ! � � � � � � � � � � � � �� ! � � � � � � �� " � � � #� � � � � ��

�� #� � � � � � � � �� " � � � #� � � � � ��

�� " � � � � � ��

� � ! � � � � � � � � � � � � � � � � � � � ! � � � � � � � � � � � � � � � � � � ��

� � � � � ! � � � � � � � � � � � � � � ��

� � � � � � ! � � � � � � � � � � � � � � �� 6 � � �� % � � � � �� ! � � � � � � � � � � � � � � � � � ! � � � � � � � � � �� 7 � � � � � �� 8 � � � �� 8 � � � �� ! � � � � � � � � � � � �� 8 � � � �� ! � � � � � � � � � �� '� � � � � �� '� � � � � '� � � � � � �� '� � � � �� '� � � � ��

9 0* 0 0 3 - � - / - � � �� " � � � � � � � � � '� � � � � �� : � � � � � � � � � � � � � � ��

�- � - / - � � �� " � � � � � � � � �

� � � � � &� �� &� �� : � � � � � � � � � � � � � : � � � � � &� �� '� � � � � '� � � � � � � � � �� '� � � � � '� � � � � � � � ��

� � � � '� � � � � '� � � � � � � � ��

9 0 � ; 0 � � 9 0 � . ; +4 . ; +�� '� � � � � � � � ��'� � � � � �� : � &� �� ! � � � � � � � � � � � ! � � � � � � � � � ��

9 0* 0 0< 0 � ; 0 � �� '� � � � �� '� � � � � �� : ��

=4 > 3 �) + 3 � > ; 0 ) 0 � >4 >� � � ��

2* � > ; +5 0 3 � +� � � �� ! � � � � � � � � � � � � � � � � � ! � � � � � � � � � �� 8 � � � ��

? � + � � ;4 ; ; � 2* � > ; +5 0 3 � +� � � �� ! � � � � � � � � � � �� ! � � � � � � � �: � � � � � � � : � � �� : � � ! � � � � � � � � � �� @ � * � < 0 2* � > ; +5 0 3 � +� �� &� � � � � � � �8 � � � �� ! � � � � � � � � � � �� ! � � � � � � � �: � � ! � � � � � � � � � ��

? �< � 0 � >4� � �� "A � � � �� : � � � ��

� � + � � ;4 ; ; � ? �< � 0 � >4 3 � � � � � � � � � � � � � ��

B

C

C

C

BD $ � � �� E � � � � � � � ! � � � � � � � � F C

B

B

C

BC

B

C

G

G

CC

B

C

B

C

B C

C

B

B

CBC

C

B

$ � � �� B

C

7 � � � � � ��

B

C

7 � � � � � ��

B

C

Kuva

2:Luokkarakenne

elijärjestelmän

ydin

10

3.4 IO ja DB

Tiedostoja käsittelevät luokat ovat omassa pakkauksessaan (fi.helsinki.cs.ilpo.io). Pak-kauksessa on luokat tulostiedostojen (opiskelijanumerolista ja valmis ryhmittely) kirjoi-tusta varten sekä työvälineet, joilla keskeneräisiä ryhmäjakoja voidaan tallettaa ja ladata.Tietokantayhteys, kantaan tehtävät kyselyt sekä kyselyjen käsittely sijatsevatfi.helsinki.cs.ilpo.db -pakkauksen luokissa. Paketteihin liittyvät luokat esitellään kuvassa3.

4 Käyttöliittymä

Ilpon käyttöliittymän suunnitelma löytyy määrittelydokumentin liitteestä. Tähän ei otetatarkemmin kantaa tässä dokumentissa. Tässä dokumentissa käsitellään vain käyttöliitty-män toteutusta.

Käyttöliittymän fyysinen rakenne koostuu kolmesta osasta: vasemmalla ylhäällä olevas-ta sort-solusta, vasemmalla alhaalla olevasta detail-solusta ja oikealla olevasta ryhmä-solusta. Sort-solu koostuu kahdesta tab-lehdestä: opiskelijoiden sort-solusta ja henkilö-kunnan sort-solusta. Opiskelijoiden sort-solu sisältää kurssille ilmoittautuneita opiske-lijoita esittäviä palloja, ja tämä toteutetaan kokonaan grafiikalla. Henkilökunnan sort-solu sisältää listan kurssille ilmoitetuista henkilökuntalaisista, ja tämä toteutetaan swing-komponenteilla. Detail-solussa on joko tarkkaa tietoa yhdestä valitusta opiskelijasta taivähemmän tarkkaa tietoa useasta valitusta opiskelijasta. Nämä toteutetaan swing-kom-ponenteilla. Ryhmäsolu toteutetaan kokonaan grafiikalla. Se sisältää ryhmiä sekä niissäolevia opiskelijoita kuvaavia palloja ja henkilökuntalaisia kuvaavia komponentteja.

Varsinkaan grafiikalla toteutettavia osia ei ole tarkasti suunniteltu, koska kenelläkään ryh-mäläisellä ei ole vankkaa kokemusta tai tietoa, kuinka se pitäisi tarkalleen ottaen tehdä.Swing-komponenteilla toteutettavien osien suunnitelmat taas ovat vajaita, koska swinginrakenne pakottaa käyttämään todella monia sisäkkäisiä luokkia (kuten JScrollPane, jokamahdollistaa näytön skrollauksen). Näitä ylimääräisiä luokkia ei ole suunnitelmiin miten-kään sisällytetty. Käyttöliittymäsuunnittelun pohjalla on ryhmämme oma tulkina model-view-control (MVC) -ratkaisusta. MVC on suunnittelumalli, jonka idea on jakaa järjestel-män toiminnallisuus kolmeen osaan: model-osassa on järjestelmän looginen toiminnalli-suus (sekä tietosisältö), view-osassa on käyttäjälle esitettävä osa (eli graafisen käyttöliit-tymän komponentit, kuten napit ja muut napiskuukkelit) ja control-osassa on käyttäjänsyötteiden prosessointi.

Ilpo on jaettu pakkauksiin siten, että fi.helsinki.cs.ilpo -pakkauksessa on model-luokat,fi.helsinki.cs.ilpo.view -pakkauksessa on view-luokat ja fi.helsinki.cs.ilpo.control -pakka-uksessa on control-luokat. Käyttöliittymän luokkien välisiä yhteyksiä tarkastellaan kuvis-sa 4, 5 sekä 6. Kaikki model-luokat on kuvattu täydellisesti. View-luokat on kuvattu niintarkasti, kuin suunnittelun kannalta on ollut järkevää, eli jokaista Swing-komponenttienperintää ja muita suoraan Swingiin liittyviä ominaisuuksia ei ole dokumentoitu. Yhtäkäänyksittäistä control-luokkaa ei ole käytännössä lainkaan suunniteltu, mutta yleisesti kaik-kien control-luokkien toiminta on sen sijaan suunniteltu. KontrolliPalikka -luokka kuvaa

11

��

� � � ��

� � � ��

� � � ��

� � � ��

��

� � � � � � � � � � � ��

! � � � �� " � # � � � � $ � � � �� % � � � �� % � � � �� % �� % � � � � � � � � � � � �� & � # � �'

� ( � � � � ) �� $ � �� & � * � � ( � �

� # � � + � � �� $ & � , � � � � �

� ( � � + � � �� $ & � , � � � � �

- �. /0 �1 2 � � � � �

� �� 3 !4 5 $ � �' � � � � � �� & � , � � � � �

0 � �� 1 � � �� 6 � 7 �� 0 � � � �� 8 � 2�

� �' � � � � � ��

� � � � ! � �' � � � $ � �' � � � � � �� & � # � �'

� � � � � * � �� $ & � , � � � � �

� � � * � �� $ & � , � � � � �

9: � �� 8 � 2� �; 7 � 1 � �; 8 � � � �

� �� " � � � � � � � $� " � � � � � � � � �� % � �' � � � � � �� & � , � � � � �

0 ; 1 �

� ��

� (� � � � �� ' � � � � � ��

( � ( �� ( � � � � � � �

( � (# ( � � � � � �

� (� � � �< � � � � � �� (� ��

� " � � � # � � �� ' � ( , �

� � 5 ( � ( �� (' � � � �� $ & � � � � ��

( � � " � � � � � � � $ & � # � �'

" � �# � � � " � � � � � � � $ & � # � �'

( � = � � * � �� < � � " � $ & � # � �'

" � �# � � = � � * � �� < � � " � $ & � # � �'

� � � " � � � � � � � � (� �� $ & � ��

" � �# � � � " � � � � � � � �' � � � " � � � � ( � � � ( � � � $ & � # � �'

� � (' � � " � � � � � � � �' � � � " � � � � ( � � � ( � � � $ & � # � �'

� � � � = � � * � �� $ & � = � � * � ��

� � � � � ( ( � � � � � � " � � � � � � � $ & � ��

) (� � � � $ & � # � �'

� � � � >� " � � � �� $# � � >� " � � � �� & � # � �'

� � � � ) �� $ � " � � (� �� & � ) ��

� � � � >� " � � ) �� $ � " � � (� �� & � >� " � � � ��

� � � � ) �� $ � � ) �� & � # � �'

�� 8 � 2�

� (� � � � �� ' � � � � � ��

( � (# ( � � � � � �

( � ( �� ( � � � � � � �

� (� � � � �< � � � � � �� (� ��

! � � � �� $ � (� � � � � ) (� � � �% � � � �� " � # � � � � � ! � � � �� " � # � � � � & � # � �'

� � (' � )� � � � � � " � � � � � � � � $ & � 3 � � � � , � ? � " � � � � � � � � @

� � (' � ) (� � � � � � " � � � � � � � $ & � �� ? � " � � � � � � � @

� � (' � ) (� � � � � = � � � � �� $ & � �� ? = � � � � �� @

� � (' � ) (� � � � � = � � >� � � ( � � � $ & � * � � ( � �

� �' � � � � � � � � � � � ( � � � ( � � � � � $� " � � " � � � � � � �% � � � 3 � � � � , � ? � " � � � � � � � � @ & � # � �'

� �' � � � � �# ( � � � � � ( � � � ( � � � � � $� � � " � � � � � � � & � # � �'

� � (' � ) (� � � � � ) �� $ & � * � � ( � �

� � (' � � " � � � � � � � � >� � � ( � � � $� " � � � � � � � � (� �� & � * � � ( � �

9: � �� 8 � 2�

� � ( � � � � ��

� " � � � � � � � � (� ��

� ��

� � � �� " � � � � � � � ��

� � � ( � # ( � � � � � �

" � � � � � � � � � � ��

# � " � � ! � � � � � � � � ��

"� � � � ( ) (� � � � � � , � �

( ( � � � � � , � �

� � �� )� � � � � � � � � �

� � � ( � �� , � �

� � �� ( � �� , � �

� " � � � � � � � $ � � � �� ! � � � �� & � # � �'

� ' ' � " � � � � � � � 5 � � � � �� $� � � " � � � � � � � 5 � � � � �� & � # � �'

� � �� 5 ( � �� $ � � = " � * � �� & � # � �'

" �� ( ( � 5 ( � � ( � $ & � # � �'

� � * � �� 5 ( � �� $ � � = " � * � �� & � # � �'

" �� ( = � � $ & � # � �'

� � � " � � � � � � � � (� �� $ ( ( � � � " � � � � � � � � (� �� & � # � �'

� � (' � � " � � � � ( � � � ( � � � $ & � # � �'

" � �# � � � " � � � � ( � � � ( � � � $ & � # � �'

� � �� A � � � �' � $ & � # � �'

� � � � � � � � � � � � " � � � � $ & � � � ��

� � � � � ( � � � � ( � " � � � � � � � � $ � � � ( � � � � ( � " � � � � � � � � & � # � �'

� � � � � �# ( � � � � $ � � 3 � � � � , � & � # � �'

� � �� B ( " (# � $ & � # � �'

� � � � B ( " (# � � " � � � � � � � � $ ( � � � B ( " (# � � " � � � � � � � � & � # � �'

� � � � >� � � ( � # � � � � � � � $ & � >� � � ( � >� � � � � � �

5 � � � � >� " � � # � � � ( � $# � >� " � � # � � � ( � & � # � �'

� �� C � �� 1 2 � � � �� 2�

� # � � � ! � �' � � � � � � � ��

� # � � ! � �' � � � $ � �' � � � � � �� & � ,� � � � �

� �� $� �� & � , � � � � �

� ( � � ! � �' � � � $ & � , � � � � �

� � �� $ � �' � � � � � �� & � , � � � � �

D 8 : �

� � � � � �E "� � " �� " ��

� (� � � � E "� � " �� " ��

� � � � $ � � � � � � � � �� FG & � # � �'

( � ! � � � �� " � # � � � � $ & � # � �'

� � � = � � ( � � � �� $ & � # � �'

H� 1 � 1 �

� � � � �� $ � � � ! � � � �� % � � ) (� � � � & � # � �'

� � � * � ' � � , ( � � ) �� $ & � 5 � � � �' 5 � � ? ) �� @

" � � � � ) �� $ & � # � �'

" � � � � >� � � ( � � � $� � � " � � � � � � �% � � ) (� � � � & � # � �'

I

J

J

I

J

I

Kuva

3:Tietokantaan

jatiedostoihin

liittyvätluokat

12

kaikkia teoriassa mahdollisia kontrolli-luokkia.

13

� � ��

��

� � � � ��

!" #$% &' ' " ( )* * +

� ,� � �- � � � � � �

. � �� /� 0 � �

1 ,� � �2 ��3 �

45 67 ( 8 69 & !:

* ; &' #5 + &< " ! 7 = 5 9 * ( 8 69 & !:

! & = & ( 8 69 & !:

' " 4 #* ;* ' 6 & ( 8 69 & ! :

" + * & 6 7 ' % 7 * ' & ( & ! 6

;" " " & !5 ( 8 69 & ! :

% " ;" " >5 #' 6 & ( 8 69 & !:

; * &' 65 6 67 ? 7 9 ' ' & + 6" ( )* * +

7 7 ' &< " ( )* * +

9 $ 4 = " ?" ! !" ' ' " ( & ! 6

* = " + 7 # #* ( )* * +

9 $ 4 = " + 7 # #* ( ) * * +

@ ; & ' #5 + &< " A 6 &5 6* #" ! 6" # $ ' 5 + &< " ( > &5 6* #" ! 6" # $ ' 5 + &< " B (% * &C

" C C @ ; &' #5 + &< " D &' 65 !5 9 A* ( @ ; &' #5 + &< " D & ' 65 !5 9 B (% * &C

65 5 @ = " D 7 # #* A & ( E + ;* F $ 4 = " B (% * &C

;5 9 7 7 6" D 7 # & 67 ' A B (% * &C

65 5 F $ 4 = " D 7 # #* A & ( E + ;* F $ 4 = " B (% * &C

;5 9 7 E + = * A B (% * &C

' 5 6 @ ; &' #5 + &< " ! 7 = 5 9 * A 7 7 ' & @ ; & ' #5 + &< " ! 7 = 5 9 * ( ' 69 & ! : B (% * &C

! * 7 C " @ ; & ! 6* ' 7 * 9 & 67 #' 5 6 A B (% * &C

;" &% & 6" @ ; & ! 6* ' 7 * 9 & 67 #' 5 6 A B (% * &C

6" 9 #" ' 6" G' & 6 &5 C * 6 A B (% * &C

+ &' 6" " H" " " & !5 * ; & ! ! * 6 A B ( I* + +5 I 6 & * !

+ &' " " 8 7 * 9 & 65 6 67 @ ; & ! 6* < " #' * A' ( 8 7 * 9 & 65 6 6 7 @ ; & ! 6* < " #' * B (% * &C

+ &' " " 8 &% 7 " & !5 A' ( J " ' 4 6" ) +5 B (% * &C

6" 9 #" ' 6" K 7 ; 7 % " 6 A B (% * &C

+ &' " " K 7 ; 7 % " @ ; & ! 6* < " #' * A 7 * < ( K 7 ; 7 % " @ ; & ! 6* < " #' * B (% * &C

+ &' " " L" ' 6" 7 ' % " & 4 6* 5 4 6* A B ( L" ' 6" 7 ' L" & 4 6* 5 4 6*

D &' " " L" ;" " % " ' 6" 7 ' A% ( L" ;" " % " ' 6" 7 ' B (% * &C

M � , /� 0 � �

! & = & ( ' 6 9 & !:

% " ;" " >5 #' 6 & ( ' 69 & ! :

+ 7 # & 6 67 ( )* * +

" C C F $ 4 = " D &' 65 !5 9 A 9 ( E + ; * F $ 4 = " D & ' 65 !5 9 B (% * &C

+ 7 # & 6' 5 A B (% * &C

" % " " A B (% * &C

. � �� N- �� /� 0 � �

. � �� O �P 0 � /� 0 � �

� � � � � � ��

Q� �� R � � �S � ��

� � � � ��

� P ��

T � R� � � � � ��

U

U

VV

U

VV

U

U

V

V

U

V

U

V

U

+ 7 # & 6 7 '

U

W

VU

Kuva

4:Käyttöliittym

änsisäisetrakenteet

14

� � ��

� � � � �

��

� ��

��

��

� � � � � ��

��

� ��

� � � � � �� !� � � � �

!� � � � � " ��

!� � � � � #� � ��

$$

$

$

$

$

$

$

$ $

%

$

$%

$

$

$%

$$

$

%

$

%

$ $

$

%

Kuva

5:Käyttöliittym

ängraafisiin

komponentteihin

liittyvätluokat

15

��

� � � � ��

��

��

��

� � � � ��

� � � � ��

� � � � ! � � � � � �

� � �" # �$ � % � � �� " # �$ �

�" # �$ �

� � � �& �� % � � � �

' � ( � � � )� � � � � � � (+*

, -. / 0 -1 / 2 0 -3 456 7 89 : 9 1

�� ; � � � � �

< � � � � � � � �

< =� >� � ?� @ � � � � ��

< �� @ � � �� A� � �

B � C CD � � �� E � � �� F � G � >� D � � �� E � � �� H =� � C

B �� @ � � �� F H =� � C

B � =� � F H =� � C

' � ( � � � )� � � � � � � (+*

IJ 0K L / 2 0M 56 7 89 : 9 1

N

O

N

O

N

N

PP

N

O

N

O

Kuva

6:Henkilökunnan

kiinnittämiseen

ilporyhmiin

tarvittavatluokat

1

Liite 1. Sekvenssikaaviot

1

Liite 2. Kurssi.properties-tiedosto

Esimerkki kurssi.properties-tiedostosta. Luettavuuden parantamiseksi osa asetuksistaon jaettu usealle riville, todellisuudessa näin ei toimita.

koodi = 58110-3kurssiJarjestysnumero = 1lukukausi = kevatlukuvuosi = 2005

kysymys.1.kannassa = 1kysymys.2.kannassa = 3kysymys.3.kannassa = 6kysymys.3.preferenssi = 1kysymys.3.tyyppi = csvkysymys.3.vv.1 = algoritmit, tietorakenteetkysymys.3.vv.2 = laskennan teoriakysymys.3.vv.3 = hahmontunnistuskysymys.3.vv.4 = tietokonegrafiikkakysymys.3.vv.5 = tekoälykysymys.3.vv.6 = koneoppiminenkysymys.3.vv.7 = data-analyysin laskennalliset menetelmätkysymys.3.vv.8 = ohjelmointi, ohjelmointikielet, olio-ohjelmointikysymys.3.vv.9 = ohjelmiston rakenne (arkkitehtuuri)kysymys.3.vv.10 = ohjelmiston laatu, ohjelmiston mittaaminenkysymys.3.vv.11 = ohjelmiston kehitysprosessi, ohjelmistotuotantokysymys.3.vv.12 = testauskysymys.3.vv.13 = tietoliikennekysymys.3.vv.14 = mobiilijärjestelmätkysymys.3.vv.15 = käyttöjärjestelmätkysymys.3.vv.16 = tietokoneen rakennekysymys.3.vv.17 = hajautetut sovellusalustat ja sovelluksetkysymys.3.vv.18 = sähköisen liiketoiminnan tukijärjestelmätkysymys.3.vv.19 = älykkäästi sisältöä käsittelevät web-palvelutkysymys.3.vv.20 = dokumenttien käsittelymenetelmät (mm. XML)kysymys.3.vv.21 = tiedonhakumenetelmätkysymys.3.vv.22 = tiedon louhintakysymys.3.vv.23 = bioinformatiikkakysymys.3.vv.24 = kieliteknologiakysymys.3.vv.25 = tietokannatkysymys.3.vv.26 = käyttöliittymätkysymys.3.vv.27 = opettajalinja, aihepiiristä toivotaantarkennusta lisätiedoissakysymys.3.vv.28 = muu, aihepiiri tarkennettava lisätiedoissa(esimerkiksi sovelletun tietojenkäsittelyn osalta sovellusala)

kysymys.4.kannassa = 6kysymys.4.preferenssi = 2

2

kysymys.4.tyyppi = csvkysymys.4.vv.1 = algoritmit, tietorakenteetkysymys.4.vv.2 = laskennan teoriakysymys.4.vv.3 = hahmontunnistuskysymys.4.vv.4 = tietokonegrafiikkakysymys.4.vv.5 = tekoälykysymys.4.vv.6 = koneoppiminenkysymys.4.vv.7 = data-analyysin laskennalliset menetelmätkysymys.4.vv.8 = ohjelmointi, ohjelmointikielet, olio-ohjelmointikysymys.4.vv.9 = ohjelmiston rakenne (arkkitehtuuri)kysymys.4.vv.10 = ohjelmiston laatu, ohjelmiston mittaaminenkysymys.4.vv.11 = ohjelmiston kehitysprosessi, ohjelmistotuotantokysymys.4.vv.12 = testauskysymys.4.vv.13 = tietoliikennekysymys.4.vv.14 = mobiilijärjestelmätkysymys.4.vv.15 = käyttöjärjestelmätkysymys.4.vv.16 = tietokoneen rakennekysymys.4.vv.17 = hajautetut sovellusalustat ja sovelluksetkysymys.4.vv.18 = sähköisen liiketoiminnan tukijärjestelmätkysymys.4.vv.19 = älykkäästi sisältöä käsittelevät web-palvelutkysymys.4.vv.20 = dokumenttien käsittelymenetelmät (mm. XML)kysymys.4.vv.21 = tiedonhakumenetelmätkysymys.4.vv.22 = tiedon louhintakysymys.4.vv.23 = bioinformatiikkakysymys.4.vv.24 = kieliteknologiakysymys.4.vv.25 = tietokannatkysymys.4.vv.26 = käyttöliittymätkysymys.4.vv.27 = opettajalinja, aihepiiristä toivotaantarkennusta lisätiedoissakysymys.4.vv.28 = muu, aihepiiri tarkennettava lisätiedoissa(esimerkiksi sovelletun tietojenkäsittelyn osalta sovellusala)

kysymys.5.kannassa = 6kysymys.5.preferenssi = 3kysymys.5.tyyppi = csvkysymys.5.vv.1 = algoritmit, tietorakenteetkysymys.5.vv.2 = laskennan teoriakysymys.5.vv.3 = hahmontunnistuskysymys.5.vv.4 = tietokonegrafiikkakysymys.5.vv.5 = tekoälykysymys.5.vv.6 = koneoppiminenkysymys.5.vv.7 = data-analyysin laskennalliset menetelmätkysymys.5.vv.8 = ohjelmointi, ohjelmointikielet, olio-ohjelmointikysymys.5.vv.9 = ohjelmiston rakenne (arkkitehtuuri)kysymys.5.vv.10 = ohjelmiston laatu, ohjelmiston mittaaminenkysymys.5.vv.11 = ohjelmiston kehitysprosessi, ohjelmistotuotantokysymys.5.vv.12 = testaus

3

kysymys.5.vv.13 = tietoliikennekysymys.5.vv.14 = mobiilijärjestelmätkysymys.5.vv.15 = käyttöjärjestelmätkysymys.5.vv.16 = tietokoneen rakennekysymys.5.vv.17 = hajautetut sovellusalustat ja sovelluksetkysymys.5.vv.18 = sähköisen liiketoiminnan tukijärjestelmätkysymys.5.vv.19 = älykkäästi sisältöä käsittelevät web-palvelutkysymys.5.vv.20 = dokumenttien käsittelymenetelmät (mm. XML)kysymys.5.vv.21 = tiedonhakumenetelmätkysymys.5.vv.22 = tiedon louhintakysymys.5.vv.23 = bioinformatiikkakysymys.5.vv.24 = kieliteknologiakysymys.5.vv.25 = tietokannatkysymys.5.vv.26 = käyttöliittymätkysymys.5.vv.27 = opettajalinja, aihepiiristä toivotaantarkennusta lisätiedoissakysymys.5.vv.28 = muu, aihepiiri tarkennettava lisätiedoissa(esimerkiksi sovelletun tietojenkäsittelyn osalta sovellusala)

kysymys.6.kannassa = 6kysymys.6.preferenssi = 4kysymys.6.tyyppi = csvkysymys.6.vv.1 = algoritmit, tietorakenteetkysymys.6.vv.2 = laskennan teoriakysymys.6.vv.3 = hahmontunnistuskysymys.6.vv.4 = tietokonegrafiikkakysymys.6.vv.5 = tekoälykysymys.6.vv.6 = koneoppiminenkysymys.6.vv.7 = data-analyysin laskennalliset menetelmätkysymys.6.vv.8 = ohjelmointi, ohjelmointikielet, olio-ohjelmointikysymys.6.vv.9 = ohjelmiston rakenne (arkkitehtuuri)kysymys.6.vv.10 = ohjelmiston laatu, ohjelmiston mittaaminenkysymys.6.vv.11 = ohjelmiston kehitysprosessi, ohjelmistotuotantokysymys.6.vv.12 = testauskysymys.6.vv.13 = tietoliikennekysymys.6.vv.14 = mobiilijärjestelmätkysymys.6.vv.15 = käyttöjärjestelmätkysymys.6.vv.16 = tietokoneen rakennekysymys.6.vv.17 = hajautetut sovellusalustat ja sovelluksetkysymys.6.vv.18 = sähköisen liiketoiminnan tukijärjestelmätkysymys.6.vv.19 = älykkäästi sisältöä käsittelevät web-palvelutkysymys.6.vv.20 = dokumenttien käsittelymenetelmät (mm. XML)kysymys.6.vv.21 = tiedonhakumenetelmätkysymys.6.vv.22 = tiedon louhintakysymys.6.vv.23 = bioinformatiikkakysymys.6.vv.24 = kieliteknologiakysymys.6.vv.25 = tietokannat

4

kysymys.6.vv.26 = käyttöliittymätkysymys.6.vv.27 = opettajalinja, aihepiiristä toivotaantarkennusta lisätiedoissakysymys.6.vv.28 = muu, aihepiiri tarkennettava lisätiedoissa(esimerkiksi sovelletun tietojenkäsittelyn osalta sovellusala)

kysymys.7.kannassa = 6kysymys.7.preferenssi = 5kysymys.7.tyyppi = csvkysymys.7.vv.1 = algoritmit, tietorakenteetkysymys.7.vv.2 = laskennan teoriakysymys.7.vv.3 = hahmontunnistuskysymys.7.vv.4 = tietokonegrafiikkakysymys.7.vv.5 = tekoälykysymys.7.vv.6 = koneoppiminenkysymys.7.vv.7 = data-analyysin laskennalliset menetelmätkysymys.7.vv.8 = ohjelmointi, ohjelmointikielet, olio-ohjelmointikysymys.7.vv.9 = ohjelmiston rakenne (arkkitehtuuri)kysymys.7.vv.10 = ohjelmiston laatu, ohjelmiston mittaaminenkysymys.7.vv.11 = ohjelmiston kehitysprosessi, ohjelmistotuotantokysymys.7.vv.12 = testauskysymys.7.vv.13 = tietoliikennekysymys.7.vv.14 = mobiilijärjestelmätkysymys.7.vv.15 = käyttöjärjestelmätkysymys.7.vv.16 = tietokoneen rakennekysymys.7.vv.17 = hajautetut sovellusalustat ja sovelluksetkysymys.7.vv.18 = sähköisen liiketoiminnan tukijärjestelmätkysymys.7.vv.19 = älykkäästi sisältöä käsittelevät web-palvelutkysymys.7.vv.20 = dokumenttien käsittelymenetelmät (mm. XML)kysymys.7.vv.21 = tiedonhakumenetelmätkysymys.7.vv.22 = tiedon louhintakysymys.7.vv.23 = bioinformatiikkakysymys.7.vv.24 = kieliteknologiakysymys.7.vv.25 = tietokannatkysymys.7.vv.26 = käyttöliittymätkysymys.7.vv.27 = opettajalinja, aihepiiristä toivotaantarkennusta lisätiedoissakysymys.7.vv.28 = muu, aihepiiri tarkennettava lisätiedoissa(esimerkiksi sovelletun tietojenkäsittelyn osalta sovellusala)

kysymys.8.kannassa = 2kysymys.9.kannassa = 7kysymys.10.kannassa = 15

html.otsikko = Kevään 2005 ohjelmistotuotantoprojektienalustava ryhmäjako

html.ingressi = Seuraavassa on 12.01.2005 päivätty lista

5

kevään 2005 ohjelmistotuotantoprojekteista.html.kokoontumisajat = Ryhmät aloittavat kokoontumisensa

viikolla 4 (24.1.2005 - 28.1.2005).Projektit päättyvät viimeistäänviikolla 18 (2.5.2005 - 6.5.2005).

html.jonotusotsikko = Jonotuslistahtml.jonotusohjeet = Jonotuslistalle on sijoitettu

opiskelijat, joilla on ryhmäjakoalaadittaessa ollut puutteita kurssinesitietovaatimusten suhteen.Opiskelijoita voidaan sijoittaalistalta ryhmiin, mikäli he saavatpuuttuvat suoritukset valmiiksi ennenryhmien toiminnan alkamista. Jos löydätnimesi listalta ja mielestäsiesitietovaatimukset ovat kohdaltasikunnossa, ota mahdollisimman pianyhteyttä osoitteeseen

<a href="mailto:[email protected]">[email protected]</a>html.spostiosoite = [email protected]

1

Liite 3. Yleinen.properties-tiedosto

Esimerkki yleinen.properties-tiedostosta

tk.osoite = kontti.helsinki.fitk.portti = 1522tk.nimi = tkta

Contents

1 Pakkaus fi.helsinki.cs.ilpo 21.1 Luokka Henkilokuntalainen . . . . . . . . . . . . . . . . . . . . . 3

1.1.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.1.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 31.1.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 31.1.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 31.1.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2 Luokka IlmoRyhma . . . . . . . . . . . . . . . . . . . . . . . . . 41.2.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 41.2.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 41.2.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 41.2.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.3 Luokka Ilpo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.3.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.3.2 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 51.3.3 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.4 Luokka IlpoRyhma . . . . . . . . . . . . . . . . . . . . . . . . . 61.4.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.4.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 61.4.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 71.4.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 71.4.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.5 Luokka Kurssi . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.5.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.5.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 81.5.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 81.5.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 91.5.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1.6 Luokka Kysymys . . . . . . . . . . . . . . . . . . . . . . . . . . 131.6.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.6.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 141.6.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 14

Sisältö 2

1.6.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 141.6.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.7 Luokka Opintojakso . . . . . . . . . . . . . . . . . . . . . . . . . 151.7.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.7.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 151.7.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 151.7.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 161.7.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

1.8 Luokka Opiskelija . . . . . . . . . . . . . . . . . . . . . . . . . . 161.8.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 171.8.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 171.8.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 171.8.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 181.8.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

1.9 Luokka Sivuaine . . . . . . . . . . . . . . . . . . . . . . . . . . 221.9.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 221.9.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 231.9.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 231.9.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 231.9.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1.10 Luokka SuoritettuOpintojakso . . . . . . . . . . . . . . . . . . . 241.10.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 241.10.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 241.10.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 241.10.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 241.10.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

1.11 Luokka SuoritettuSivuainekurssi . . . . . . . . . . . . . . . . . . 261.11.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 261.11.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 261.11.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 26

1.12 Luokka UupuvaOpintojakso . . . . . . . . . . . . . . . . . . . . 261.12.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 261.12.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 271.12.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 271.12.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 271.12.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

1.13 Luokka Vapaakysymys . . . . . . . . . . . . . . . . . . . . . . . 281.13.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 281.13.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 281.13.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 281.13.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 281.13.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

1.14 Luokka Vapaavastaus . . . . . . . . . . . . . . . . . . . . . . . . 291.14.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Sisältö 3

1.14.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 291.14.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 29

1.15 Luokka Vastausvaihtoehto . . . . . . . . . . . . . . . . . . . . . 291.15.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 291.15.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 291.15.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 301.15.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 301.15.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2 Pakkaus fi.helsinki.cs.ilpo.control 312.1 Luokka IlmoRyhmaListener . . . . . . . . . . . . . . . . . . . . 31

2.1.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 312.1.2 Kaikki tunnetut alirajapinnat . . . . . . . . . . . . . . . . 322.1.3 Kaikki luokat, joiden tiedetään toteuttavan rajapinnan . . . 32

2.2 Luokka IlpoRyhmaListener . . . . . . . . . . . . . . . . . . . . . 322.2.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 322.2.2 Kaikki tunnetut alirajapinnat . . . . . . . . . . . . . . . . 322.2.3 Kaikki luokat, joiden tiedetään toteuttavan rajapinnan . . . 32

2.3 Luokka NakymaRyhmaHKListener . . . . . . . . . . . . . . . . 322.3.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 322.3.2 Kaikki tunnetut alirajapinnat . . . . . . . . . . . . . . . . 322.3.3 Kaikki luokat, joiden tiedetään toteuttavan rajapinnan . . . 32

2.4 Luokka NakymaRyhmaListener . . . . . . . . . . . . . . . . . . 322.4.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 332.4.2 Kaikki tunnetut alirajapinnat . . . . . . . . . . . . . . . . 332.4.3 Kaikki luokat, joiden tiedetään toteuttavan rajapinnan . . . 33

2.5 Luokka OpiskelijaListener . . . . . . . . . . . . . . . . . . . . . 332.5.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 332.5.2 Kaikki tunnetut alirajapinnat . . . . . . . . . . . . . . . . 332.5.3 Kaikki luokat, joiden tiedetään toteuttavan rajapinnan . . . 33

2.6 Luokka PalloListener . . . . . . . . . . . . . . . . . . . . . . . . 332.6.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 332.6.2 Kaikki tunnetut alirajapinnat . . . . . . . . . . . . . . . . 332.6.3 Kaikki luokat, joiden tiedetään toteuttavan rajapinnan . . . 33

2.7 Luokka KontrolliPalikka . . . . . . . . . . . . . . . . . . . . . . 342.7.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 342.7.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 342.7.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 34

2.8 Luokka KontrolliYlenkatsoUupuva . . . . . . . . . . . . . . . . . 342.8.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 342.8.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 342.8.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 352.8.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 352.8.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Sisältö 4

3 Pakkaus fi.helsinki.cs.ilpo.view 363.1 Luokka AutentikointiIkkuna . . . . . . . . . . . . . . . . . . . . 37

3.1.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 373.1.2 Kenttien yhteenveto . . . . . . . . . . . . . . . . . . . . 383.1.3 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 383.1.4 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 383.1.5 Kentät . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383.1.6 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 383.1.7 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

3.2 Luokka HenkilotietoSolu . . . . . . . . . . . . . . . . . . . . . . 383.2.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.2.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 393.2.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 39

3.3 Luokka HKBoxi . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.3.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.3.2 Kaikki tunnetut aliluokat . . . . . . . . . . . . . . . . . . 393.3.3 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 393.3.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 39

3.4 Luokka HKSortSolu . . . . . . . . . . . . . . . . . . . . . . . . 403.4.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 403.4.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 403.4.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 40

3.5 Luokka IsoHKBoxi . . . . . . . . . . . . . . . . . . . . . . . . . 403.5.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 403.5.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 403.5.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 40

3.6 Luokka KopioituvaPallo . . . . . . . . . . . . . . . . . . . . . . 413.6.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 413.6.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 413.6.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 41

3.7 Luokka NakymaRyhma . . . . . . . . . . . . . . . . . . . . . . . 413.7.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 413.7.2 Kaikki tunnetut aliluokat . . . . . . . . . . . . . . . . . . 423.7.3 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 423.7.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 42

3.8 Luokka NakymaUusiRyhma . . . . . . . . . . . . . . . . . . . . 423.8.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 423.8.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 423.8.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 42

3.9 Luokka NakymaVanhaRyhma . . . . . . . . . . . . . . . . . . . 423.9.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 433.9.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 433.9.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 43

3.10 Luokka OpiskelijaListassaJComponent . . . . . . . . . . . . . . . 43

Sisältö 5

3.10.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 433.10.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 433.10.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 43

3.11 Luokka OpiskelijaSortSolu . . . . . . . . . . . . . . . . . . . . . 443.11.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 443.11.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 443.11.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 443.11.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 443.11.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

3.12 Luokka Pallo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453.12.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 453.12.2 Kaikki tunnetut aliluokat . . . . . . . . . . . . . . . . . . 453.12.3 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 453.12.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 45

3.13 Luokka PieniHKBoxi . . . . . . . . . . . . . . . . . . . . . . . . 453.13.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 453.13.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 453.13.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 46

3.14 Luokka PoistaOpiskelijaButton . . . . . . . . . . . . . . . . . . . 463.14.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 463.14.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 463.14.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 46

3.15 Luokka PoistaRyhmaButton . . . . . . . . . . . . . . . . . . . . 463.15.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 463.15.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 463.15.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 47

3.16 Luokka PoistaRyhmastaButton . . . . . . . . . . . . . . . . . . . 473.16.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 473.16.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 473.16.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 47

3.17 Luokka RyhmaSolu . . . . . . . . . . . . . . . . . . . . . . . . . 473.17.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 473.17.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 473.17.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 473.17.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 483.17.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

3.18 Luokka RyhmatietoSolu . . . . . . . . . . . . . . . . . . . . . . 483.18.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 483.18.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 483.18.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 48

3.19 Luokka SiirtyvaPallo . . . . . . . . . . . . . . . . . . . . . . . . 483.19.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 493.19.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 493.19.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 49

Sisältö 6

3.20 Luokka SortSolu . . . . . . . . . . . . . . . . . . . . . . . . . . 493.20.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 493.20.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 493.20.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 49

3.21 Luokka TietoSolu . . . . . . . . . . . . . . . . . . . . . . . . . . 503.21.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 503.21.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 503.21.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 50

3.22 Luokka TulosRyhmaNakyma . . . . . . . . . . . . . . . . . . . . 503.22.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 503.22.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 503.22.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 50

3.23 Luokka YlenkatsoJButton . . . . . . . . . . . . . . . . . . . . . 513.23.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 513.23.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 513.23.3 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 51

4 Pakkaus fi.helsinki.cs.ilpo.db 524.1 Luokka Parseri . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

4.1.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 524.1.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 524.1.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 524.1.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 534.1.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

4.2 Luokka Tietokantakyselija . . . . . . . . . . . . . . . . . . . . . 534.2.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 544.2.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 544.2.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 544.2.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 554.2.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

4.3 Luokka Tietokantayhteys . . . . . . . . . . . . . . . . . . . . . . 584.3.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 584.3.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 584.3.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 584.3.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 584.3.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

5 Pakkaus fi.helsinki.cs.ilpo.io 605.1 Luokka HTMLKirjoitin . . . . . . . . . . . . . . . . . . . . . . . 60

5.1.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 605.1.2 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 605.1.3 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

5.2 Luokka KeskeneraistenRyhmienKasittelija . . . . . . . . . . . . . 615.2.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Sisältö 7

5.2.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 615.2.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 615.2.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 625.2.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

5.3 Luokka OpiskelijanumeroTulostin . . . . . . . . . . . . . . . . . 635.3.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 635.3.2 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 635.3.3 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5.4 Luokka Tiedostokirjoittaja . . . . . . . . . . . . . . . . . . . . . 645.4.1 Kuvaus . . . . . . . . . . . . . . . . . . . . . . . . . . . 645.4.2 Konstruktorien yhteenveto . . . . . . . . . . . . . . . . . 645.4.3 Metodien yhteenveto . . . . . . . . . . . . . . . . . . . . 645.4.4 Konstruktorit . . . . . . . . . . . . . . . . . . . . . . . . 645.4.5 Metodit . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Chapter 1

Pakkaus fi.helsinki.cs.ilpo

Pakkaus Sisältö Sivu

LuokatHenkilokuntalainen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Henkilökunnan jäsen, joka liittyy ilpon tuottamiin lopullisiin ryhmiin.IlmoRyhma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

IlmoRyhmat ovat peräisin Kurjesta.Ilpo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Class IlpoIlpoRyhma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Ilpon sisäisen ryhmäjaon ryhmät.Kurssi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Järjestelmän kannalta keskeinen tietorakenne, johon liittyy kaikki yhden kurssinryhmittelyn kannalta olennainen tieto.

Kysymys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Ilmon monivalintakysymys ilpossa.

Opintojakso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15TKTL:n kurssi, jonka opiskelija on saattanut suorittaa.

Opiskelija . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Edustaa yhtä kurssille ilmoittautunutta opiskelijaa.

Sivuaine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Opiskelijan yhden sivuaine-aineen suoritusten majapaikka.

SuoritettuOpintojakso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Yhdistää opiskelijan ja tämän suorittaman tktl:n opintojakson toisiinsa.

SuoritettuSivuainekurssi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Opiskelijan suorittama sivuainekurssi.

UupuvaOpintojakso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Kurssin esitietoihin kuuluva opintojakso, jota opiskelija ei ole suorittanut.

Vapaakysymys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28Ilmoittatumisen yhteydessä kysytty kysymys, johon on voitu vastata vapaamuotois-esti.

8

CHAPTER 1. PAKKAUS FI.HELSINKI.CS.ILPO 9

Vapaavastaus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Opiskelijan vastaus vapaakysymykseen.

Vastausvaihtoehto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Vastausvaihtoehto sellaisen kysymyksen, johon on valmiit vastausvaihtoehdot.

1.1 Luokka Henkilokuntalainen

Henkilökunnan jäsen, joka liittyy ilpon tuottamiin lopullisiin ryhmiin. Henkilöstäon tiedossa nimi ja rooli kurssin pienryhmässä. Luokka on tiukassa symbioosissailpoRyhma-luokan ilmentymien kanssa.

1.1.1 Kuvauspublic class Henkilokuntalainenextends java.lang.Objectimplements java.io.Serializable

1.1.2 Konstruktorien yhteenveto

Henkilokuntalainen(String, String) Luo uuden kurssiin liittyvänhenkilökunnan jäsenen.

1.1.3 Metodien yhteenveto

toString() Palauttaa tekstiesityksen (nimi / rooli) henkilökunnanjäsenestä

1.1.4 Konstruktorit

• Henkilokuntalainenpublic Henkilokuntalainen( java.lang.String nimi,java.lang.String rooli )

– KuvausLuo uuden kurssiin liittyvän henkilökunnan jäsenen.

– Parametrit∗ nimi – Kurssiin liittyvän henkilökunnan jäsenen nimi∗ rooli – Tehtävä, jota henkilökunnan jäsen hoitaa

1.1.5 Metodit

• toStringpublic java.lang.String toString( )


– KuvausPalauttaa tekstiesityksen (nimi / rooli) henkilökunnan jäsenestä

– Palauttaa – Tekstiesitys

1.2 Luokka IlmoRyhma

IlmoRyhmat ovat peräisin Kurjesta. Niitä käytetään kun järjestelmän sisäisetryhmät talletetaan tietokantaan.

1.2.1 Kuvauspublic class IlmoRyhmaextends java.lang.Objectimplements java.io.Serializable


IlmoRyhma(int) Luo uuden numeron mukaisen Ilmoryhmän


annaHenkilokuntalaiset() Palauttaa ryhmän työntekijät.lisaaHenkilokuntalainen(Henkilokuntalainen) Lisää ryhmään

työläisen.

1.2.4 Konstruktorit

• IlmoRyhmapublic IlmoRyhma( int ryhmanumero )

– KuvausLuo uuden numeron mukaisen Ilmoryhmän

– Parametrit∗ ryhmanumero – Ryhmän numero Ilmossa.

1.2.5 Metodit

• annaHenkilokuntalaisetpublic java.util.Collection annaHenkilokuntalaiset( )

– KuvausPalauttaa ryhmän työntekijät.

– Palauttaa – Ryhmään liittyvät henkilökunnan jäsenet.


• lisaaHenkilokuntalainenpublic void lisaaHenkilokuntalainen( Henkilokuntalainenhenkilo )

– KuvausLisää ryhmään työläisen.

– Parametrit∗ henkilo – lisättävä henkilökuntalainen

1.3 Luokka Ilpo

Class Ilpo

1.3.1 Kuvauspublic class Ilpoextends javax.swing.JFrame


getKurssiProperties() Palauttaa kurssin PropertiesitgetYleinenProperties() Palauttaa yleiset PropertiesitlaitaIkkunaPystyyn()luoTietokantayhteys(String, String)main(String[]) Main-metodisetKurssiProperties(Properties) Asettaa kurssikohtaiset Propertiesit

1.3.3 Metodit

• getKurssiPropertiespublic static java.util.Properties getKurssiProperties()

– KuvausPalauttaa kurssin Propertiesit

– Palauttaa – Kurssin Propertiesit

• getYleinenPropertiespublic static java.util.PropertiesgetYleinenProperties( )

– KuvausPalauttaa yleiset Propertiesit

– Palauttaa – Yleiset Propertiesit


• laitaIkkunaPystyynpublic void laitaIkkunaPystyyn( )

• luoTietokantayhteyspublic static void luoTietokantayhteys(java.lang.String kayttajaTunnus, java.lang.Stringsalasana ) heittää java.lang.Exception

– Parametrit∗ kayttajaTunnus –∗ salasana –

• mainpublic static void main( java.lang.String[] args )

– KuvausMain-metodi

– Parametrit∗ args – main-metodin parametrit (eivät vaikuta mihinkään)

• setKurssiPropertiespublic static void setKurssiProperties(java.util.Properties value )

– KuvausAsettaa kurssikohtaiset Propertiesit

– Parametrit∗ value – Kurssikohtaiset Propertiesit

1.4 Luokka IlpoRyhma

Ilpon sisäisen ryhmäjaon ryhmät.

1.4.1 Kuvauspublic class IlpoRyhmaextends java.lang.Objectimplements java.io.Serializable


IlpoRyhma() Luo uuden IlpoRyhma-olion



avaa() Avaa IlpoRyhma-oloin lukituksen.lisaaRyhmaListener(IlpoRyhmaListener) Lisää

IlmoRyhma-olioon sen tilaa kuuntelevan kuuntelijan.lukitse() Asettaa IlpoRyhma-olion lukituksi.muokkaaVapaatekstia(String) Muokkaa ryhmässä olevaa sen tilaa

kuvaavaa tekstiä.

1.4.4 Konstruktorit

• IlpoRyhmapublic IlpoRyhma( )

– KuvausLuo uuden IlpoRyhma-olion

1.4.5 Metodit

• avaapublic void avaa( )

– KuvausAvaa IlpoRyhma-oloin lukituksen.

• lisaaRyhmaListenerpublic void lisaaRyhmaListener(control.IlpoRyhmaListener r )

– KuvausLisää IlmoRyhma-olioon sen tilaa kuuntelevan kuuntelijan.

– Parametrit∗ r – uusi IlpoRyhmaListener olio

• lukitsepublic void lukitse( )

– KuvausAsettaa IlpoRyhma-olion lukituksi.

• muokkaaVapaatekstiapublic void muokkaaVapaatekstia( java.lang.StringuusiTeksti )

– KuvausMuokkaa ryhmässä olevaa sen tilaa kuvaavaa tekstiä. Jos lisättäväteksti on tyhjä merkkijono asetetaan arvoksi null;


– Parametrit∗ uusiTeksti – Tekstihuomio, joka lisätään ryhmäään

1.5 Luokka Kurssi

Järjestelmän kannalta keskeinen tietorakenne, johon liittyy kaikki yhden kurssinryhmittelyn kannalta olennainen tieto.

1.5.1 Kuvauspublic class Kurssiextends java.lang.Objectimplements java.io.Serializable


Kurssi(String, String, int, char, int, Tietokantayhteys) Luotietokantakyselijan sekä parserin, joiden avulla noudetaankannasta opiskelijoiden tiedot, ilmoittautumisen yhteydessäkerätyt tiedot, sekä kurssin pienryhmät.


annaIlmoRyhmat() Palauttaa kurssiin liittyvät IlmoRyhma-oliot.annaKayttajatunnukset() Palauttaa kokoelmaolion, joka sisältää

kaikkien kurssille ilmoittautuneden opiskelijoidenkäyttäjätunnukset.

annaKurssiJarjestysnumero() Palauttaa arvonaan kurssinjärjestysnumeron.

annaKurssikoodi() Palauttaa ryhmiteltävän kurssin kurssikoodinannaKysymys(int) Palauttaa arvonaan sen Kysymys-olion, jossa on

parametrin mukainen Ilpo-järjestysnumero.annaLukukaudenNimi() Palauttaa ryhmiteltävän kurssin

lukukauden nimen suomeksiannaLukukausi() Palauttaa arvonaan lukukauden lyhenteen, jolloin

kurssi luennoidaan.annaLukuvuosi() Palauttaa lukuvuoden, jolloin ryhmiteltävä kurssin

pidetään.annaOpintojaksot() Palauttaa järjestelmän opintojaksot, toistaiseksi

puhtaasti testikäytössäannaOpiskelijanumerot() Palauttaa kokoelmaolion, joka sisältää

kaikkien kurssille ilmoittautuneden opiskelijoidenopiskelijanumerot.


annaPuutteellisetOpiskelijat() Palauttaa kokoelmaolion, jokakoostuu niistä Opiskelija-olioista, joilla on puutteitaopintosuorituksissa.

annaRyhmattomatOpiskelijat() Palauttaa kokoelmaolion, jokakoostuu niistä Opiskelija-olioista, jotka eivät kuulu mihinkäänIlpoRyhma-olioon.

annaVapaaKysymys(int) Palauttaa arvonaan senvapaaKysymys-olion, jossa on parametrin mukainenIlpo-järjestysnumero.

lisaaKayttajatunnukset() Lisää käyttäjätunnukset niilleopiskelijoille, joilla niitä ei ole.

lisaaKysymys(Kysymys) Lisää Kurssi-olioon kysymyksen, johon onolemassa valmiit vastausvaihtoehdot.

lisaaVapaakysymys(Vapaakysymys) Lisää Kurssi-olioonkysymyksen, jonka vastaukset ovat vapaamuotoisia.

noudaOpiskelijoidenOpintosuoritukset() Noutaa opiskelijoidenopintosuoritukset kannasta ja luo Opiskelija-olioille suorituksiavastaavat SuoritettuOpintojakso-, Sivuaine- sekäSuoritettuSivuaineKurssi-oliot.

paivitaIlmoRyhmatJaOpet() Hakee tietokannasta kurssinpienryhmät sekä niiden ohjaajat ja luo vastaavatHenkilakuntalainen- sekä IlmoRyhmä-oloit.

paivitaOpiskelijat() Hakee tietokannasta kurssille ilmoittautuneidenopiskelijoiden tiedot, merkitse ilmoittautumisensa peruneetopiskelijat peruneiksi ja luo uusia ilmoittautuneita kohti uudetOpiskelija-oliot.

paivitaOpiskelijoidenOpintosuoritukset() Noutaa tietokannastaopiskelijoiden opintosuoritukset ja päivittää ne tarvittaessa.

1.5.4 Konstruktorit

• Kurssipublic Kurssi( java.lang.String nimi,java.lang.String kurssikoodi, int lukuvuosi, charlukukausi, int kurssiJarjestysnumero, db.Tietokantayhteysyhteys )

– KuvausLuo tietokantakyselijan sekä parserin, joiden avulla noudetaankannasta opiskelijoiden tiedot, ilmoittautumisen yhteydessä kerätyttiedot, sekä kurssin pienryhmät.

– Parametrit∗ nimi – kurssin nimi∗ kurssikoodi – Kurssin kurssikoodi


∗ lukuvuosi – Lukuvuosi, jolloin kurssi luennoidaan∗ lukukausi – Lukukausi, jolloin kurssi luennoidaan∗ kurssiJarjestysnumero – Ilmaisee, kuinka mones

kyseisen opintojakson ilmentymä kyseisellä∗ yhteys – Tietokantayhteys, joka annetaan kyselijälle

lukukadella on kyseessä

1.5.5 Metodit

• annaIlmoRyhmatpublic java.util.Collection annaIlmoRyhmat( )

– KuvausPalauttaa kurssiin liittyvät IlmoRyhma-oliot.

– Palauttaa – Kurssin IlmoRyhma-oliot.

• annaKayttajatunnuksetpublic java.util.Collection annaKayttajatunnukset( )

– KuvausPalauttaa kokoelmaolion, joka sisältää kaikkien kurssilleilmoittautuneden opiskelijoiden käyttäjätunnukset.

– Palauttaa – Kokoelma, jossa opiskelijoiden käyttäjätunnukset

• annaKurssiJarjestysnumeropublic int annaKurssiJarjestysnumero( )

– KuvausPalauttaa arvonaan kurssin järjestysnumeron. Järjestysnumero kertoomonesko kyseisen opintojakson ilmentymä kurssi on kyseisellälukukaudella.

– Palauttaa – Kurssin järjestysnemure lukukauden sisällä

• annaKurssikoodipublic java.lang.String annaKurssikoodi( )

– KuvausPalauttaa ryhmiteltävän kurssin kurssikoodin

– Palauttaa – Kurssikoodi merkkijonona

• annaKysymyspublic Kysymys annaKysymys( int ilponumero )

– KuvausPalauttaa arvonaan sen Kysymys-olion, jossa on parametrin mukainenIlpo-järjestysnumero.


– Parametrit∗ ilponumero – Järjestelmän sisäinen järjestysnumero

kysymykselle.

– Palauttaa – Haluttu Kysymys-olio.

• annaLukukaudenNimipublic java.lang.String annaLukukaudenNimi( )

– KuvausPalauttaa ryhmiteltävän kurssin lukukauden nimen suomeksi

– Palauttaa – Merkkijono, joka on lukukauden nimi suomeksi

• annaLukukausipublic char annaLukukausi( )

– KuvausPalauttaa arvonaan lukukauden lyhenteen, jolloin kurssi luennoidaan.k = kevät, v = kesä, s = syksy

– Palauttaa – Lukuvuoden lyhenne

• annaLukuvuosipublic int annaLukuvuosi( )

– KuvausPalauttaa lukuvuoden, jolloin ryhmiteltävä kurssin pidetään.

– Palauttaa – Lukuvuosi kokonaislukuna

• annaOpintojaksotpublic java.util.Hashtable annaOpintojaksot( )

– KuvausPalauttaa järjestelmän opintojaksot, toistaiseksi puhtaasti testikäytössä

• annaOpiskelijanumerotpublic java.util.Collection annaOpiskelijanumerot( )

– KuvausPalauttaa kokoelmaolion, joka sisältää kaikkien kurssilleilmoittautuneden opiskelijoiden opiskelijanumerot.

– Palauttaa – Kokoelma, jossa opiskelijoiden opiskelijanumerot

• annaPuutteellisetOpiskelijatpublic java.util.Collection annaPuutteellisetOpiskelijat()


– KuvausPalauttaa kokoelmaolion, joka koostuu niistä Opiskelija-olioista, joillaon puutteita opintosuorituksissa.

– Palauttaa – Puutteliset Opiskelija-oliot.

• annaRyhmattomatOpiskelijatpublic java.util.Collection annaRyhmattomatOpiskelijat()

– KuvausPalauttaa kokoelmaolion, joka koostuu niistä Opiskelija-olioista, jotkaeivät kuulu mihinkään IlpoRyhma-olioon. HTMLKirjoitin käyttäämetodia. Niitä Opiskelija-olioita, joiden poistettuKurssilta-kentänarvo on true ei listata (Ilmoittautumisensa peruneet opiskelijat).

– Palauttaa – Ryhmättömät Opiskelija-oliot.

• annaVapaaKysymyspublic Vapaakysymys annaVapaaKysymys( int ilponumero )

– KuvausPalauttaa arvonaan sen vapaaKysymys-olion, jossa on parametrinmukainen Ilpo-järjestysnumero.

– Parametrit∗ ilponumero – Järjestelmän sisäinen järjestysnumero

kysymykselle.

– Palauttaa – Haluttu VapaaKysymys-olio.

• lisaaKayttajatunnuksetpublic void lisaaKayttajatunnukset( )

– KuvausLisää käyttäjätunnukset niille opiskelijoille, joilla niitä ei ole. Vain netunnukset, jotka löytyvät desmondista lisätään.

• lisaaKysymyspublic void lisaaKysymys( Kysymys uusiKysymys )

– KuvausLisää Kurssi-olioon kysymyksen, johon on olemassa valmiitvastausvaihtoehdot.

– Parametrit∗ uusiKysymys – Vaihtoehdollinen kysymys.


• lisaaVapaakysymyspublic void lisaaVapaakysymys( VapaakysymysuusiVapaaKysymys )

– KuvausLisää Kurssi-olioon kysymyksen, jonka vastaukset ovatvapaamuotoisia.

– Parametrit∗ uusiVapaaKysymys – parseroitu kysysmys

• noudaOpiskelijoidenOpintosuorituksetpublic void noudaOpiskelijoidenOpintosuoritukset( )

– KuvausNoutaa opiskelijoiden opintosuoritukset kannasta ja luoOpiskelija-olioille suorituksia vastaavat SuoritettuOpintojakso-,Sivuaine- sekä SuoritettuSivuaineKurssi-oliot.

• paivitaIlmoRyhmatJaOpetpublic void paivitaIlmoRyhmatJaOpet( )

– KuvausHakee tietokannasta kurssin pienryhmät sekä niiden ohjaajat ja luovastaavat Henkilakuntalainen- sekä IlmoRyhmä-oloit. Metodiylikirjoittaa järjestelmässä olevat IlpoRyhmä- sekäHenkilokuntalainen-oliot sekä hävittää niihin mahdollistesti liittyvätviitteet.

• paivitaOpiskelijatpublic void paivitaOpiskelijat( )

– KuvausHakee tietokannasta kurssille ilmoittautuneiden opiskelijoiden tiedot,merkitse ilmoittautumisensa peruneet opiskelijat peruneiksi ja luouusia ilmoittautuneita kohti uudet Opiskelija-oliot.

• paivitaOpiskelijoidenOpintosuorituksetpublic void paivitaOpiskelijoidenOpintosuoritukset( )

– KuvausNoutaa tietokannasta opiskelijoiden opintosuoritukset ja päivittää netarvittaessa.

1.6 Luokka Kysymys

Ilmon monivalintakysymys ilpossa.


1.6.1 Kuvauspublic class Kysymysextends java.lang.Objectimplements java.io.Serializable


Kysymys(String, int, boolean) Luo uudenmonivalintakysymys-olion.


annaKysymysNumeroIlpossa() Palauttaa arvonaan kysymyksenjärjestelmän sisäisen järjestysnumeron.

annaVastausvaihtoehto(String) Palauttaa vastauksenlisaaVastausvaihtoehto(Vastausvaihtoehto) Ennaltamääritetyn

vastausvaihtoehdon lisääminen

1.6.4 Konstruktorit

• Kysymyspublic Kysymys( java.lang.String kysymys, intkysymysNumeroIlpossa, boolean radioKysymys )

– KuvausLuo uuden monivalintakysymys-olion.

– Parametrit∗ kysymys – Kysymys tekstimuodosso.∗ kysymysNumeroIlpossa – Järjestelmän sisäinen ID

kysymykselle.∗ radioKysymys – Lippu, joka ilmoittaa onko kysymys

radiobutton-tyyppinen.

1.6.5 Metodit

• annaKysymysNumeroIlpossapublic int annaKysymysNumeroIlpossa( )

– KuvausPalauttaa arvonaan kysymyksen järjestelmän sisäisenjärjestysnumeron. Järjestysnumero yksilöi kysymyksen.

– Palauttaa – Yksilöivä kysymyksen järjestysnumero.


• annaVastausvaihtoehtopublic Vastausvaihtoehto annaVastausvaihtoehto(java.lang.String vastaus )

– KuvausPalauttaa vastauksen

– Parametrit∗ vastaus – tekstimuotainen vastaus

– Palauttaa – vastausvaihtoehto

• lisaaVastausvaihtoehtopublic void lisaaVastausvaihtoehto( Vastausvaihtoehtovaihtoehto )

– KuvausEnnaltamääritetyn vastausvaihtoehdon lisääminen

– Parametrit∗ vaihtoehto – vastausvaihtoehto

1.7 Luokka Opintojakso

TKTL:n kurssi, jonka opiskelija on saattanut suorittaa.

1.7.1 Kuvauspublic class Opintojaksoextends java.lang.Objectimplements java.io.Serializable


Opintojakso(String, String, double) Luo uuden opintojakso-olion


annaKurssikoodi() Palauttaa arvonaan opintojakson kurssikoodin.lisaaSuoritettuOpintojakso(SuoritettuOpintojakso) Lisää

opintosuorituksen tämän opintojaksan suorituksiintoString() Palauttaa kirjallisen esityksen Opintojakso-oliosta.


1.7.4 Konstruktorit

• Opintojaksopublic Opintojakso( java.lang.String nimi,java.lang.String kurssikoodi, double opintoviikot )

– KuvausLuo uuden opintojakso-olion

– Parametrit∗ nimi – Opintojakson nimi∗ kurssikoodi – Opintojakson kurssikoodi∗ opintoviikot – Opintojakson laajuus opintoviikoissa

1.7.5 Metodit


– KuvausPalauttaa arvonaan opintojakson kurssikoodin.

– Palauttaa – kurssikoodi merkkijonona.

• lisaaSuoritettuOpintojaksopublic void lisaaSuoritettuOpintojakso(SuoritettuOpintojakso suoritus )

– KuvausLisää opintosuorituksen tämän opintojaksan suorituksiin

– Parametrit∗ suoritus – Opiskelijan kyseisen opintojakson suoritus


– KuvausPalauttaa kirjallisen esityksen Opintojakso-oliosta.

– Palauttaa – Merkkijono, muotoa "kurssikoodi nimi (X ov)"

1.8 Luokka Opiskelija

Edustaa yhtä kurssille ilmoittautunutta opiskelijaa.


1.8.1 Kuvauspublic class Opiskelijaextends java.lang.Objectimplements java.io.Serializable


Opiskelija(String, String, String, String, int, String, int,Tietokantakyselija) Luo uuden Opiskelija-olion


annaHetu() Palauttaa arvonaan opiskelijan henkilötunnuksenannaKayttajatunnus() Palauttaa arvonaan opiskelijan

käyttäjätunnuksen.annaOpiskelijanumero() Palauttaa arvonaan opiskelijan

opiskelijanumeron.asetaKayttajatunnus(String) Asettaa opiskelijan käyttäjätunnuksen.asetaOpiskelijanumero(String) Asettaa opiskelijan

opiskelijanumeron.lisaaOpiskelijaListener(OpiskelijaListener) Lisää Opiskelja-oliolle

tämän tilaa kuuntelevan kuuntelijan.lisaaSivuaineSuoritus(String, String, String, Date, String) Lisää

suoritetun sivuainekurssin opiskelijan tietorakenteeseen.lisaaSuoritettuOpintojakso(SuoritettuOpintojakso) Lisää

SuoritettuOpintojakso-olion Opiskelija-olion tietoihin.lisaaUupuvaOpintojakso(UupuvaOpintojakso) Luo uuden

UupuvaOpintojakso-olion.lisaaVapaavastaus(Vapaavastaus) Lisää opiskelijan vastaaman

vapaavastauksen.lisaaVastausvaihtoehto(Vastausvaihtoehto) Luo uuden

Vastausvaihtoehto-olion.muokkaaVapaatekstia(String) Muokkaa opiskelijassa olevaa hänen

tilaansa kuvaavaa tekstiä.nollaaSivuainesuoritukset() Tyhjentää opiskelijan sivuaineopinnot.noudaOpintosuoritukset() Hakee kannasta opiskelijan

opintosuoritukset ja alustaa opiskelijanopintosuoritukset-sisältävät tietorakenteet.

paivitaOpintosuoritukset() Päivittää opiskelijan Opintosuorituksetvastaamaan tietokannasta löytyviä.

peruIlmo() Merkitsee opiskelijan poistetuksi kurssilta.peruutaLukitus() Mikäli Opiskelija-olio oli vain ryhmälukossa,

poistaa ryhmälukon ja palauttaa Opiskelija-olion aktiiviseksikaikkiin ryhmiin, joihin se on liitetty.


tarkastaEsitiedot() Tarkastaa Desmond.jar:n avulla, mitäryhmiteltävälle kurssille vaadittavia kursseja opiskelijaltapuuttuu.

teeOmaLukko(IlpoRyhma) Lukitsee Opiskelija-olion IlpoRyhmai:hin ja piilottaa opiskelijan muista ryhmistä, joihin hänet onliitetty.

teeRyhmaLukko(IlpoRyhma) Lukitsee Opiskelija ryhmälukollaannettuun IlpoRyhma-olioon.

toString() Tekstiesitys opiskelijasta

1.8.4 Konstruktorit

• Opiskelijapublic Opiskelija( java.lang.String hetu,java.lang.String opiskelijanumero, java.lang.Stringnimi, java.lang.String sahkoposti, int aloitusvuosi,java.lang.String paaaine, int ryhmaKannassa,db.Tietokantakyselija tietokantakyselija )

– KuvausLuo uuden Opiskelija-olion

– Parametrit∗ hetu – Opiskelijan henkilötunnus∗ opiskelijanumero – Opiskelijan opiskelijanumero∗ nimi – Opiskelijan nimi∗ sahkoposti – Opiskelijan sähköpostiosoite∗ aloitusvuosi – Vuosi, jolloin opiskelija on opintonsa

aloittanut∗ paaaine – Opiskelijan pääaineen lyhenne∗ ryhmaKannassa – Ryhmä, johon opiskelija on sijoitettu

ilmoittautmisen yhteydessä∗ tietokantakyselija – Tietokantakyselija, jota opiskelija

käyttää jatkossa noutaakseen ilmotietonsa ja opintosuoritteensa.

1.8.5 Metodit

• annaHetupublic java.lang.String annaHetu( )

– KuvausPalauttaa arvonaan opiskelijan henkilötunnuksen

– Palauttaa – Opiskelijan henkilötunnus


• annaKayttajatunnuspublic java.lang.String annaKayttajatunnus( )

– KuvausPalauttaa arvonaan opiskelijan käyttäjätunnuksen.

– Palauttaa – Opiskelijan käyttäjätunnus

• annaOpiskelijanumeropublic java.lang.String annaOpiskelijanumero( )

– KuvausPalauttaa arvonaan opiskelijan opiskelijanumeron.

– Palauttaa – Opiskelijan opiskelijanumero

• asetaKayttajatunnuspublic void asetaKayttajatunnus( java.lang.StringuusiKayttajatunnus )

– KuvausAsettaa opiskelijan käyttäjätunnuksen.

– Parametrit∗ uusiKayttajatunnus – uusi käyttäjätunnus

• asetaOpiskelijanumeropublic void asetaOpiskelijanumero( java.lang.StringuusiOpiskelijanumero )

– KuvausAsettaa opiskelijan opiskelijanumeron.

– Parametrit∗ uusiOpiskelijanumero – tekstimuodossa oleva

opiskelijanumero

• lisaaOpiskelijaListenerpublic void lisaaOpiskelijaListener(control.OpiskelijaListener o )

– KuvausLisää Opiskelja-oliolle tämän tilaa kuuntelevan kuuntelijan.

– Parametrit∗ o – Kuuntelija.

• lisaaSivuaineSuorituspublic void lisaaSivuaineSuoritus( java.lang.String sid,java.lang.String kk, java.lang.String n,java.util.Date pvm, java.lang.String as )


– KuvausLisää suoritetun sivuainekurssin opiskelijan tietorakenteeseen.

– Parametrit∗ sid – sivuaineen id Desmond järjestelmässä∗ kk – Kurssin kurssikoodi∗ n – Kurssin nimi∗ pvm – Päivämäärä, jolloin kurssi on suoritettu∗ as – Arvosana, mikä opiskelijalle on menty antamaan

• lisaaSuoritettuOpintojaksopublic void lisaaSuoritettuOpintojakso(SuoritettuOpintojakso s )

– KuvausLisää SuoritettuOpintojakso-olion Opiskelija-olion tietoihin.

– Parametrit∗ s – SuoritettuOpintojakso-olio joka vastaa opiskelijan suoritusta.

• lisaaUupuvaOpintojaksopublic void lisaaUupuvaOpintojakso( UupuvaOpintojaksouoj )

– KuvausLuo uuden UupuvaOpintojakso-olion.

– Parametrit∗ uoj – UupuvaOpintojakso-olio

• lisaaVapaavastauspublic void lisaaVapaavastaus( Vapaavastaus v )

– KuvausLisää opiskelijan vastaaman vapaavastauksen.

– Parametrit∗ v – Vapaavastaus-olio

• lisaaVastausvaihtoehtopublic void lisaaVastausvaihtoehto( Vastausvaihtoehto v)

– KuvausLuo uuden Vastausvaihtoehto-olion.

– Parametrit∗ v – Vastausvaihtoehto


• muokkaaVapaatekstiapublic void muokkaaVapaatekstia( java.lang.StringuusiTeksti )

– KuvausMuokkaa opiskelijassa olevaa hänen tilaansa kuvaavaa tekstiä. Joslisättävä teksti on tyhjä merkkijono asetetaan arvoksi null;

– Parametrit∗ uusiTeksti – Tekstihuomio, joka lisätään opiskelijaan

• nollaaSivuainesuorituksetpublic void nollaaSivuainesuoritukset( )

– KuvausTyhjentää opiskelijan sivuaineopinnot. Metodia käytetäänsivuainesuoritusten yhteydessä.

• noudaOpintosuorituksetpublic void noudaOpintosuoritukset( )

– KuvausHakee kannasta opiskelijan opintosuoritukset ja alustaa opiskelijanopintosuoritukset-sisältävät tietorakenteet.

• paivitaOpintosuorituksetpublic void paivitaOpintosuoritukset( )

– KuvausPäivittää opiskelijan Opintosuoritukset vastaamaan tietokannastalöytyviä.

• peruIlmopublic void peruIlmo( )

– KuvausMerkitsee opiskelijan poistetuksi kurssilta. Metodia käytetääntietokantapäivitysten yhteydessä.

• peruutaLukituspublic void peruutaLukitus( )

– KuvausMikäli Opiskelija-olio oli vain ryhmälukossa, poistaa ryhmälukon japalauttaa Opiskelija-olion aktiiviseksi kaikkiin ryhmiin, joihin se onliitetty. Mikäli Opiskelija-olio oli sekä ryhmälukittu että omalukittu,poistaa vain ryhmälukon ja jättää omalukon päälle. MikäliOpiskelija-olio oli vain omalukittu, poistaa omalukon ja palauttaaOpiskelija-olion aktiiviseksi kaikkiin ryhmiin, joihin se on liitetty.


• tarkastaEsitiedotpublic void tarkastaEsitiedot( )

– KuvausTarkastaa Desmond.jar:n avulla, mitä ryhmiteltävälle kurssillevaadittavia kursseja opiskelijalta puuttuu.

• teeOmaLukkopublic void teeOmaLukko( IlpoRyhma i )

– KuvausLukitsee Opiskelija-olion IlpoRyhma i:hin ja piilottaa opiskelijanmuista ryhmistä, joihin hänet on liitetty.

– Parametrit∗ i – IlpoRyhma, johon opiskelija lukitaan.

• teeRyhmaLukkopublic void teeRyhmaLukko( IlpoRyhma i )

– KuvausLukitsee Opiskelija ryhmälukolla annettuun IlpoRyhma-olioon.

– Parametrit∗ i – Ilporyhmä, johon opiskelija lukitaan. Mikäli Opiskelija on jo

omalukittu johonkin ryhmään, tämän IlpoRyhmän täytyy ollasama, mihin Opiskelija on omalukittu.


– KuvausTekstiesitys opiskelijasta

– Palauttaa – nimi hetu/opnro/käyttäjätunnus

1.9 Luokka Sivuaine

Opiskelijan yhden sivuaine-aineen suoritusten majapaikka.

1.9.1 Kuvauspublic class Sivuaineextends java.lang.Objectimplements java.io.Serializable



Sivuaine(String) Luodaan nimetön sivuaineSivuaine(String, String) Luodaan sivuaine, jonka nimi löytyi

.properties tiedostosta


lisaaSuoritus(SuoritettuSivuainekurssi) Lisää opiskelijansuorittaman sivuainekurssin

1.9.4 Konstruktorit

• Sivuainepublic Sivuaine( java.lang.String id )

– KuvausLuodaan nimetön sivuaine

– Parametrit∗ id – Sivuaineen ID, peräisin Desmondista

• Sivuainepublic Sivuaine( java.lang.String sivuaineID,java.lang.String nimi )

– KuvausLuodaan sivuaine, jonka nimi löytyi .properties tiedostosta

– Parametrit∗ sivuaineID – Sivuaineen ID, peräisin Desmondista∗ nimi – Sivuaineen nimi, jos sellainen on tiedossa

1.9.5 Metodit

• lisaaSuorituspublic void lisaaSuoritus( SuoritettuSivuainekurssi s)

– KuvausLisää opiskelijan suorittaman sivuainekurssin

– Parametrit∗ s – Sivuainekurssi, joka on suoritettu


1.10 Luokka SuoritettuOpintojakso

Yhdistää opiskelijan ja tämän suorittaman tktl:n opintojakson toisiinsa. Pitääsisällään suorituksen tiedot (päivämäärä, arvosana)

1.10.1 Kuvauspublic class SuoritettuOpintojaksoextends java.lang.Objectimplements java.io.Serializable


SuoritettuOpintojakso(Opintojakso, Opiskelija, Date, String)Luo opintosuorituksen


annaArvosana() Palauttaa arvonaan suorituksen arvosananannaKurssikoodi() Palauttaa arvonaan suoritetun opintojakson

kurssikoodinannaPaivamaara() Palauttaa arvonaan suorituksen päivämääränvaihdaSuorittaja(Opiskelija) Vaihtaa kurssin suorittaneen

Opiskelijan.vertaaJaPaivita(SuoritettuOpintojakso) Vertailee kahta saman

Opiskelija-olion opintosuoritusta.

1.10.4 Konstruktorit

• SuoritettuOpintojaksopublic SuoritettuOpintojakso( Opintojakso opintojakso,Opiskelija suorittaja, java.util.Date paivamaara,java.lang.String arvosana )

– KuvausLuo opintosuorituksen

– Parametrit∗ opintojakso – Suoritettu opintojakso∗ suorittaja – Sankarillisen suorituksen tehnyt soturisieluinen

opiskelija∗ paivamaara – Suorituksen ajankohta∗ arvosana – Suorituksen arvosana


1.10.5 Metodit

• annaArvosanapublic java.lang.String annaArvosana( )

– KuvausPalauttaa arvonaan suorituksen arvosanan

– Palauttaa – Suorituksesta annettu arvosana.


– KuvausPalauttaa arvonaan suoritetun opintojakson kurssikoodin

– Palauttaa – Suoritetun opintojakson kurssikoodi

• annaPaivamaarapublic java.util.Date annaPaivamaara( )

– KuvausPalauttaa arvonaan suorituksen päivämäärän

– Palauttaa – Päivämäärä, jolloin suoritus on tehty.

• vaihdaSuorittajapublic void vaihdaSuorittaja( Opiskelija suorittanut )

– KuvausVaihtaa kurssin suorittaneen Opiskelijan. Metodia käytetäänopiskelijan opintosuortiuste päivityksessä.

– Parametrit∗ suorittanut – Opiskelija joka asetetaan suorittajaksi

• vertaaJaPaivitapublic boolean vertaaJaPaivita( SuoritettuOpintojaksos )

– KuvausVertailee kahta saman Opiskelija-olion opintosuoritusta. Metodiakäytetään opintosuoritusten päivitysten yhteydessä. Metodi päivittääsuorituksen päivämäärän ja arvosanan, mikäli parametrinan annettu(kannasta löytynyt) suoritus on uudempi.

– Parametrit∗ s – Vertailtava opintosuoritus, jota ei muuteteta

– Palauttaa – True, mikäli suoritus viittaa samaan opintojaksoon.


1.11 Luokka SuoritettuSivuainekurssi

Opiskelijan suorittama sivuainekurssi.

1.11.1 Kuvauspublic class SuoritettuSivuainekurssiextends java.lang.Objectimplements java.io.Serializable


SuoritettuSivuainekurssi(String, String, Date, String) Luo uudenopiskelijan suorittaman sivuainekurssin.


• SuoritettuSivuainekurssipublic SuoritettuSivuainekurssi( java.lang.Stringkurssikoodi, java.lang.String nimi, java.util.Datepaivamaara, java.lang.String arvosana )

– KuvausLuo uuden opiskelijan suorittaman sivuainekurssin.

– Parametrit∗ kurssikoodi – Kurssin kurssikoodi∗ nimi – Kurssin nimi∗ paivamaara – Päivämäärä, jolloin kurssi on suoritettu∗ arvosana – Arvosana, mikä opiskelijalle on menty antamaan

1.12 Luokka UupuvaOpintojakso

Kurssin esitietoihin kuuluva opintojakso, jota opiskelija ei ole suorittanut. Tiedotpohjautuvat Desmondin tietokantaan.

1.12.1 Kuvauspublic class UupuvaOpintojaksoextends java.lang.Objectimplements java.io.Serializable



UupuvaOpintojakso(Opintojakso) Luo uudenUupuvaOpintojakso-olion.


vertaaSuoritukseen(SuoritettuOpintojakso) VertaaUupuvaOpintosjakso-olion kurssikoodiaSuoritettuOpintojakso-olion kurssikoodiin.

ylenKatso() Merkitsee uupuvan opintojakson sellaiseen tilaan, ettäpuute ei ole näkyvillä.


• UupuvaOpintojaksopublic UupuvaOpintojakso( Opintojakso opintojakso )

– KuvausLuo uuden UupuvaOpintojakso-olion. Puute on parametrina annettukurssi.

– Parametrit∗ opintojakso – puuttuva opintojakso

1.12.5 Metodit

• vertaaSuoritukseenpublic boolean vertaaSuoritukseen(SuoritettuOpintojakso verrokki )

– KuvausVertaa UupuvaOpintosjakso-olion kurssikoodiaSuoritettuOpintojakso-olion kurssikoodiin.

– Parametrit∗ verrokki – SuoritettuOpintojakso-olio, joka saattaa vastatata

uupuvaa.– Palauttaa – True, mikäli kyse on samasta kurssista.

• ylenKatsopublic void ylenKatso( )

– KuvausMerkitsee uupuvan opintojakson sellaiseen tilaan, että puute ei olenäkyvillä. Tämä tulee kyseeseen esimerkiksi silloin, kun opiskelija onsuorittanut kurssin, eikä siitä ole vielä merkintää rekistereissä taisilloin, kun kurssi on korvattu muilla opinnoilla.


1.13 Luokka Vapaakysymys

Ilmoittatumisen yhteydessä kysytty kysymys, johon on voitu vastatavapaamuotoisesti.

1.13.1 Kuvauspublic class Vapaakysymysextends java.lang.Objectimplements java.io.Serializable


Vapaakysymys(String, int) Luo Vapaakysymys-olion


annaKysymysNumeroIlpossa() Palauttaa arvonaan kysymyksenjärjestelmän sisäisen järjestysnumeron.


• Vapaakysymyspublic Vapaakysymys( java.lang.String kysymys, intkysymysNumeroIlpossa )

– KuvausLuo Vapaakysymys-olion

– Parametrit∗ kysymys – Kysytty asia∗ kysymysNumeroIlpossa – Ilpon sisäinen järjestysnumero

kysymykselle, joka on määritetty kurssi.properties-tiedostossa.

1.13.5 Metodit

• annaKysymysNumeroIlpossapublic int annaKysymysNumeroIlpossa( )

– KuvausPalauttaa arvonaan kysymyksen järjestelmän sisäisenjärjestysnumeron. Järjestysnumero yksilöi kysymyksen.

– Palauttaa – Yksilöivä kysymyksen järjestysnumero.


1.14 Luokka Vapaavastaus

Opiskelijan vastaus vapaakysymykseen.

1.14.1 Kuvauspublic class Vapaavastausextends java.lang.Objectimplements java.io.Serializable


Vapaavastaus(Vapaakysymys, String) Luo uudenVapaavastaus-olion.


• Vapaavastauspublic Vapaavastaus( Vapaakysymys vapaakysymys,java.lang.String vastaus )

– KuvausLuo uuden Vapaavastaus-olion.

– Parametrit∗ vastaus – Kysymys johon on vastattu.∗ vapaakysymys – Vastaus joka on annettu Ilmoon.

1.15 Luokka Vastausvaihtoehto

Vastausvaihtoehto sellaisen kysymyksen, johon on valmiit vastausvaihtoehdot.

1.15.1 Kuvauspublic class Vastausvaihtoehtoextends java.lang.Objectimplements java.io.Serializable


Vastausvaihtoehto(String, String, Kysymys) Luo uudenvastausvaihtoehdon.



annaVastausnumero() Palauttaa arvonaan vastauksen numeronIlmo-lomakkeessa.

lisaaVastannutOpiskelija(Opiskelija) Lisää yhden juuri näin tähänkysymykseen vastanneen opiskelijan vastausvaihtoehdontietorakenteeseen.


• Vastausvaihtoehtopublic Vastausvaihtoehto( java.lang.String vaihtoehto,java.lang.String vastausnumero, Kysymys kysymys )

– KuvausLuo uuden vastausvaihtoehdon.

– Parametrit∗ vaihtoehto – Vastaus tekstimuodossa∗ vastausnumero – Vastauksen numero ilmo-lomakkeella∗ kysymys – Kysymys, johon vastausvaihtoehto liittyy

1.15.5 Metodit

• annaVastausnumeropublic java.lang.String annaVastausnumero( )

– KuvausPalauttaa arvonaan vastauksen numeron Ilmo-lomakkeessa.

– Palauttaa – Vastauksen numero Ilmo-lomakkeessa

• lisaaVastannutOpiskelijapublic void lisaaVastannutOpiskelija( Opiskelija vastannut)

– KuvausLisää yhden juuri näin tähän kysymykseen vastanneen opiskelijanvastausvaihtoehdon tietorakenteeseen.

– Parametrit∗ vastannut – Opiskelija, joka on erehtynyt vastaamaan

kysymykseen vaihtoehdon mukaisesti

Chapter 2

Pakkaus fi.helsinki.cs.ilpo.control


RajapinnatIlmoRyhmaListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

IlmoRyhmä-olion kuuntelija.IlpoRyhmaListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

IlpoRyhmä-olion kuuntelija.NakymaRyhmaHKListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

PieniHKBoxi-olentoon tapahtuvia tapahtumia kuunteleva kuuntelija.NakymaRyhmaListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

NakymaRyhma-olioita kuunteleva rajapinta.OpiskelijaListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Opiskelija-oliota kuunteleva rajapinta.PalloListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Kuutelee Pallo-olioihin kohdistuvia toimintoja.

LuokatKontrolliPalikka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

KontrolliPalikka kuvaa kaikki kontrolliluokkia, eikä sitä ole oikeasti olemassa.KontrolliYlenkatsoUupuva . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Suorittaa uupuvien opintosuoritusten ylenkatsomisen.

2.1 Luokka IlmoRyhmaListener

IlmoRyhmä-olion kuuntelija. Kuuntelee IlmoRyhmä-oliossa tapahtuviamuutoksia.

2.1.1 Kuvaus

public interface IlmoRyhmaListener

37

CHAPTER 2. PAKKAUS FI.HELSINKI.CS.ILPO.CONTROL 38

2.1.2 Kaikki tunnetut alirajapinnat

HKBoxi (in 3.3, page 39), IsoHKBoxi (in 3.5, page 40), PieniHKBoxi (in 3.13, page 45)

2.1.3 Kaikki luokat, joiden tiedetään toteuttavan rajapinnan

HKBoxi (in 3.3, page 39)

2.2 Luokka IlpoRyhmaListener

IlpoRyhmä-olion kuuntelija. Kuuntelee IlpoRyhmä-oliossa tapahtuvia muutoksia.

2.2.1 Kuvaus

public interface IlpoRyhmaListener


NakymaRyhma (in 3.7, page 41), NakymaUusiRyhma (in 3.8, page 42),NakymaVanhaRyhma (in 3.9, page 42)


NakymaRyhma (in 3.7, page 41)

2.3 Luokka NakymaRyhmaHKListener

PieniHKBoxi-olentoon tapahtuvia tapahtumia kuunteleva kuuntelija.

2.3.1 Kuvaus

public interface NakymaRyhmaHKListener


KontrolliPalikka (in 2.7, page 34)




2.4 Luokka NakymaRyhmaListener

NakymaRyhma-olioita kuunteleva rajapinta.

2.4.1 Kuvaus

public interface NakymaRyhmaListener





2.5 Luokka OpiskelijaListener

Opiskelija-oliota kuunteleva rajapinta. Kuuntelee Opiskelija-oliossa tapahtuviamuutoksia.

2.5.1 Kuvaus

public interface OpiskelijaListener


KopioituvaPallo (in 3.6, page 41), Pallo (in 3.12, page 45), SiirtyvaPallo (in 3.19, page48)


Pallo (in 3.12, page 45)

2.6 Luokka PalloListener

Kuutelee Pallo-olioihin kohdistuvia toimintoja.

2.6.1 Kuvaus

public interface PalloListener






2.7 Luokka KontrolliPalikka

KontrolliPalikka kuvaa kaikki kontrolliluokkia, eikä sitä ole oikeasti olemassa.Kontrolliluokat nimetään oikeasti tyyliin "KontrolliToiminto", missä Toiminto onsuoritettavan toiminnon nimi. Toteutettavat Listener- rajapinnatkin ovat jokaisellakontrolliluokalla omat. Kaikki eivät siis toteuta kaikkia kuuntelijoita.Kontrolliluokat kuuntelevat siis käyttöliittymän komponentteja (view-osaa) jailmoittavat halutusta toiminnasta sisäiselle tietorakenteelle (model-osaan).Esimerkiksi KontrolliLYlenkatsoUupuva suorittaa uupuvien opintosuoritustenylenkatsomisen.

2.7.1 Kuvauspublic class KontrolliPalikkaextends java.lang.Objectimplements PalloListener, NakymaRyhmaListener, NakymaRyhmaHKListener


KontrolliPalikka()

2.7.3 Konstruktorit

• KontrolliPalikkapublic KontrolliPalikka( )

2.8 Luokka KontrolliYlenkatsoUupuva

Suorittaa uupuvien opintosuoritusten ylenkatsomisen. Tämä luokka onsuunnitteluvaiheessa esimerkkiluokka kontrolliluokista, joita myösKontrolliPalikka-luokka kuvaa.


2.8.1 Kuvauspublic class KontrolliYlenkatsoUupuvaextends java.lang.Objectimplements java.awt.event.ActionListener


KontrolliYlenkatsoUupuva()


actionPerformed(ActionEvent) Tavallinen actionPerformed-metodi.

2.8.4 Konstruktorit

• KontrolliYlenkatsoUupuvapublic KontrolliYlenkatsoUupuva( )

2.8.5 Metodit

• actionPerformedpublic void actionPerformed(java.awt.event.ActionEvent event )

– KuvausTavallinen actionPerformed-metodi. Suoritetaan, kun se, mitä tälläkuunnellaan, päättää kutsua tätä metodia.

– Parametrit∗ event – ActionEvent, joka laukaisi tämän Listenerin.

Chapter 3

Pakkaus fi.helsinki.cs.ilpo.view


LuokatAutentikointiIkkuna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Class AutentikointiIkkunaHenkilotietoSolu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Näytön vasempaan alanurkkaan tietosoluun asetettava opiskelijan tarkemmat tiedotsisältävä näkymä.

HKBoxi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Ilmoon talletetun ryhmän henkilökuntaa kuvaavan graafinen elementin yliluokka.

HKSortSolu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Ilmosta saatavien ryhmien henkilökuntaa esittäviä palikoita sisältävän listansisältävä solu näytön vasempaan ylänurkkaan.

IsoHKBoxi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Vasemmassa ylänurkassa näkyvä Ilmon ryhmähenkilökuntaa esittävä graafinen el-ementti.

KopioituvaPallo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Vasemman ylänurkan sortsolun opiskelijasortsolun opiskelijaa esittävä graafinenpallo, joka voidaan vetää ryhmänäkymän puolelle oikealle puolelle näyttöä jo-honkin ryhmään, jolloin opiskelija liitetään kyseiseen ryhmään, mutta alkuperäinenpallo jää paikalleen.

NakymaRyhma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Ryhmää esittävä graafinen representaatio asetettavaksi näytön oikeaan puoliskoon,ryhmäsoluun.

NakymaUusiRyhma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42NakymaUusiRyhma on ryhmasolun vasempaan alanurkkan luotava tyhjä ryhmä,joka opiskelijoita lisättäessä korvataan NakymaVanhaRyhmalla.

NakymaVanhaRyhma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Näytön oikeaan puoliskoon, ryhmäsoluun, liitettävä ryhmän representaatio, johonlisätty opiskelijoita, ja joka näin liittyy johonkin ilporyhmään.

OpiskelijaListassaJComponent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

42

CHAPTER 3. PAKKAUS FI.HELSINKI.CS.ILPO.VIEW 43

Tietosolun ollessa listanäkymässä, ovat listanäkymän näkymät OpiskelijaListassaJ-Componentteja.

OpiskelijaSortSolu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44Ikkunan vasempaan ylänurkkaan Sortsoluun asetettava opiskelijapalloja sisältävänäkymä.

Pallo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Järjestelmän peruselementti, opiskelijaa esittävä pallo, jonka ulkoasun perivätainakin KopioituvaPallo sekä SiirtyvaPallo.

PieniHKBoxi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Oikealla ryhmänäytössä ryhmän sisällä sijaitseva graafinen elementti, joka kuvaaIlmoryhmän henkilökuntaa, joka on kiinnitetty ilporyhmään.

PoistaOpiskelijaButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Button, joka poistaa opiskelijan.

PoistaRyhmaButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Button, jota painamalla ryhmä poistuu.

PoistaRyhmastaButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47Button, jota painamalla Opiskelija poistuu IlpoRyhmästä.

RyhmaSolu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47Näytön oikea puoli, jossa ilpon ryhmät kelluvat.

RyhmatietoSolu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Valitun ryhmän opiskelijoiden tiedot listassa näyttävä näkymä, joka sijaitsee ti-etosolussa näytän vasemmassa alanurkassa.

SiirtyvaPallo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Ryhmäsolun ryhmissä kelluvat opiskelijoita kuvaavat pallot, jotka siirrettäessä si-irtyvät uuteen ryhmään.

SortSolu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Vasemman ylänurkan solu, johon asetetaan erilaisia järjestämiseen liittyviä soluja.

TietoSolu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Näytön vasemmassa alanurkassa oleva solu, johon asetetaan joko opiskelijantarkempia tietoja sisältävä solu tai vaihtoehtoisesti valittujen opiskelijoiden tiivis-tettyjä tietoja sisältävä lista.

TulosRyhmaNakyma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Vasemman ylänurkan järjestettyjä opiskelijapalloja sisältävä näkymä.

YlenkatsoJButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Button, jota painamalla käyttäjä voi ylenkatsoa uupuvan opintosuorituksen.

3.1 Luokka AutentikointiIkkuna

Class AutentikointiIkkuna

3.1.1 Kuvauspublic class AutentikointiIkkuna


extends javax.swing.JFrame

3.1.2 Kenttien yhteenveto

passwordFielduserNameField


AutentikointiIkkuna()


main(String[])onkoAutentikointiOK()onkoPainettuOk()

3.1.5 Kentät

• protected javax.swing.JTextField userNameField

• protected javax.swing.JPasswordField passwordField

3.1.6 Konstruktorit

• AutentikointiIkkunapublic AutentikointiIkkuna( )

3.1.7 Metodit


• onkoAutentikointiOKpublic boolean onkoAutentikointiOK( )

• onkoPainettuOkpublic boolean onkoPainettuOk( )

3.2 Luokka HenkilotietoSolu

Näytön vasempaan alanurkkaan tietosoluun asetettava opiskelijan tarkemmattiedot sisältävä näkymä.


3.2.1 Kuvauspublic class HenkilotietoSoluextends javax.swing.JPanel


HenkilotietoSolu() Luodaan TietoSoluun liittyväopiskelijatietonäkymä.

3.2.3 Konstruktorit

• HenkilotietoSolupublic HenkilotietoSolu( )

– KuvausLuodaan TietoSoluun liittyvä opiskelijatietonäkymä.

3.3 Luokka HKBoxi

Ilmoon talletetun ryhmän henkilökuntaa kuvaavan graafinen elementin yliluokka.

3.3.1 Kuvauspublic class HKBoxiextends java.lang.Objectimplements fi.helsinki.cs.ilpo.control.IlmoRyhmaListener

3.3.2 Kaikki tunnetut aliluokat

IsoHKBoxi (in 3.5, page 40), PieniHKBoxi (in 3.13, page 45)


HKBoxi(IlmoRyhma) Luo uuden Ilmoryhmään liityvän HKBoxin

3.3.4 Konstruktorit

• HKBoxipublic HKBoxi( fi.helsinki.cs.ilpo.IlmoRyhmailmoRyhma )

– KuvausLuo uuden Ilmoryhmään liityvän HKBoxin

– Parametrit∗ ilmoRyhma – elementin kuvaama ryhmähenkilökunta


3.4 Luokka HKSortSolu

Ilmosta saatavien ryhmien henkilökuntaa esittäviä palikoita sisältävän listansisältävä solu näytön vasempaan ylänurkkaan.

3.4.1 Kuvauspublic class HKSortSoluextends javax.swing.JPanel


HKSortSolu() Luodaan HKSortSolu

3.4.3 Konstruktorit

• HKSortSolupublic HKSortSolu( )

– KuvausLuodaan HKSortSolu

3.5 Luokka IsoHKBoxi

Vasemmassa ylänurkassa näkyvä Ilmon ryhmähenkilökuntaa esittävä graafinenelementti.

3.5.1 Kuvauspublic class IsoHKBoxiextends fi.helsinki.cs.ilpo.view.HKBoxi (in 3.3, page 39)


IsoHKBoxi(IlmoRyhma) Luo uuden Ilmoryhmän henkilökuntaaesittävän kuvajaisen.

3.5.3 Konstruktorit

• IsoHKBoxipublic IsoHKBoxi( fi.helsinki.cs.ilpo.IlmoRyhmailmoRyhma )

– KuvausLuo uuden Ilmoryhmän henkilökuntaa esittävän kuvajaisen.



3.6 Luokka KopioituvaPallo

Vasemman ylänurkan sortsolun opiskelijasortsolun opiskelijaa esittävä graafinenpallo, joka voidaan vetää ryhmänäkymän puolelle oikealle puolelle näyttöäjohonkin ryhmään, jolloin opiskelija liitetään kyseiseen ryhmään, muttaalkuperäinen pallo jää paikalleen.

3.6.1 Kuvauspublic class KopioituvaPalloextends fi.helsinki.cs.ilpo.view.Pallo (in 3.12, page 45)


KopioituvaPallo(Opiskelija) Luodaan sortsolussa asuva näkyväpallo.

3.6.3 Konstruktorit

• KopioituvaPallopublic KopioituvaPallo( fi.helsinki.cs.ilpo.Opiskelijaopiskelija )

– KuvausLuodaan sortsolussa asuva näkyvä pallo.

– Parametrit∗ opiskelija – Opiskelija, jota pallo esittää.

3.7 Luokka NakymaRyhma

Ryhmää esittävä graafinen representaatio asetettavaksi näytön oikeaanpuoliskoon, ryhmäsoluun.

3.7.1 Kuvauspublic abstract class NakymaRyhmaextends java.lang.Objectimplements fi.helsinki.cs.ilpo.control.IlpoRyhmaListener



NakymaUusiRyhma (in 3.8, page 42), NakymaVanhaRyhma (in 3.9, page 42)


NakymaRyhma() Tehdään NakymaUusiRyhman jaNakymaVanhaRyhman yhteiset konstruktointitoiminnot.

3.7.4 Konstruktorit

• NakymaRyhmapublic NakymaRyhma( )

– KuvausTehdään NakymaUusiRyhman ja NakymaVanhaRyhman yhteisetkonstruktointitoiminnot.

3.8 Luokka NakymaUusiRyhma

NakymaUusiRyhma on ryhmasolun vasempaan alanurkkan luotava tyhjä ryhmä,joka opiskelijoita lisättäessä korvataan NakymaVanhaRyhmalla.

3.8.1 Kuvauspublic class NakymaUusiRyhmaextends fi.helsinki.cs.ilpo.view.NakymaRyhma (in 3.7, page 41)


NakymaUusiRyhma()

3.8.3 Konstruktorit

• NakymaUusiRyhmapublic NakymaUusiRyhma( )

3.9 Luokka NakymaVanhaRyhma

Näytön oikeaan puoliskoon, ryhmäsoluun, liitettävä ryhmän representaatio, johonlisätty opiskelijoita, ja joka näin liittyy johonkin ilporyhmään.


3.9.1 Kuvauspublic class NakymaVanhaRyhmaextends fi.helsinki.cs.ilpo.view.NakymaRyhma (in 3.7, page 41)


NakymaVanhaRyhma(IlpoRyhma) Luodaan ilpoRyhmän graafinenilmentymä

3.9.3 Konstruktorit

• NakymaVanhaRyhmapublic NakymaVanhaRyhma(fi.helsinki.cs.ilpo.IlpoRyhma ilpoRyhma )

– KuvausLuodaan ilpoRyhmän graafinen ilmentymä

– Parametrit∗ ilpoRyhma – NakymaRyhman esittämä ryhmä

3.10 Luokka OpiskelijaListassaJComponent

Tietosolun ollessa listanäkymässä, ovat listanäkymän näkymätOpiskelijaListassaJComponentteja.

3.10.1 Kuvauspublic class OpiskelijaListassaJComponentextends javax.swing.JComponent


OpiskelijaListassaJComponent(Opiskelija) Luodaanryhmätietosoluun liitettävä komponentti.


• OpiskelijaListassaJComponentpublic OpiskelijaListassaJComponent(fi.helsinki.cs.ilpo.Opiskelija opiskelija )

– KuvausLuodaan ryhmätietosoluun liitettävä komponentti.


3.11 Luokka OpiskelijaSortSolu

Ikkunan vasempaan ylänurkkaan Sortsoluun asetettava opiskelijapalloja sisältävänäkymä.

3.11.1 Kuvauspublic class OpiskelijaSortSoluextends javax.swing.JPanel


OpiskelijaSortSolu() Luodaan ilmentymä Opiskelijasortsolusta


addTulosRyhmaNakyma(TulosRyhmaNakyma) LisätäänTulosRyhmaNakyma järjestämisen yhteydessä näkymään.

paintComponent(Graphics)


• OpiskelijaSortSolupublic OpiskelijaSortSolu( )

– KuvausLuodaan ilmentymä Opiskelijasortsolusta

3.11.5 Metodit

• addTulosRyhmaNakymapublic void addTulosRyhmaNakyma( TulosRyhmaNakymatulosRyhmaNakyma )

– KuvausLisätään TulosRyhmaNakyma järjestämisen yhteydessä näkymään.

– Parametrit∗ tulosRyhmaNakyma – Lisättävä TulosRyhmaNakyma

• paintComponentprotected void paintComponent( java.awt.Graphics arg0)


3.12 Luokka Pallo

Järjestelmän peruselementti, opiskelijaa esittävä pallo, jonka ulkoasun perivätainakin KopioituvaPallo sekä SiirtyvaPallo.

3.12.1 Kuvauspublic abstract class Palloextends java.lang.Objectimplements fi.helsinki.cs.ilpo.control.OpiskelijaListener


KopioituvaPallo (in 3.6, page 41), SiirtyvaPallo (in 3.19, page 48)


Pallo() Luodaan opiskelijaa esittävä graafinen pallo.


• Pallopublic Pallo( )

– KuvausLuodaan opiskelijaa esittävä graafinen pallo.

3.13 Luokka PieniHKBoxi

Oikealla ryhmänäytössä ryhmän sisällä sijaitseva graafinen elementti, joka kuvaaIlmoryhmän henkilökuntaa, joka on kiinnitetty ilporyhmään.

3.13.1 Kuvauspublic class PieniHKBoxiextends fi.helsinki.cs.ilpo.view.HKBoxi (in 3.3, page 39)


PieniHKBoxi(IlmoRyhma) Luo uuden Ilmoryhmän henkilökuntaaesittävän kuvajaisen.



• PieniHKBoxipublic PieniHKBoxi( fi.helsinki.cs.ilpo.IlmoRyhmailmoRyhma )

– KuvausLuo uuden Ilmoryhmän henkilökuntaa esittävän kuvajaisen.


3.14 Luokka PoistaOpiskelijaButton

Button, joka poistaa opiskelijan. Jostain.

3.14.1 Kuvauspublic class PoistaOpiskelijaButtonextends javax.swing.JButton


PoistaOpiskelijaButton() Luo tämän olion.


• PoistaOpiskelijaButtonpublic PoistaOpiskelijaButton( )

– KuvausLuo tämän olion.

3.15 Luokka PoistaRyhmaButton

Button, jota painamalla ryhmä poistuu.

3.15.1 Kuvauspublic class PoistaRyhmaButtonextends javax.swing.JButton


PoistaRyhmaButton()



• PoistaRyhmaButtonpublic PoistaRyhmaButton( )

3.16 Luokka PoistaRyhmastaButton

Button, jota painamalla Opiskelija poistuu IlpoRyhmästä.

3.16.1 Kuvauspublic class PoistaRyhmastaButtonextends javax.swing.JButton


PoistaRyhmastaButton()


• PoistaRyhmastaButtonpublic PoistaRyhmastaButton( )

3.17 Luokka RyhmaSolu

Näytön oikea puoli, jossa ilpon ryhmät kelluvat.

3.17.1 Kuvauspublic class RyhmaSoluextends javax.swing.JPanel


RyhmaSolu() Luodaan ilpoon asetettava ryhmänäkymä.


paintComponent(Graphics)



• RyhmaSolupublic RyhmaSolu( )

– KuvausLuodaan ilpoon asetettava ryhmänäkymä.

3.17.5 Metodit

• paintComponentprotected void paintComponent( java.awt.Graphics arg0)

3.18 Luokka RyhmatietoSolu

Valitun ryhmän opiskelijoiden tiedot listassa näyttävä näkymä, joka sijaitseetietosolussa näytän vasemmassa alanurkassa.

3.18.1 Kuvauspublic class RyhmatietoSoluextends java.lang.Object


RyhmatietoSolu() Luodaan ryhmätietosolu valitun ryhmänOpiskelijoiden pohjalta


• RyhmatietoSolupublic RyhmatietoSolu( )

– KuvausLuodaan ryhmätietosolu valitun ryhmän Opiskelijoiden pohjalta

3.19 Luokka SiirtyvaPallo

Ryhmäsolun ryhmissä kelluvat opiskelijoita kuvaavat pallot, jotka siirrettäessäsiirtyvät uuteen ryhmään.


3.19.1 Kuvauspublic class SiirtyvaPalloextends fi.helsinki.cs.ilpo.view.Pallo (in 3.12, page 45)


SiirtyvaPallo(Opiskelija) Luodaan NakymaRyhmaan siirrettäessänäkyvä pallo.


• SiirtyvaPallopublic SiirtyvaPallo( fi.helsinki.cs.ilpo.Opiskelijaopiskelija )

– KuvausLuodaan NakymaRyhmaan siirrettäessä näkyvä pallo.

– Parametrit∗ opiskelija – Opiskelija, jota pallo esittää.

3.20 Luokka SortSolu

Vasemman ylänurkan solu, johon asetetaan erilaisia järjestämiseen liittyviä soluja.

3.20.1 Kuvauspublic class SortSoluextends java.lang.Object


SortSolu() Luo päänäyttöön liitettävän järjestyssolun.


• SortSolupublic SortSolu( )

– KuvausLuo päänäyttöön liitettävän järjestyssolun.


3.21 Luokka TietoSolu

Näytön vasemmassa alanurkassa oleva solu, johon asetetaan joko opiskelijantarkempia tietoja sisältävä solu tai vaihtoehtoisesti valittujen opiskelijoidentiivistettyjä tietoja sisältävä lista.

3.21.1 Kuvauspublic class TietoSoluextends java.lang.Object


TietoSolu() Luodaan päänäyttöön kiinnitettävä TietoSolu.


• TietoSolupublic TietoSolu( )

– KuvausLuodaan päänäyttöön kiinnitettävä TietoSolu.

3.22 Luokka TulosRyhmaNakyma

Vasemman ylänurkan järjestettyjä opiskelijapalloja sisältävä näkymä.

3.22.1 Kuvauspublic class TulosRyhmaNakymaextends java.lang.Object


TulosRyhmaNakyma() Luodaan sortsoluun liittyvä järjestysnäkymä.


• TulosRyhmaNakymapublic TulosRyhmaNakyma( )

– KuvausLuodaan sortsoluun liittyvä järjestysnäkymä.


3.23 Luokka YlenkatsoJButton

Button, jota painamalla käyttäjä voi ylenkatsoa uupuvan opintosuorituksen. Tämäsijaitsee detail-solussa (vasemmalla alhalla), jokaisen uupuvan opintosuorituksenyhteydessä.

3.23.1 Kuvauspublic class YlenkatsoJButtonextends javax.swing.JButton


YlenkatsoJButton(UupuvaOpintojakso) Luo tämän nappulan.


• YlenkatsoJButtonpublic YlenkatsoJButton(fi.helsinki.cs.ilpo.UupuvaOpintojakso uupuva )

– KuvausLuo tämän nappulan.

– Parametrit∗ uupuva – UupuvaOpintoJakso, mitä tällä napilla ylenkatsotaan.

Chapter 4

Pakkaus fi.helsinki.cs.ilpo.db


LuokatParseri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Parsii kysymykset ja vastaukset.Tietokantakyselija . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Tietokantakyselija sisältää SQL-kyselyt, joita Ilpo käyttää.Tietokantayhteys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Yhteys Ilmo/Desmond tietokantaan

4.1 Luokka Parseri

Parsii kysymykset ja vastaukset.

4.1.1 Kuvauspublic class Parseriextends java.lang.Object


Parseri(Tietokantakyselija, Kurssi) Luo parseri olion


haeRadiobuttonKysymykset() Metodi hakee radiobutton tyyppisetkysymykset

parsiKysymykset() Metodi parsii kaikki kysymyksetparsiVastaukset(Opiskelija, Kurssi) Metodi parsii kaikki vastaukset

58

CHAPTER 4. PAKKAUS FI.HELSINKI.CS.ILPO.DB 59

4.1.4 Konstruktorit

• Parseripublic Parseri( Tietokantakyselija tkk,fi.helsinki.cs.ilpo.Kurssi k )

– KuvausLuo parseri olion

– Parametrit∗ tkk – tietokantakyselijä∗ k – Kurssi olio

4.1.5 Metodit

• haeRadiobuttonKysymyksetpublic java.util.LinkedList haeRadiobuttonKysymykset()

– KuvausMetodi hakee radiobutton tyyppiset kysymykset

– Palauttaa – LinkedList

• parsiKysymyksetpublic void parsiKysymykset( )

– KuvausMetodi parsii kaikki kysymykset

• parsiVastauksetpublic void parsiVastaukset(fi.helsinki.cs.ilpo.Opiskelija o,fi.helsinki.cs.ilpo.Kurssi k )

– KuvausMetodi parsii kaikki vastaukset

– Parametrit∗ o – Opiskelija olio∗ k – Kurssi olio

4.2 Luokka Tietokantakyselija

Tietokantakyselija sisältää SQL-kyselyt, joita Ilpo käyttää. Mikäli vastauksia eitarvitse erikseen parsia, luo tietokantakyselijä vastaavat Ilpon oliot suoraankyselyn vastauksessa. Parsimista vaativien kyselyjen vastaukset annetaanResultSet-olioina parserille.


4.2.1 Kuvauspublic class Tietokantakyselijaextends java.lang.Object


Tietokantakyselija(Kurssi, Tietokantayhteys) LuoTietokantakyselija-olion.


main(String[])noudaKaikkiOpintojaksot() Noutaa kaikki Ilmo-kannasta löytyvät

(tktl:n) opintojaksot ja luo niistä Opintojakso-oliotSQL kysely:SELECT kurssikoodi, nimi_suomi, opintoviikot

FROM opintojakso

noudaKayttajatunnukset() SQL-lause, joka noutaa kaikkiendesmondista löytyvien opiskelijoidenopiskelijanumero-käyttäjätunnus parit.

noudaKurssinIlmoryhmat() Noutaa kaikki kurssiin liittyvätIlmo-ryhmät sekä niihin liittyvät henkilökunnan jäsenet

noudaKurssinIlmoVastaukset() Noutaa kurssille ilmoittautuneidenIlmoon kurssi-ilmottautumisen yhteydessä kirjoittamat vastaukset

noudaKurssinKysymykset() SQL-lause, joka noutaa kurssinIlmo-kysymykset parseroitaviksi.

noudaKurssinOpiskelijat() Noutaa kaikkien kurssilleilmoittautuneiden opiskelijoiden henkilötiedot.Opiskelija-oliotluodaan Ilmo- ja Desmond kannoista löytyvien tietojenperusteella.

noudaOpiskelijanVastaukset(String) SQL-lause, joka noutaaopiskelijan Ilmo-vastaukset parseroitaviksi.

paivitaKurssinOpiskelijat() Päivittää urssille ilmoittautuneidenopiskelijoiden muuttuneet henkilötiedot ja merkitsee neopiskelijat poistetuiksi, jotka ovat peruneet ilmonsa.

paivitaPaaainesuoritukset(Opiskelija, Hashtable) LinkittääOpintojakso-oliot Opiskelija-olioihin.

yhdistaPaaainesuorituksiin(Opiskelija, Hashtable) LinkittääOpintojakso-oliot Opiskelija-olioihin.

yhdistaSivuainesuorituksiin(Opiskelija) Noutaa opiskelijansuorittamat sivuaineopinnot, sekä luo niistä tarvittavat Sivuaine-ja SuoritettuSivuainekurssi -oliot, jotka liittää Opiskelija-olioon.


4.2.4 Konstruktorit

• Tietokantakyselijapublic Tietokantakyselija( fi.helsinki.cs.ilpo.Kurssik, Tietokantayhteys yhteys )

– KuvausLuo Tietokantakyselija-olion.

– Parametrit∗ k – Kurssi-jota ryhmitellään∗ yhteys – Tietokantayhteys, jota kyselijä käyttää urkintoihinsa

4.2.5 Metodit

• mainpublic static void main( java.lang.String[] args )heittää java.lang.Exception

• noudaKaikkiOpintojaksotpublic java.util.Hashtable noudaKaikkiOpintojaksot( )

– KuvausNoutaa kaikki Ilmo-kannasta löytyvät (tktl:n) opintojaksot ja luoniistä Opintojakso-oliotSQL kysely:SELECT kurssikoodi, nimi_suomi, opintoviikot FROM

opintojakso

– Palauttaa – Hajautustaulun, jossa on kaikki tietojenkäsittelytieteenopintojaksot. Avaimena toimii kurssikoodi.

• noudaKayttajatunnuksetpublic java.util.Hashtable noudaKayttajatunnukset( )

– KuvausSQL-lause, joka noutaa kaikkien desmondista löytyvienopiskelijoiden opiskelijanumero-käyttäjätunnus parit.

– Palauttaa – Opiskelijanumero-käyttäjätunnus parit hajautustaulussa.Avain on opiskelijanumero.

• noudaKurssinIlmoryhmatpublic java.util.Collection noudaKurssinIlmoryhmat( )

– KuvausNoutaa kaikki kurssiin liittyvät Ilmo-ryhmät sekä niihin liittyväthenkilökunnan jäsenet


– Palauttaa – IlmoRyhma-oliot, joihin on liitetty vastaavatHenkilokuntalainen-oliot.

• noudaKurssinIlmoVastauksetpublic java.sql.ResultSet noudaKurssinIlmoVastaukset( )

– KuvausNoutaa kurssille ilmoittautuneiden Ilmoon kurssi-ilmottautumisenyhteydessä kirjoittamat vastaukset

– Palauttaa – ResultSet

• noudaKurssinKysymyksetpublic java.sql.ResultSet noudaKurssinKysymykset( )heittää java.lang.Exception

– KuvausSQL-lause, joka noutaa kurssin Ilmo-kysymykset parseroitaviksi.

– Palauttaa – Ilmo-kysymykset ResultSet-oliossa.

• noudaKurssinOpiskelijatpublic java.util.Collection noudaKurssinOpiskelijat( )

– KuvausNoutaa kaikkien kurssille ilmoittautuneiden opiskelijoidenhenkilötiedot.Opiskelija-oliot luodaan Ilmo- ja Desmond kannoistalöytyvien tietojen perusteella. Metodilla ei suoriteta päivityksiä.SQL kysely:SELECT op.hetu, op.opnro, op.sukunimi ||’ ’

||op.etunimi as nimi, op.sahkopostiosoite,

op.aloitusvuosi, op.paa_aine, os.ryhma_nro FROM

osallistuminen os, opiskelija op WHERE os.hetu =

op.hetu AND os.voimassa = ’K’ AND os.kurssikoodi =

kk AND os.lukuvuosi = lv AND os.lukukausi=lk AND

os.kurssi_nro = knro

– Palauttaa – Opiskelijat Collection-oliossa.

• noudaOpiskelijanVastauksetpublic java.sql.ResultSet noudaOpiskelijanVastaukset(java.lang.String hetu )

– KuvausSQL-lause, joka noutaa opiskelijan Ilmo-vastaukset parseroitaviksi.

– Parametrit∗ hetu – Opiskelijan henkilötunnus


– Palauttaa – Ilmo-vastaukset ResultSet-oliossa.

• paivitaKurssinOpiskelijatpublic void paivitaKurssinOpiskelijat( )

– KuvausPäivittää urssille ilmoittautuneiden opiskelijoiden muuttuneethenkilötiedot ja merkitsee ne opiskelijat poistetuiksi, jotka ovatperuneet ilmonsa. Tarvittavat uudet Opiskelija-oliot(jälki-ilmoittautuneet) luodaan Ilmo- ja Desmond kannoista löytyvientietojen perusteella.

• paivitaPaaainesuorituksetpublic void paivitaPaaainesuoritukset(fi.helsinki.cs.ilpo.Opiskelija opiskelija,java.util.Hashtable opintojaksot )

– KuvausLinkittää Opintojakso-oliot Opiskelija-olioihin. Noutaa opiskelijanpääainesuoritukset, joista generoi SuoritettuOpintojakso-olioitaOpintojakso-olioita hyväksikäyttäen.

– Parametrit∗ opiskelija – Opiskelija, jonka opintosuoritukset päivitetään.∗ opintojaksot – Kaikki kannasta löytyvät tktl:n opintojaksot

• yhdistaPaaainesuorituksiinpublic void yhdistaPaaainesuorituksiin(fi.helsinki.cs.ilpo.Opiskelija opiskelija,java.util.Hashtable opintojaksot )

– KuvausLinkittää Opintojakso-oliot Opiskelija-olioihin. Noutaa opiskelijanpääainesuoritukset, joista generoi SuoritettuOpintojakso-olioitaOpintojakso-olioita hyväksikäyttäen.

– Parametrit∗ opiskelija – Opiskelija, jonka opintosuoritukset noukitaan∗ opintojaksot – Kaikki kannasta löytyvät tktl:n opintojaksot

• yhdistaSivuainesuorituksiinpublic void yhdistaSivuainesuorituksiin(fi.helsinki.cs.ilpo.Opiskelija opiskelija )

– KuvausNoutaa opiskelijan suorittamat sivuaineopinnot, sekä luo niistätarvittavat Sivuaine- ja SuoritettuSivuainekurssi -oliot, jotka liittääOpiskelija-olioon. Metodilla voidaan myös päivittää sivuaineopinnot.


– Parametrit∗ opiskelija – Opiskelija, jonka suoritukset noudetaan.

4.3 Luokka Tietokantayhteys

Yhteys Ilmo/Desmond tietokantaan

4.3.1 Kuvauspublic class Tietokantayhteysextends java.lang.Object


Tietokantayhteys(String, String, String, String, String, String,String) Luo uuden tietokantayhteyden.


main(String[])suljeYhteys() Sulkee yhteyden tietokantaan.suoritaKysely(String) Suorittaa SQL-kyselyn.

4.3.4 Konstruktorit

• Tietokantayhteyspublic Tietokantayhteys( java.lang.StringajuriluokanNimi, java.lang.String ajurinNimi,java.lang.String tietokannanOsoite, java.lang.StringtietokannanPortti, java.lang.String tietokannanNimi,java.lang.String kayttaja, java.lang.String salasana )heittää java.lang.Exception

– KuvausLuo uuden tietokantayhteyden. Jos yhteyden luominen ei suju (vääräsalasana / kanta nurin) lentää poikkeus, jonka koppaaja kaataa Ilponherjaten käyttäjää.

– Parametrit∗ ajuriluokanNimi – Luokan nimi, josta varsinainen ajuri

ladataan∗ ajurinNimi – Käytettävän tietokanta-ajurin nimi∗ tietokannanOsoite – Tietokannan osoite∗ tietokannanPortti – Tietokannan portti


∗ tietokannanNimi – Tietokannan nimi∗ kayttaja – Tietokannan käyttäjä∗ salasana – Tietokannan salasana

– Throws∗ java.lang.Exception – jos ajuriluokkaa ei löydy

(ClassNotFoundException) tai tietokantayhteyden avaamisessaongelmia (SQLException)

4.3.5 Metodit


• suljeYhteyspublic boolean suljeYhteys( )

– KuvausSulkee yhteyden tietokantaan.

– Palauttaa – boolean tieto onko yhteys suljettu.

• suoritaKyselypublic java.sql.ResultSet suoritaKysely(java.lang.String kysely ) heittääjava.sql.SQLException

– KuvausSuorittaa SQL-kyselyn. Jos tietokantayhteys on katkennut niin seavataan automaattisesti uudelleen ennen kuin kysely yritetäänsuorittaa.

– Parametrit∗ kysely – Suoritettava SQL-kysely merkkijonona.

– Palauttaa – Kyselyn tulos ResultSet-oliossa.

– Throws∗ java.sql.SQLException – jos yhteydessä tai

SQL-lauseessa vikaa

Chapter 5

Pakkaus fi.helsinki.cs.ilpo.io


LuokatHTMLKirjoitin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Kirjastoluokka tehdyn ryhmäjaon saamiseksi ulos HTML-formaatissaKeskeneraistenRyhmienKasittelija . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Kirjastoluokka keskeneräisten ryhmittelyjen tallentamiseen ja lataamiseen.OpiskelijanumeroTulostin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63

Kirjastoluokka, jonka ainoalla metodilla tulostetaan tekstitiedostoon ryh-miteltävien opiskelijoiden opiskelijanumerot.

Tiedostokirjoittaja . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Luokka, jonka avulla hoidetaan tiedostojen varsinainen kirjoitus.

5.1 Luokka HTMLKirjoitin

Kirjastoluokka tehdyn ryhmäjaon saamiseksi ulos HTML-formaatissa

5.1.1 Kuvauspublic final class HTMLKirjoitinextends java.lang.Object


kirjoitaHTML(Kurssi, String) Kirjoittaa ryhmäjaon HTML-sivuntyngäksi, eli pelkän table-elementin sisällön.

main(String[])

66

CHAPTER 5. PAKKAUS FI.HELSINKI.CS.ILPO.IO 67

5.1.3 Metodit

• kirjoitaHTMLpublic static boolean kirjoitaHTML(fi.helsinki.cs.ilpo.Kurssi kurssi, java.lang.StringtiedostonNimi )

– KuvausKirjoittaa ryhmäjaon HTML-sivun tyngäksi, eli pelkäntable-elementin sisällön.

– Parametrit∗ kurssi – Ryhmiteltävä kurssi-olio.∗ tiedostonNimi – Kirjoitettevan tiedoston nimi

– Palauttaa – Ilmaisee, josko operaatio sujui onnellisten tähtien alla.


5.2 Luokka KeskeneraistenRyhmienKasittelija

Kirjastoluokka keskeneräisten ryhmittelyjen tallentamiseen ja lataamiseen.Varsinainen kirjoitus tehdään Tiedostokirjoittaja-kirjastoluokan avulla.

5.2.1 Kuvauspublic class KeskeneraistenRyhmienKasittelijaextends java.lang.Object


KeskeneraistenRyhmienKasittelija(String)


annaTiedostonNimi() Get the value of tiedostonNimiasetaTiedostonNimi(String) Set the value of tiedostonNimi.lataaRyhmittely() Lataa ryhmittelyn levyltä.main(String[])tallennaRyhmittely(Kurssi) Tallentaa ryhmittelyn asetettuun

tiedostoon.


5.2.4 Konstruktorit

• KeskeneraistenRyhmienKasittelijapublic KeskeneraistenRyhmienKasittelija( java.lang.StringtiedostonNimi )

5.2.5 Metodit

• annaTiedostonNimipublic java.lang.String annaTiedostonNimi( )

– KuvausGet the value of tiedostonNimi

– Palauttaa – the value of tiedostonNimi

• asetaTiedostonNimipublic void asetaTiedostonNimi( java.lang.String value)

– KuvausSet the value of tiedostonNimi.

– Parametrit∗ value – Tiedoston nimi, jota halutaan käsitellä.

• lataaRyhmittelypublic fi.helsinki.cs.ilpo.Kurssi lataaRyhmittely( )heittää java.lang.Exception

– KuvausLataa ryhmittelyn levyltä.

– Palauttaa – Viite ladattuun Kurssi-olioon.

– Throws∗ java.lang.Exception – Jos tiedoston latauksessa tapahtuu

virhe


• tallennaRyhmittelypublic void tallennaRyhmittely(fi.helsinki.cs.ilpo.Kurssi kurssi ) heittääjava.lang.Exception

– KuvausTallentaa ryhmittelyn asetettuun tiedostoon.


– Throws∗ java.lang.Exception – Jos tiedoston tallentamisessa

tapahtuu virhe

5.3 Luokka OpiskelijanumeroTulostin

Kirjastoluokka, jonka ainoalla metodilla tulostetaan tekstitiedostoonryhmiteltävien opiskelijoiden opiskelijanumerot. Varsinainen kirjoitus tehdäänTiedostokirjoittaja-kirjastoluokan avulla.

5.3.1 Kuvauspublic final class OpiskelijanumeroTulostinextends java.lang.Object


kirjoitaOpiskelijat(Collection, String) Tulostaa Opiskelija-olioidenopiskelijanumerot tekstitiedostoon 1/rivi.

main(String[])

5.3.3 Metodit

• kirjoitaOpiskelijatpublic static boolean kirjoitaOpiskelijat(java.util.Collection opiskelijat, java.lang.StringtiedostonNimi )

– KuvausTulostaa Opiskelija-olioiden opiskelijanumerot tekstitiedostoon 1/rivi.

– Parametrit∗ opiskelijat – Opiskelija-oliot Collection-rajapinnan

toteuttavassa joukossa, joiden opiskelijanumerot halutaankirjoittaa

∗ tiedostonNimi – Tiedosto, johon kirjoitetaan

– Palauttaa – Ilmoittaa onnistuiko operaatio



5.4 Luokka Tiedostokirjoittaja

Luokka, jonka avulla hoidetaan tiedostojen varsinainen kirjoitus. Eli muut luokatkäyttävät tätä avukseen.

5.4.1 Kuvauspublic class Tiedostokirjoittajaextends java.lang.Object


Tiedostokirjoittaja(String) Luo uuden Tiedostokirjoittaja-olion.


avaaTiedosto() Avaa tiedoston käsittelyä vartenkirjoita(String) Kirjoittaa tiedostoon merkkijonononkoOlemassa() Tarkistaa onko tiedosto olemassasuljeTiedosto() Sulkee avoinna olevan tiedoston

5.4.4 Konstruktorit

• Tiedostokirjoittajapublic Tiedostokirjoittaja( java.lang.String tiedostonNimi)

– KuvausLuo uuden Tiedostokirjoittaja-olion.

– Parametrit∗ tiedostonNimi – Avattavan tiedoston nimi

5.4.5 Metodit

• avaaTiedostopublic boolean avaaTiedosto( )

– KuvausAvaa tiedoston käsittelyä varten

– Palauttaa – True, mikäli avaus onnistui

• kirjoitapublic boolean kirjoita( java.lang.String merkkijono )


– KuvausKirjoittaa tiedostoon merkkijonon

– Parametrit∗ merkkijono – kirjoitettava tieto

– Palauttaa – true, mikäli kirjoitus onnistui.

• onkoOlemassapublic boolean onkoOlemassa( )

– KuvausTarkistaa onko tiedosto olemassa

– Palauttaa – True, mikäli Tiedosto löytyi.

• suljeTiedostopublic void suljeTiedosto( )

– KuvausSulkee avoinna olevan tiedoston

suunnitteludokumentti - cs.helsinki.fi filesuunnitteludokumentti - cs.helsinki.fi

Documents