Tietueet

Type Parameters:: TYPE - talletettava tyyppi

All Superinterfaces:: java.lang.Iterable<TYPE>

All Known Implementing Classes:: Harrastukset, Jasenet, PerusTietueet

public interface Tietueet<TYPE extends Tietue>
extends java.lang.Iterable<TYPE>

Rajapinta rakenteelle, joka tallettaa tietueita.

Version:

24.03.2012

Author:

vesal

Example:

 public static class Harrastus extends PerusTietue {
     private Kentta kentat[] = { 
        new IntKentta("id"),
        new IntKentta("jäsenId"),
        new JonoKentta("ala"),
        new IntKentta("aloitusvuosi"),
        new IntKentta("h/vko")
     };
     private static int seuraavaNro = 1;
     public Harrastus() { }
     public Harrastus(int jnro) { ((IntKentta)(kentat[1])).setValue(jnro); }

Method Summary

Methods
Modifier and Type	Method and Description
`TYPE`	`annaId(int id)` Etsii tietueen id:n perusteella
`java.util.List<TYPE>`	`annaTietueet(int tunnusnro, int k)` Haetaan kaikki tietyn viitteen tietueet
`java.util.List<TYPE>`	`etsi(java.lang.String hakuehto, int k)` Palauttaa "taulukossa" hakuehtoon vastaavien tietueiden viitteet
`java.lang.String`	`getBakNimi()` Palauttaa varakopiotiedoston nimen
`int`	`getLkm()` Palauttaa kerhon harrastusten lukumäärän
`java.lang.String`	`getTiedostonNimi()` Palauttaa tiedoston nimen, jota käytetään tallennukseen
`java.lang.String`	`getTiedostonPerusNimi()` Palauttaa tiedoston nimen, jota käytetään tallennukseen
`java.util.Iterator<TYPE>`	`iterator()` Iteraattori kaikkien harrastusten läpikäymiseen
`void`	`korvaaTaiLisaa(TYPE tietue)` Korvaa tietueen tietorakenteessa.
`void`	`lisaa(TYPE har)` Lisää uuden harrastuksen tietorakenteeseen.
`void`	`lueTiedostosta(java.lang.String tied)` Lukee tietueet tiedostosta.
`TYPE`	`luoUusi()`
`int`	`poista(int id)` Poistaa tietueen jolla on valittu tunnusnumero
`int`	`poista(int viiteNro, int kenttaNro)` Poistaa kaikki tietyn viittauksen tietueet
`boolean`	`poista(TYPE tietue)` Poistaa valitun harrastuksen
`void`	`setMuutos()` Laitetaan muutos, jolloin pakotetaan tallentamaan.
`void`	`setTiedostonPerusNimi(java.lang.String tied)` Asettaa tiedoston perusnimen ilan tarkenninta
`void`	`talleta()` Tallentaa harrastukset tiedostoon.

Method Detail

luoUusi
```
TYPE luoUusi()
```
Returns:
uusi talletettavan tyyppinen alkio

lisaa
```
void lisaa(TYPE har)
```
Lisää uuden harrastuksen tietorakenteeseen. Ottaa harrastuksen omistukseensa.

Parameters:
har - lisättävä harrastus. Huom tietorakenne muuttuu omistajaksi

korvaaTaiLisaa

void korvaaTaiLisaa(TYPE tietue)
                    throws SailoException

Korvaa tietueen tietorakenteessa. Ottaa tietueen omistukseensa. Etsitään samalla tunnusnumerolla oleva tietue. Jos ei löydy, niin lisätään uutena tietueena.

Parameters:

tietue - lisätäävän tietueen viite. Huom tietorakenne muuttuu omistajaksi

Throws:

SailoException - jos tietorakennen on jo täynnä

Example:

 #THROWS SailoException,CloneNotSupportedException
 #PACKAGEIMPORT
 Harrastukset harrastukset = new Harrastukset();
 Harrastus har1 = new Harrastus(), har2 = new Harrastus();
 har1.rekisteroi(); har2.rekisteroi();
 harrastukset.getLkm() === 0;
 harrastukset.korvaaTaiLisaa(har1); harrastukset.getLkm() === 1;
 harrastukset.korvaaTaiLisaa(har2); harrastukset.getLkm() === 2;
 Harrastus har3 = har1.clone();
 har3.aseta(2,"kkk");
 Iterator i2=harrastukset.iterator();
 i2.next() === har1;
 harrastukset.korvaaTaiLisaa(har3); harrastukset.getLkm() === 2;
 i2=harrastukset.iterator();
 Harrastus h = i2.next();
 h === har3;
 h == har3 === true;
 h == har1 === false;

poista

boolean poista(TYPE tietue)

Poistaa valitun harrastuksen

Parameters:

tietue - poistettava harrastus

Returns:

tosi jos löytyi poistettava harrastus

Example:

 #THROWS SailoException 
 #import java.io.File;
  Harrastukset harrasteet = new Harrastukset();
  Harrastus pitsi21 = new Harrastus(); pitsi21.vastaaPitsinNyplays(2);
  Harrastus pitsi11 = new Harrastus(); pitsi11.vastaaPitsinNyplays(1);
  Harrastus pitsi22 = new Harrastus(); pitsi22.vastaaPitsinNyplays(2); 
  Harrastus pitsi12 = new Harrastus(); pitsi12.vastaaPitsinNyplays(1); 
  Harrastus pitsi23 = new Harrastus(); pitsi23.vastaaPitsinNyplays(2); 
  harrasteet.lisaa(pitsi21);
  harrasteet.lisaa(pitsi11);
  harrasteet.lisaa(pitsi22);
  harrasteet.lisaa(pitsi12);
  harrasteet.poista(pitsi23) === false ; harrasteet.getLkm() === 4;
  harrasteet.poista(pitsi11) === true;   harrasteet.getLkm() === 3;
  List h = harrasteet.annaTietueet(1,1);
  h.size() === 1; 
  h.get(0) === pitsi12;

poista

int poista(int id)

Poistaa tietueen jolla on valittu tunnusnumero

Parameters:

id - poistettavan tietueen tunnusnumero

Returns:

1 jos poistettiin, 0 jos ei löydy

Example:

 PerusTietueet harrastukset = new PerusTietueet(new Harrastus());
 Harrastus har1 = new Harrastus(), har2 = new Harrastus(), har3 = new Harrastus();
 har1.rekisteroi(); har2.rekisteroi(); har3.rekisteroi();
 int id1 = har1.getTunnusNro();
 harrastukset.lisaa(har1); harrastukset.lisaa(har2); harrastukset.lisaa(har3);
 harrastukset.poista(id1+1) === 1;
 harrastukset.poista(id1+1) === 0; harrastukset.getLkm() === 2;
 harrastukset.poista(id1) === 1; harrastukset.getLkm() === 1;
 harrastukset.poista(id1+3) === 0; harrastukset.getLkm() === 1;

poista

int poista(int viiteNro,
         int kenttaNro)

Poistaa kaikki tietyn viittauksen tietueet

Parameters:

viiteNro - viite siihen, minkä jäsenen harrastukset poistetaan

kenttaNro - mistä kentästä täytyy vastaava numero löytyä

Returns:

montako poistettiin

Example:

 #THROWS SailoException 
 #import java.io.File;
  Harrastukset harrasteet = new Harrastukset();
  Harrastus pitsi21 = new Harrastus(); pitsi21.vastaaPitsinNyplays(2);
  Harrastus pitsi11 = new Harrastus(); pitsi11.vastaaPitsinNyplays(1);
  Harrastus pitsi22 = new Harrastus(); pitsi22.vastaaPitsinNyplays(2); 
  Harrastus pitsi12 = new Harrastus(); pitsi12.vastaaPitsinNyplays(1); 
  Harrastus pitsi23 = new Harrastus(); pitsi23.vastaaPitsinNyplays(2); 
  harrasteet.lisaa(pitsi21);
  harrasteet.lisaa(pitsi11);
  harrasteet.lisaa(pitsi22);
  harrasteet.lisaa(pitsi12);
  harrasteet.lisaa(pitsi23);
  harrasteet.poista(2,1) === 3;  harrasteet.getLkm() === 2;
  harrasteet.poista(3,1) === 0;  harrasteet.getLkm() === 2;
  List h = harrasteet.annaTietueet(2,1);
  h.size() === 0; 
  h = harrasteet.annaTietueet(1,1);
  h.get(0) === pitsi11;
  h.get(1) === pitsi12;

lueTiedostosta

void lueTiedostosta(java.lang.String tied)
                    throws SailoException

Lukee tietueet tiedostosta.

Parameters:

tied - tiedoston nimen alkuosa

Throws:

SailoException - jos lukeminen epäonnistuu

Example:

 #THROWS SailoException 
 #import java.io.File;
  Harrastukset harrasteet = new Harrastukset();
  Harrastus pitsi21 = new Harrastus(); pitsi21.vastaaPitsinNyplays(2);
  Harrastus pitsi11 = new Harrastus(); pitsi11.vastaaPitsinNyplays(1);
  Harrastus pitsi22 = new Harrastus(); pitsi22.vastaaPitsinNyplays(2); 
  Harrastus pitsi12 = new Harrastus(); pitsi12.vastaaPitsinNyplays(1); 
  Harrastus pitsi23 = new Harrastus(); pitsi23.vastaaPitsinNyplays(2); 
  String tiedNimi = "testikelmit";
  File ftied = new File(tiedNimi+".har");
  ftied.delete();
  harrasteet.lueTiedostosta(tiedNimi); #THROWS SailoException
  harrasteet.lisaa(pitsi21);
  harrasteet.lisaa(pitsi11);
  harrasteet.lisaa(pitsi22);
  harrasteet.lisaa(pitsi12);
  harrasteet.lisaa(pitsi23);
  harrasteet.talleta();
  harrasteet = new Harrastukset();
  harrasteet.lueTiedostosta(tiedNimi);
  Iterator i = harrasteet.iterator();
  i.next().toString() === pitsi21.toString();
  i.next().toString() === pitsi11.toString();
  i.next().toString() === pitsi22.toString();
  i.next().toString() === pitsi12.toString();
  i.next().toString() === pitsi23.toString();
  i.hasNext() === false;
  harrasteet.lisaa(pitsi23);
  harrasteet.talleta();
  ftied.delete() === true;
  File fbak = new File(tiedNimi+".hbak");
  fbak.delete() === true;

talleta
```
void talleta()
             throws SailoException
```
Tallentaa harrastukset tiedostoon.

Throws:

SailoException - jos talletus epäonnistuu

getLkm
```
int getLkm()
```
Palauttaa kerhon harrastusten lukumäärän

Returns:
harrastusten lukumäärä

setTiedostonPerusNimi
```
void setTiedostonPerusNimi(java.lang.String tied)
```
Asettaa tiedoston perusnimen ilan tarkenninta

Parameters:
tied - tallennustiedoston perusnimi

getTiedostonPerusNimi
```
java.lang.String getTiedostonPerusNimi()
```
Palauttaa tiedoston nimen, jota käytetään tallennukseen

Returns:
tallennustiedoston nimi

getTiedostonNimi
```
java.lang.String getTiedostonNimi()
```
Palauttaa tiedoston nimen, jota käytetään tallennukseen

Returns:
tallennustiedoston nimi

getBakNimi
```
java.lang.String getBakNimi()
```
Palauttaa varakopiotiedoston nimen

Returns:
varakopiotiedoston nimi

iterator

java.util.Iterator<TYPE> iterator()

Iteraattori kaikkien harrastusten läpikäymiseen

Specified by:

iterator in interface java.lang.Iterable<TYPE extends Tietue>

Returns:

harrastusiteraattori

Example:

 #PACKAGEIMPORT
 #import java.util.*;
 
  Harrastukset harrasteet = new Harrastukset();
  Harrastus pitsi21 = new Harrastus(2); harrasteet.lisaa(pitsi21);
  Harrastus pitsi11 = new Harrastus(1); harrasteet.lisaa(pitsi11);
  Harrastus pitsi22 = new Harrastus(2); harrasteet.lisaa(pitsi22);
  Harrastus pitsi12 = new Harrastus(1); harrasteet.lisaa(pitsi12);
  Harrastus pitsi23 = new Harrastus(2); harrasteet.lisaa(pitsi23);
 
  Iterator i2=harrasteet.iterator();
  i2.next() === pitsi21;
  i2.next() === pitsi11;
  i2.next() === pitsi22;
  i2.next() === pitsi12;
  i2.next() === pitsi23;
  i2.next() === pitsi12;  #THROWS NoSuchElementException  
  
  int n = 0;
  int jnrot[] = {2,1,2,1,2};
  
  for ( Harrastus har:harrasteet ) { 
    har.getHarrastusNro() === jnrot[n]; n++;  
  }
  
  n === 5;

setMuutos
```
void setMuutos()
```
Laitetaan muutos, jolloin pakotetaan tallentamaan.

annaTietueet

java.util.List<TYPE> annaTietueet(int tunnusnro,
                                int k)

Haetaan kaikki tietyn viitteen tietueet

Parameters:

tunnusnro - etsittävän viitteen tunnusnumero jolle tietueita haetaan

k - etsittävän kentän numero

Returns:

tietorakenne jossa viiteet löydetteyihin tietueisiin

Example:

 #import java.util.*;
 
  Harrastukset harrasteet = new Harrastukset();
  Harrastus pitsi21 = new Harrastus(2); harrasteet.lisaa(pitsi21);
  Harrastus pitsi11 = new Harrastus(1); harrasteet.lisaa(pitsi11);
  Harrastus pitsi22 = new Harrastus(2); harrasteet.lisaa(pitsi22);
  Harrastus pitsi12 = new Harrastus(1); harrasteet.lisaa(pitsi12);
  Harrastus pitsi23 = new Harrastus(2); harrasteet.lisaa(pitsi23);
  Harrastus pitsi51 = new Harrastus(5); harrasteet.lisaa(pitsi51);
  
  List loytyneet;
  loytyneet = harrasteet.annaTietueet(3,1);
  loytyneet.size() === 0; 
  loytyneet = harrasteet.annaTietueet(1,1);
  loytyneet.size() === 2; 
  loytyneet.get(0) == pitsi11 === true;
  loytyneet.get(1) == pitsi12 === true;
  loytyneet = harrasteet.annaTietueet(5,1);
  loytyneet.size() === 1; 
  loytyneet.get(0) == pitsi51 === true;

etsi

java.util.List<TYPE> etsi(java.lang.String hakuehto,
                        int k)

Palauttaa "taulukossa" hakuehtoon vastaavien tietueiden viitteet

Parameters:

hakuehto - hakuehto

k - etsittävän kentän indeksi

Returns:

tietorakenteen löytyneistä tietueista

Example:

 #THROWS SailoException 
  Harrastukset harrastukset = new Harrastukset();
  Harrastus har1 = new Harrastus(); har1.parse("1|2|Possujen jahtaaminen|1940|22");
  Harrastus har2 = new Harrastus(); har2.parse("2|1|Poikien hoitaminen|1953|1");
  Harrastus har3 = new Harrastus(); har3.parse("3|2|Kelmien kerho|1948|20");
  Harrastus har4 = new Harrastus(); har4.parse("4|1|Kalastus|1947|20");
  Harrastus har5 = new Harrastus(); har5.parse("5|3|Viulu|1952|15");
  harrastukset.lisaa(har1); harrastukset.lisaa(har2); harrastukset.lisaa(har3); 
  harrastukset.lisaa(har4); harrastukset.lisaa(har5);
  List loytyneet;
  loytyneet = harrastukset.etsi("*s*",2);
  loytyneet.size() === 2;
  loytyneet.get(0) == har4 === true;
  loytyneet.get(1) == har1 === true;
   
  loytyneet = harrastukset.etsi("*5*",3);
  loytyneet.size() === 2;
  loytyneet.get(0) == har5 === true;
  loytyneet.get(1) == har2 === true;

annaId

TYPE annaId(int id)

Etsii tietueen id:n perusteella

Parameters:

id - tunnusnumero, jonka mukaan etsitään

Returns:

tietue jolla etsittävä id tai null

Example:

  Harrastukset harrastukset = new Harrastukset();
  Harrastus har1 = new Harrastus(); har1.parse("1|2|Possujen jahtaaminen|1940|22");
  Harrastus har2 = new Harrastus(); har2.parse("2|1|Poikien hoitaminen|1953|1");
  Harrastus har3 = new Harrastus(); har3.parse("3|2|Kelmien kerho|1948|20");
  harrastukset.lisaa(har1); harrastukset.lisaa(har2); harrastukset.lisaa(har3); 
  harrastukset.annaId(1) == har1 === true;
  harrastukset.annaId(2) == har2 === true;
  harrastukset.annaId(3) == har3 === true;

Interface Tietueet<TYPE extends Tietue>

Method Summary

Method Detail

luoUusi

lisaa

korvaaTaiLisaa

poista

poista

poista

lueTiedostosta

talleta

getLkm

setTiedostonPerusNimi

getTiedostonPerusNimi

getTiedostonNimi

getBakNimi

iterator

setMuutos

annaTietueet

etsi

annaId