de.ipcon.tools

Class bini

java.lang.Object

de.ipcon.tools.bini

public final class bini
extends java.lang.Object

Eine kleine Klasse um ein Inifile windoze-like einzulesen. Also Sektionen in [] und Variable=Wert. Superprimitiv. Tut aber seinen Zweck. Kommentare kann das Ding auch, werden genauso notiert wie in Netrexx: mit -- ist man dabei. Uninterpretierbare Zeilen werden still und klammheimlich ?bergangen. FIXME this class could use a major rework

Constructor Summary

Constructors

Constructor and Description
bini()
bini(java.io.File _inf) Der Konstruktur.
bini(java.io.InputStream _infis)

Method Summary

Modifier and Type	Method and Description
netrexx.lang.Rexx	_getval(netrexx.lang.Rexx section, netrexx.lang.Rexx variable)
void	buildconf() Die Kernroutine: Sie öffnet eine Datei und baut die inneren Verwaltungsstrukturen auf.
void	buildconf(java.io.BufferedReader br)
void	commentOut(netrexx.lang.Rexx _section, netrexx.lang.Rexx _variable, netrexx.lang.Rexx _comment)
boolean	doUpdate() wie doUpdate(Rexx), nur nimmt Sie sich das Infdatum selbst auf protected properties.
long	doUpdate(long l) Halbautomatisches Neuladen, falls das Inifile auf dem Datenträger inzwischen neuer ist.
netrexx.lang.Rexx	getCommentedOut(netrexx.lang.Rexx _section, netrexx.lang.Rexx _variable)
netrexx.lang.Rexx	getInifileName()
long	getInifileTimestamp()
static bini	getInstance(java.lang.String _PID)
static bini	getInstance(java.lang.String _PID, java.lang.String _PIN)
static bini	getInstance(java.lang.String _PID, java.lang.String _PIN, boolean forceNewInstance)
java.util.Properties	getSectionAsProperties(java.lang.String _section)
java.util.Properties	getSectionAsProperties(java.lang.String _section, java.util.Properties props)
java.lang.String[]	getSections(java.lang.String _prefix) Sections may contain of two parts like "ThisIsTheMainPart.ThisIsTheSuffix".
netrexx.lang.Rexx	getval(netrexx.lang.Rexx section, netrexx.lang.Rexx variable) Holt Wert aus dem Inifile: Sektion,Variable
netrexx.lang.Rexx	getval(netrexx.lang.Rexx section, netrexx.lang.Rexx variable, netrexx.lang.Rexx $default) Holt Wert mit Default aus dem Inifile: Sektion,Variable,Default
boolean	getValueAsBool(java.lang.String _section, java.lang.String _variable)
boolean	getValueAsBool(java.lang.String _section, java.lang.String _variable, boolean _default)
int	getValueAsInt(java.lang.String _section, java.lang.String _variable)
int	getValueAsInt(java.lang.String _section, java.lang.String _variable, int _default)
java.lang.String	getValueAsString(java.lang.String _section, java.lang.String _variable)
java.lang.String	getValueAsString(java.lang.String _section, java.lang.String _variable, java.lang.String _default)
netrexx.lang.Rexx	getvalWithUpdateAllowed(netrexx.lang.Rexx section, netrexx.lang.Rexx variable) Holt einen Wert auf dem Inifile und updatet ggfs. die Inistrukturen vorher.
boolean	hasSection(java.lang.String section)
java.lang.String	mergeStateWithSource(java.io.BufferedReader _reader) Merges the current configuration values with the structure of the source reader.
void	reload() Manuelles Neuladen der Ini-Struktur.
void	save() Persists the current in-memory configuration to the file system.
java.lang.String	save(java.io.BufferedReader _reader) Deprecated. use mergeStateWithSource(BufferedReader)
void	setval(netrexx.lang.Rexx _section, netrexx.lang.Rexx _variable, netrexx.lang.Rexx _value)

Methods inherited from class java.lang.Object

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

Constructor Detail

bini

public bini(java.io.File _inf)
     throws java.io.IOException,
            java.io.FileNotFoundException

Der Konstruktur. Braucht nen Filenamen und baut daraus ein bini-Objekt.

Throws:

java.io.IOException

java.io.FileNotFoundException

bini

public bini(java.io.InputStream _infis)
     throws java.io.IOException,
            java.io.FileNotFoundException

Throws:

java.io.IOException

java.io.FileNotFoundException

bini

public bini()

Method Detail

getInstance

public static bini getInstance(java.lang.String _PID)

getInstance

public static bini getInstance(java.lang.String _PID,
                               java.lang.String _PIN)

getInstance

public static bini getInstance(java.lang.String _PID,
                               java.lang.String _PIN,
                               boolean forceNewInstance)

getInifileName

public netrexx.lang.Rexx getInifileName()

getInifileTimestamp

public long getInifileTimestamp()

reload

public void reload()

Manuelles Neuladen der Ini-Struktur.

doUpdate

public long doUpdate(long l)

Halbautomatisches Neuladen, falls das Inifile auf dem Datenträger inzwischen neuer ist. Gibt ne 0 zur?ck, wenn das nicht der Fall war, ansonsten neues infdate als Timestamp.

doUpdate

public boolean doUpdate()

wie doUpdate(Rexx), nur nimmt Sie sich das Infdatum selbst auf protected properties.

buildconf

public void buildconf()
               throws java.io.IOException,
                      java.io.FileNotFoundException

Die Kernroutine: Sie öffnet eine Datei und baut die inneren Verwaltungsstrukturen auf.

Throws:

java.io.IOException

java.io.FileNotFoundException

buildconf

public void buildconf(java.io.BufferedReader br)
               throws java.io.IOException

Throws:

java.io.IOException

getval

public netrexx.lang.Rexx getval(netrexx.lang.Rexx section,
                                netrexx.lang.Rexx variable)

Holt Wert aus dem Inifile: Sektion,Variable

_getval

public netrexx.lang.Rexx _getval(netrexx.lang.Rexx section,
                                 netrexx.lang.Rexx variable)

getval

public netrexx.lang.Rexx getval(netrexx.lang.Rexx section,
                                netrexx.lang.Rexx variable,
                                netrexx.lang.Rexx $default)

Holt Wert mit Default aus dem Inifile: Sektion,Variable,Default

getValueAsString

public java.lang.String getValueAsString(java.lang.String _section,
                                         java.lang.String _variable)

getValueAsString

public java.lang.String getValueAsString(java.lang.String _section,
                                         java.lang.String _variable,
                                         java.lang.String _default)

getValueAsBool

public boolean getValueAsBool(java.lang.String _section,
                              java.lang.String _variable)

getValueAsBool

public boolean getValueAsBool(java.lang.String _section,
                              java.lang.String _variable,
                              boolean _default)

getValueAsInt

public int getValueAsInt(java.lang.String _section,
                         java.lang.String _variable)

getValueAsInt

public int getValueAsInt(java.lang.String _section,
                         java.lang.String _variable,
                         int _default)

hasSection

public boolean hasSection(java.lang.String section)

getSectionAsProperties

public java.util.Properties getSectionAsProperties(java.lang.String _section)

getSectionAsProperties

public java.util.Properties getSectionAsProperties(java.lang.String _section,
                                                   java.util.Properties props)

getvalWithUpdateAllowed

public netrexx.lang.Rexx getvalWithUpdateAllowed(netrexx.lang.Rexx section,
                                                 netrexx.lang.Rexx variable)

Holt einen Wert auf dem Inifile und updatet ggfs. die Inistrukturen vorher.

getSections

public java.lang.String[] getSections(java.lang.String _prefix)

Sections may contain of two parts like "ThisIsTheMainPart.ThisIsTheSuffix". This method allows to retrieve sections that match a specific main part.

Returns:

the full section header strings for all sections that have _prefix as their main part. Returns empty array if no matching section exists.

setval

public void setval(netrexx.lang.Rexx _section,
                   netrexx.lang.Rexx _variable,
                   netrexx.lang.Rexx _value)

commentOut

public void commentOut(netrexx.lang.Rexx _section,
                       netrexx.lang.Rexx _variable,
                       netrexx.lang.Rexx _comment)

getCommentedOut

public netrexx.lang.Rexx getCommentedOut(netrexx.lang.Rexx _section,
                                         netrexx.lang.Rexx _variable)

save

public void save()
          throws java.io.IOException,
                 java.io.FileNotFoundException

Persists the current in-memory configuration to the file system.

This method reads the original configuration file to preserve formatting and comments, merges the current values, and overwrites the file defined in the inf variable.

Throws:

IOException - If an I/O error occurs while reading the template or writing the file.

FileNotFoundException - If the source file cannot be found.

IRuntimeException - If the configuration was loaded from a stream (streamOnly is true), preventing a file-system write-back.

save

@Deprecated
public java.lang.String save(java.io.BufferedReader _reader)

Deprecated. use mergeStateWithSource(BufferedReader)

mergeStateWithSource

public java.lang.String mergeStateWithSource(java.io.BufferedReader _reader)

Merges the current configuration values with the structure of the source reader.

This method iterates through the provided reader (representing the original file content). It preserves existing comments and structure. It replaces values for existing keys and appends new keys to their respective sections.

Note: This method currently does not support multi-line entries.

Parameters:

_reader - A BufferedReader providing the source configuration text/template.

Returns:

A String containing the fully reconstructed configuration with updated values.