Overview  Package   Class  Deprecated  Index  Help 
Groovy 1.7.0
FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | PROPERTY | CONSTR | METHOD DETAIL: FIELD | PROPERTY | CONSTR | METHOD

groovy.util
Class ConfigObject

java.lang.Object
  java.util.AbstractMap
      java.util.HashMap
          java.util.LinkedHashMap
              groovy.util.ConfigObject

class ConfigObject
extends LinkedHashMap

A ConfigObject at a simple level is a Map that creates configuration entries (other ConfigObjects) when referencing them. This means that navigating to foo.bar.stuff will not return null but nested ConfigObjects which are of course empty maps The Groovy truth can be used to check for the existance of "real" entries.

author:
Graeme Rocher
since:
1.5

Property Summary
static def KEYWORDS

static def TAB_CHARACTER

URL configFile

The config file that was used when parsing this ConfigObject

 
Constructor Summary
ConfigObject(URL file)

ConfigObject()

 
Method Summary
Map flatten()

A ConfigObject is a tree structure consisting of nested maps.

Map flatten(Map target)

Flattens this ConfigObject populating the results into the target Map

def getProperty(String name)

Overrides the default getProperty implementation to create nested ConfigObject instances on demand for non-existant keys

Map merge(ConfigObject other)

Merges the given map with this ConfigObject overriding any matching configuration entries in this ConfigObject

Properties toProperties()

Converts this ConfigObject into a the java.util.Properties format, flattening the tree structure beforehand

Properties toProperties(String prefix)

Converts this ConfigObject ino the java.util.Properties format, flatten the tree and prefixing all entries with the given prefix

Writer writeTo(Writer outArg)

Writes this config object into a String serialized representation which can later be parsed back using the parse() method

 
Methods inherited from class LinkedHashMap
get, clear, containsValue, put, clone, isEmpty, entrySet, putAll, size, values, remove, keySet, containsKey, hashCode, equals, toString, wait, wait, wait, getClass, notify, notifyAll
 
Methods inherited from class HashMap
get, put, clone, clear, isEmpty, entrySet, putAll, size, values, remove, keySet, containsKey, containsValue, hashCode, equals, toString, wait, wait, wait, getClass, notify, notifyAll
 
Methods inherited from class AbstractMap
get, put, hashCode, clear, equals, toString, isEmpty, entrySet, putAll, size, values, remove, keySet, containsKey, containsValue, wait, wait, wait, getClass, notify, notifyAll
 
Methods inherited from class Object
wait, wait, wait, hashCode, getClass, equals, toString, notify, notifyAll
 

Property Detail

KEYWORDS

static final def KEYWORDS

TAB_CHARACTER

static final def TAB_CHARACTER

configFile

URL configFile
The config file that was used when parsing this ConfigObject

 
Constructor Detail

ConfigObject

public ConfigObject(URL file)

ConfigObject

public ConfigObject()

 
Method Detail

flatten

Map flatten()
A ConfigObject is a tree structure consisting of nested maps. This flattens the maps into a single level structure like a properties file

flatten

Map flatten(Map target)
Flattens this ConfigObject populating the results into the target Map
see:
ConfigObject#flatten()

getProperty

public def getProperty(String name)
Overrides the default getProperty implementation to create nested ConfigObject instances on demand for non-existant keys

merge

Map merge(ConfigObject other)
Merges the given map with this ConfigObject overriding any matching configuration entries in this ConfigObject
param:
other The ConfigObject to merge with
return:
The result of the merge

toProperties

Properties toProperties()
Converts this ConfigObject into a the java.util.Properties format, flattening the tree structure beforehand
return:
A java.util.Properties instance

toProperties

Properties toProperties(String prefix)
Converts this ConfigObject ino the java.util.Properties format, flatten the tree and prefixing all entries with the given prefix
param:
prefix The prefix to append before property entries
return:
A java.util.Properties instance

writeTo

Writer writeTo(Writer outArg)
Writes this config object into a String serialized representation which can later be parsed back using the parse() method
see:
Writable#writeTo

 

Copyright © 2003-2009 The Codehaus. All rights reserved.