http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/84380388/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 f6c62ff..f4b68e9 100644 --- a/content/site/apidocs/org/apache/juneau/ini/ConfigFile.html +++ b/content/site/apidocs/org/apache/juneau/ini/ConfigFile.html @@ -18,7 +18,7 @@ catch(err) { } //--> -var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":10,"i6":6,"i7":6,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":6,"i19":6,"i20":6,"i21":6,"i22":6,"i23":10,"i24":10,"i25":10,"i26":6,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":6,"i34":6,"i35":6,"i36":6,"i37":6,"i38":6,"i39":10,"i40":10,"i41":6,"i42":6,"i43":6,"i44":6,"i45":6,"i46":6,"i47":10,"i48":6,"i49":6,"i50":10,"i51":6,"i52":6,"i53":6,"i54":6,"i55":10}; +var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":10,"i6":6,"i7":6,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":6,"i25":6,"i26":6,"i27":6,"i28":6,"i29":10,"i30":10,"i31":10,"i32":6,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":6,"i40":6,"i41":6,"i42":6,"i43":6,"i44":6,"i45":10,"i46":10,"i47":10,"i48":10,"i49":6,"i50":6,"i51":6,"i52":6,"i53":6,"i54":6,"i55":10,"i56":6,"i57":6,"i58":10,"i59":6,"i60":6,"i61":6,"i62":6,"i63":10}; var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -258,13 +258,49 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? </tr> <tr id="i13" class="rowColor"> <td class="colFirst"><code><T> T</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-org.apache.juneau.parser.Parser-java.lang.Class-">getObject</a></span>(<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, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + <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)</code> +<div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.Class-"><code>getObject(String, Class)</code></a> but allows you to specify the parser to use to parse the value.</div> +</td> +</tr> +<tr id="i14" class="altColor"> +<td class="colFirst"><code><T> T</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-org.apache.juneau.parser.Parser-java.lang.reflect.Type-java.lang.reflect.Type...-">getObject</a></span>(<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, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + <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> type, + <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)</code> +<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> but allows you to specify the parser to use to parse the value.</div> +</td> +</tr> +<tr id="i15" class="rowColor"> +<td class="colFirst"><code><T> T</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.String-java.lang.Class-">getObject</a></span>(<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> sectionName, <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> sectionKey, <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)</code> <div class="block">Gets the entry with the specified key and converts it to the specified value.</div> </td> </tr> -<tr id="i14" class="altColor"> +<tr id="i16" class="altColor"> +<td class="colFirst"><code><T> T</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.String-org.apache.juneau.parser.Parser-java.lang.Class-">getObject</a></span>(<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> sectionName, + <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> sectionKey, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + <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)</code> +<div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.String-java.lang.Class-"><code>getObject(String, String, Class)</code></a> but allows you to specify the parser to use to parse the value.</div> +</td> +</tr> +<tr id="i17" class="rowColor"> +<td class="colFirst"><code><T> T</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.String-org.apache.juneau.parser.Parser-java.lang.reflect.Type-java.lang.reflect.Type...-">getObject</a></span>(<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> sectionName, + <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> sectionKey, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + <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> type, + <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)</code> +<div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.String-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>getObject(String, String, Type, Type...)</code></a> but allows you to specify the parser to use to parse the value.</div> +</td> +</tr> +<tr id="i18" class="altColor"> <td class="colFirst"><code><T> T</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.String-java.lang.reflect.Type-java.lang.reflect.Type...-">getObject</a></span>(<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> sectionName, <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> sectionKey, @@ -273,7 +309,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <div class="block">Gets the entry with the specified key and converts it to the specified value.</div> </td> </tr> -<tr id="i15" class="rowColor"> +<tr id="i19" class="rowColor"> <td class="colFirst"><code><T> T</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObject-java.lang.String-java.lang.reflect.Type-java.lang.reflect.Type...-">getObject</a></span>(<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, <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> type, @@ -281,7 +317,26 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <div class="block">Gets the entry with the specified key and converts it to the specified value.</div> </td> </tr> -<tr id="i16" class="altColor"> +<tr id="i20" class="altColor"> +<td class="colFirst"><code><T> T</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObjectWithDefault-java.lang.String-org.apache.juneau.parser.Parser-T-java.lang.Class-">getObjectWithDefault</a></span>(<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, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + T def, + <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)</code> +<div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObjectWithDefault-java.lang.String-T-java.lang.Class-"><code>getObjectWithDefault(String, Object, Class)</code></a> but allows you to specify the parser to use to parse the value.</div> +</td> +</tr> +<tr id="i21" class="rowColor"> +<td class="colFirst"><code><T> T</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObjectWithDefault-java.lang.String-org.apache.juneau.parser.Parser-T-java.lang.reflect.Type-java.lang.reflect.Type...-">getObjectWithDefault</a></span>(<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, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + T def, + <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> type, + <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)</code> +<div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObjectWithDefault-java.lang.String-T-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>getObjectWithDefault(String, Object, Type, Type...)</code></a> but allows you to specify the parser to use to parse the value.</div> +</td> +</tr> +<tr id="i22" class="altColor"> <td class="colFirst"><code><T> T</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObjectWithDefault-java.lang.String-T-java.lang.Class-">getObjectWithDefault</a></span>(<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, T def, @@ -289,7 +344,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <div class="block">Gets the entry with the specified key and converts it to the specified value.</div> </td> </tr> -<tr id="i17" class="rowColor"> +<tr id="i23" class="rowColor"> <td class="colFirst"><code><T> T</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObjectWithDefault-java.lang.String-T-java.lang.reflect.Type-java.lang.reflect.Type...-">getObjectWithDefault</a></span>(<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, T def, @@ -298,48 +353,48 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <div class="block">Gets the entry with the specified key and converts it to the specified value.</div> </td> </tr> -<tr id="i18" class="altColor"> +<tr id="i24" class="altColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getResolving--">getResolving</a></span>()</code> <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>.</div> </td> </tr> -<tr id="i19" class="rowColor"> +<tr id="i25" class="rowColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getResolving-org.apache.juneau.svl.VarResolver-">getResolving</a></span>(<a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl">VarResolver</a> vr)</code> <div class="block">Returns a wrapped instance of this config file where calls to getters have their values first resolved by the specified <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl"><code>VarResolver</code></a>.</div> </td> </tr> -<tr id="i20" class="altColor"> +<tr id="i26" class="altColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getResolving-org.apache.juneau.svl.VarResolverSession-">getResolving</a></span>(<a href="../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl">VarResolverSession</a> vs)</code> <div class="block">Returns a wrapped instance of this config file where calls to getters have their values first resolved by the specified <a href="../../../../org/apache/juneau/svl/VarResolverSession.html" title="class in org.apache.juneau.svl"><code>VarResolverSession</code></a>.</div> </td> </tr> -<tr id="i21" class="rowColor"> +<tr id="i27" class="rowColor"> <td class="colFirst"><code>protected abstract <a href="../../../../org/apache/juneau/ini/Section.html" title="class in org.apache.juneau.ini">Section</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getSection-java.lang.String-">getSection</a></span>(<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)</code> <div class="block">Gets the section with the specified name.</div> </td> </tr> -<tr id="i22" class="altColor"> +<tr id="i28" class="altColor"> <td class="colFirst"><code>protected abstract <a href="../../../../org/apache/juneau/ini/Section.html" title="class in org.apache.juneau.ini">Section</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getSection-java.lang.String-boolean-">getSection</a></span>(<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, boolean create)</code> <div class="block">Gets the section with the specified name and optionally creates it if it's not there.</div> </td> </tr> -<tr id="i23" class="rowColor"> +<tr id="i29" class="rowColor"> <td class="colFirst"><code><T> T</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getSectionAsBean-java.lang.String-java.lang.Class-">getSectionAsBean</a></span>(<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> sectionName, <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)</code> <div class="block">Shortcut for calling <code>getSectionAsBean(sectionName, c, <jk>false</jk>)</code>.</div> </td> </tr> -<tr id="i24" class="altColor"> +<tr id="i30" class="altColor"> <td class="colFirst"><code><T> T</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getSectionAsBean-java.lang.String-java.lang.Class-boolean-">getSectionAsBean</a></span>(<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> sectionName, <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, @@ -347,7 +402,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <div class="block">Converts this config file section to the specified bean instance.</div> </td> </tr> -<tr id="i25" class="rowColor"> +<tr id="i31" class="rowColor"> <td class="colFirst"><code><T> T</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getSectionAsInterface-java.lang.String-java.lang.Class-">getSectionAsInterface</a></span>(<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> sectionName, <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)</code> @@ -355,94 +410,95 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? write using getters and setters.</div> </td> </tr> -<tr id="i26" class="altColor"> +<tr id="i32" class="altColor"> <td class="colFirst"><code>abstract <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><<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>></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getSectionKeys-java.lang.String-">getSectionKeys</a></span>(<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> sectionName)</code> <div class="block">Returns the current set of keys in the specified section.</div> </td> </tr> -<tr id="i27" class="rowColor"> +<tr id="i33" class="rowColor"> <td class="colFirst"><code><a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getSectionMap-java.lang.String-">getSectionMap</a></span>(<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> sectionName)</code> <div class="block">Returns the specified section as a map of key/value pairs.</div> </td> </tr> -<tr id="i28" class="altColor"> +<tr id="i34" class="altColor"> <td class="colFirst"><code><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></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getString-java.lang.String-">getString</a></span>(<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)</code> <div class="block">Gets the entry with the specified key.</div> </td> </tr> -<tr id="i29" class="rowColor"> +<tr id="i35" class="rowColor"> <td class="colFirst"><code><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></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getString-java.lang.String-java.lang.String-">getString</a></span>(<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, <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> def)</code> <div class="block">Returns the specified value as a string from the config file.</div> </td> </tr> -<tr id="i30" class="altColor"> +<tr id="i36" class="altColor"> <td class="colFirst"><code><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>[]</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getStringArray-java.lang.String-">getStringArray</a></span>(<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)</code> <div class="block">Gets the entry with the specified key, splits the value on commas, and returns the values as trimmed strings.</div> </td> </tr> -<tr id="i31" class="rowColor"> +<tr id="i37" class="rowColor"> <td class="colFirst"><code><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>[]</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getStringArray-java.lang.String-java.lang.String:A-">getStringArray</a></span>(<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, <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>[] def)</code> <div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getStringArray-java.lang.String-"><code>getStringArray(String)</code></a> but returns a default value if the value cannot be found.</div> </td> </tr> -<tr id="i32" class="altColor"> +<tr id="i38" class="altColor"> <td class="colFirst"><code>protected <a href="../../../../org/apache/juneau/svl/VarResolver.html" title="class in org.apache.juneau.svl">VarResolver</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#getVarResolver--">getVarResolver</a></span>()</code> </td> </tr> -<tr id="i33" class="rowColor"> +<tr id="i39" class="rowColor"> <td class="colFirst"><code>abstract boolean</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#isEncoded-java.lang.String-">isEncoded</a></span>(<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)</code> <div class="block">Returns <jk>true</jk> if the encoding flag is set on the specified entry.</div> </td> </tr> -<tr id="i34" class="altColor"> +<tr id="i40" class="altColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#load--">load</a></span>()</code> <div class="block">Loads ths config file object from the persisted file contents.</div> </td> </tr> -<tr id="i35" class="rowColor"> +<tr id="i41" class="rowColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#load-java.io.Reader-">load</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true"; title="class or interface in java.io">Reader</a> r)</code> <div class="block">Loads ths config file object from the specified reader.</div> </td> </tr> -<tr id="i36" class="altColor"> +<tr id="i42" class="altColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#loadIfModified--">loadIfModified</a></span>()</code> <div class="block">Reloads ths config file object from the persisted file contents if the modified timestamp on the file has changed.</div> </td> </tr> -<tr id="i37" class="rowColor"> +<tr id="i43" class="rowColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#merge-org.apache.juneau.ini.ConfigFile-">merge</a></span>(<a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a> cf)</code> <div class="block">Merges the contents of the specified config file into this config file.</div> </td> </tr> -<tr id="i38" class="altColor"> +<tr id="i44" class="altColor"> <td class="colFirst"><code>protected abstract <T> T</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#parse-java.lang.String-java.lang.reflect.Type-java.lang.reflect.Type...-">parse</a></span>(<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> s, +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#parse-java.lang.String-org.apache.juneau.parser.Parser-java.lang.reflect.Type-java.lang.reflect.Type...-">parse</a></span>(<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> s, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, <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> type, <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)</code> <div class="block">Converts the specified string to an object of the specified type.</div> </td> </tr> -<tr id="i39" class="rowColor"> +<tr id="i45" class="rowColor"> <td class="colFirst"><code><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></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.Object-">put</a></span>(<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, <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> value)</code> <div class="block">Adds or replaces an entry with the specified key with a POJO serialized to a string using the registered serializer.</div> </td> </tr> -<tr id="i40" class="altColor"> +<tr id="i46" class="altColor"> <td class="colFirst"><code><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></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.Object-boolean-">put</a></span>(<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, <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> value, @@ -450,101 +506,123 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <div class="block">Adds or replaces an entry with the specified key with the specified value.</div> </td> </tr> -<tr id="i41" class="rowColor"> +<tr id="i47" class="rowColor"> +<td class="colFirst"><code><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></code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.Object-org.apache.juneau.serializer.Serializer-">put</a></span>(<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, + <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> value, + <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a> serializer)</code> +<div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.Object-"><code>put(String, Object)</code></a> but allows you to specify the serializer to use to serialize the value.</div> +</td> +</tr> +<tr id="i48" class="altColor"> +<td class="colFirst"><code><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></code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-boolean-">put</a></span>(<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, + <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> value, + <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a> serializer, + boolean encoded, + boolean newline)</code> +<div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.Object-boolean-"><code>put(String, Object, boolean)</code></a> but allows you to specify the serializer to use to serialize the value.</div> +</td> +</tr> +<tr id="i49" class="rowColor"> <td class="colFirst"><code>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></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.String-java.lang.Object-boolean-">put</a></span>(<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> sectionName, +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.String-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-boolean-">put</a></span>(<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> sectionName, <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> sectionKey, <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> value, - boolean encoded)</code> + <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a> serializer, + boolean encoded, + boolean newline)</code> <div class="block">Sets an entry value in this config file.</div> </td> </tr> -<tr id="i42" class="altColor"> +<tr id="i50" class="altColor"> <td class="colFirst"><code>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></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.String-java.lang.String-boolean-">put</a></span>(<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> sectionName, <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> sectionKey, <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> value, boolean encoded)</code> -<div class="block">Identical to <a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.String-java.lang.Object-boolean-"><code>put(String, String, Object, boolean)</code></a> except used when the value is a simple string +<div class="block">Identical to <a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.String-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-boolean-"><code>put(String, String, Object, Serializer, boolean, boolean)</code></a> except used when the value is a simple string to avoid having to catch a <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer"><code>SerializeException</code></a>.</div> </td> </tr> -<tr id="i43" class="rowColor"> +<tr id="i51" class="rowColor"> <td class="colFirst"><code>protected abstract void</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#readLock--">readLock</a></span>()</code> <div class="block">Places a read lock on this config file.</div> </td> </tr> -<tr id="i44" class="altColor"> +<tr id="i52" class="altColor"> <td class="colFirst"><code>protected abstract void</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#readUnlock--">readUnlock</a></span>()</code> <div class="block">Removes the read lock on this config file.</div> </td> </tr> -<tr id="i45" class="rowColor"> +<tr id="i53" class="rowColor"> <td class="colFirst"><code>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></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#remove-java.lang.String-java.lang.String-">remove</a></span>(<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> sectionName, <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> sectionKey)</code> <div class="block">Removes an antry from this config file.</div> </td> </tr> -<tr id="i46" class="altColor"> +<tr id="i54" class="altColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#removeSection-java.lang.String-">removeSection</a></span>(<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)</code> <div class="block">Removes the section with the specified name.</div> </td> </tr> -<tr id="i47" class="rowColor"> +<tr id="i55" class="rowColor"> <td class="colFirst"><code><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></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#removeString-java.lang.String-">removeString</a></span>(<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)</code> <div class="block">Removes an entry with the specified key.</div> </td> </tr> -<tr id="i48" class="altColor"> +<tr id="i56" class="altColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#save--">save</a></span>()</code> <div class="block">Saves this config file to disk.</div> </td> </tr> -<tr id="i49" class="rowColor"> +<tr id="i57" class="rowColor"> <td class="colFirst"><code>protected 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></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#serialize-java.lang.Object-">serialize</a></span>(<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> o)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#serialize-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-">serialize</a></span>(<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> o, + <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a> serializer, + boolean newline)</code> <div class="block">Converts the specified object to a string.</div> </td> </tr> -<tr id="i50" class="altColor"> +<tr id="i58" class="altColor"> <td class="colFirst"><code><a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#serializeTo-java.io.Writer-">serializeTo</a></span>(<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)</code> <div class="block">Saves this config file to the specified writer as an INI file.</div> </td> </tr> -<tr id="i51" class="rowColor"> +<tr id="i59" class="rowColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#serializeTo-java.io.Writer-org.apache.juneau.ini.ConfigFileFormat-">serializeTo</a></span>(<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, <a href="../../../../org/apache/juneau/ini/ConfigFileFormat.html" title="enum in org.apache.juneau.ini">ConfigFileFormat</a> format)</code> <div class="block">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#serializeTo-java.io.Writer-"><code>serializeTo(Writer)</code></a>, except allows you to explicitely specify a format.</div> </td> </tr> -<tr id="i52" class="altColor"> +<tr id="i60" class="altColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/ini/ConfigFile.html" title="class in org.apache.juneau.ini">ConfigFile</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#setSection-java.lang.String-java.util.Map-">setSection</a></span>(<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, <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="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a>> contents)</code> <div class="block">Creates or overwrites the specified section.</div> </td> </tr> -<tr id="i53" class="rowColor"> +<tr id="i61" class="rowColor"> <td class="colFirst"><code>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></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#toString--">toString</a></span>()</code> <div class="block">Returns the config file contents as a string.</div> </td> </tr> -<tr id="i54" class="altColor"> +<tr id="i62" class="altColor"> <td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/Writable.html" title="interface in org.apache.juneau">Writable</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#toWritable--">toWritable</a></span>()</code> <div class="block">Wraps this config file in a <a href="../../../../org/apache/juneau/Writable.html" title="interface in org.apache.juneau"><code>Writable</code></a> interface that renders it as plain text.</div> </td> </tr> -<tr id="i55" class="rowColor"> +<tr id="i63" class="rowColor"> <td class="colFirst"><code><a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/ini/ConfigFile.html#writeProperties-java.lang.String-java.lang.Object-boolean-java.lang.Class...-">writeProperties</a></span>(<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> sectionName, <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> bean, @@ -617,16 +695,18 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? </dl> </li> </ul> -<a name="put-java.lang.String-java.lang.String-java.lang.Object-boolean-"> +<a name="put-java.lang.String-java.lang.String-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-boolean-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>put</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.65">put</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> sectionName, +<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.68">put</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> sectionName, <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> sectionKey, <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> value, - boolean encoded) + <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a> serializer, + boolean encoded, + boolean newline) throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre> <div class="block">Sets an entry value in this config file.</div> <dl> @@ -634,7 +714,10 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <dd><code>sectionName</code> - The section name. Must not be <jk>null</jk>.</dd> <dd><code>sectionKey</code> - The section key. Must not be <jk>null</jk>.</dd> <dd><code>value</code> - The new value.</dd> -<dd><code>encoded</code> - </dd> +<dd><code>serializer</code> - The serializer to use for serializing the object. + If <jk>null</jk>, then uses the predefined serializer on the config file.</dd> +<dd><code>encoded</code> - If <jk>true</jk>, then encode the value using the encoder associated with this config file.</dd> +<dd><code>newline</code> - If <jk>true</jk>, then put serialized output on a separate line from the key.</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>The previous value, or <jk>null</jk> if the section or key did not previously exist.</dd> <dt><span class="throwsLabel">Throws:</span></dt> @@ -649,11 +732,11 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>put</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.78">put</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> sectionName, +<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.81">put</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> sectionName, <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> sectionKey, <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> value, boolean encoded)</pre> -<div class="block">Identical to <a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.String-java.lang.Object-boolean-"><code>put(String, String, Object, boolean)</code></a> except used when the value is a simple string +<div class="block">Identical to <a href="../../../../org/apache/juneau/ini/ConfigFile.html#put-java.lang.String-java.lang.String-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-boolean-"><code>put(String, String, Object, Serializer, boolean, boolean)</code></a> except used when the value is a simple string to avoid having to catch a <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer"><code>SerializeException</code></a>.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -674,7 +757,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>remove</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.89">remove</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> sectionName, +<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.92">remove</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> sectionName, <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> sectionKey)</pre> <div class="block">Removes an antry from this config file.</div> <dl> @@ -694,7 +777,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>getSectionKeys</h4> -<pre>public abstract <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><<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.98">getSectionKeys</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> sectionName)</pre> +<pre>public abstract <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><<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.101">getSectionKeys</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> sectionName)</pre> <div class="block">Returns the current set of keys in the specified section.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -712,7 +795,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>loadIfModified</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.107">loadIfModified</a>() +<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.110">loadIfModified</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">Reloads ths config file object from the persisted file contents if the modified timestamp on the file has changed.</div> <dl> @@ -730,7 +813,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>load</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.116">load</a>() +<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.119">load</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">Loads ths config file object from the persisted file contents.</div> <dl> @@ -748,7 +831,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>load</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.126">load</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true"; title="class or interface in java.io">Reader</a> r) +<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.129">load</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true"; title="class or interface in java.io">Reader</a> r) 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">Loads ths config file object from the specified reader.</div> <dl> @@ -768,7 +851,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>addLines</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.145">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, +<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.148">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> @@ -797,7 +880,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>addHeaderComments</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.166">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, +<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.169">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> @@ -828,7 +911,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>clearHeaderComments</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.175">clearHeaderComments</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)</pre> +<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.178">clearHeaderComments</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)</pre> <div class="block">Removes any header comments from the specified section.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -846,7 +929,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <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.184">getBeanSession</a>()</pre> +<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.187">getBeanSession</a>()</pre> <div class="block">Returns the reusable bean session associated with this config file. <p> Used for performing simple datatype conversions.</div> @@ -856,13 +939,15 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? </dl> </li> </ul> -<a name="serialize-java.lang.Object-"> +<a name="serialize-java.lang.Object-org.apache.juneau.serializer.Serializer-boolean-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>serialize</h4> -<pre>protected 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.198">serialize</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> o) +<pre>protected 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.204">serialize</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> o, + <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a> serializer, + 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> @@ -873,6 +958,9 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>o</code> - The object to serialize.</dd> +<dd><code>serializer</code> - The serializer to use for serializing the object. + If <jk>null</jk>, then uses the predefined serializer on the config file.</dd> +<dd><code>newline</code> - If <jk>true</jk>, add a newline at the beginning of the value.</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>The serialized object.</dd> <dt><span class="throwsLabel">Throws:</span></dt> @@ -880,13 +968,14 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? </dl> </li> </ul> -<a name="parse-java.lang.String-java.lang.reflect.Type-java.lang.reflect.Type...-"> +<a name="parse-java.lang.String-org.apache.juneau.parser.Parser-java.lang.reflect.Type-java.lang.reflect.Type...-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>parse</h4> -<pre>protected abstract <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.209">parse</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> s, +<pre>protected abstract <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.217">parse</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> s, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, <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> type, <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> @@ -894,6 +983,8 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>s</code> - The string to parse.</dd> +<dd><code>parser</code> - The parser to use for parsing the object. + If <jk>null</jk>, then uses the predefined parser on the config file.</dd> <dd><code>type</code> - The data type to create.</dd> <dd><code>args</code> - The generic type arguments if the type is 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"><code>Collection</code></a> or <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true"; title="class or interface in java.util"><code>Map</code></a></dd> <dt><span class="returnLabel">Returns:</span></dt> @@ -909,7 +1000,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>readLock</h4> -<pre>protected abstract void <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.214">readLock</a>()</pre> +<pre>protected abstract void <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.222">readLock</a>()</pre> <div class="block">Places a read lock on this config file.</div> </li> </ul> @@ -919,7 +1010,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>readUnlock</h4> -<pre>protected abstract void <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.219">readUnlock</a>()</pre> +<pre>protected abstract void <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.227">readUnlock</a>()</pre> <div class="block">Removes the read lock on this config file.</div> </li> </ul> @@ -929,7 +1020,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <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.233">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>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.241">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, <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> def)</pre> <div class="block">Returns the specified value as a string from the config file.</div> <dl> @@ -947,7 +1038,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>removeString</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.246">removeString</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> +<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.254">removeString</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">Removes an entry with the specified key.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -965,7 +1056,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>getObject</h4> -<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.303">getObject</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>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.311">getObject</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, <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> type, <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> @@ -1024,13 +1115,42 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? </dl> </li> </ul> +<a name="getObject-java.lang.String-org.apache.juneau.parser.Parser-java.lang.reflect.Type-java.lang.reflect.Type...-"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>getObject</h4> +<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.330">getObject</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, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + <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> type, + <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">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 allows you to specify the parser to use to parse the value.</div> +<dl> +<dt><span class="paramLabel">Parameters:</span></dt> +<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>parser</code> - The parser to use for parsing the object. + If <jk>null</jk>, then uses the predefined parser on the config file.</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> +<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> + <br>Ignored if the main type is not a map or collection.</dd> +<dt><span class="returnLabel">Returns:</span></dt> +<dd>The value, or <jk>null</jk> if the section or key does not exist.</dd> +<dt><span class="throwsLabel">Throws:</span></dt> +<dd><code><a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></code> - If parser could not parse the value or if a parser is not registered with this config file.</dd> +</dl> +</li> +</ul> <a name="getObject-java.lang.String-java.lang.Class-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getObject</h4> -<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.340">getObject</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>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.367">getObject</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, <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. @@ -1070,6 +1190,34 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? </dl> </li> </ul> +<a name="getObject-java.lang.String-org.apache.juneau.parser.Parser-java.lang.Class-"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>getObject</h4> +<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.383">getObject</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, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + <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.Class-"><code>getObject(String, Class)</code></a> but allows you to specify the parser to use to parse the value.</div> +<dl> +<dt><span class="paramLabel">Type Parameters:</span></dt> +<dd><code>T</code> - The class type of the object being created.</dd> +<dt><span class="paramLabel">Parameters:</span></dt> +<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>parser</code> - The parser to use for parsing the object. + If <jk>null</jk>, then uses the predefined parser on the config file.</dd> +<dd><code>type</code> - The object type to create.</dd> +<dt><span class="returnLabel">Returns:</span></dt> +<dd>The parsed object.</dd> +<dt><span class="throwsLabel">Throws:</span></dt> +<dd><code><a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></code> - If the input contains a syntax error or is malformed, or is not valid for the specified type.</dd> +<dt><span class="seeLabel">See Also:</span></dt> +<dd><a href="../../../../org/apache/juneau/BeanSession.html#getClassMeta-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>for argument syntax for maps and collections.</code></a></dd> +</dl> +</li> +</ul> <a name="getObjectWithDefault-java.lang.String-java.lang.Object-java.lang.Class-"> <!-- --> </a><a name="getObjectWithDefault-java.lang.String-T-java.lang.Class-"> @@ -1078,7 +1226,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>getObjectWithDefault</h4> -<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.359">getObjectWithDefault</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>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.401">getObjectWithDefault</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, T def, <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> @@ -1097,6 +1245,34 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? </dl> </li> </ul> +<a name="getObjectWithDefault-java.lang.String-org.apache.juneau.parser.Parser-java.lang.Object-java.lang.Class-"> +<!-- --> +</a><a name="getObjectWithDefault-java.lang.String-org.apache.juneau.parser.Parser-T-java.lang.Class-"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>getObjectWithDefault</h4> +<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.417">getObjectWithDefault</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, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + T def, + <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#getObjectWithDefault-java.lang.String-T-java.lang.Class-"><code>getObjectWithDefault(String, Object, Class)</code></a> but allows you to specify the parser to use to parse the value.</div> +<dl> +<dt><span class="paramLabel">Parameters:</span></dt> +<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>parser</code> - The parser to use for parsing the object. + If <jk>null</jk>, then uses the predefined parser on the config file.</dd> +<dd><code>def</code> - The default value if section or key does not exist.</dd> +<dd><code>type</code> - The class to convert the value to.</dd> +<dt><span class="returnLabel">Returns:</span></dt> +<dd>The value, or <jk>null</jk> if the section or key does not exist.</dd> +<dt><span class="throwsLabel">Throws:</span></dt> +<dd><code><a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></code> - If parser could not parse the value or if a parser is not registered with this config file.</dd> +</dl> +</li> +</ul> <a name="getObjectWithDefault-java.lang.String-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type:A-"> <!-- --> </a><a name="getObjectWithDefault-java.lang.String-T-java.lang.reflect.Type-java.lang.reflect.Type...-"> @@ -1105,7 +1281,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? <ul class="blockList"> <li class="blockList"> <h4>getObjectWithDefault</h4> -<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.382">getObjectWithDefault</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>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.440">getObjectWithDefault</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, T def, <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> type, <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) @@ -1129,13 +1305,46 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html? </dl> </li> </ul> +<a name="getObjectWithDefault-java.lang.String-org.apache.juneau.parser.Parser-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type:A-"> +<!-- --> +</a><a name="getObjectWithDefault-java.lang.String-org.apache.juneau.parser.Parser-T-java.lang.reflect.Type-java.lang.reflect.Type...-"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>getObjectWithDefault</h4> +<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/ini/ConfigFile.html#line.460">getObjectWithDefault</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, + <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser, + T def, + <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> type, + <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">Same as <a href="../../../../org/apache/juneau/ini/ConfigFile.html#getObjectWithDefault-java.lang.String-T-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>getObjectWithDefault(String, Object, Type, Type...)</code></a> but allows you to specify the parser to use to parse the value.</div> +<dl> +<dt><span class="paramLabel">Parameters:</span></dt> +<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>parser</code> - The parser to use for parsing the object. + If <jk>null</jk>, then uses the predefined parser on the config file.</dd> +<dd><code>def</code> - The default value if section or key does not exist.</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> +<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> + <br>Ignored if the main type is not a map or collection.</dd> +<dt><span class="returnLabel">Returns:</span></dt> +<dd>The value, or <jk>null</jk> if the section or key does not exist.</dd> +<dt><span class="throwsLabel">Throws:</span></dt> +<dd><code><a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></code> - If parser could not parse the value or if a parser is not registered with this config file.</dd> +</dl> +</li> +</ul> <a name="getObject-java.lang.String-java.lang.String-java.lang.Class-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getObject</h4> -<pre>public final <T> T <a href="../../../../
<TRUNCATED>
