de.ipcon.tools

Class L10nPack

java.lang.Object

de.ipcon.tools.L10nPack

All Implemented Interfaces:

SecureExternalizable, java.io.Serializable, java.lang.Cloneable

public class L10nPack
extends java.lang.Object
implements java.io.Serializable, java.lang.Cloneable, SecureExternalizable

The reason why there is no HashMap deposited here is that these objects consist of many Strings and we want to avoid pointers here as much as possible, because the Strings already consume a lot of space. Therefore two arrays containing keys and values are used; the keys are sorted and the lookup is done using binary search. Furthermore there are methods to quickly put the packs to disk and back. The faster and more efficiently this can be done, the more likely it is that we can cache the bundles in a cache using WeakReferences without seriously compromising performance. Exactly for this reason a cascading with parents is not planned, so that the GC has a chance to dispose of such an object. Therefore the administration of the individual packs remains to a manager who can get the reload done.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
L10nPack()
L10nPack(java.util.Map m)
L10nPack(java.lang.String[] _keys, java.lang.String[] _values)
L10nPack(java.lang.String[] _keys, java.lang.String[] _values, boolean preSorted)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Clonable implementation
void	fillFromUnsortedArrays(java.lang.String[] _keys, java.lang.String[] _values)
void	fillInMissingsFrom(L10nPack p) Builds missing keys in the pack from another pack.
java.lang.Long	getId()
java.lang.String[]	getKeys() For verification we need all keys, copied for safety's sake.
long	getLmod()
java.util.Locale	getLocale() The following properties are intentionally not simply defined as indirect, because the setter should return the pack itself, as I don't want to multiply out the constructors too much.
java.lang.String	getName()
java.lang.Integer	getPathPos()
java.lang.String	getString(java.lang.String key) That's what this class is actually about... :-)
void	readFile()
void	readFile(java.io.File dir)
void	readFile(java.io.File dir, java.lang.String _name)
void	readFile(java.io.File dir, java.lang.String _name, java.util.Locale _locale)
L10nPack	readFromInputStream(java.io.InputStream is)
void	readInstance(SecureObjectInputI s) Reads an instance of this class from the given SecureObjectInputI without using readObject.
L10nPack	setId(java.lang.Long _id)
L10nPack	setLmod(long l)
L10nPack	setLocale(java.util.Locale l)
L10nPack	setName(java.lang.String s)
L10nPack	setPathPos(java.lang.Integer _pos)
void	setString(java.lang.String key, java.lang.String value)
int	size()
java.lang.String	toString()
void	writeFile()
void	writeFile(java.io.File dir)
void	writeInstance(SecureObjectOutputI s) Writes an instance of this class to the given SecureObjectOutputI without using writeObject.
L10nPack	writeLine(java.io.BufferedWriter w, java.lang.String s)

Methods inherited from class java.lang.Object

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

Constructor Detail

L10nPack

public L10nPack()

L10nPack

public L10nPack(java.lang.String[] _keys,
                java.lang.String[] _values)

L10nPack

public L10nPack(java.lang.String[] _keys,
                java.lang.String[] _values,
                boolean preSorted)

L10nPack

public L10nPack(java.util.Map m)

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

size

public int size()

fillFromUnsortedArrays

public void fillFromUnsortedArrays(java.lang.String[] _keys,
                                   java.lang.String[] _values)

fillInMissingsFrom

public void fillInMissingsFrom(L10nPack p)

Builds missing keys in the pack from another pack.

getLocale

public java.util.Locale getLocale()

The following properties are intentionally not simply defined as indirect, because the setter should return the pack itself, as I don't want to multiply out the constructors too much.

setLocale

public L10nPack setLocale(java.util.Locale l)

getName

public java.lang.String getName()

setName

public L10nPack setName(java.lang.String s)

getLmod

public long getLmod()

setLmod

public L10nPack setLmod(long l)

getId

public java.lang.Long getId()

setId

public L10nPack setId(java.lang.Long _id)

setPathPos

public L10nPack setPathPos(java.lang.Integer _pos)

getPathPos

public java.lang.Integer getPathPos()

getString

public java.lang.String getString(java.lang.String key)

That's what this class is actually about... :-)

setString

public void setString(java.lang.String key,
                      java.lang.String value)

getKeys

public java.lang.String[] getKeys()

For verification we need all keys, copied for safety's sake.

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Clonable implementation

Overrides:

clone in class java.lang.Object

Throws:

java.lang.CloneNotSupportedException

writeInstance

public void writeInstance(SecureObjectOutputI s)
                   throws java.io.IOException

Description copied from interface: SecureExternalizable

Writes an instance of this class to the given SecureObjectOutputI without using writeObject.

Specified by:

writeInstance in interface SecureExternalizable

Throws:

java.io.IOException

readInstance

public void readInstance(SecureObjectInputI s)
                  throws java.io.IOException

Description copied from interface: SecureExternalizable

Reads an instance of this class from the given SecureObjectInputI without using readObject.

Specified by:

readInstance in interface SecureExternalizable

Throws:

java.io.IOException

writeFile

public void writeFile()

writeFile

public void writeFile(java.io.File dir)

readFile

public void readFile()

readFile

public void readFile(java.io.File dir)

readFile

public void readFile(java.io.File dir,
                     java.lang.String _name)

readFile

public void readFile(java.io.File dir,
                     java.lang.String _name,
                     java.util.Locale _locale)

readFromInputStream

public L10nPack readFromInputStream(java.io.InputStream is)

writeLine

public L10nPack writeLine(java.io.BufferedWriter w,
                          java.lang.String s)
                   throws java.io.IOException

Throws:

java.io.IOException