java-basics/12_exception/4_Kello-ja-Poikkeukset.md

# Kello ja poikkeukset

## 1. Kello-luokka

Kirjoita luokka `Kello`. Kello-luokassa on oltava seuraavat ominaisuudet:

- yksityiset oliomuuttujat `tunnit` (int) ja `minuutit` (int)

- konstruktori `Kello(int tunnit, int minuutit)`, joka asettaa annetut arvot oliomuuttujiin

- getterit ja setterit molemmille oliomuuttujille

- `public void lisaaMinuutit(int mins)` -metodi, joka kasvattaa kellonaikaa annettujen minuuttien verran. Jos minuutit ovat lisäyksen jälkeen 60 tai yli, kasvatetaan myös tunteja siten, että minuuttiosuus pysyy aina välillä  0 ≤ minuutit ≤ 59. Jos vastaavasti tunnit ovat lisäyksen jälkeen 24 tai enemmän, pyörähtää kello ympäri ja tunnit alkavat jälleen nollasta.

- `toString`-metodi, joka palauttaa kellonajan merkkijonoesityksen muodossa "22:52". Jos kellonajan minuutit ovat alle 10, tulee minuuttien edessä olla etunolla, esim. "0:06".

## 2. Parametriarvojen tarkastaminen ja poikkeusten heittäminen

Toteuta `Kello`-luokkaan tarkastukset, joissa tarkastetaan, että luokalle annetut tunnit ovat väliltä `0` ≤ tunnit ≤ `23` ja minuutit väliltä `0` ≤ minuutit ≤ `59`. Mikäli kellolle annetaan aika sallitun välin ulkopuolelta, tulee sen heittää `IllegalArgumentException`-poikkeus. Joudut huomioimaan oikeellisen ajan tarkastamisen sekä konstruktorissa että set-metodeissa.

Tarkasta myös `lisaaMinuutit`-metodissa, että kelloon ei yritetä lisätä negatiivista aikaa. Mikäli lisättävät minuutit on negatiivinen luku, heitä `IllegalArgumentException`.

`IllegalArgumentException`-luokan konstruktorille tulee antaa parametrina virheilmoitus. Tämän tehtävän kannalta ei ole merkitystä, minkä virheviestin annat poikkeuksille, esim:

```
throw new IllegalArgumentException("Virheellinen kellonaika");
```

Tässä tehtävässä sinun ei tarvitse toteuttaa tekstikäyttöliittymää, mutta sinun kannattaa testata luokkasi erillisellä main-metodilla.

## ESIMERKKI

```
=== Suoritettava testikoodi ===
public class KelloTest {

    public static void main(String[] args) {
    
        Kello kello = new Kello(22, 12);
        System.out.println(kello);
        
        kello.lisaaMinuutit(40);
        System.out.println(kello);
        
        kello.lisaaMinuutit(29);
        System.out.println(kello);
        
        kello.lisaaMinuutit(45);
        System.out.println(kello);
    }
}

=== Ohjelman tulosteet ===
22:12
22:52
23:21
0:06
```

**Kello.java**

```
public class Kello {

    private int tunnit, minuutit;

    private static int hour_min = 0;
    private static int hour_max = 23;

    private static int mins_min = 0;
    private static int mins_max = 59;

    public void setTunnit(int tunnit) {
        this.tarkistaKello(tunnit,hour_min,hour_max);
        this.tunnit = tunnit;
    }

    public void setMinuutit(int minuutit) {
        this.tarkistaKello(minuutit, mins_min, mins_max);
        this.minuutit = minuutit;
    }

    public int getTunnit(){
        return this.tunnit;
    }

    public int getMinuutit() {
        return this.minuutit;
    }

    public void lisaaMinuutit(int mins) throws IllegalArgumentException {

        // kasvattaa kellonaikaa annettujen minuuttien verran
        // jos minuutit yli 60, kasvattaa tunteja siten, että minuutit pysyvät välillä 0-59
        //
        // jos tunnit ovat lisäyksen jälkeen 24 tai enemmän, "pyörähtää kello ympäri" ja
        // tunnit alkavat jälleen nollasta.

        if (mins < 0) {
            throw new IllegalArgumentException("Virheellinen minuuttiarvo");
        }

        this.minuutit += mins;

        if (this.minuutit > 60) {

            // kokonaiset tunnit kaikista minuuteista
            int hours       = (int)((double)this.minuutit/60.0);
            this.tunnit    += hours;

            // (minuutit/60 - kokonaiset tunnit) * 60 = jäljelle jäävät minuutit
            this.minuutit  = (int)((((double)this.minuutit/60.0) - hours) * 60);

        }

        if (this.tunnit >= 24) {
            this.tunnit = 0;
        }

    }

    public Kello(int tunnit, int minuutit) {
        // konstruktori, joka asettaa annetut arvot (tunnit, minuutit) oliomuuttujiin 'tunnit' ja 'minuutit'

        this.tarkistaKello(minuutit, mins_min, mins_max);
        this.tarkistaKello(tunnit,hour_min,hour_max);

        this.setTunnit(tunnit);
        this.setMinuutit(minuutit);
    }

    private void tarkistaKello(int tyyppi, int min, int max) {
        if (!(tyyppi >= min && tyyppi <= max)) {
            throw new IllegalArgumentException("Virheellinen kellonaika");
        }
    }

    @Override
    public String toString() {
        // palauttaa kellonajan merkkijonoesityksen muodossa "22:52"
        // jos minuutit alle 10, tulee minuuttien edessä olla etunolla, esim. "0:06".

        if (this.minuutit < 10) {
            return this.tunnit + ":" + "0" + this.minuutit;
        } else {
            return this.tunnit + ":" + this.minuutit;
        }
    }
}
```