org.ini4j.IniPreferences Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of izpack-ini4j Show documentation
Show all versions of izpack-ini4j Show documentation
Java API for handling configuration files in Windows .ini format. The library includes its own Map
based API, Java Preferences API and Java Beans API for handling .ini files. Additionally, the library includes a
feature rich (variable/macro substitution, multiply property values, etc) java.util.Properties replacement.
/*
* Copyright 2005,2009 Ivan SZKIBA
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.ini4j;
import java.io.IOException;
import java.io.InputStream;
import java.io.Reader;
import java.net.URL;
import java.util.ArrayList;
import java.util.List;
import java.util.prefs.AbstractPreferences;
import java.util.prefs.BackingStoreException;
public class IniPreferences extends AbstractPreferences
{
/** frequently used empty String array */
private static final String[] EMPTY = {};
/** underlaying Ini implementation */
private final Ini _ini;
/**
* Constructs a new preferences node on top of Ini instance.
*
* @param ini underlaying Ini instance
*/
public IniPreferences(Ini ini)
{
super(null, "");
_ini = ini;
}
/**
* Constructs a new preferences node based on newly loaded Ini instance.
*
* This is just a helper constructor, to make simpler constructing IniPreferences
* directly from Reader.
*
* @param input the Reader containing Ini data
* @throws IOException if an I/O error occured
* @throws InvalidFileFormatException if Ini parsing error occured
*/
public IniPreferences(Reader input) throws IOException, InvalidFileFormatException
{
super(null, "");
_ini = new Ini(input);
}
/**
* Constructs a new preferences node based on newly loaded Ini instance.
*
* This is just a helper constructor, to make simpler constructing IniPreferences
* directly from InputStream.
*
* @param input the InputStream containing Ini data
* @throws IOException if an I/O error occured
* @throws InvalidFileFormatException if Ini parsing error occured
*/
public IniPreferences(InputStream input) throws IOException, InvalidFileFormatException
{
super(null, "");
_ini = new Ini(input);
}
/**
* Constructs a new preferences node based on newly loaded Ini instance.
*
* This is just a helper constructor, to make simpler constructing IniPreferences
* directly from URL.
*
* @param input the URL containing Ini data
* @throws IOException if an I/O error occured
* @throws InvalidFileFormatException if Ini parsing error occured
*/
public IniPreferences(URL input) throws IOException, InvalidFileFormatException
{
super(null, "");
_ini = new Ini(input);
}
/**
* Provide access to underlaying {@link org.ini4j.Ini} implementation.
*
* @return Ini implementation
*/
protected Ini getIni()
{
return _ini;
}
/**
* Implements the getSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#getSpi(String)}.
*
* This implementation doesn't support this operation, so allways throws UnsupportedOperationException.
*
* @return if the value associated with the specified key at this preference node, or null if there is no association for this key, or the association cannot be determined at this time.
* @param key key to getvalue for
* @throws UnsupportedOperationException this implementation allways throws this exception
*/
@Override protected String getSpi(String key) throws UnsupportedOperationException
{
throw new UnsupportedOperationException();
}
/**
* Implements the childrenNamesSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#childrenNamesSpi()}.
* @return an array containing the names of the children of this preference node.
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected String[] childrenNamesSpi() throws BackingStoreException
{
List names = new ArrayList();
for (String name : _ini.keySet())
{
if (name.indexOf(_ini.getPathSeparator()) < 0)
{
names.add(name);
}
}
return names.toArray(EMPTY);
}
/**
* Implements the childSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#childSpi(String)}.
* @param name child name
* @return child node
*/
@Override protected SectionPreferences childSpi(String name)
{
Ini.Section sec = _ini.get(name);
boolean isNew = sec == null;
if (isNew)
{
sec = _ini.add(name);
}
return new SectionPreferences(this, sec, isNew);
}
/**
* Implements the flushSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#flushSpi()}.
*
* This implementation does nothing.
*
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected void flushSpi() throws BackingStoreException
{
assert true;
}
/**
* Implements the keysSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#keysSpi()}.
*
* This implementation allways return an empty array.
*
* @return an empty array.
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected String[] keysSpi() throws BackingStoreException
{
return EMPTY;
}
/**
* Implements the putSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#putSpi(String,String)}.
*
* This implementation doesn;t support this operation, so allways throws UnsupportedOperationException.
*
* @param key key to set value for
* @param value new value for key
* @throws UnsupportedOperationException this implementation allways throws this exception
*/
@Override protected void putSpi(String key, String value) throws UnsupportedOperationException
{
throw new UnsupportedOperationException();
}
/**
* Implements the removeNodeSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#removeNodeSpi()}.
*
* This implementation doesn;t support this operation, so allways throws UnsupportedOperationException.
* @throws UnsupportedOperationException this implementation allways throws this exception
* @throws BackingStoreException this implementation never throws this exception
*/
@Override protected void removeNodeSpi() throws BackingStoreException, UnsupportedOperationException
{
throw new UnsupportedOperationException();
}
/**
* Implements the removeSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#removeSpi(String)}.
* @param key key to remove
* @throws UnsupportedOperationException this implementation allways throws this exception
*/
@Override protected void removeSpi(String key) throws UnsupportedOperationException
{
throw new UnsupportedOperationException();
}
/**
* Implements the syncSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#syncSpi()}.
*
* This implementation does nothing.
*
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected void syncSpi() throws BackingStoreException
{
assert true;
}
protected class SectionPreferences extends AbstractPreferences
{
/** underlaying Section implementation */
private final Ini.Section _section;
/**
* Constructs a new SectionPreferences instance on top of Ini.Section instance.
*
* @param parent parent preferences node
* @parem section underlaying Ini.Section instance
* @param isNew indicate is this a new node or already existing one
*/
SectionPreferences(AbstractPreferences parent, Ini.Section section, boolean isNew)
{
super(parent, section.getSimpleName());
_section = section;
newNode = isNew;
}
/**
* Implements the flush method as per the specification in
* {@link java.util.prefs.Preferences#flush()}.
*
* This implementation just call parent's flush() method.
*
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override public void flush() throws BackingStoreException
{
parent().flush();
}
/**
* Implements the sync method as per the specification in
* {@link java.util.prefs.Preferences#sync()}.
*
* This implementation just call parent's sync() method.
*
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override public void sync() throws BackingStoreException
{
parent().sync();
}
/**
* Implements the getSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#getSpi(String)}.
* @return if the value associated with the specified key at this preference node, or null if there is no association for this key, or the association cannot be determined at this time.
* @param key key to getvalue for
*/
@Override protected String getSpi(String key)
{
return _section.fetch(key);
}
/**
* Implements the childrenNamesSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#childrenNamesSpi()}.
*
* This implementation allways returns an empty array.
*
* @return an emty array.
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected String[] childrenNamesSpi() throws BackingStoreException
{
return _section.childrenNames();
}
/**
* Implements the childSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#childSpi(String)}.
*
* This implementation doesn't support this operation.
*
* @throws UnsupportedOperationException this implementation allways throws this exception
* @param name child name
* @return child node
*/
@Override protected SectionPreferences childSpi(String name) throws UnsupportedOperationException
{
Ini.Section child = _section.getChild(name);
boolean isNew = child == null;
if (isNew)
{
child = _section.addChild(name);
}
return new SectionPreferences(this, child, isNew);
}
/**
* Implements the flushSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#flushSpi()}.
*
* This implementation does nothing.
*
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected void flushSpi() throws BackingStoreException
{
assert true;
}
/**
* Implements the keysSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#keysSpi()}.
*
* @return an array of the keys that have an associated value in this preference node.
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected String[] keysSpi() throws BackingStoreException
{
return _section.keySet().toArray(EMPTY);
}
/**
* Implements the putSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#putSpi(String,String)}.
*
* @param key key to set value for
* @param value new value of key
*/
@Override protected void putSpi(String key, String value)
{
_section.put(key, value);
}
/**
* Implements the removeNodeSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#removeNodeSpi()}.
*
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected void removeNodeSpi() throws BackingStoreException
{
_ini.remove(_section);
}
/**
* Implements the removeSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#removeSpi(String)}.
* @param key key to remove
*/
@Override protected void removeSpi(String key)
{
_section.remove(key);
}
/**
* Implements the syncSpi method as per the specification in
* {@link java.util.prefs.AbstractPreferences#syncSpi()}.
*
* This implementation does nothing.
*
* @throws BackingStoreException if this operation cannot be completed due to a failure in the backing store, or inability to communicate with it.
*/
@Override protected void syncSpi() throws BackingStoreException
{
assert true;
}
}
}