fi.jyu.mit.ohj2

Class IniFile

java.lang.Object

fi.jyu.mit.ohj2.IniFile

public class IniFile
extends Object

Luokka ini-tiedoston käsittelyyn. Tiedoston muoto:

 [FormGUI]
 leveys=200
 korkeus=100
 cbEtsi=1
 [Positions]
 FormGUI=0,0
 

Usea ohjelman osa voi "luoda" tiedoston uudestaan, koska jo avattut tiedostot puskuroidaan, eikä niitä avata enää toista kertaa. Tämä ei kuitenkaan ole vielä thread-safe.

Version:

14.6.2013

Author:

vesal

Example:

 #import java.io.File;
   File fini = new File("testini.ini");
   File fini2 = new File("testini2.ini");
   fini.delete();  fini2.delete();
   
   IniFile ini = IniFile.create("testini.ini");
   ini.write("FormGUI","leveys",200);
   ini.write("FormGUI","korkeus",100);
   ini.write("FormGUI","cbEtsi",1);
   ini.write("Positions","FormGUI","20,30");
   
   fini.renameTo(fini2) === true; // koska saman luominen ei loisi mitään uutta
   
   ini = IniFile.create("testini2.ini");
   ini.read("FormGUI","leveys",0) === 200;
   ini.read("FormGUI","korkeus",0) === 100;
   ini.read("FormGUI","cbEtsi",0) === 1;
   ini.read("FormGUI","cbEiOo",2) === 2;
   ini.read("eioo","cbEiOo",2) === 2;
   ini.read("Positions","FormGUI","1,1") === "20,30";
   ini.write("FormGUI","cbEtsi",0);
   ini.read("FormGUI","cbEtsi",9) === 0;
   fini2.delete() === true;
 

Method Summary

Methods

Modifier and Type	Method and Description
static IniFile	create(String fileName) Luodaan uusi ini-file tai annetaan entinen jos on jo kerran luettu
String	read(String section, String item) Luetaan arvo
int	read(String section, String item, int defValue) Luetaan arvo
String	read(String section, String item, String defValue) Luetaan arvo
void	saveFile() Tallenttaa koko rakenteen
void	write(String section, String item, int value) Kirjoitetaan uusi arvo
void	write(String section, String item, String value) Kirjoitetaan uusi arvo

Methods inherited from class java.lang.Object

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

Method Detail

create

public static IniFile create(String fileName)

Luodaan uusi ini-file tai annetaan entinen jos on jo kerran luettu

Parameters:

fileName - minkä nimistä tiedostoa käsitellään

Returns:

luota tai puskurista otettu tiedosto

saveFile

public void saveFile()

Tallenttaa koko rakenteen

write

public void write(String section,
         String item,
         String value)

Kirjoitetaan uusi arvo

Parameters:

section - mihin osioon kirjoitetaan

item - mikä on nimi

value - mikä on uusi arvo

write

public void write(String section,
         String item,
         int value)

Kirjoitetaan uusi arvo

Parameters:

section - mihin osioon kirjoitetaan

item - mikä on nimi

value - mikä on uusi arvo

read

public String read(String section,
          String item,
          String defValue)

Luetaan arvo

Parameters:

section - mistä osioista luetaan

item - mistä kohdasta luetaan

defValue - mikä arvo palautetaan jos itemia ei löydy

Returns:

löydetty arvo tai oletus

read

public String read(String section,
          String item)

Luetaan arvo

Parameters:

section - mistä osioista luetaan

item - mistä kohdasta luetaan

Returns:

löydetty arvo tai null jos ei löydy

read

public int read(String section,
       String item,
       int defValue)

Luetaan arvo

Parameters:

section - mistä osioista luetaan

item - mistä kohdasta luetaan

defValue - mikä arvo palautetaan jos itemia ei löydy

Returns:

löydetty arvo tai oletus