Kierros 9, tehtävä 3

Luokan kirjoittaminen (270 p)

Tässä tehtävässä harjoitellaan erityisesti seuraavia asioita:

• luokan kirjoittaminen
• lista olion kenttänä.

Tässä tehtävässä sinun ei tarvitse kirjoittaa lainkaan pääohjelmaa, vaan sinun tehtäväsi on kirjoittaa olion ominaisuudet ja toiminnot määrittelevä luokka. Huomaa siis, että sinun kirjoittamasi luokan ei tarvitse tulostaa mitään eikä pyytää mitään käyttäjältä. Kaikki kommunikointi käyttäjän kanssa tapahtuu valmiina annetussa moduulissa.

Luo uusi projekti tehtava9_3 ja siihen moduuli keihaanheittaja. Kirjoita tähän moduliin luokka Keihaanheittaja yhden keihaanheittokilpailun osanottajan kuvaamista varten. Kopioi myös samaan projektiin toinen moduuli heittajatesti. Se sisältää testiohjelman, jonka avulla voit testata kirjoittamasi luokan toimintaa. Älä muuta moduulin heittajatesti sisältöä mitenkään.

Määrittele luokkaan metodien ulkopuolella seuraava vakio:

• KIERROS_LKM = 6
  • Keihaanheittokilpailun kierrosten lukumäärä

Keihaanheittaja-oliolla on luokan yhteisen vakion lisäksi seuraavat kentät:

• __nimi
  • Heittajan nimi.
• __heitot
  • Lista, joka sisältää heittäjän tulokset eri kierroksilta (indeksillä 0 on kierroksen 1 tulos jne.) Jos heittäjä ei ole vielä heittänyt jonkin kierroksen heittoa, on listassa vastaavalla indeksillä arvo 0.0. Jos jonkin kierroksen heitto on hylätty, on listassa vastaavalla indeksillä mikä tahansa negatiivinen arvo. Listan alkiot ovat desimaalilukuja.

Kirjoita sitten luokkaan seuraavat metodit

• __init__(self, annettu_nimi)
  • Metodi luo uuden Keihaanheittaja-olion. Luotavan heittäjän nimi annetaan parametrina. Metodi myös luo listan tuloksia varten. Listan alkioiden arvoksi alustetaan 0.0.
• kerro_nimi(self)
  • Metodi palauttaa heittäjän nimen
• kirjaa_tulos(self, kierros, tulos)
  • Metodi kirjaa tälle heittäjälle parametrina annetun tuloksen parametrina annetulta kierrokselta. Kirjaaminen onnistuu vain, jos heittäjällä ei ole vielä tulosta tältä kierrokselta (joko hyväksyttyä tai hylättyä) ja annettu kierroksen numero on vähintään 1 ja korkeintaan KIERROS_LKM. Tällöin metodi palauttaa arvon True. Muussa tapauksessa tapauksessa metodi ei tee mitään ja palauttaa arvon False. Tuloksen järkevyyttä ei tarvitse tarkistaa. Voit olettaa, että metodin kutsuja antaa metodin viimeiseksi parametriksi negatiivisen arvon, jos heitto on hylätty.
• korjaa_tulos(self, kierros, tulos)
  • Metodi toimii muuten kuten kirjaa_tulos, mutta tämän metodin suoritus onnistuu myös silloin, kun heittäjällä on jo tulos parametrina annetulta kierrokselta. Metodi on tarkoitettu virheellisesti kirjattujen tulosten korjaamiseen.
• kerro_tulos(self, kierros)
  • Metodi palauttaa heittäjän tuloksen parametrina annetulta kierrokselta. Metodi palauttaa arvon 0.0, jos heittäjä ei ole vielä heittänyt ko. kierroksen heittoa ja negatiivisen arvon, jos ko. kierroksen heitto on hylatty.
• kerro_paras_tulos(self)
  • Metodi palauttaa heittäjän parhaan tuloksen tähän asti. Jos heittäjällä ei ole yhtään hyväksyttyä heittoa (tai hän ei ole vielä heittänyt yhtään heittoa) metodi palauttaa arvon 0.0.
• vertaa(self, toinen_heittaja)
  • Metodi tutkii, onko nykyinen heittäjä huonompi, yhtä hyvä vai parempi kuin parametrina annettu toinen heittäjä. Metodi palauttaa arvon -1, jos nykyinen heittäjä on huonompi, arvon 0, jos heittäjät ovat yhtä hyviä ja arvon 1, jos nykyinen heittäjä on parempi. Heittäjien paremmuuden ratkaisee parhaan heiton pituus. Jos heittäjien parhaat heitot ovat yhtä pitkiä, heittäjät katsotaan yhtä hyviksi (toiseksi parhaita heittoja ei siis verrata, kuten oikeasti keihäänheittokilpailuissa tehdään). Jos toisella heittäjällä on hyväksytty heitto ja toisella ei ole lainkaan hyväksyttyjä tai heitettyjä heittoja, hyväksytyn heiton omaava heittäjä katsotaan paremmaksi. Jos kummallakaan heittäjällä ei ole hyväksyttyä heittoa, heittäjät katsotaan yhtä hyviksi.
• __str__(self)
  • Metodi palauttaa merkkijonon, joka sisältää heittäjän nimen ja kaikkien kierrosten tulokset toisistaan pikulla erotettuina. Jos jonkin kierroksen heittoa ei ole hyväksytty, tulee merkkjonoon kierroksen kohdalle X. Jos heittäjä ei ole käyttänyt jonkin kierroksen heittoa, tulee merkkojonoon kierroksen kohdalle viiva. Hyväksyttyjen heittojen tulokset esitetään aina kahden desimaalin tarkkuudella. Esimerkki:

    Tero P, 78.00, 84.58, X, -, -, -
    

Kun olet kirjoittanut luokan valmiiksi, voit testata sitä ajamalla valmiiksi kirjoitettua testiohjelmaa heittajatesti. Älä tee mitään muutoksia heittajatesti-ohjelmaan. Jos Eclipse valittaa virheistä tässä ohjelmassa, kysymys on todennäköisesti siitä, että sinun Keihaanheittaja-luokastasi puuttuu vielä sellaisia ominaisuuksia, joita heittajatesti-moduulin ohjelma käyttää.

Kun luokkasi näyttää toimivan oikein sitä testipääohjelmalla testatessa, palauta Gobliniin tiedosto keihaanheittaja.py.

Esimerkki testiohjelman suorituksesta:

[ohjelman suoritus alkaa]

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna heittajan nimi.
Teemu Teekkari

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna heittajan nimi.
Tiina Teekkari

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Tiina Teekkari
Anna kilpailijan numero.
1
Anna kierros.
1
Anna tulos (negatiivinen on hylatty).
-100.0
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
3
Vertaillaan kahta kilpailijaa.

1. Teemu Teekkari
2. Tiina Teekkari
Anna 1. kilpailijan numero.
1
Anna 2. kilpailijan numero.
2
Kilpailijat ovat yhta hyvia.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
4
Teemu Teekkari, X, -, -, -, -, -
Tiina Teekkari, -, -, -, -, -, -

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna heittajan nimi.
Risto Rakentaja

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna heittajan nimi.
Maija Maanmittari

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Tiina Teekkari
3. Risto Rakentaja
4. Maija Maanmittari
Anna kilpailijan numero.
2
Anna kierros.
1
Anna tulos (negatiivinen on hylatty).
56.75
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Tiina Teekkari
3. Risto Rakentaja
4. Maija Maanmittari
Anna kilpailijan numero.
3
Anna kierros.
1
Anna tulos (negatiivinen on hylatty).
78.76
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Tiina Teekkari
3. Risto Rakentaja
4. Maija Maanmittari
Anna kilpailijan numero.
4
Anna kierros.
1
Anna tulos (negatiivinen on hylatty).
61.26
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
4
Teemu Teekkari, X, -, -, -, -, -
Tiina Teekkari, 56.75, -, -, -, -, -
Risto Rakentaja, 78.76, -, -, -, -, -
Maija Maanmittari, 61.26, -, -, -, -, -

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Tiina Teekkari
3. Risto Rakentaja
4. Maija Maanmittari
Anna kilpailijan numero.
1
Anna kierros.
2
Anna tulos (negatiivinen on hylatty).
81.25
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
4
Teemu Teekkari, X, 81.25, -, -, -, -
Tiina Teekkari, 56.75, -, -, -, -, -
Risto Rakentaja, 78.76, -, -, -, -, -
Maija Maanmittari, 61.26, -, -, -, -, -

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Tiina Teekkari
3. Risto Rakentaja
4. Maija Maanmittari
Anna kilpailijan numero.
1
Anna kierros.
3
Anna tulos (negatiivinen on hylatty).
-50
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
4
Teemu Teekkari, X, 81.25, X, -, -, -
Tiina Teekkari, 56.75, -, -, -, -, -
Risto Rakentaja, 78.76, -, -, -, -, -
Maija Maanmittari, 61.26, -, -, -, -, -

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Tiina Teekkari
3. Risto Rakentaja
4. Maija Maanmittari
Anna kilpailijan numero.
1
Anna kierros.
3
Anna tulos (negatiivinen on hylatty).
79.75
Tuloksen kirjaus ei onnistunut.
Haluatko korjata vanhaa tulosta (k/e)?
k
Tulos korjattiin.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
4
Teemu Teekkari, X, 81.25, 79.75, -, -, -
Tiina Teekkari, 56.75, -, -, -, -, -
Risto Rakentaja, 78.76, -, -, -, -, -
Maija Maanmittari, 61.26, -, -, -, -, -

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
5
Paras tulos on 81.25 m.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
3
Vertaillaan kahta kilpailijaa.

1. Teemu Teekkari
2. Tiina Teekkari
3. Risto Rakentaja
4. Maija Maanmittari
Anna 1. kilpailijan numero.
2
Anna 2. kilpailijan numero.
4
Toinen kilpailija on parempi.

Valitse toiminto:
1. luo uusi keihaanheittaja
2. kirjaa tulos
3. vertaa kahta heittajaa
4. tulosta heittajat ja tulokset
5. etsi paras tulos
6. lopeta
6
[ohjelman suoritus päättyy]

Värikoodit:
Sininen: Syöte käyttäjältä
Vihreä: Ohjelman tuloste
Punainen: Erityishuomatus: ei tulosteta