Package emi.shims.java.com.unascribed.nil

Class QDCSS

java.lang.Object

emi.shims.java.com.unascribed.nil.QDCSS

public class QDCSS
extends Object

A quick-and-dirty "CSS" parser.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	QDCSS.BadValueException
static class	QDCSS.QDCSSException

Method Summary

Modifier and Type	Method	Description
boolean	containsKey(String key)
Set<Map.Entry<String,List<String>>>	entrySet()
Map<String,String>	flatten()	Return a view of this QDCSS's data, dropping multivalues and collapsing to a basic key-value mapping that returns the last defined value for any given key.
Optional<String>	get(String key)	Return the last defined value for the given key.
List<String>	getAll(String key)	Return all defined values for the given key, or an empty list if it's not defined.
String	getBlame(String key)
String	getBlame(String key, int index)
Optional<Boolean>	getBoolean(String key)
Optional<Double>	getDouble(String key)
<E extends Enum<E>> Optional<E>	getEnum(String key, Class<E> clazz)
Optional<Integer>	getInt(String key)
String	getPrelude()
Set<String>	keySet()
static QDCSS	load(File f)
static QDCSS	load(String fileName, InputStream in)
static QDCSS	load(String fileName, Reader r)
static QDCSS	load(String fileName, String s)
static QDCSS	load(URL u)
static QDCSS	load(Path p)
QDCSS	merge(QDCSS that)	Merge the given QDCSS's data with this QDCSS's data, returning a new QDCSS object.
void	put(String key, Iterable<String> values)
void	put(String key, String value)
void	put(String key, String... values)
void	setYapLog(Consumer<String> yapLog)	Enables "yap" mode for parse failures in this config, where rather than throwing a BadValueException a warning string will be sent to this Consumer and an empty Optional returned to the caller of get*.
int	size()
String	toString()	Lossily convert this QDCSS's data into an INI.

Methods inherited from class java.lang.Object

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

Method Details

setYapLog

public void setYapLog(Consumer<String> yapLog)

Enables "yap" mode for parse failures in this config, where rather than throwing a BadValueException a warning string will be sent to this Consumer and an empty Optional returned to the caller of get*.

If yapLog is null, "yap" mode is turned off.

containsKey

public boolean containsKey(String key)

put

public void put(String key,
 String value)

put

public void put(String key,
 String... values)

put

public void put(String key,
 Iterable<String> values)

getAll

public List<String> getAll(String key)

Return all defined values for the given key, or an empty list if it's not defined.

getBlame

public String getBlame(String key)

getBlame

public String getBlame(String key,
 int index)

get

public Optional<String> get(String key)

Return the last defined value for the given key.

getInt

public Optional<Integer> getInt(String key)
                         throws QDCSS.BadValueException

Throws:

QDCSS.BadValueException

getDouble

public Optional<Double> getDouble(String key)
                           throws QDCSS.BadValueException

Throws:

QDCSS.BadValueException

getBoolean

public Optional<Boolean> getBoolean(String key)
                             throws QDCSS.BadValueException

Throws:

QDCSS.BadValueException

getPrelude

public String getPrelude()

getEnum

public <E extends Enum<E>> Optional<E> getEnum(String key,
 Class<E> clazz)
                                        throws QDCSS.BadValueException

Throws:

QDCSS.BadValueException

keySet

public Set<String> keySet()

entrySet

public Set<Map.Entry<String,List<String>>> entrySet()

size

public int size()

toString

public String toString()

Lossily convert this QDCSS's data into an INI. Comments, section declarations, etc will be lost.

Overrides:

toString in class Object

merge

public QDCSS merge(QDCSS that)

Merge the given QDCSS's data with this QDCSS's data, returning a new QDCSS object. Keys defined in the given QDCSS will have their values appended to this one's. For usages of get(java.lang.String), this is equivalent to an override.

flatten

public Map<String,String> flatten()

Return a view of this QDCSS's data, dropping multivalues and collapsing to a basic key-value mapping that returns the last defined value for any given key.

load

public static QDCSS load(String fileName,
 String s)
                  throws SyntaxErrorException

Throws:

SyntaxErrorException

load

public static QDCSS load(File f)
                  throws IOException

Throws:

IOException

load

public static QDCSS load(Path p)
                  throws IOException

Throws:

IOException

load

public static QDCSS load(URL u)
                  throws IOException

Throws:

IOException

load

public static QDCSS load(String fileName,
 InputStream in)
                  throws IOException

Throws:

IOException

load

public static QDCSS load(String fileName,
 Reader r)
                  throws IOException

Throws:

IOException