kanta

Interface Tietue

All Known Implementing Classes:

Harrastus, Jasen, PerusTietue, PohjaTietue

public interface Tietue

Rajapinta tietueelle johon voidaan taulukon avulla rakentaa "attribuutit".

Version:

Mar 23, 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;

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[]	getKentat()
Kentta	getKentta(int k)
int	getKenttia()
java.lang.String	getKysymys(int k)
java.lang.String[]	getOtsikot()
int	getSeuraavaNro()
int	getTunnusNro() Palautetaan tietueen oma id
void	parse(java.lang.String rivi) Selvitää tietueen tiedot | erotellusta merkkijonosta.
int	rekisteroi() Antaa tietueelle seuraavan rekisterinumeron.
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

Method Detail

getKenttia

int getKenttia()

Returns:

tietueen kenttien lukumäärä

Example:

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

ekaKentta

int ekaKentta()

Returns:

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

Example:

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

getKentta

Kentta getKentta(int k)

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;   
 

getKentat

Kentta[] getKentat()

Returns:

palautetaan viite koko kenttätaulukkoon.

Example:

   Harrastus har = new Harrastus();
   har.parse("   2   |  10  |   Kalastus  | 1949 | 22 t ");
   Kentta[] kentat  = har.getKentat();   
   ((IntKentta)(kentat[4])).getValue() === 22;   
 

getKysymys

java.lang.String getKysymys(int k)

Parameters:

k - minkä kentän kysymys halutaan

Returns:

valitun kentän kysymysteksti

Example:

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

getOtsikot

java.lang.String[] getOtsikot()

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

java.lang.String anna(int k)

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

int annaInt(int k)

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

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

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

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

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

Tietue clone()
             throws java.lang.CloneNotSupportedException

Tehdään identtinen klooni tietueesta

Returns:

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

void tulosta(java.io.PrintWriter out)

Tulostetaan tietueen tiedot

Parameters:

out - tietovirta johon tulostetaan

tulosta

void tulosta(java.io.OutputStream os)

Tulostetaan tietueen tiedot

Parameters:

os - tietovirta johon tulostetaan

tulosta

void tulosta(java.io.PrintStream out)

Tulostetaan tietueen tiedot

Parameters:

out - tietovirta johon tulostetaan

rekisteroi

int rekisteroi()

Antaa tietueelle seuraavan rekisterinumeron.

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

int getTunnusNro()

Palautetaan tietueen oma id

Returns:

tietueen id

Example:

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

toString

java.lang.String toString()

Palauttaa tietueen tiedot merkkijonona jonka voi tallentaa tiedostoon.

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

void parse(java.lang.String rivi)

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

Parameters:

rivi - josta tietueen 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.*";
 

getSeuraavaNro

int getSeuraavaNro()

Returns:

seuraava vapaa id-numero

Example:

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

getAvain

java.lang.String getAvain(int k)

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

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

boolean equals(Tietue tietue)

Tutkii onko tietueen tiedot samat kuin parametrina tuodun tietueen tiedot

Parameters:

tietue - 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;