Kerho

java.lang.Object
- kerho.Kerho

All Implemented Interfaces:

java.lang.Iterable<Jasen>
```
public class Kerho
extends java.lang.Object
implements java.lang.Iterable<Jasen>
```
Kerho-luokka, joka huolehtii jäsenistöstä. Pääosin kaikki metodit ovat vain "välittäjämetodeja" jäsenistöön.

Version:

1.0, 09.02.2003, 1.1, 23.02.2003, 1.2, 07.01.2008 / testit

Author:

Vesa Lappalainen

Constructor Summary

Constructors
Constructor and Description

Kerho()

Constructors
Constructor and Description
`Kerho()`

Method Summary

Methods
Modifier and Type	Method and Description
`java.util.List<Harrastus>`	`annaHarrastukset(Jasen jasen)` Haetaan kaikki jäsen harrastukset
`Jasen`	`annaJasenId(int id)`
`java.util.Collection<Jasen>`	`etsi(java.lang.String hakuehto, int k)` Palauttaa "taulukossa" hakuehtoon vastaavien jäsenten viitteet
`int`	`getJasenia()` Palautaa kerhon jäsenmäärän
`java.lang.String`	`getNimi()`
`java.util.Iterator<Harrastus>`	`harrastusIterator()` Kaikkien harrastusten iteraattori
`java.util.Iterator<Jasen>`	`iterator()` Kaikien jäsenten iteraattori
`java.util.Iterator<Jasen>`	`jasenIterator()` Kaikien jäsenten iteraattori
`void`	`korvaaTaiLisaa(Jasen jasen)` Korvaa jäsenen tietorakenteessa.
`void`	`lisaa(Harrastus har)` Listään uusi harrastus kerhoon
`void`	`lisaa(Jasen jasen)` Lisää kerhoon uuden jäsenen
`void`	`lueTiedostosta(java.lang.String nimi)` Lukee kerhon tiedot tiedostosta
`static void`	`main(java.lang.String[] args)` Testiohjelma kerhosta
`int`	`poista(int id)` Poistaa jäsenistöstä ja harrasteista ne joilla on nro.
`void`	`poistaHarrastus(Harrastus harrastus)` Poistaa tämän harrastuksen
`void`	`setHarrastusMuutos()` Laitetaan harrastukset muuttuneeksi, niin pakotetaan tallentamaan.
`void`	`talleta()` Tallettaa kerhon tiedot tiedostoon.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail
- Kerho
```
public Kerho()
```

Method Detail

getJasenia
```
public int getJasenia()
```
Palautaa kerhon jäsenmäärän

Returns:
jäsenmäärä

poista
```
public int poista(int id)
```
Poistaa jäsenistöstä ja harrasteista ne joilla on nro. Kesken.

Parameters:
id - viitenumero, jonka mukaan poistetaan

Returns:
montako jäsentä poistettiin

poistaHarrastus
```
public void poistaHarrastus(Harrastus harrastus)
```
Poistaa tämän harrastuksen

Parameters:
harrastus - poistettava harrastus

lisaa

public void lisaa(Jasen jasen)

Lisää kerhoon uuden jäsenen

Parameters:

jasen - lisättävä jäsen

Example:

 #THROWS SailoException
 #PACKAGEIMPORT
 Kerho kerho = new Kerho();
 Jasen aku1 = new Jasen(), aku2 = new Jasen();
 aku1.rekisteroi(); aku2.rekisteroi();
 kerho.getJasenia() === 0;
 kerho.lisaa(aku1); kerho.getJasenia() === 1;
 kerho.lisaa(aku2); kerho.getJasenia() === 2;
 kerho.lisaa(aku1); kerho.getJasenia() === 3;
 kerho.getJasenia() === 3;
 
 Iterator iter = kerho.iterator();
 Jasen jasen0 = iter.next();
 Jasen jasen1 = iter.next();
 jasen0 === aku1;
 jasen1 === aku2;
 iter.next() === aku1;
 jasen1 == aku1 === false;
 jasen1 == aku2 === true;
 kerho.lisaa(aku1); kerho.getJasenia() === 4;
 kerho.lisaa(aku1); kerho.getJasenia() === 5;

korvaaTaiLisaa
```
public void korvaaTaiLisaa(Jasen jasen)
```
Korvaa jäsenen tietorakenteessa. Ottaa jäsenen omistukseensa. Etsitään samalla tunnusnumerolla oleva jäsen. Jos ei löydy, niin lisätään uutena jäsenenä.

Parameters:
jasen - lisätäävän jäsenen viite. Huom tietorakenne muuttuu omistajaksi

lisaa
```
public void lisaa(Harrastus har)
```
Listään uusi harrastus kerhoon

Parameters:
har - lisättävä harrastus

iterator
```
public java.util.Iterator<Jasen> iterator()
```
Kaikien jäsenten iteraattori

Specified by:

iterator in interface java.lang.Iterable<Jasen>

Returns:
jäseniteraattori

jasenIterator
```
public java.util.Iterator<Jasen> jasenIterator()
```
Kaikien jäsenten iteraattori

Returns:
jäseniteraattori

harrastusIterator
```
public java.util.Iterator<Harrastus> harrastusIterator()
```
Kaikkien harrastusten iteraattori

Returns:
harrastusiteraattori

etsi
```
public java.util.Collection<Jasen> etsi(java.lang.String hakuehto,
                               int k)
```
Palauttaa "taulukossa" hakuehtoon vastaavien jäsenten viitteet

Parameters:
hakuehto - hakuehto
k - etsittävän kentän indeksi

Returns:
tietorakenteen löytyneistä jäsenistä

annaHarrastukset
```
public java.util.List<Harrastus> annaHarrastukset(Jasen jasen)
```
Haetaan kaikki jäsen harrastukset

Parameters:
jasen - jäsen jolle harrastuksia haetaan

Returns:
tietorakenne jossa viiteet löydetteyihin harrastuksiin

setHarrastusMuutos
```
public void setHarrastusMuutos()
```
Laitetaan harrastukset muuttuneeksi, niin pakotetaan tallentamaan.

lueTiedostosta

public void lueTiedostosta(java.lang.String nimi)
                    throws SailoException

Lukee kerhon tiedot tiedostosta

Parameters:

nimi - jota käyteään lukemisessa

Throws:

SailoException - jos lukeminen epäonnistuu

Example:

 #THROWS SailoException 
 #import java.io.*;
 #import java.util.*;
 #import kanta.SailoException;
 
  Kerho kerho = new Kerho();
  
  Jasen aku1 = new Jasen(); aku1.vastaaAkuAnkka(); aku1.rekisteroi();
  Jasen aku2 = new Jasen(); aku2.vastaaAkuAnkka(); aku2.rekisteroi();
  Harrastus pitsi21 = new Harrastus(); pitsi21.vastaaPitsinNyplays(aku2.getTunnusNro());
  Harrastus pitsi11 = new Harrastus(); pitsi11.vastaaPitsinNyplays(aku1.getTunnusNro());
  Harrastus pitsi22 = new Harrastus(); pitsi22.vastaaPitsinNyplays(aku2.getTunnusNro()); 
  Harrastus pitsi12 = new Harrastus(); pitsi12.vastaaPitsinNyplays(aku1.getTunnusNro()); 
  Harrastus pitsi23 = new Harrastus(); pitsi23.vastaaPitsinNyplays(aku2.getTunnusNro());
   
  String tiedNimi = "testikelmit";
  File ftied  = new File(tiedNimi+".dat");
  File fhtied = new File(tiedNimi+".har");
  ftied.delete();
  fhtied.delete();
  kerho.lueTiedostosta(tiedNimi); #THROWS SailoException
  kerho.lisaa(aku1);
  kerho.lisaa(aku2);
  kerho.lisaa(pitsi21);
  kerho.lisaa(pitsi11);
  kerho.lisaa(pitsi22);
  kerho.lisaa(pitsi12);
  kerho.lisaa(pitsi23);
  kerho.talleta();
  kerho = new Kerho();
  kerho.lueTiedostosta(tiedNimi);
  Iterator i = kerho.iterator();
  i.next().toString() === aku1.toString();
  i.next().toString() === aku2.toString();
  i.hasNext() === false;
  Iterator ih = kerho.harrastusIterator();
  ih.next().toString() === pitsi21.toString();
  ih.next().toString() === pitsi11.toString();
  ih.next().toString() === pitsi22.toString();
  ih.next().toString() === pitsi12.toString();
  ih.next().toString() === pitsi23.toString();
  ih.hasNext() === false;
  kerho.lisaa(aku2);
  kerho.lisaa(pitsi23);
  kerho.talleta();
  ftied.delete()  === true;
  fhtied.delete() === true;
  File fbak = new File(tiedNimi+".bak");
  File fhbak = new File(tiedNimi+".hbak");
  fbak.delete() === true;
  fhbak.delete() === true;

talleta
```
public void talleta()
             throws SailoException
```
Tallettaa kerhon tiedot tiedostoon. Vaikka jäsenten tallettamien epäonistuisi, niin yritetään silti tallettaa harrastuksia ennen poikkeuksen heittämistä.

Throws:

SailoException - jos tallettamisessa ongelmia

main
```
public static void main(java.lang.String[] args)
```
Testiohjelma kerhosta

Parameters:
args - ei käytössä

getNimi
```
public java.lang.String getNimi()
```
Returns:
kerhon koko nimi

annaJasenId
```
public Jasen annaJasenId(int id)
```
Parameters:
id - jäsenen id, jota haetaan

Returns:
jäsen jolla on valittu id

Class Kerho

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Kerho

Method Detail

getJasenia

poista

poistaHarrastus

lisaa

korvaaTaiLisaa

lisaa

iterator

jasenIterator

harrastusIterator

etsi

annaHarrastukset

setHarrastusMuutos

lueTiedostosta

talleta

main

getNimi

annaJasenId