kerho

Class Jasen

java.lang.Object

kerho.Jasen

All Implemented Interfaces:

java.lang.Cloneable

public class Jasen
extends java.lang.Object
implements java.lang.Cloneable

Kerhon jäsen joka osaa mm. itse huolehtia tunnusNro:staan.

Version:

1.0, 22.02.2003, 2.0, 09.01.2011 - kentät indeksoituna

Author:

Vesa Lappalainen

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Jasen.Vertailija Luokka joka vertaa kahta jäsentä keskenään

Constructor Summary

Constructors

Constructor and Description
Jasen() Alustetaan jäsenen merkkijono-attribuuti tyhjiksi jonoiksi ja tunnusnro = 0.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	anna(int k) Antaa k:n kentän sisällön merkkijonona
java.lang.String	aseta(int k, java.lang.String jono) Asettaa k:n kentän arvoksi parametrina tuodun merkkijonon arvon
Jasen	clone() Tehdään identtinen klooni jäsenestä
int	ekaKentta() Eka kenttä joka on mielekäs kysyttäväksi
boolean	equals(Jasen jasen) Tutkii onko jäsenen tiedot samat kuin parametrina tuodun jäsenen tiedot
java.lang.String	getAvain(int k) Antaa k:n kentän sisällön avain-merkkijonona jonka perusteella voi lajitella
int	getKenttia() Palauttaa jäsenen kenttien lukumäärän
java.lang.String	getKysymys(int k) Palauttaa k:tta jäsenen kenttää vastaavan kysymyksen
java.lang.String	getNimi()
java.lang.String[]	getOtsikot()
int	getTunnusNro() Palauttaa jäsenen tunnusnumeron.
static void	main(java.lang.String[] args) Testiohjelma jäsenelle.
void	parse(java.lang.String rivi) Selvitää jäsenen tiedot | erotellusta merkkijonosta Pitää huolen että seuraavaNro on suurempi kuin tuleva tunnusNro.
int	rekisteroi() Antaa jäsenelle seuraavan rekisterinumeron.
java.lang.String	toString() Palauttaa jäsenen tiedot merkkijonona jonka voi tallentaa tiedostoon.
void	tulosta(java.io.OutputStream os) Tulostetaan henkilön tiedot
void	tulosta(java.io.PrintStream out) Tulostetaan henkilön tiedot
void	tulosta(java.io.PrintWriter out) Tulostetaan henkilön tiedot
void	vastaaAkuAnkka() Apumetodi, jolla saadaan täytettyä testiarvot jäsenelle.
void	vastaaAkuAnkka(java.lang.String apuhetu) Apumetodi, jolla saadaan täytettyä testiarvot jäsenelle.

Methods inherited from class java.lang.Object

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

Constructor Detail

Jasen

public Jasen()

Alustetaan jäsenen merkkijono-attribuuti tyhjiksi jonoiksi ja tunnusnro = 0.

Method Detail

getKenttia

public int getKenttia()

Palauttaa jäsenen kenttien lukumäärän

Returns:

kenttien lukumäärä

ekaKentta

public int ekaKentta()

Eka kenttä joka on mielekäs kysyttäväksi

Returns:

eknn kentän indeksi

getNimi

public java.lang.String getNimi()

Returns:

jäsenen nimi

Example:

   Jasen aku = new Jasen();
   aku.vastaaAkuAnkka();
   aku.getNimi() =R= "Ankka Aku .*";
 

anna

public java.lang.String anna(int k)

Antaa k:n kentän sisällön merkkijonona

Parameters:

k - monenenko kentän sisältö palautetaan

Returns:

kentän sisältö merkkijonona

getAvain

public 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:

   Jasen aku = new Jasen();
   aku.parse("   1  |  Ankka Aku   | 030201-111C");
   aku.getAvain(0) === "         1";
   aku.getAvain(1) === "ANKKA AKU";
   aku.getAvain(2) === "010203-111C";
   aku.getAvain(20) === "";
 

aseta

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

Asettaa k:n kentän arvoksi parametrina tuodun merkkijonon arvon

Parameters:

k - kuinka monennen kentän arvo asetetaan

jono - jonoa joka asetetaan kentän arvoksi

Returns:

null jos asettaminen onnistuu, muuten vastaava virheilmoitus.

Example:

   Jasen jasen = new Jasen();
   jasen.aseta(1,"Ankka Aku") === null;
   jasen.aseta(2,"kissa") =R= ".*Hetu liian lyhyt"
   jasen.aseta(2,"030201-1111") === "hetu: Tarkistusmerkin kuuluisi olla C"; 
   jasen.aseta(2,"030201-111C") === null; 
   jasen.aseta(9,"kissa") === "liittymisvuosi: Ei kokonaisluku (kissa)";
   jasen.aseta(9,"1940") === null;
 

getKysymys

public java.lang.String getKysymys(int k)

Palauttaa k:tta jäsenen kenttää vastaavan kysymyksen

Parameters:

k - kuinka monennen kentän kysymys palautetaan (0-alkuinen)

Returns:

k:netta kenttää vastaava kysymys

getOtsikot

public java.lang.String[] getOtsikot()

Returns:

kaikkien näytettävien kysymysten otsikot merkkijonotaulukkona

Example:

 #import java.util.Arrays;
   Jasen jasen = new Jasen();
   Arrays.toString(jasen.getOtsikot()) =R= "\\[nimi, hetu, katuosoite.*";
 

vastaaAkuAnkka

public void vastaaAkuAnkka(java.lang.String apuhetu)

Apumetodi, jolla saadaan täytettyä testiarvot jäsenelle.

Parameters:

apuhetu - hetu joka annetaan henkilölle

vastaaAkuAnkka

public void vastaaAkuAnkka()

Apumetodi, jolla saadaan täytettyä testiarvot jäsenelle. Henkilötunnus arvotaan, jotta kahdella jäsenellä ei olisi samoja tietoja.

tulosta

public void tulosta(java.io.PrintWriter out)

Tulostetaan henkilön tiedot

Parameters:

out - tietovirta johon tulostetaan

tulosta

public void tulosta(java.io.OutputStream os)

Tulostetaan henkilön tiedot

Parameters:

os - tietovirta johon tulostetaan

tulosta

public void tulosta(java.io.PrintStream out)

Tulostetaan henkilön tiedot

Parameters:

out - tietovirta johon tulostetaan

rekisteroi

public int rekisteroi()

Antaa jäsenelle seuraavan rekisterinumeron.

Returns:

jäsenen uusi tunnusNro

Example:

   Jasen aku1 = new Jasen();
   aku1.getTunnusNro() === 0;
   aku1.rekisteroi();
   Jasen aku2 = new Jasen();
   aku2.rekisteroi();
   int n1 = aku1.getTunnusNro();
   int n2 = aku2.getTunnusNro();
   n1 === n2-1;
 

getTunnusNro

public int getTunnusNro()

Palauttaa jäsenen tunnusnumeron.

Returns:

jäsenen tunnusnumero

toString

public java.lang.String toString()

Palauttaa jäsenen tiedot merkkijonona jonka voi tallentaa tiedostoon.

Overrides:

toString in class java.lang.Object

Returns:

jäsen tolppaeroteltuna merkkijonona

Example:

   Jasen jasen = new Jasen();
   jasen.parse("   3  |  Ankka Aku   | 030201-111C");
   jasen.toString().startsWith("3|Ankka Aku|030201-111C|") === true; // on enemmäkin kuin 3 kenttää, siksi loppu |
 

parse

public void parse(java.lang.String rivi)

Selvitää jäsenen tiedot | erotellusta merkkijonosta Pitää huolen että seuraavaNro on suurempi kuin tuleva tunnusNro.

Parameters:

rivi - josta jäsenen tiedot otetaan

Example:

   Jasen jasen = new Jasen();
   jasen.parse("   3  |  Ankka Aku   | 030201-111C");
   jasen.getTunnusNro() === 3;
   jasen.toString().startsWith("3|Ankka Aku|030201-111C|") === true; // on enemmäkin kuin 3 kenttää, siksi loppu |

   jasen.rekisteroi();
   int n = jasen.getTunnusNro();
   jasen.parse(""+(n+20));       // Otetaan merkkijonosta vain tunnusnumero
   jasen.rekisteroi();           // ja tarkistetaan että seuraavalla kertaa tulee yhtä isompi
   jasen.getTunnusNro() === n+20+1;
     
 

clone

public Jasen clone()
            throws java.lang.CloneNotSupportedException

Tehdään identtinen klooni jäsenestä

Overrides:

clone in class java.lang.Object

Returns:

Object kloonattu jäsen

Throws:

java.lang.CloneNotSupportedException

Example:

 #THROWS CloneNotSupportedException 
   Jasen jasen = new Jasen();
   jasen.parse("   3  |  Ankka Aku   | 123");
   Jasen kopio = jasen.clone();
   kopio.toString() === jasen.toString();
   jasen.parse("   4  |  Ankka Tupu   | 123");
   kopio.toString().equals(jasen.toString()) === false;
 

equals

public boolean equals(Jasen jasen)

Tutkii onko jäsenen tiedot samat kuin parametrina tuodun jäsenen tiedot

Parameters:

jasen - jäsen johon verrataan

Returns:

true jos kaikki tiedot samat, false muuten

Example:

   Jasen jasen1 = new Jasen();
   jasen1.parse("   3  |  Ankka Aku   | 030201-111C");
   Jasen jasen2 = new Jasen();
   jasen2.parse("   3  |  Ankka Aku   | 030201-111C");
   Jasen jasen3 = new Jasen();
   jasen3.parse("   3  |  Ankka Aku   | 030201-115H");
   
   jasen1.equals(jasen2) === true;
   jasen2.equals(jasen1) === true;
   jasen1.equals(jasen3) === false;
   jasen3.equals(jasen2) === false;
 

main

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

Testiohjelma jäsenelle.

Parameters:

args - ei käytössä