kanta

Class PerusTietue

java.lang.Object

kanta.PerusTietue

All Implemented Interfaces:

java.lang.Cloneable, Tietue

Direct Known Subclasses:

Harrastus, Jasen, PohjaTietue

public abstract class PerusTietue
extends java.lang.Object
implements java.lang.Cloneable, Tietue

Tietue joka osaa mm. itse huolehtia tunnus_nro:staan. Oikean tietueen tekemiseksi tämä on perittävä ja lisättävä mm. Kentta-taulukko. 0's kenttä on aina id-numero.

Version:

1.0, 22.02.2003, 1.1, 23.02.2012

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;

Constructor Summary

Constructors

Constructor and Description
PerusTietue()

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	anna(int k)
int	annaInt(int k) Kentän sisältö kokonaislukuna.
java.lang.String	aseta(int k, java.lang.String s) Asetetaan valitun kentän sisältö.
Tietue	clone() Tehdään identtinen klooni tietueesta
int	ekaKentta()
boolean	equals(Tietue tietue) Tutkii onko tietueen tiedot samat kuin parametrina tuodun tietueen tiedot
java.lang.String	getAvain(int k) Antaa k:n kentän sisällön avain-merkkijonona jonka perusteella voi lajitella
Kentta	getKentta(int k)
int	getKenttia()
java.lang.String	getKysymys(int k)
java.lang.String[]	getOtsikot()
int	getTunnusNro() Palautetaan tietueen oma id
void	parse(java.lang.String rivi) Selvittää tietueen tiedot | erotellusta merkkijonosta.
int	rekisteroi() Antaa tietueelle seuraavan rekisterinumeron
protected abstract void	setKentat(Kentta[] kentat) Asetetaan kentät.
protected abstract void	setSeuraavaNro(int i)
java.lang.String	toString() Palauttaa tietueen tiedot merkkijonona jonka voi tallentaa tiedostoon.
void	tulosta(java.io.OutputStream os) Tulostetaan tietueen tiedot
void	tulosta(java.io.PrintStream out) Tulostetaan tietueen tiedot
void	tulosta(java.io.PrintWriter out) Tulostetaan tietueen tiedot

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface kanta.Tietue

getKentat, getSeuraavaNro

Constructor Detail

PerusTietue

public PerusTietue()

Method Detail

setSeuraavaNro

protected abstract void setSeuraavaNro(int i)

Parameters:

i - seuraava id-numero jota tästä lähiten käytetään

setKentat

protected abstract void setKentat(Kentta[] kentat)

Asetetaan kentät. Käytetään lähinnä kloonaamisessa

Parameters:

kentat - uudet kentät tietueelle

getKenttia

public int getKenttia()

Specified by:

getKenttia in interface Tietue

Returns:

tietueen kenttien lukumäärä

Example:

   Harrastus har = new Harrastus();
   har.getKenttia() === 5;
 

ekaKentta

public int ekaKentta()

Specified by:

ekaKentta in interface Tietue

Returns:

ensimmäinen käyttäjän syötettävän kentän indeksi

Example:

   Harrastus har = new Harrastus();
   har.ekaKentta() === 2;
 

getKentta

public Kentta getKentta(int k)

Specified by:

getKentta in interface Tietue

Parameters:

k - Mikä kenttä halutaan

Returns:

k.s kenttä

Example:

   Harrastus har = new Harrastus();
   har.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   IntKentta kentta = (IntKentta)har.getKentta(3);   
   kentta.getValue() === 1949;   
 

getKysymys

public java.lang.String getKysymys(int k)

Specified by:

getKysymys in interface Tietue

Parameters:

k - minkä kentän kysymys halutaan

Returns:

valitun kentän kysymysteksti

Example:

   Harrastus har = new Harrastus();
   har.getKysymys(2) === "ala";
 

getOtsikot

public java.lang.String[] getOtsikot()

Specified by:

getOtsikot in interface Tietue

Returns:

kaikkien näytettävien kysymysten otsikot merkkijonotaulukkona

Example:

 #import java.util.Arrays;
   Harrastus har = new Harrastus();
   Arrays.toString(har.getOtsikot()) =R= "\\[ala, aloitusvuosi, h/vko.*";
 

anna

public java.lang.String anna(int k)

Specified by:

anna in interface Tietue

Parameters:

k - Minkä kentän sisältö halutaan

Returns:

valitun kentän sisältö

Example:

   Harrastus har = new Harrastus();
   har.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   har.anna(0) === "2";   
   har.anna(1) === "10";   
   har.anna(2) === "Kalastus";   
   har.anna(3) === "1949";   
   har.anna(4) === "22";   
 

annaInt

public int annaInt(int k)

Kentän sisältö kokonaislukuna. Jos ei ole IntKentta, niin -1.

Specified by:

annaInt in interface Tietue

Parameters:

k - Minkä kentän sisältö halutaan

Returns:

valitun kentän sisältö kokonaislukuna.

Example:

   Harrastus har = new Harrastus();
   har.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   har.annaInt(0) === 2;   
   har.annaInt(1) === 10;   
   har.annaInt(2) === -1;   
   har.annaInt(3) === 1949;   
   har.annaInt(4) === 22;   
 

aseta

public java.lang.String aseta(int k,
                     java.lang.String s)

Asetetaan valitun kentän sisältö. Mikäli asettaminen onnistuu, palautetaan null, muutoin virheteksti.

Specified by:

aseta in interface Tietue

Parameters:

k - minkä kentän sisältö asetetaan

s - asetettava sisältö merkkijonona

Returns:

null jos ok, muuten virheteksti

Example:

   Harrastus har = new Harrastus();
   har.aseta(3,"kissa") === "aloitusvuosi: Ei kokonaisluku (kissa)";
   har.aseta(3,"1940")  === null;
   har.aseta(4,"kissa") === "h/vko: Ei kokonaisluku (kissa)";
   har.aseta(4,"20")    === null;
 

clone

public Tietue clone()
             throws java.lang.CloneNotSupportedException

Tehdään identtinen klooni tietueesta

Specified by:

clone in interface Tietue

Overrides:

clone in class java.lang.Object

Returns:

Object kloonattu tietue

Throws:

java.lang.CloneNotSupportedException - jos kloonausta ei tueta

Example:

 #THROWS CloneNotSupportedException 
   Harrastus har = new Harrastus();
   har.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   Harrastus kopio = har.clone();
   kopio.toString() === har.toString();
   har.parse("   1   |  11  |   Uinti  | 1949 | 22 t ");
   kopio.toString().equals(har.toString()) === false;
   kopio instanceof Harrastus === true;
 

tulosta

public void tulosta(java.io.PrintWriter out)

Tulostetaan tietueen tiedot

Specified by:

tulosta in interface Tietue

Parameters:

out - tietovirta johon tulostetaan

tulosta

public void tulosta(java.io.OutputStream os)

Tulostetaan tietueen tiedot

Specified by:

tulosta in interface Tietue

Parameters:

os - tietovirta johon tulostetaan

tulosta

public void tulosta(java.io.PrintStream out)

Tulostetaan tietueen tiedot

Specified by:

tulosta in interface Tietue

Parameters:

out - tietovirta johon tulostetaan

rekisteroi

public int rekisteroi()

Antaa tietueelle seuraavan rekisterinumeron

Specified by:

rekisteroi in interface Tietue

Returns:

tietueen uusi tunnus_nro

Example:

   Harrastus pitsi1 = new Harrastus();
   pitsi1.getTunnusNro() === 0;
   pitsi1.rekisteroi();
   int n1 = pitsi1.getTunnusNro();
   Harrastus pitsi2 = new Harrastus();
   pitsi2.rekisteroi() === n1 + 1;
   int n2 = pitsi2.getTunnusNro();
   n1 === n2-1;
 

getTunnusNro

public int getTunnusNro()

Palautetaan tietueen oma id

Specified by:

getTunnusNro in interface Tietue

Returns:

tietueen id

Example:

   Harrastus harrastus = new Harrastus();
   harrastus.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   harrastus.getTunnusNro() === 2;
 

toString

public java.lang.String toString()

Palauttaa tietueen tiedot merkkijonona jonka voi tallentaa tiedostoon.

Specified by:

toString in interface Tietue

Overrides:

toString in class java.lang.Object

Returns:

tietue tolppaeroteltuna merkkijonona

Example:

   Harrastus harrastus = new Harrastus();
   harrastus.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   harrastus.toString()    =R= "2\\|10\\|Kalastus\\|1949\\|22.*";
 

parse

public void parse(java.lang.String rivi)

Selvittää tietueen tiedot | erotellusta merkkijonosta. Pitää huolen että seuraavaNro on suurempi kuin tuleva tunnusnro.

Specified by:

parse in interface Tietue

Parameters:

rivi - josta harrastuksen tiedot otetaan

Example:

   Harrastus harrastus = new Harrastus();
   harrastus.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   harrastus.getJasenNro() === 10;
   harrastus.toString()     =R= "2\\|10\\|Kalastus\\|1949\\|22.*";
   
   harrastus.rekisteroi();
   int n = harrastus.getTunnusNro();
   harrastus.parse(""+(n+20));
   harrastus.rekisteroi();
   harrastus.getTunnusNro() === n+20+1;
   harrastus.toString()     =R= "" + (n+20+1) + "\\|10\\|\\|1949\\|22.*";
 

getAvain

public java.lang.String getAvain(int k)

Antaa k:n kentän sisällön avain-merkkijonona jonka perusteella voi lajitella

Specified by:

getAvain in interface Tietue

Parameters:

k - monenenko kentän sisältö palautetaan

Returns:

kentän sisältö merkkijonona

Example:

   Harrastus har = new Harrastus();
   har.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   har.getAvain(0) === "         2";
   har.getAvain(1) === "        10";
   har.getAvain(2) === "KALASTUS";
   har.getAvain(20) === "";
 

equals

public boolean equals(Tietue tietue)

Tutkii onko tietueen tiedot samat kuin parametrina tuodun tietueen tiedot

Specified by:

equals in interface Tietue

Parameters:

tietue - johon verrataan

Returns:

true jos kaikki tiedot samat, false muuten

Example:

   Harrastus har1 = new Harrastus();
   har1.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   Harrastus har2 = new Harrastus();
   har2.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   Harrastus har3 = new Harrastus();
   har3.parse("   3   |  12  |   Kalastus  | 1949 | 22 t ");
   
   
   har1.equals(har2) === true;
   har2.equals(har1) === true;
   har1.equals(har3) === false;
   har3.equals(har2) === false;