You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2018/01/14 23:07:01 UTC
[18/51] [partial] juneau-website git commit: Update javadocs.
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigFile.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigFile.html b/content/site/apidocs/org/apache/juneau/ini/ConfigFile.html
index 81c14fe..9a9b1ef 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigFile.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigFile.html
@@ -120,7 +120,7 @@ var activeTableTab = "activeTableTab";
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>
implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../../../../org/apache/juneau/ini/Section.html" title="class in org.apache.juneau.ini">Section</a>></pre>
<div class="block">Implements the API for accessing the contents of a config file.
-
+
<p>
Refer to <a class='doclink' href='package-summary.html#TOC'>org.apache.juneau.ini</a> for usage information.</div>
</li>
@@ -896,7 +896,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<pre>public abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.168">addLines</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> section,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>... lines)</pre>
<div class="block">Adds arbitrary lines to the specified config file section.
-
+
<p>
The lines can be any of the following....
<ul class='spaced-list'>
@@ -907,7 +907,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<li>
<js>" foobar "</js> - Anything else (interpreted as a comment).
</ul>
-
+
<p>
If the section does not exist, it will automatically be created.</div>
<dl>
@@ -930,12 +930,12 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<pre>public abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.195">addHeaderComments</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> section,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>... headerComments)</pre>
<div class="block">Adds header comments to the specified section.
-
+
<p>
Header comments are defined as lines that start with <jk>"#"</jk> immediately preceding a section header
<jk>"[section]"</jk>.
These are handled as part of the section itself instead of being interpreted as comments in the previous section.
-
+
<p>
Header comments can be of the following formats...
<ul class='spaced-list'>
@@ -944,7 +944,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<li>
<js>"comment"</js> - Anything else (will automatically be prefixed with <js>"# "</js>).
</ul>
-
+
<p>
If the section does not exist, it will automatically be created.</div>
<dl>
@@ -984,7 +984,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<h4>getBeanSession</h4>
<pre>protected abstract <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.214">getBeanSession</a>()</pre>
<div class="block">Returns the reusable bean session associated with this config file.
-
+
<p>
Used for performing simple datatype conversions.</div>
<dl>
@@ -1004,7 +1004,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
boolean newline)
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block">Converts the specified object to a string.
-
+
<p>
The serialized output is identical to LAX JSON (JSON with unquoted attributes) except for the following
exceptions:
@@ -1117,7 +1117,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</a>... args)
throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
<div class="block">Gets the entry with the specified key and converts it to the specified value.
-
+
<p>
The key can be in one of the following formats...
<ul class='spaced-list'>
@@ -1126,43 +1126,43 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<li>
<js>"section/key"</js> - A value from the specified section.
</ul>
-
+
<p>
The type can be a simple type (e.g. beans, strings, numbers) or parameterized type (collections/maps).
-
+
<h5 class='section'>Examples:</h5>
<p class='bcode'>
- ConfigFile cf = <jk>new</jk> ConfigFileBuilder().build(<js>"MyConfig.cfg"</js>);
-
+ ConfigFile cf = ConfigFile.<jsm>create</jsm>().build(<js>"MyConfig.cfg"</js>);
+
<jc>// Parse into a linked-list of strings.</jc>
List l = cf.getObject(<js>"MySection/myListOfStrings"</js>, LinkedList.<jk>class</jk>, String.<jk>class</jk>);
-
+
<jc>// Parse into a linked-list of beans.</jc>
List l = cf.getObject(<js>"MySection/myListOfBeans"</js>, LinkedList.<jk>class</jk>, MyBean.<jk>class</jk>);
-
+
<jc>// Parse into a linked-list of linked-lists of strings.</jc>
List l = cf.getObject(<js>"MySection/my2dListOfStrings"</js>, LinkedList.<jk>class</jk>,
LinkedList.<jk>class</jk>, String.<jk>class</jk>);
-
+
<jc>// Parse into a map of string keys/values.</jc>
Map m = cf.getObject(<js>"MySection/myMap"</js>, TreeMap.<jk>class</jk>, String.<jk>class</jk>,
String.<jk>class</jk>);
-
+
<jc>// Parse into a map containing string keys and values of lists containing beans.</jc>
Map m = cf.getObject(<js>"MySection/myMapOfListsOfBeans"</js>, TreeMap.<jk>class</jk>, String.<jk>class</jk>,
List.<jk>class</jk>, MyBean.<jk>class</jk>);
</p>
-
+
<p>
<code>Collection</code> classes are assumed to be followed by zero or one objects indicating the element type.
-
+
<p>
<code>Map</code> classes are assumed to be followed by zero or two meta objects indicating the key and value
types.
-
+
<p>
The array can be arbitrarily long to indicate arbitrarily complex data structures.
-
+
<h5 class='section'>Notes:</h5>
<ul>
<li>Use the <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.Class-"><code>getObject(String, Class)</code></a> method instead if you don't need a parameterized map/collection.
@@ -1172,7 +1172,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<dd><code>key</code> - The key. See <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getString-java.lang.String-"><code>getString(String)</code></a> for a description of the key.</dd>
<dd><code>type</code> - The object type to create.
<br>Can be any of the following: <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau"><code>ClassMeta</code></a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang"><code>Class</code></a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/ParameterizedType.html?is-external=true" title="class or interface in java.lang.reflect"><code>ParameterizedType</code></a>,
- <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/GenericArrayType.html?is-external=true" title="class or interface in java.lang.reflect"><code>GenericArrayType</code></a></dd>
+ <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/GenericArrayType.html?is-external=true" title="class or interface in java.lang.reflect"><code>GenericArrayType</code></a></dd>
<dd><code>args</code> - The type arguments of the class if it's a collection or map.
<br>Can be any of the following: <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau"><code>ClassMeta</code></a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang"><code>Class</code></a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/ParameterizedType.html?is-external=true" title="class or interface in java.lang.reflect"><code>ParameterizedType</code></a>,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/GenericArrayType.html?is-external=true" title="class or interface in java.lang.reflect"><code>GenericArrayType</code></a>
@@ -1225,26 +1225,26 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> type)
throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
<div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>getObject(String, Type, Type...)</code></a> except optimized for a non-parameterized class.
-
+
<p>
This is the preferred parse method for simple types since you don't need to cast the results.
-
+
<h5 class='section'>Examples:</h5>
<p class='bcode'>
- ConfigFile cf = <jk>new</jk> ConfigFileBuilder().build(<js>"MyConfig.cfg"</js>);
-
+ ConfigFile cf = ConfigFile.<jsm>create</jsm>().build(<js>"MyConfig.cfg"</js>);
+
<jc>// Parse into a string.</jc>
String s = cf.getObject(<js>"MySection/mySimpleString"</js>, String.<jk>class</jk>);
-
+
<jc>// Parse into a bean.</jc>
MyBean b = cf.getObject(<js>"MySection/myBean"</js>, MyBean.<jk>class</jk>);
-
+
<jc>// Parse into a bean array.</jc>
MyBean[] b = cf.getObject(<js>"MySection/myBeanArray"</js>, MyBean[].<jk>class</jk>);
-
+
<jc>// Parse into a linked-list of objects.</jc>
List l = cf.getObject(<js>"MySection/myList"</js>, LinkedList.<jk>class</jk>);
-
+
<jc>// Parse into a map of object keys/values.</jc>
Map m = cf.getObject(<js>"MySection/myMap"</js>, TreeMap.<jk>class</jk>);
</p></div>
@@ -1304,7 +1304,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> type)
throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
<div class="block">Gets the entry with the specified key and converts it to the specified value.
-
+
<p>
Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.Class-"><code>getObject(String, Class)</code></a>, but with a default value.</div>
<dl>
@@ -1362,7 +1362,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</a>... args)
throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
<div class="block">Gets the entry with the specified key and converts it to the specified value.
-
+
<p>
Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>getObject(String, Type, Type...)</code></a>, but with a default value.</div>
<dl>
@@ -1430,7 +1430,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c)
throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
<div class="block">Gets the entry with the specified key and converts it to the specified value.
-
+
<p>
Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.Class-"><code>getObject(String, Class)</code></a>, but used when key is already broken into section/key.</div>
<dl>
@@ -1483,7 +1483,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</a>... args)
throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
<div class="block">Gets the entry with the specified key and converts it to the specified value.
-
+
<p>
Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>getObject(String, Type, Type...)</code></a>, but used when key is already broken into section/key.</div>
<dl>
@@ -1546,7 +1546,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<h4>getString</h4>
<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.632">getString</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block">Gets the entry with the specified key.
-
+
<p>
The key can be in one of the following formats...
<ul class='spaced-list'>
@@ -1622,10 +1622,10 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<pre>public final int <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.689">getInt</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key,
int def)</pre>
<div class="block">Convenience method for getting int config values.
-
+
<p>
<js>"K"</js>, <js>"M"</js>, and <js>"G"</js> can be used to identify kilo, mega, and giga.
-
+
<h5 class='section'>Example:</h5>
<ul class='spaced-list'>
<li>
@@ -1667,10 +1667,10 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<pre>public final long <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.724">getLong</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key,
long def)</pre>
<div class="block">Convenience method for getting long config values.
-
+
<p>
<js>"K"</js>, <js>"M"</js>, and <js>"G"</js> can be used to identify kilo, mega, and giga.
-
+
<h5 class='section'>Example:</h5>
<ul class='spaced-list'>
<li>
@@ -1732,7 +1732,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block">Adds or replaces an entry with the specified key with a POJO serialized to a string using the registered
serializer.
-
+
<p>
Equivalent to calling <code>put(key, value, isEncoded(key))</code>.</div>
<dl>
@@ -1783,7 +1783,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
boolean encoded)
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block">Adds or replaces an entry with the specified key with the specified value.
-
+
<p>
The format of the entry depends on the data type of the value.
<ul class='spaced-list'>
@@ -1922,10 +1922,10 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
boolean ignoreUnknownProperties)
throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
<div class="block">Converts this config file section to the specified bean instance.
-
+
<p>
Key/value pairs in the config file section get copied as bean property values to the specified bean class.
-
+
<h6 class='figure'>Example config file</h6>
<p class='bcode'>
<cs>[MyAddress]</cs>
@@ -1935,7 +1935,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<ck>state</ck> = <cv>NY</cv>
<ck>zip</ck> = <cv>12345</cv>
</p>
-
+
<h6 class='figure'>Example bean</h6>
<p class='bcode'>
<jk>public class</jk> Address {
@@ -1944,10 +1944,10 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
public int zip;
}
</p>
-
+
<h6 class='figure'>Example usage</h6>
<p class='bcode'>
- ConfigFile cf = <jk>new</jk> ConfigFileBuilder().build(<js>"MyConfig.cfg"</js>);
+ ConfigFile cf = ConfigFile.<jsm>create</jsm>().build(<js>"MyConfig.cfg"</js>);
Address myAddress = cf.getSectionAsBean(<js>"MySection"</js>, Address.<jk>class</jk>);
</p></div>
<dl>
@@ -1973,7 +1973,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c)</pre>
<div class="block">Wraps a config file section inside a Java interface so that values in the section can be read and
write using getters and setters.
-
+
<h6 class='figure'>Example config file</h6>
<p class='bcode'>
<cs>[MySection]</cs>
@@ -1984,41 +1984,41 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<ck>int3dArray</ck> = <cv>[[[123,null],null],null]</cv>
<ck>bean1d3dListMap</ck> = <cv>{key:[[[[{foo:'bar',baz:123}]]]]}</cv>
</p>
-
+
<h6 class='figure'>Example interface</h6>
<p class='bcode'>
<jk>public interface</jk> MyConfigInterface {
-
+
String getString();
<jk>void</jk> setString(String x);
-
+
<jk>int</jk> getInt();
<jk>void</jk> setInt(<jk>int</jk> x);
-
+
MyEnum getEnum();
<jk>void</jk> setEnum(MyEnum x);
-
+
MyBean getBean();
<jk>void</jk> setBean(MyBean x);
-
+
<jk>int</jk>[][][] getInt3dArray();
<jk>void</jk> setInt3dArray(<jk>int</jk>[][][] x);
-
+
Map<String,List<MyBean[][][]>> getBean1d3dListMap();
<jk>void</jk> setBean1d3dListMap(Map<String,List<MyBean[][][]>> x);
}
</p>
-
+
<h6 class='figure'>Example usage</h6>
<p class='bcode'>
- ConfigFile cf = <jk>new</jk> ConfigFileBuilder().build(<js>"MyConfig.cfg"</js>);
-
+ ConfigFile cf = ConfigFile.<jsm>create</jsm>().build(<js>"MyConfig.cfg"</js>);
+
MyConfigInterface ci = cf.getSectionAsInterface(<js>"MySection"</js>, MyConfigInterface.<jk>class</jk>);
-
+
<jk>int</jk> myInt = ci.getInt();
-
+
ci.setBean(<jk>new</jk> MyBean());
-
+
cf.save();
</p></div>
<dl>
@@ -2090,7 +2090,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<h4>addSection</h4>
<pre>public abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.1107">addSection</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</pre>
<div class="block">Appends a section to this config file if it does not already exist.
-
+
<p>
Returns the existing section if it already exists.</div>
<dl>
@@ -2184,7 +2184,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<pre>public final <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.1155">serializeTo</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io">Writer</a> out)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Saves this config file to the specified writer as an INI file.
-
+
<p>
The writer will automatically be closed.</div>
<dl>
@@ -2244,7 +2244,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<h4>merge</h4>
<pre>public abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.1189">merge</a>(<a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> cf)</pre>
<div class="block">Merges the contents of the specified config file into this config file.
-
+
<p>
Pretty much identical to just replacing this config file, but causes the
<a href="../../../../org/apache/juneau/ini/ConfigFileListener.html#onChange-org.apache.juneau.ini.ConfigFile-java.util.Set-"><code>ConfigFileListener.onChange(ConfigFile, Set)</code></a> method to be invoked on differences between the file.</div>
@@ -2266,7 +2266,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<h4>toString</h4>
<pre>public abstract <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.1198">toString</a>()</pre>
<div class="block">Returns the config file contents as a string.
-
+
<p>
The contents of the string are the same as the contents that would be serialized to disk.</div>
<dl>
@@ -2318,7 +2318,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?
<pre>public abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.1234">getResolving</a>()</pre>
<div class="block">Returns a wrapped instance of this config file where calls to getters have their values first resolved by a
default <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl"><code>VarResolver</code></a>.
-
+
The default <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl"><code>VarResolver</code></a> is registered with the following <a href="../../../../org/apache/juneau/svl/Var.html" title="class in org.apache.juneau.svl"><code>StringVars</code></a>:
<ul class='spaced-list'>
<li>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigFileBuilder.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigFileBuilder.html b/content/site/apidocs/org/apache/juneau/ini/ConfigFileBuilder.html
index 666eaf5..2665803 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigFileBuilder.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigFileBuilder.html
@@ -111,10 +111,10 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.38">ConfigFileBuilder</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Builder for creating instances of <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini"><code>ConfigFiles</code></a>.
-
+
<h5 class='section'>Example:</h5>
<p class='bcode'>
- ConfigFile cf = <jk>new</jk> ConfigFileBuilder().build(<js>"MyConfig.cfg"</js>);
+ ConfigFile cf = ConfigFile.<jsm>create</jsm>().build(<js>"MyConfig.cfg"</js>);
String setting = cf.get(<js>"MySection/mysetting"</js>);
</p></div>
</li>
@@ -271,7 +271,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>encoder</h4>
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFileBuilder.html" title="class in org.apache.juneau.ini">ConfigFileBuilder</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.56">encoder</a>(<a href="../../../../org/apache/juneau/ini/Encoder.html" title="interface in org.apache.juneau.ini">Encoder</a> encoder)</pre>
<div class="block">Specify the encoder to use for encoded config file entries (e.g. <js>"mySecret*={...}"</js>).
-
+
<p>
The default value for this setting is an instance of <a href="../../../../org/apache/juneau/ini/XorEncoder.html" title="class in org.apache.juneau.ini"><code>XorEncoder</code></a>.</div>
<dl>
@@ -290,7 +290,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>serializer</h4>
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFileBuilder.html" title="class in org.apache.juneau.ini">ConfigFileBuilder</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.70">serializer</a>(<a href="../../../../org/apache/juneau/serializer/WriterSerializer.html" title="class in org.apache.juneau.serializer">WriterSerializer</a> serializer)</pre>
<div class="block">Specify the serializer to use for serializing POJOs when using <a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.Object-"><code>ConfigFile.put(String, Object)</code></a>.
-
+
<p>
The default value for this setting is <a href="../../../../org/apache/juneau/json/JsonSerializer.html#DEFAULT_LAX"><code>JsonSerializer.DEFAULT_LAX</code></a>.</div>
<dl>
@@ -309,7 +309,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>parser</h4>
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFileBuilder.html" title="class in org.apache.juneau.ini">ConfigFileBuilder</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.84">parser</a>(<a href="../../../../org/apache/juneau/parser/ReaderParser.html" title="class in org.apache.juneau.parser">ReaderParser</a> parser)</pre>
<div class="block">Specify the parser to use for parsing POJOs when using <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.Class-"><code>ConfigFile.getObject(String,Class)</code></a>.
-
+
<p>
The default value for this setting is <a href="../../../../org/apache/juneau/json/JsonParser.html#DEFAULT"><code>JsonParser.DEFAULT</code></a></div>
<dl>
@@ -328,7 +328,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>charset</h4>
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFileBuilder.html" title="class in org.apache.juneau.ini">ConfigFileBuilder</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.98">charset</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/nio/charset/Charset.html?is-external=true" title="class or interface in java.nio.charset">Charset</a> charset)</pre>
<div class="block">Specify the config file character encoding.
-
+
<p>
The default value for this setting is <a href="http://docs.oracle.com/javase/7/docs/api/java/nio/charset/Charset.html?is-external=true#defaultCharset--" title="class or interface in java.nio.charset"><code>Charset.defaultCharset()</code></a>.</div>
<dl>
@@ -347,10 +347,10 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>paths</h4>
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFileBuilder.html" title="class in org.apache.juneau.ini">ConfigFileBuilder</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.115">paths</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>... searchPaths)</pre>
<div class="block">Specify the search paths for config files.
-
+
<p>
Can contain relative or absolute paths.
-
+
<p>
The default value for this setting is <code>[<js>"."</js>]</code>.</div>
<dl>
@@ -369,7 +369,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>readOnly</h4>
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFileBuilder.html" title="class in org.apache.juneau.ini">ConfigFileBuilder</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.130">readOnly</a>()</pre>
<div class="block">Make <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini"><code>ConfigFiles</code></a> read-only.
-
+
<p>
The default value of this setting is <jk>false</jk>.</div>
<dl>
@@ -386,7 +386,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>createIfNotExists</h4>
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFileBuilder.html" title="class in org.apache.juneau.ini">ConfigFileBuilder</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.143">createIfNotExists</a>()</pre>
<div class="block">Create config files if they cannot be found on the file system.
-
+
<p>
The default value for this setting is <jk>false</jk>.</div>
<dl>
@@ -441,7 +441,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.180">build</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</a> f)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Create a new config file backed by the specified file.
-
+
<p>
This method is provided primarily for testing purposes.</div>
<dl>
@@ -481,13 +481,13 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>main</h4>
<pre>public static void <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileBuilder.html#line.266">main</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[] args)</pre>
<div class="block">Implements command-line features for working with INI configuration files.
-
+
<p>
Invoke as a normal Java program...
<p class='bcode'>
java org.apache.juneau.ini.ConfigFileBuilder [args]
</p>
-
+
<p>
Arguments can be any of the following...
<ul class='spaced-list'>
@@ -508,7 +508,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<code>setVals -configFile <configFile> -vals [var1=val1 [var2=val2...]] [-verbose]</code>
Sets values in config files.
</ul>
-
+
<p>
For example, the following command will create the file <code>'MyConfig.bat'</code> from the contents of the
file <code>'MyConfig.cfg'</code>.
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigFileContext.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigFileContext.html b/content/site/apidocs/org/apache/juneau/ini/ConfigFileContext.html
index 1083b41..f31405c 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigFileContext.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigFileContext.html
@@ -396,7 +396,7 @@ extends <a href="../../../../org/apache/juneau/Context.html" title="class in org
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/Context.html#createSession-org.apache.juneau.SessionArgs-">Context</a></code></span></div>
<div class="block">Create a new session based on the properties defined on this context combined with the specified
runtime args.
-
+
<p>
Use this method for creating sessions if you don't need to override any
properties or locale/timezone currently set on this context.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigFileImpl.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigFileImpl.html b/content/site/apidocs/org/apache/juneau/ini/ConfigFileImpl.html
index f00cbcb..2c5ad62 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigFileImpl.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigFileImpl.html
@@ -496,10 +496,10 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<a href="http://docs.oracle.com/javase/7/docs/api/java/nio/charset/Charset.html?is-external=true" title="class or interface in java.nio.charset">Charset</a> charset)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Constructor.
-
+
<p>
Loads the contents of the specified file into this config file.
-
+
<p>
If file does not initially exist, this object will start off empty.</div>
<dl>
@@ -530,7 +530,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>public <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileImpl.html#line.113">ConfigFileImpl</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</a> file)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Constructor.
-
+
<p>
Shortcut for calling <code><jk>new</jk> ConfigFileImpl(file, <jk>false</jk>, <jk>null</jk>, <jk>null</jk>,
<jk>null</jk>, <jk>null</jk>);</code></div>
@@ -551,7 +551,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>public <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileImpl.html#line.126">ConfigFileImpl</a>()
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Constructor.
-
+
<p>
Shortcut for calling <code><jk>new</jk> ConfigFileImpl(<jk>null</jk>, <jk>false</jk>, <jk>null</jk>,
<jk>null</jk>, <jk>null</jk>, <jk>null</jk>);</code></div>
@@ -643,7 +643,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#serialize-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-">ConfigFile</a></code></span></div>
<div class="block">Converts the specified object to a string.
-
+
<p>
The serialized output is identical to LAX JSON (JSON with unquoted attributes) except for the following
exceptions:
@@ -913,7 +913,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>... lines)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#addLines-java.lang.String-java.lang.String...-">ConfigFile</a></code></span></div>
<div class="block">Adds arbitrary lines to the specified config file section.
-
+
<p>
The lines can be any of the following....
<ul class='spaced-list'>
@@ -924,7 +924,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<li>
<js>" foobar "</js> - Anything else (interpreted as a comment).
</ul>
-
+
<p>
If the section does not exist, it will automatically be created.</div>
<dl>
@@ -948,12 +948,12 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>... headerComments)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#addHeaderComments-java.lang.String-java.lang.String...-">ConfigFile</a></code></span></div>
<div class="block">Adds header comments to the specified section.
-
+
<p>
Header comments are defined as lines that start with <jk>"#"</jk> immediately preceding a section header
<jk>"[section]"</jk>.
These are handled as part of the section itself instead of being interpreted as comments in the previous section.
-
+
<p>
Header comments can be of the following formats...
<ul class='spaced-list'>
@@ -962,7 +962,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<li>
<js>"comment"</js> - Anything else (will automatically be prefixed with <js>"# "</js>).
</ul>
-
+
<p>
If the section does not exist, it will automatically be created.</div>
<dl>
@@ -1044,7 +1044,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFileImpl.html" title="class in org.apache.juneau.ini">ConfigFileImpl</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileImpl.html#line.581">addSection</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#addSection-java.lang.String-">ConfigFile</a></code></span></div>
<div class="block">Appends a section to this config file if it does not already exist.
-
+
<p>
Returns the existing section if it already exists.</div>
<dl>
@@ -1188,7 +1188,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileImpl.html#line.675">toString</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#toString--">ConfigFile</a></code></span></div>
<div class="block">Returns the config file contents as a string.
-
+
<p>
The contents of the string are the same as the contents that would be serialized to disk.</div>
<dl>
@@ -1242,7 +1242,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileImpl.html#line.707">merge</a>(<a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> cf)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#merge-org.apache.juneau.ini.ConfigFile-">ConfigFile</a></code></span></div>
<div class="block">Merges the contents of the specified config file into this config file.
-
+
<p>
Pretty much identical to just replacing this config file, but causes the
<a href="../../../../org/apache/juneau/ini/ConfigFileListener.html#onChange-org.apache.juneau.ini.ConfigFile-java.util.Set-"><code>ConfigFileListener.onChange(ConfigFile, Set)</code></a> method to be invoked on differences between the file.</div>
@@ -1265,7 +1265,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>protected <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileImpl.html#line.731">getBeanSession</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getBeanSession--">ConfigFile</a></code></span></div>
<div class="block">Returns the reusable bean session associated with this config file.
-
+
<p>
Used for performing simple datatype conversions.</div>
<dl>
@@ -1356,7 +1356,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getResolving--">ConfigFile</a></code></span></div>
<div class="block">Returns a wrapped instance of this config file where calls to getters have their values first resolved by a
default <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl"><code>VarResolver</code></a>.
-
+
The default <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl"><code>VarResolver</code></a> is registered with the following <a href="../../../../org/apache/juneau/svl/Var.html" title="class in org.apache.juneau.svl"><code>StringVars</code></a>:
<ul class='spaced-list'>
<li>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigFileListener.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigFileListener.html b/content/site/apidocs/org/apache/juneau/ini/ConfigFileListener.html
index 7024b4c..eceaf02 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigFileListener.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigFileListener.html
@@ -115,7 +115,7 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileListener.html#line.23">ConfigFileListener</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Listener that can be used to listen for change events in config files.
-
+
<p>
Use the <a href="../../../../org/apache/juneau/ini/ConfigFile.html#addListener-org.apache.juneau.ini.ConfigFileListener-"><code>ConfigFile.addListener(ConfigFileListener)</code></a> method to register listeners.</div>
</li>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigFileVar.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigFileVar.html b/content/site/apidocs/org/apache/juneau/ini/ConfigFileVar.html
index 9b0782c..0743e31 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigFileVar.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigFileVar.html
@@ -126,28 +126,28 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileVar.html#line.48">ConfigFileVar</a>
extends <a href="../../../../org/apache/juneau/svl/DefaultingVar.html" title="class in org.apache.juneau.svl">DefaultingVar</a></pre>
<div class="block">Config file variable resolver.
-
+
<p>
The format for this var is <js>"$C{key[,defaultValue]}"</js>.
See <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getString-java.lang.String-"><code>ConfigFile.getString(String)</code></a> for the format of the key.
-
+
<p>
This variable resolver requires that a <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini"><code>ConfigFile</code></a> object be set as a context object on the resolver or a
session object on the resolver session.
-
+
<h5 class='section'>Example:</h5>
<p class='bcode'>
<jc>// Create a config file object.</jc>
ConfigFile configFile = new ConfigFileBuilder().build(<js>"MyConfig.cfg"</js>);
-
+
<jc>// Create a variable resolver that resolves config file entries (e.g. "$C{MySection/myKey}")</jc>
VarResolver r = <jk>new</jk> VarResolver().addVars(ConfigVar.<js>class</js>)
.addContextObject(<jsf>SESSION_config</jsf>, configFile);
-
+
<jc>// Use it!</jc>
System.<jsf>out</jsf>.println(r.resolve(<js>"Value for myKey in section MySection is $C{MySection/myKey}"</js>));
</p>
-
+
<p>
Since this is a <a href="../../../../org/apache/juneau/svl/SimpleVar.html" title="class in org.apache.juneau.svl"><code>SimpleVar</code></a>, any variables contained in the result will be recursively resolved.
Likewise, if the arguments contain any variables, those will be resolved before they are passed to this var.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigFileWrapped.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigFileWrapped.html b/content/site/apidocs/org/apache/juneau/ini/ConfigFileWrapped.html
index 1893b10..410755e 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigFileWrapped.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigFileWrapped.html
@@ -121,10 +121,10 @@ var activeTableTab = "activeTableTab";
extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></pre>
<div class="block">Wraps an instance of <a href="../../../../org/apache/juneau/ini/ConfigFileImpl.html" title="class in org.apache.juneau.ini"><code>ConfigFileImpl</code></a> in an interface that will automatically replace <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl"><code>VarResolver</code></a>
variables.
-
+
<p>
The <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getResolving-org.apache.juneau.svl.VarResolver-"><code>ConfigFile.getResolving(VarResolver)</code></a> returns an instance of this class.
-
+
<p>
This class overrides the <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getString-java.lang.String-java.lang.String-"><code>ConfigFile.getString(String, String)</code></a> to resolve string variables.
All other method calls are passed through to the inner config file.</div>
@@ -656,7 +656,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>... lines)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#addLines-java.lang.String-java.lang.String...-">ConfigFile</a></code></span></div>
<div class="block">Adds arbitrary lines to the specified config file section.
-
+
<p>
The lines can be any of the following....
<ul class='spaced-list'>
@@ -667,7 +667,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<li>
<js>" foobar "</js> - Anything else (interpreted as a comment).
</ul>
-
+
<p>
If the section does not exist, it will automatically be created.</div>
<dl>
@@ -691,12 +691,12 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>... headerComments)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#addHeaderComments-java.lang.String-java.lang.String...-">ConfigFile</a></code></span></div>
<div class="block">Adds header comments to the specified section.
-
+
<p>
Header comments are defined as lines that start with <jk>"#"</jk> immediately preceding a section header
<jk>"[section]"</jk>.
These are handled as part of the section itself instead of being interpreted as comments in the previous section.
-
+
<p>
Header comments can be of the following formats...
<ul class='spaced-list'>
@@ -705,7 +705,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<li>
<js>"comment"</js> - Anything else (will automatically be prefixed with <js>"# "</js>).
</ul>
-
+
<p>
If the section does not exist, it will automatically be created.</div>
<dl>
@@ -787,7 +787,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileWrapped.html#line.169">addSection</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#addSection-java.lang.String-">ConfigFile</a></code></span></div>
<div class="block">Appends a section to this config file if it does not already exist.
-
+
<p>
Returns the existing section if it already exists.</div>
<dl>
@@ -893,7 +893,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileWrapped.html#line.199">toString</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#toString--">ConfigFile</a></code></span></div>
<div class="block">Returns the config file contents as a string.
-
+
<p>
The contents of the string are the same as the contents that would be serialized to disk.</div>
<dl>
@@ -952,7 +952,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getResolving--">ConfigFile</a></code></span></div>
<div class="block">Returns a wrapped instance of this config file where calls to getters have their values first resolved by a
default <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl"><code>VarResolver</code></a>.
-
+
The default <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl"><code>VarResolver</code></a> is registered with the following <a href="../../../../org/apache/juneau/svl/Var.html" title="class in org.apache.juneau.svl"><code>StringVars</code></a>:
<ul class='spaced-list'>
<li>
@@ -1015,7 +1015,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>public <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileWrapped.html#line.232">merge</a>(<a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> newCf)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#merge-org.apache.juneau.ini.ConfigFile-">ConfigFile</a></code></span></div>
<div class="block">Merges the contents of the specified config file into this config file.
-
+
<p>
Pretty much identical to just replacing this config file, but causes the
<a href="../../../../org/apache/juneau/ini/ConfigFileListener.html#onChange-org.apache.juneau.ini.ConfigFile-java.util.Set-"><code>ConfigFileListener.onChange(ConfigFile, Set)</code></a> method to be invoked on differences between the file.</div>
@@ -1038,7 +1038,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
<pre>protected <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a> <a href="../../../../src-html/org/apache/juneau/ini/ConfigFileWrapped.html#line.238">getBeanSession</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getBeanSession--">ConfigFile</a></code></span></div>
<div class="block">Returns the reusable bean session associated with this config file.
-
+
<p>
Used for performing simple datatype conversions.</div>
<dl>
@@ -1210,7 +1210,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigFile.html#serialize-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-">ConfigFile</a></code></span></div>
<div class="block">Converts the specified object to a string.
-
+
<p>
The serialized output is identical to LAX JSON (JSON with unquoted attributes) except for the following
exceptions:
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigSource.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigSource.html b/content/site/apidocs/org/apache/juneau/ini/ConfigSource.html
index e4612b4..65bbeb1 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigSource.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigSource.html
@@ -287,7 +287,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>protected abstract boolean <a href="../../../../src-html/org/apache/juneau/ini/ConfigSource.html#line.73">hasBeenModified</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block">Returns whether the underlying configuration contents have changed.
-
+
<p>
For example, if the configuration source is a file, this method would return <jk>true</jk> if the
file on the filesystem has been modified since the <a href="../../../../org/apache/juneau/ini/ConfigSource.html#read-java.lang.String-"><code>read(String)</code></a> method was called.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigSourceFile.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigSourceFile.html b/content/site/apidocs/org/apache/juneau/ini/ConfigSourceFile.html
index edbab25..c50ba8c 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigSourceFile.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigSourceFile.html
@@ -280,7 +280,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigSource.html" title="cla
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigSource.html#hasBeenModified-java.lang.String-">ConfigSource</a></code></span></div>
<div class="block">Returns whether the underlying configuration contents have changed.
-
+
<p>
For example, if the configuration source is a file, this method would return <jk>true</jk> if the
file on the filesystem has been modified since the <a href="../../../../org/apache/juneau/ini/ConfigSource.html#read-java.lang.String-"><code>ConfigSource.read(String)</code></a> method was called.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigSourceMemory.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigSourceMemory.html b/content/site/apidocs/org/apache/juneau/ini/ConfigSourceMemory.html
index 8364cea..dbe2945 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigSourceMemory.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigSourceMemory.html
@@ -280,7 +280,7 @@ extends <a href="../../../../org/apache/juneau/ini/ConfigSource.html" title="cla
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/ini/ConfigSource.html#hasBeenModified-java.lang.String-">ConfigSource</a></code></span></div>
<div class="block">Returns whether the underlying configuration contents have changed.
-
+
<p>
For example, if the configuration source is a file, this method would return <jk>true</jk> if the
file on the filesystem has been modified since the <a href="../../../../org/apache/juneau/ini/ConfigSource.html#read-java.lang.String-"><code>ConfigSource.read(String)</code></a> method was called.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/ConfigSourceSettings.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/ConfigSourceSettings.html b/content/site/apidocs/org/apache/juneau/ini/ConfigSourceSettings.html
index 26ef4ed..611f03d 100644
--- a/content/site/apidocs/org/apache/juneau/ini/ConfigSourceSettings.html
+++ b/content/site/apidocs/org/apache/juneau/ini/ConfigSourceSettings.html
@@ -225,7 +225,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>isCreateIfNotExists</h4>
<pre>public boolean <a href="../../../../src-html/org/apache/juneau/ini/ConfigSourceSettings.html#line.99">isCreateIfNotExists</a>()</pre>
<div class="block">Specifies whether config files should be created if they're not found in the search paths.
-
+
<p>
Note that the first writable path will be used for the location of the file.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/EntryListener.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/EntryListener.html b/content/site/apidocs/org/apache/juneau/ini/EntryListener.html
index 71c5fd2..5a62162 100644
--- a/content/site/apidocs/org/apache/juneau/ini/EntryListener.html
+++ b/content/site/apidocs/org/apache/juneau/ini/EntryListener.html
@@ -116,7 +116,7 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/ini/EntryListener.html#line.23">EntryListener</a>
extends <a href="../../../../org/apache/juneau/ini/ConfigFileListener.html" title="class in org.apache.juneau.ini">ConfigFileListener</a></pre>
<div class="block">Listener that can be used to listen for change events for a specific entry in a config file.
-
+
<p>
Use the <a href="../../../../org/apache/juneau/ini/ConfigFile.html#addListener-org.apache.juneau.ini.ConfigFileListener-"><code>ConfigFile.addListener(ConfigFileListener)</code></a> method to register listeners.</div>
</li>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/SectionListener.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/SectionListener.html b/content/site/apidocs/org/apache/juneau/ini/SectionListener.html
index 3f27fce..8bc2127 100644
--- a/content/site/apidocs/org/apache/juneau/ini/SectionListener.html
+++ b/content/site/apidocs/org/apache/juneau/ini/SectionListener.html
@@ -116,7 +116,7 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/ini/SectionListener.html#line.25">SectionListener</a>
extends <a href="../../../../org/apache/juneau/ini/ConfigFileListener.html" title="class in org.apache.juneau.ini">ConfigFileListener</a></pre>
<div class="block">Listener that can be used to listen for change events for a specific section in a config file.
-
+
<p>
Use the <a href="../../../../org/apache/juneau/ini/ConfigFile.html#addListener-org.apache.juneau.ini.ConfigFileListener-"><code>ConfigFile.addListener(ConfigFileListener)</code></a> method to register listeners.</div>
</li>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/ini/XorEncoder.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/ini/XorEncoder.html b/content/site/apidocs/org/apache/juneau/ini/XorEncoder.html
index 8fb14da..83cf3f7 100644
--- a/content/site/apidocs/org/apache/juneau/ini/XorEncoder.html
+++ b/content/site/apidocs/org/apache/juneau/ini/XorEncoder.html
@@ -116,7 +116,7 @@ var activeTableTab = "activeTableTab";
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>
implements <a href="../../../../org/apache/juneau/ini/Encoder.html" title="interface in org.apache.juneau.ini">Encoder</a></pre>
<div class="block">Simply XOR+Base64 encoder for obscuring passwords and other sensitive data in INI config files.
-
+
<p>
This is not intended to be used as strong encryption.</div>
</li>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/internal/ArrayUtils.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/internal/ArrayUtils.html b/content/site/apidocs/org/apache/juneau/internal/ArrayUtils.html
index 22d603e..26bd84e 100644
--- a/content/site/apidocs/org/apache/juneau/internal/ArrayUtils.html
+++ b/content/site/apidocs/org/apache/juneau/internal/ArrayUtils.html
@@ -441,7 +441,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>asSet</h4>
<pre>public static <T> <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><T> <a href="../../../../src-html/org/apache/juneau/internal/ArrayUtils.html#line.142">asSet</a>(T[] array)</pre>
<div class="block">Converts the specified array to a <code>Set</code>.
-
+
<p>
The order of the entries in the set are the same as the array.</div>
<dl>
@@ -462,7 +462,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>iterator</h4>
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>> <a href="../../../../src-html/org/apache/juneau/internal/ArrayUtils.html#line.189">iterator</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> array)</pre>
<div class="block">Returns an iterator against an array.
-
+
<p>
This works with any array type (e.g. <code>String[]</code>, <code>Object[]</code>,
<code><jk>int</jk>[]</code>, etc...).</div>
@@ -483,7 +483,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static <T> <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/internal/ArrayUtils.html#line.223">toArray</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a><?> c,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> componentType)</pre>
<div class="block">Converts the specified collection to an array.
-
+
<p>
Works on both object and primitive arrays.</div>
<dl>
@@ -557,7 +557,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a> <a href="../../../../src-html/org/apache/juneau/internal/ArrayUtils.html#line.287">copyToList</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> array,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a> list)</pre>
<div class="block">Copies the specified array into the specified list.
-
+
<p>
Works on both object and primitive arrays.</div>
<dl>
@@ -710,7 +710,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>toStringArray</h4>
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[] <a href="../../../../src-html/org/apache/juneau/internal/ArrayUtils.html#line.431">toStringArray</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a><?> c)</pre>
<div class="block">Converts the specified collection to an array of strings.
-
+
<p>
Entries are converted to strings using <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang"><code>Object.toString()</code></a>.
<jk>null</jk> values remain <jk>null</jk>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/internal/ByteArrayCache.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/internal/ByteArrayCache.html b/content/site/apidocs/org/apache/juneau/internal/ByteArrayCache.html
index 71b5096..f8760f8 100644
--- a/content/site/apidocs/org/apache/juneau/internal/ByteArrayCache.html
+++ b/content/site/apidocs/org/apache/juneau/internal/ByteArrayCache.html
@@ -215,7 +215,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>DEFAULT</h4>
<pre>public static final <a href="../../../../org/apache/juneau/internal/ByteArrayCache.html" title="class in org.apache.juneau.internal">ByteArrayCache</a> <a href="../../../../src-html/org/apache/juneau/internal/ByteArrayCache.html#line.30">DEFAULT</a></pre>
<div class="block">Default global byte array cache.
-
+
<p>
Note that this can't ever get garbage collected so don't add really large arrays!</div>
</li>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/internal/Cache.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/internal/Cache.html b/content/site/apidocs/org/apache/juneau/internal/Cache.html
index f80e553..6c75445 100644
--- a/content/site/apidocs/org/apache/juneau/internal/Cache.html
+++ b/content/site/apidocs/org/apache/juneau/internal/Cache.html
@@ -116,7 +116,7 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/internal/Cache.html#line.26">Cache</a><K,V>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Simple in-memory cache of objects.
-
+
<p>
Essentially just a wrapper around a ConcurrentHashMap.</div>
</li>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/internal/ClassUtils.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/internal/ClassUtils.html b/content/site/apidocs/org/apache/juneau/internal/ClassUtils.html
index bc86703..f759f6b 100644
--- a/content/site/apidocs/org/apache/juneau/internal/ClassUtils.html
+++ b/content/site/apidocs/org/apache/juneau/internal/ClassUtils.html
@@ -598,7 +598,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>getReadableClassName</h4>
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/internal/ClassUtils.html#line.108">getReadableClassName</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> className)</pre>
<div class="block">Converts the specified class name to a readable form when class name is a special construct like <js>"[[Z"</js>.
-
+
<h5 class='section'>Example:</h5>
<p class='bcode'>
<jsm>getReadableClassName</jsm>(<js>"java.lang.Object"</js>); <jc>// Returns "java.lang.Object"</jc>
@@ -626,7 +626,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ClassNotFoundException.html?is-external=true" title="class or interface in java.lang">ClassNotFoundException</a></pre>
<div class="block">Converts the string generated by <a href="../../../../org/apache/juneau/internal/ClassUtils.html#getReadableClassName-java.lang.Class-"><code>getReadableClassName(Class)</code></a> back into a <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang"><code>Class</code></a>.
-
+
<p>
Generics are stripped from the string since they cannot be converted to a class.</div>
<dl>
@@ -704,7 +704,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>getMethodSignature</h4>
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/internal/ClassUtils.html#line.201">getMethodSignature</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> m)</pre>
<div class="block">Returns the signature of the specified method.
-
+
<p>
For no-arg methods, the signature will be a simple string such as <js>"toString"</js>.
For methods with one or more args, the arguments will be fully-qualified class names (e.g.
@@ -921,11 +921,11 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static <T extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>> T <a href="../../../../src-html/org/apache/juneau/internal/ClassUtils.html#line.380">getMethodAnnotation</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> a,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> m)</pre>
<div class="block">Returns the specified annotation on the specified method.
-
+
<p>
Similar to <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true#getAnnotation-java.lang.Class-" title="class or interface in java.lang.reflect"><code>Method.getAnnotation(Class)</code></a>, but searches up the parent hierarchy for the annotation
defined on parent classes and interfaces.
-
+
<p>
Normally, annotations defined on methods of parent classes and interfaces are not inherited by the child methods.
This utility method gets around that limitation by searching the class hierarchy for the "same" method
@@ -949,11 +949,11 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> c,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> method)</pre>
<div class="block">Returns the specified annotation on the specified method.
-
+
<p>
Similar to <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true#getAnnotation-java.lang.Class-" title="class or interface in java.lang.reflect"><code>Method.getAnnotation(Class)</code></a>, but searches up the parent hierarchy for the annotation defined
on parent classes and interfaces.
-
+
<p>
Normally, annotations defined on methods of parent classes and interfaces are not inherited by the child methods.
This utility method gets around that limitation by searching the class hierarchy for the "same" method
@@ -979,7 +979,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static final <T> <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Constructor.html?is-external=true" title="class or interface in java.lang.reflect">Constructor</a><T> <a href="../../../../src-html/org/apache/juneau/internal/ClassUtils.html#line.443">findNoArgConstructor</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> c,
<a href="../../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> v)</pre>
<div class="block">Locates the no-arg constructor for the specified class.
-
+
<p>
Constructor must match the visibility requirements specified by parameter 'v'.
If class is abstract, always returns <jk>null</jk>.
@@ -1294,7 +1294,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Field.html?is-external=true" title="class or interface in java.lang.reflect">Field</a>> <a href="../../../../src-html/org/apache/juneau/internal/ClassUtils.html#line.894">getAllFields</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a> c,
boolean parentFirst)</pre>
<div class="block">Returns all the fields in the specified class and all parent classes.
-
+
<p>
Fields are ordered in either parent-to-child, or child-to-parent order, then alphabetically.</div>
<dl>
@@ -1315,7 +1315,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a>> <a href="../../../../src-html/org/apache/juneau/internal/ClassUtils.html#line.952">getAllMethods</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a> c,
boolean parentFirst)</pre>
<div class="block">Returns all the methods in the specified class and all parent classes.
-
+
<p>
Methods are ordered in either parent-to-child, or child-to-parent order, then alphabetically.</div>
<dl>
@@ -1403,7 +1403,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>toString</h4>
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/internal/ClassUtils.html#line.1117">toString</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> m)</pre>
<div class="block">Returns a readable representation of the specified method.
-
+
<p>
The format of the string is <js>"full-qualified-class.method-name(parameter-simple-class-names)"</js>.</div>
<dl>
@@ -1422,7 +1422,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>toString</h4>
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/internal/ClassUtils.html#line.1137">toString</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Field.html?is-external=true" title="class or interface in java.lang.reflect">Field</a> f)</pre>
<div class="block">Returns a readable representation of the specified field.
-
+
<p>
The format of the string is <js>"full-qualified-class.field-name"</js>.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/internal/CollectionUtils.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/internal/CollectionUtils.html b/content/site/apidocs/org/apache/juneau/internal/CollectionUtils.html
index 6f8d3a3..cbdfce6 100644
--- a/content/site/apidocs/org/apache/juneau/internal/CollectionUtils.html
+++ b/content/site/apidocs/org/apache/juneau/internal/CollectionUtils.html
@@ -295,7 +295,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><?> <a href="../../../../src-html/org/apache/juneau/internal/CollectionUtils.html#line.71">addReverse</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a> list,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a> append)</pre>
<div class="block">Adds the contents of one list to the other in reverse order.
-
+
<p>
i.e. add values from 2nd list from end-to-start order to the end of the 1st list.</div>
<dl>
@@ -316,7 +316,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><?> <a href="../../../../src-html/org/apache/juneau/internal/CollectionUtils.html#line.88">addReverse</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a> list,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] append)</pre>
<div class="block">Adds the contents of the array to the list in reverse order.
-
+
<p>
i.e. add values from the array from end-to-start order to the end of the list.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/internal/DateUtils.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/internal/DateUtils.html b/content/site/apidocs/org/apache/juneau/internal/DateUtils.html
index 9c91fb2..3a2b95c 100644
--- a/content/site/apidocs/org/apache/juneau/internal/DateUtils.html
+++ b/content/site/apidocs/org/apache/juneau/internal/DateUtils.html
@@ -111,10 +111,10 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/internal/DateUtils.html#line.30">DateUtils</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">A utility class for parsing and formatting HTTP dates as used in cookies and other headers.
-
+
<p>
This class handles dates as defined by RFC 2616 section 3.3.1 as well as some other common non-standard formats.
-
+
<p>
This class was copied from HttpClient 4.3.</div>
</li>
@@ -425,7 +425,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<pre>public static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/internal/DateUtils.html#line.145">formatDate</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Date.html?is-external=true" title="class or interface in java.util">Date</a> date,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</pre>
<div class="block">Formats the given date according to the specified pattern.
-
+
<p>
The pattern must conform to that used by the <a href="http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true" title="class or interface in java.text"><code>simple date format</code></a> class.</div>
<dl>
@@ -459,7 +459,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>toValidISO8601DT</h4>
<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/internal/DateUtils.html#line.222">toValidISO8601DT</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> in)</pre>
<div class="block">Pads out an ISO8601 string so that it can be parsed using <a href="http://docs.oracle.com/javase/7/docs/api/javax/xml/bind/DatatypeConverter.html?is-external=true#parseDateTime-java.lang.String-" title="class or interface in javax.xml.bind"><code>DatatypeConverter.parseDateTime(String)</code></a>.
-
+
<ul>
<li><js>"2001-07-04T15:30:45-05:00"</js> --> <js>"2001-07-04T15:30:45-05:00"</js>
<li><js>"2001-07-04T15:30:45Z"</js> --> <js>"2001-07-04T15:30:45Z"</js>