PerusTietueet

java.lang.Object
- kanta.PerusTietueet<TYPE>

Type Parameters:: TYPE - Minkä tyyppisiä tietueita talletetaan

All Implemented Interfaces:: java.lang.Iterable<TYPE>, Tietueet<TYPE>

Direct Known Subclasses:: Harrastukset, Jasenet

public class PerusTietueet<TYPE extends Tietue>
extends java.lang.Object
implements Tietueet<TYPE>

Rakenne tietueita varten. Osaa lukea ja kirjoittaa tiedoston. Osaa poistaa ja etsiä tietyn viitteen tietueet

Version:

1.0, 22.02.2003, 2.0, 24.03.2012 - geneerinen versio

Author:

Vesa Lappalainen

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); }

Constructor Summary

Constructors
Constructor and Description
`PerusTietueet(TYPE malli)` Rakenteen alustaminen.
`PerusTietueet(TYPE malli, java.lang.String tark, java.lang.String baktark)` Rakenteen alustaminen.

Method Summary

Methods
Modifier and Type	Method and Description
`TYPE`	`annaId(int id)` Etsii tietueen id:n perusteella
`java.util.List<TYPE>`	`annaTietueet(int viiteNro, 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
`java.lang.String`	`getBaktark()`
`int`	`getLkm()` Palauttaa tietueiden lukumäärän
`java.lang.String`	`getTark()`
`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 tietueen tietorakenteeseen.
`protected void`	`lueAlkurivit(java.io.BufferedReader fi)` Lukee rivit tiedoston alusta
`void`	`lueTiedostosta(java.lang.String tied)` Lukee PerusTietueet tiedostosta.
`TYPE`	`luoUusi()` Luodaan uusi talletettavan kaltainen olio.
`int`	`poista(int id)` Poistaa tietueen jolla on valittu tunnusnumero
`int`	`poista(int viiteNro, int k)` Poistaa kaikki tietyn viitteen tietueet PerusTietueet
`boolean`	`poista(TYPE tietue)` Poistaa valitun tietueen
`void`	`setBaktark(java.lang.String baktark)`
`void`	`setMuutos()` Laitetaan muutos, jolloin pakotetaan tallentamaan.
`void`	`setTark(java.lang.String tark)`
`void`	`setTiedostonPerusNimi(java.lang.String tied)` Asettaa tiedoston perusnimen ilman tarkenninta
`void`	`talleta()` Tallentaa PerusTietueet tiedostoon.
`protected void`	`teeAlkutalletus(java.io.PrintWriter fo)` Tiedoston alkuun tulevat rivit

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

Constructor Detail
- PerusTietueet
```
public PerusTietueet(TYPE malli)
```
  Rakenteen alustaminen.
  
  Parameters:
  malli - malliolio, jonka kloonilla voi luoda uusia
- PerusTietueet
```
public PerusTietueet(TYPE malli,
             java.lang.String tark,
             java.lang.String baktark)
```
  Rakenteen alustaminen.
  
  Parameters:
  malli - malliolio, jonka kloonilla voi luoda uusia
  tark - tiedoston tarkennin
  baktark - backuptiedoston tarkennin, jos null, ei tehdä

Method Detail

luoUusi
```
public TYPE luoUusi()
```
Luodaan uusi talletettavan kaltainen olio. Tarvitaan tiedoston lukemisessa.

Specified by:

luoUusi in interface Tietueet<TYPE extends Tietue>

Returns:
uusi talletettavan tyyppinen alkio

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

Specified by:

lisaa in interface Tietueet<TYPE extends Tietue>

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

korvaaTaiLisaa

public void korvaaTaiLisaa(TYPE tietue)

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

Specified by:

korvaaTaiLisaa in interface Tietueet<TYPE extends Tietue>

Parameters:

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

Example:

 #THROWS CloneNotSupportedException
 #PACKAGEIMPORT
 PerusTietueet harrastukset = new PerusTietueet(new Harrastus());
 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

public boolean poista(TYPE tietue)

Poistaa valitun tietueen

Specified by:

poista in interface Tietueet<TYPE extends Tietue>

Parameters:

tietue - poistettava tietue

Returns:

tosi jos löytyi poistettava tietue

Example:

 #THROWS SailoException 
 #import java.io.File;
  PerusTietueet harrasteet = new PerusTietueet(new Harrastus());
  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

public int poista(int id)

Poistaa tietueen jolla on valittu tunnusnumero

Specified by:

poista in interface Tietueet<TYPE extends Tietue>

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

public int poista(int viiteNro,
         int k)

Poistaa kaikki tietyn viitteen tietueet PerusTietueet

Specified by:

poista in interface Tietueet<TYPE extends Tietue>

Parameters:

viiteNro - viite siihen, mihin liittyvät tietueet poistetaan

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

Returns:

montako poistettiin

Example:

 #THROWS SailoException 
 #import java.io.File;
  PerusTietueet harrasteet = new PerusTietueet(new Harrastus());
  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

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

Lukee PerusTietueet tiedostosta.

Specified by:

lueTiedostosta in interface Tietueet<TYPE extends Tietue>

Parameters:

tied - tiedoston nimen alkuosa

Throws:

SailoException - jos lukeminen epäonnistuu

Example:

 #THROWS SailoException 
 #import java.io.File;
  PerusTietueet harrasteet = new PerusTietueet(new Harrastus());
  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+".dat");
  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 PerusTietueet(new Harrastus());
  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+".bak");
  fbak.delete() === true;

lueAlkurivit

protected void lueAlkurivit(java.io.BufferedReader fi)
                     throws java.io.IOException,
                            SailoException

Lukee rivit tiedoston alusta

Parameters:: fi - virta josta luetaan
Throws:: java.io.IOException - jos jokin menee vikaan; SailoException - jos tieto virheellistä

teeAlkutalletus
```
protected void teeAlkutalletus(java.io.PrintWriter fo)
```
Tiedoston alkuun tulevat rivit

Parameters:
fo - virta johon talletetaan

talleta
```
public void talleta()
             throws SailoException
```
Tallentaa PerusTietueet tiedostoon.

Specified by:

talleta in interface Tietueet<TYPE extends Tietue>

Throws:

SailoException - jos talletus epäonnistuu

getLkm
```
public int getLkm()
```
Palauttaa tietueiden lukumäärän

Specified by:

getLkm in interface Tietueet<TYPE extends Tietue>

Returns:
harrastusten lukumäärä

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

Specified by:

setTiedostonPerusNimi in interface Tietueet<TYPE extends Tietue>

Parameters:
tied - tallennustiedoston perusnimi

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

Specified by:

getTiedostonPerusNimi in interface Tietueet<TYPE extends Tietue>

Returns:
tallennustiedoston nimi

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

Specified by:

getTiedostonNimi in interface Tietueet<TYPE extends Tietue>

Returns:
tallennustiedoston nimi

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

Specified by:

getBakNimi in interface Tietueet<TYPE extends Tietue>

Returns:
varakopiotiedoston nimi

iterator

public java.util.Iterator<TYPE> iterator()

Iteraattori kaikkien harrastusten läpikäymiseen

Specified by:

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

Specified by:

iterator in interface Tietueet<TYPE extends Tietue>

Returns:

harrastusiteraattori

Example:

 #PACKAGEIMPORT
 #import java.util.*;
 
  PerusTietueet harrasteet = new PerusTietueet(new Harrastus());
  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.getJasenNro() === jnrot[n]; n++;  
  }
  
  n === 5;

annaTietueet

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

Haetaan kaikki tietyn viitteen tietueet

Specified by:

annaTietueet in interface Tietueet<TYPE extends Tietue>

Parameters:

viiteNro - 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.*;
 
  PerusTietueet harrasteet = new PerusTietueet(new Harrastus());
  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

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

Palauttaa "taulukossa" hakuehtoon vastaavien tietueiden viitteet

Specified by:

etsi in interface Tietueet<TYPE extends Tietue>

Parameters:

hakuehto - hakuehto

k - etsittävän kentän indeksi

Returns:

tietorakenteen löytyneistä tietueista

Example:

 #THROWS SailoException 
  PerusTietueet harrastukset = new PerusTietueet(new Harrastus());
  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

public TYPE annaId(int id)

Etsii tietueen id:n perusteella

Specified by:

annaId in interface Tietueet<TYPE extends Tietue>

Parameters:

id - tunnusnumero, jonka mukaan etsitään

Returns:

tietue jolla etsittävä id tai null

Example:

  PerusTietueet harrastukset = new PerusTietueet(new Harrastus());
  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;

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

Specified by:

setMuutos in interface Tietueet<TYPE extends Tietue>

getTark
```
public java.lang.String getTark()
```
Returns:
tiedoston tarkennin

setTark

public void setTark(java.lang.String tark)

Parameters:: tark - tiedoston tarkennin

getBaktark
```
public java.lang.String getBaktark()
```
Returns:
backup tiedostojen tarkennin

setBaktark
```
public void setBaktark(java.lang.String baktark)
```
Parameters:
baktark - backup tiedostojen tarkennin

Class PerusTietueet<TYPE extends Tietue>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PerusTietueet

PerusTietueet

Method Detail

luoUusi

lisaa

korvaaTaiLisaa

poista

poista

poista

lueTiedostosta

lueAlkurivit

teeAlkutalletus

talleta

getLkm

setTiedostonPerusNimi

getTiedostonPerusNimi

getTiedostonNimi

getBakNimi

iterator

annaTietueet

etsi

annaId

setMuutos

getTark

setTark

getBaktark

setBaktark