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 2017/11/26 19:46:17 UTC
[08/51] [partial] juneau-website git commit: New
Security-Best-Practices section in javadocs.
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/81ca4d4d/content/site/apidocs/src-html/org/apache/juneau/PropertyStore.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/PropertyStore.html b/content/site/apidocs/src-html/org/apache/juneau/PropertyStore.html
index abcea68..dbabd61 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/PropertyStore.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/PropertyStore.html
@@ -284,11 +284,11 @@
<span class="sourceLineNo">276</span> ReaderParser defaultParser;<a name="line.276"></a>
<span class="sourceLineNo">277</span><a name="line.277"></a>
<span class="sourceLineNo">278</span> // Bean session for converting strings to POJOs.<a name="line.278"></a>
-<span class="sourceLineNo">279</span> private static BeanSession beanSession;<a name="line.279"></a>
+<span class="sourceLineNo">279</span> private volatile static BeanSession beanSession;<a name="line.279"></a>
<span class="sourceLineNo">280</span><a name="line.280"></a>
<span class="sourceLineNo">281</span> // Used to keep properties in alphabetical order regardless of whether<a name="line.281"></a>
<span class="sourceLineNo">282</span> // they're not strings.<a name="line.282"></a>
-<span class="sourceLineNo">283</span> private static Comparator<Object> PROPERTY_COMPARATOR = new Comparator<Object>() {<a name="line.283"></a>
+<span class="sourceLineNo">283</span> static final Comparator<Object> PROPERTY_COMPARATOR = new Comparator<Object>() {<a name="line.283"></a>
<span class="sourceLineNo">284</span> @Override<a name="line.284"></a>
<span class="sourceLineNo">285</span> public int compare(Object o1, Object o2) {<a name="line.285"></a>
<span class="sourceLineNo">286</span> return unswap(o1).toString().compareTo(unswap(o2).toString());<a name="line.286"></a>
@@ -727,7 +727,7 @@
<span class="sourceLineNo">719</span> if (pm != null)<a name="line.719"></a>
<span class="sourceLineNo">720</span> o = pm.get(name, type, null);<a name="line.720"></a>
<span class="sourceLineNo">721</span> if (o == null && def != null)<a name="line.721"></a>
-<span class="sourceLineNo">722</span> o = ClassUtils.newInstance(type, def, args);<a name="line.722"></a>
+<span class="sourceLineNo">722</span> o = getBeanSession().newInstance(type, def, args);<a name="line.722"></a>
<span class="sourceLineNo">723</span> if (o == null)<a name="line.723"></a>
<span class="sourceLineNo">724</span> return null;<a name="line.724"></a>
<span class="sourceLineNo">725</span> if (ClassUtils.isParentClass(type, o.getClass()))<a name="line.725"></a>
@@ -918,7 +918,7 @@
<span class="sourceLineNo">910</span> * Hashcode generator that treats strings and primitive values the same.<a name="line.910"></a>
<span class="sourceLineNo">911</span> * (e.g. <code>123</code> and <js>"123"</js> result in the same hashcode.)<a name="line.911"></a>
<span class="sourceLineNo">912</span> */<a name="line.912"></a>
-<span class="sourceLineNo">913</span> private static class NormalizingHashCode extends HashCode {<a name="line.913"></a>
+<span class="sourceLineNo">913</span> static final class NormalizingHashCode extends HashCode {<a name="line.913"></a>
<span class="sourceLineNo">914</span> @Override /* HashCode */<a name="line.914"></a>
<span class="sourceLineNo">915</span> protected Object unswap(Object o) {<a name="line.915"></a>
<span class="sourceLineNo">916</span> return PropertyStore.unswap(o);<a name="line.916"></a>
@@ -935,7 +935,7 @@
<span class="sourceLineNo">927</span> * The {@link PropertyMap#hashCode()} and {@link PropertyMap#equals(Object)} methods can be used to compare with<a name="line.927"></a>
<span class="sourceLineNo">928</span> * other property maps.<a name="line.928"></a>
<span class="sourceLineNo">929</span> */<a name="line.929"></a>
-<span class="sourceLineNo">930</span> public class PropertyMap {<a name="line.930"></a>
+<span class="sourceLineNo">930</span> final class PropertyMap {<a name="line.930"></a>
<span class="sourceLineNo">931</span><a name="line.931"></a>
<span class="sourceLineNo">932</span> private final Map<String,Property> map = new ConcurrentSkipListMap<>();<a name="line.932"></a>
<span class="sourceLineNo">933</span> private volatile int hashCode = 0;<a name="line.933"></a>
@@ -943,7 +943,7 @@
<span class="sourceLineNo">935</span> private final Lock rl = lock.readLock(), wl = lock.writeLock();<a name="line.935"></a>
<span class="sourceLineNo">936</span> private final String prefix;<a name="line.936"></a>
<span class="sourceLineNo">937</span><a name="line.937"></a>
-<span class="sourceLineNo">938</span> private PropertyMap(String prefix) {<a name="line.938"></a>
+<span class="sourceLineNo">938</span> PropertyMap(String prefix) {<a name="line.938"></a>
<span class="sourceLineNo">939</span> this.prefix = prefix;<a name="line.939"></a>
<span class="sourceLineNo">940</span> prefix = prefix + '.';<a name="line.940"></a>
<span class="sourceLineNo">941</span> Properties p = System.getProperties();<a name="line.941"></a>
@@ -955,7 +955,7 @@
<span class="sourceLineNo">947</span> /**<a name="line.947"></a>
<span class="sourceLineNo">948</span> * Copy constructor.<a name="line.948"></a>
<span class="sourceLineNo">949</span> */<a name="line.949"></a>
-<span class="sourceLineNo">950</span> private PropertyMap(PropertyMap orig, PropertyMap apply) {<a name="line.950"></a>
+<span class="sourceLineNo">950</span> PropertyMap(PropertyMap orig, PropertyMap apply) {<a name="line.950"></a>
<span class="sourceLineNo">951</span> this.prefix = apply.prefix;<a name="line.951"></a>
<span class="sourceLineNo">952</span> if (orig != null)<a name="line.952"></a>
<span class="sourceLineNo">953</span> for (Map.Entry<String,Property> e : orig.map.entrySet())<a name="line.953"></a>
@@ -981,7 +981,7 @@
<span class="sourceLineNo">973</span> * @param def The default value if the specified property is not set.<a name="line.973"></a>
<span class="sourceLineNo">974</span> * @return The property value.<a name="line.974"></a>
<span class="sourceLineNo">975</span> */<a name="line.975"></a>
-<span class="sourceLineNo">976</span> public <T> T get(String name, Class<T> type, T def) {<a name="line.976"></a>
+<span class="sourceLineNo">976</span> <T> T get(String name, Class<T> type, T def) {<a name="line.976"></a>
<span class="sourceLineNo">977</span> rl.lock();<a name="line.977"></a>
<span class="sourceLineNo">978</span> try {<a name="line.978"></a>
<span class="sourceLineNo">979</span> Property p = map.get(name);<a name="line.979"></a>
@@ -1013,7 +1013,7 @@
<span class="sourceLineNo">1005</span> * @return The property value.<a name="line.1005"></a>
<span class="sourceLineNo">1006</span> */<a name="line.1006"></a>
<span class="sourceLineNo">1007</span> @SuppressWarnings("unchecked")<a name="line.1007"></a>
-<span class="sourceLineNo">1008</span> public <K,V> Map<K,V> getMap(String name, Class<K> keyType, Class<V> valueType, Map<K,V> def) {<a name="line.1008"></a>
+<span class="sourceLineNo">1008</span> <K,V> Map<K,V> getMap(String name, Class<K> keyType, Class<V> valueType, Map<K,V> def) {<a name="line.1008"></a>
<span class="sourceLineNo">1009</span> rl.lock();<a name="line.1009"></a>
<span class="sourceLineNo">1010</span> try {<a name="line.1010"></a>
<span class="sourceLineNo">1011</span> Property p = map.get(name);<a name="line.1011"></a>
@@ -1043,7 +1043,7 @@
<span class="sourceLineNo">1035</span> *<a name="line.1035"></a>
<span class="sourceLineNo">1036</span> * @return A new {@link LinkedHashMap} with all values in this property map.<a name="line.1036"></a>
<span class="sourceLineNo">1037</span> */<a name="line.1037"></a>
-<span class="sourceLineNo">1038</span> public Map<String,Object> asMap() {<a name="line.1038"></a>
+<span class="sourceLineNo">1038</span> Map<String,Object> asMap() {<a name="line.1038"></a>
<span class="sourceLineNo">1039</span> rl.lock();<a name="line.1039"></a>
<span class="sourceLineNo">1040</span> try {<a name="line.1040"></a>
<span class="sourceLineNo">1041</span> Map<String,Object> m = new LinkedHashMap<>();<a name="line.1041"></a>
@@ -1055,7 +1055,7 @@
<span class="sourceLineNo">1047</span> }<a name="line.1047"></a>
<span class="sourceLineNo">1048</span> }<a name="line.1048"></a>
<span class="sourceLineNo">1049</span><a name="line.1049"></a>
-<span class="sourceLineNo">1050</span> private void set(String name, Object value) {<a name="line.1050"></a>
+<span class="sourceLineNo">1050</span> void set(String name, Object value) {<a name="line.1050"></a>
<span class="sourceLineNo">1051</span> wl.lock();<a name="line.1051"></a>
<span class="sourceLineNo">1052</span> hashCode = 0;<a name="line.1052"></a>
<span class="sourceLineNo">1053</span> try {<a name="line.1053"></a>
@@ -1068,7 +1068,7 @@
<span class="sourceLineNo">1060</span> }<a name="line.1060"></a>
<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
<span class="sourceLineNo">1062</span><a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> private void addTo(String name, Object value) {<a name="line.1063"></a>
+<span class="sourceLineNo">1063</span> void addTo(String name, Object value) {<a name="line.1063"></a>
<span class="sourceLineNo">1064</span> wl.lock();<a name="line.1064"></a>
<span class="sourceLineNo">1065</span> hashCode = 0;<a name="line.1065"></a>
<span class="sourceLineNo">1066</span> try {<a name="line.1066"></a>
@@ -1080,7 +1080,7 @@
<span class="sourceLineNo">1072</span> }<a name="line.1072"></a>
<span class="sourceLineNo">1073</span> }<a name="line.1073"></a>
<span class="sourceLineNo">1074</span><a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> private void putTo(String name, Object key, Object value) {<a name="line.1075"></a>
+<span class="sourceLineNo">1075</span> void putTo(String name, Object key, Object value) {<a name="line.1075"></a>
<span class="sourceLineNo">1076</span> wl.lock();<a name="line.1076"></a>
<span class="sourceLineNo">1077</span> hashCode = 0;<a name="line.1077"></a>
<span class="sourceLineNo">1078</span> try {<a name="line.1078"></a>
@@ -1092,7 +1092,7 @@
<span class="sourceLineNo">1084</span> }<a name="line.1084"></a>
<span class="sourceLineNo">1085</span> }<a name="line.1085"></a>
<span class="sourceLineNo">1086</span><a name="line.1086"></a>
-<span class="sourceLineNo">1087</span> private void putTo(String name, Object value) {<a name="line.1087"></a>
+<span class="sourceLineNo">1087</span> void putTo(String name, Object value) {<a name="line.1087"></a>
<span class="sourceLineNo">1088</span> wl.lock();<a name="line.1088"></a>
<span class="sourceLineNo">1089</span> hashCode = 0;<a name="line.1089"></a>
<span class="sourceLineNo">1090</span> try {<a name="line.1090"></a>
@@ -1104,7 +1104,7 @@
<span class="sourceLineNo">1096</span> }<a name="line.1096"></a>
<span class="sourceLineNo">1097</span> }<a name="line.1097"></a>
<span class="sourceLineNo">1098</span><a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> private void removeFrom(String name, Object value) {<a name="line.1099"></a>
+<span class="sourceLineNo">1099</span> void removeFrom(String name, Object value) {<a name="line.1099"></a>
<span class="sourceLineNo">1100</span> wl.lock();<a name="line.1100"></a>
<span class="sourceLineNo">1101</span> hashCode = 0;<a name="line.1101"></a>
<span class="sourceLineNo">1102</span> try {<a name="line.1102"></a>
@@ -1154,10 +1154,10 @@
<span class="sourceLineNo">1146</span> }<a name="line.1146"></a>
<span class="sourceLineNo">1147</span><a name="line.1147"></a>
<span class="sourceLineNo">1148</span> private abstract static class Property {<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> private final String name, type;<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> private final Object value;<a name="line.1150"></a>
+<span class="sourceLineNo">1149</span> final String name, type;<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span> final Object value;<a name="line.1150"></a>
<span class="sourceLineNo">1151</span><a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> private static Property create(String name, Object value) {<a name="line.1152"></a>
+<span class="sourceLineNo">1152</span> static final Property create(String name, Object value) {<a name="line.1152"></a>
<span class="sourceLineNo">1153</span> if (name.endsWith(".set"))<a name="line.1153"></a>
<span class="sourceLineNo">1154</span> return new SetProperty(name, value);<a name="line.1154"></a>
<span class="sourceLineNo">1155</span> else if (name.endsWith(".list"))<a name="line.1155"></a>
@@ -1219,7 +1219,7 @@
<span class="sourceLineNo">1211</span> }<a name="line.1211"></a>
<span class="sourceLineNo">1212</span> }<a name="line.1212"></a>
<span class="sourceLineNo">1213</span><a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> private static class SimpleProperty extends Property {<a name="line.1214"></a>
+<span class="sourceLineNo">1214</span> private static final class SimpleProperty extends Property {<a name="line.1214"></a>
<span class="sourceLineNo">1215</span><a name="line.1215"></a>
<span class="sourceLineNo">1216</span> SimpleProperty(String name, Object value) {<a name="line.1216"></a>
<span class="sourceLineNo">1217</span> super(name, "SIMPLE", value);<a name="line.1217"></a>
@@ -1227,10 +1227,10 @@
<span class="sourceLineNo">1219</span> }<a name="line.1219"></a>
<span class="sourceLineNo">1220</span><a name="line.1220"></a>
<span class="sourceLineNo">1221</span> @SuppressWarnings({"unchecked"})<a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> private static class SetProperty extends Property {<a name="line.1222"></a>
+<span class="sourceLineNo">1222</span> private static final class SetProperty extends Property {<a name="line.1222"></a>
<span class="sourceLineNo">1223</span> private final Set<Object> value;<a name="line.1223"></a>
<span class="sourceLineNo">1224</span><a name="line.1224"></a>
-<span class="sourceLineNo">1225</span> private SetProperty(String name, Object value) {<a name="line.1225"></a>
+<span class="sourceLineNo">1225</span> SetProperty(String name, Object value) {<a name="line.1225"></a>
<span class="sourceLineNo">1226</span> super(name, "SET", new ConcurrentSkipListSet<>(PROPERTY_COMPARATOR));<a name="line.1226"></a>
<span class="sourceLineNo">1227</span> this.value = (Set<Object>)value();<a name="line.1227"></a>
<span class="sourceLineNo">1228</span> add(value);<a name="line.1228"></a>
@@ -1287,10 +1287,10 @@
<span class="sourceLineNo">1279</span> }<a name="line.1279"></a>
<span class="sourceLineNo">1280</span><a name="line.1280"></a>
<span class="sourceLineNo">1281</span> @SuppressWarnings({"unchecked"})<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> private static class ListProperty extends Property {<a name="line.1282"></a>
+<span class="sourceLineNo">1282</span> private static final class ListProperty extends Property {<a name="line.1282"></a>
<span class="sourceLineNo">1283</span> private final LinkedList<Object> value;<a name="line.1283"></a>
<span class="sourceLineNo">1284</span><a name="line.1284"></a>
-<span class="sourceLineNo">1285</span> private ListProperty(String name, Object value) {<a name="line.1285"></a>
+<span class="sourceLineNo">1285</span> ListProperty(String name, Object value) {<a name="line.1285"></a>
<span class="sourceLineNo">1286</span> super(name, "LIST", new LinkedList<>());<a name="line.1286"></a>
<span class="sourceLineNo">1287</span> this.value = (LinkedList<Object>)value();<a name="line.1287"></a>
<span class="sourceLineNo">1288</span> add(value);<a name="line.1288"></a>
@@ -1348,7 +1348,7 @@
<span class="sourceLineNo">1340</span> }<a name="line.1340"></a>
<span class="sourceLineNo">1341</span><a name="line.1341"></a>
<span class="sourceLineNo">1342</span> @SuppressWarnings({"unchecked","rawtypes"})<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> private static class MapProperty extends Property {<a name="line.1343"></a>
+<span class="sourceLineNo">1343</span> private static final class MapProperty extends Property {<a name="line.1343"></a>
<span class="sourceLineNo">1344</span> final Map<Object,Object> value;<a name="line.1344"></a>
<span class="sourceLineNo">1345</span><a name="line.1345"></a>
<span class="sourceLineNo">1346</span> MapProperty(String name, Object value) {<a name="line.1346"></a>
@@ -1392,7 +1392,7 @@
<span class="sourceLineNo">1384</span> * @param o The object to normalize.<a name="line.1384"></a>
<span class="sourceLineNo">1385</span> * @return The normalized object.<a name="line.1385"></a>
<span class="sourceLineNo">1386</span> */<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> private static final Object unswap(Object o) {<a name="line.1387"></a>
+<span class="sourceLineNo">1387</span> static Object unswap(Object o) {<a name="line.1387"></a>
<span class="sourceLineNo">1388</span> if (o instanceof Class)<a name="line.1388"></a>
<span class="sourceLineNo">1389</span> return ((Class<?>)o).getName();<a name="line.1389"></a>
<span class="sourceLineNo">1390</span> if (o instanceof Number || o instanceof Boolean)<a name="line.1390"></a>
@@ -1400,7 +1400,7 @@
<span class="sourceLineNo">1392</span> return o;<a name="line.1392"></a>
<span class="sourceLineNo">1393</span> }<a name="line.1393"></a>
<span class="sourceLineNo">1394</span><a name="line.1394"></a>
-<span class="sourceLineNo">1395</span> private static BeanSession getBeanSession() {<a name="line.1395"></a>
+<span class="sourceLineNo">1395</span> static BeanSession getBeanSession() {<a name="line.1395"></a>
<span class="sourceLineNo">1396</span> if (beanSession == null && BeanContext.DEFAULT != null)<a name="line.1396"></a>
<span class="sourceLineNo">1397</span> beanSession = BeanContext.DEFAULT.createSession();<a name="line.1397"></a>
<span class="sourceLineNo">1398</span> return beanSession;<a name="line.1398"></a>
@@ -1413,7 +1413,7 @@
<span class="sourceLineNo">1405</span> * Note that a bean session will not be available when constructing the BeanContext.DEFAULT context.<a name="line.1405"></a>
<span class="sourceLineNo">1406</span> * (it's a chicken-and-egg thing).<a name="line.1406"></a>
<span class="sourceLineNo">1407</span> */<a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> private static boolean isBeanSessionAvailable() {<a name="line.1408"></a>
+<span class="sourceLineNo">1408</span> static boolean isBeanSessionAvailable() {<a name="line.1408"></a>
<span class="sourceLineNo">1409</span> return getBeanSession() != null;<a name="line.1409"></a>
<span class="sourceLineNo">1410</span> }<a name="line.1410"></a>
<span class="sourceLineNo">1411</span><a name="line.1411"></a>
@@ -1422,7 +1422,7 @@
<span class="sourceLineNo">1414</span> * Basically mean both objects are equal if they're the same when converted to strings.<a name="line.1414"></a>
<span class="sourceLineNo">1415</span> */<a name="line.1415"></a>
<span class="sourceLineNo">1416</span> @SuppressWarnings({ "rawtypes" })<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> private static boolean same(Object o1, Object o2) {<a name="line.1417"></a>
+<span class="sourceLineNo">1417</span> static boolean same(Object o1, Object o2) {<a name="line.1417"></a>
<span class="sourceLineNo">1418</span> if (o1 == o2)<a name="line.1418"></a>
<span class="sourceLineNo">1419</span> return true;<a name="line.1419"></a>
<span class="sourceLineNo">1420</span> if (o1 instanceof Map) {<a name="line.1420"></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/81ca4d4d/content/site/apidocs/src-html/org/apache/juneau/Session.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/Session.html b/content/site/apidocs/src-html/org/apache/juneau/Session.html
index e6eddc0..5129e6c 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/Session.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/Session.html
@@ -22,248 +22,235 @@
<span class="sourceLineNo">014</span><a name="line.14"></a>
<span class="sourceLineNo">015</span>import static org.apache.juneau.internal.StringUtils.*;<a name="line.15"></a>
<span class="sourceLineNo">016</span><a name="line.16"></a>
-<span class="sourceLineNo">017</span>import java.io.Closeable;<a name="line.17"></a>
-<span class="sourceLineNo">018</span>import java.text.*;<a name="line.18"></a>
-<span class="sourceLineNo">019</span>import java.util.*;<a name="line.19"></a>
-<span class="sourceLineNo">020</span><a name="line.20"></a>
-<span class="sourceLineNo">021</span>import org.apache.juneau.annotation.*;<a name="line.21"></a>
-<span class="sourceLineNo">022</span>import org.apache.juneau.internal.*;<a name="line.22"></a>
-<span class="sourceLineNo">023</span>import org.apache.juneau.json.*;<a name="line.23"></a>
-<span class="sourceLineNo">024</span>import org.apache.juneau.serializer.*;<a name="line.24"></a>
-<span class="sourceLineNo">025</span><a name="line.25"></a>
-<span class="sourceLineNo">026</span>/**<a name="line.26"></a>
-<span class="sourceLineNo">027</span> * A one-time-use non-thread-safe object that's meant to be used once and then thrown away.<a name="line.27"></a>
-<span class="sourceLineNo">028</span> *<a name="line.28"></a>
-<span class="sourceLineNo">029</span> * <p><a name="line.29"></a>
-<span class="sourceLineNo">030</span> * Serializers and parsers use session objects to retrieve config properties and to use it as a scratchpad during<a name="line.30"></a>
-<span class="sourceLineNo">031</span> * serialize and parse actions.<a name="line.31"></a>
-<span class="sourceLineNo">032</span> *<a name="line.32"></a>
-<span class="sourceLineNo">033</span> * @see PropertyStore<a name="line.33"></a>
-<span class="sourceLineNo">034</span> */<a name="line.34"></a>
-<span class="sourceLineNo">035</span>public abstract class Session implements Closeable {<a name="line.35"></a>
-<span class="sourceLineNo">036</span><a name="line.36"></a>
-<span class="sourceLineNo">037</span> private JuneauLogger logger;<a name="line.37"></a>
-<span class="sourceLineNo">038</span><a name="line.38"></a>
-<span class="sourceLineNo">039</span> private final ObjectMap properties;<a name="line.39"></a>
-<span class="sourceLineNo">040</span> private final Context ctx;<a name="line.40"></a>
-<span class="sourceLineNo">041</span> private Map<String,Object> cache;<a name="line.41"></a>
-<span class="sourceLineNo">042</span> private boolean closed;<a name="line.42"></a>
-<span class="sourceLineNo">043</span> private List<String> warnings; // Any warnings encountered.<a name="line.43"></a>
-<span class="sourceLineNo">044</span><a name="line.44"></a>
-<span class="sourceLineNo">045</span><a name="line.45"></a>
-<span class="sourceLineNo">046</span> /**<a name="line.46"></a>
-<span class="sourceLineNo">047</span> * Default constructor.<a name="line.47"></a>
-<span class="sourceLineNo">048</span> *<a name="line.48"></a>
-<span class="sourceLineNo">049</span> * @param ctx<a name="line.49"></a>
-<span class="sourceLineNo">050</span> * The context creating this session object.<a name="line.50"></a>
-<span class="sourceLineNo">051</span> * The context contains all the configuration settings for the session.<a name="line.51"></a>
-<span class="sourceLineNo">052</span> * @param args<a name="line.52"></a>
-<span class="sourceLineNo">053</span> * Runtime arguments.<a name="line.53"></a>
-<span class="sourceLineNo">054</span> */<a name="line.54"></a>
-<span class="sourceLineNo">055</span> protected Session(final Context ctx, SessionArgs args) {<a name="line.55"></a>
-<span class="sourceLineNo">056</span> this.ctx = ctx;<a name="line.56"></a>
-<span class="sourceLineNo">057</span> this.properties = args.properties != null ? args.properties : ObjectMap.EMPTY_MAP;<a name="line.57"></a>
-<span class="sourceLineNo">058</span> }<a name="line.58"></a>
-<span class="sourceLineNo">059</span><a name="line.59"></a>
-<span class="sourceLineNo">060</span> /**<a name="line.60"></a>
-<span class="sourceLineNo">061</span> * Returns the session-level properties.<a name="line.61"></a>
-<span class="sourceLineNo">062</span> *<a name="line.62"></a>
-<span class="sourceLineNo">063</span> * @return The session-level properties.<a name="line.63"></a>
-<span class="sourceLineNo">064</span> */<a name="line.64"></a>
-<span class="sourceLineNo">065</span> protected final ObjectMap getProperties() {<a name="line.65"></a>
-<span class="sourceLineNo">066</span> return properties;<a name="line.66"></a>
-<span class="sourceLineNo">067</span> }<a name="line.67"></a>
-<span class="sourceLineNo">068</span><a name="line.68"></a>
-<span class="sourceLineNo">069</span> /**<a name="line.69"></a>
-<span class="sourceLineNo">070</span> * Returns the session property with the specified key.<a name="line.70"></a>
-<span class="sourceLineNo">071</span> *<a name="line.71"></a>
-<span class="sourceLineNo">072</span> * <p><a name="line.72"></a>
-<span class="sourceLineNo">073</span> * The order of lookup for the property is as follows:<a name="line.73"></a>
-<span class="sourceLineNo">074</span> * <ul><a name="line.74"></a>
-<span class="sourceLineNo">075</span> * <li>Override property passed in through the constructor.<a name="line.75"></a>
-<span class="sourceLineNo">076</span> * <li>Property defined on the context object.<a name="line.76"></a>
-<span class="sourceLineNo">077</span> * <li>System.property.<a name="line.77"></a>
-<span class="sourceLineNo">078</span> * </ul><a name="line.78"></a>
-<span class="sourceLineNo">079</span> *<a name="line.79"></a>
-<span class="sourceLineNo">080</span> * @param key The property key.<a name="line.80"></a>
-<span class="sourceLineNo">081</span> * @return The property value, or <jk>null</jk> if it doesn't exist.<a name="line.81"></a>
-<span class="sourceLineNo">082</span> */<a name="line.82"></a>
-<span class="sourceLineNo">083</span> public final String getStringProperty(String key) {<a name="line.83"></a>
-<span class="sourceLineNo">084</span> return getStringProperty(key, null);<a name="line.84"></a>
-<span class="sourceLineNo">085</span> }<a name="line.85"></a>
-<span class="sourceLineNo">086</span><a name="line.86"></a>
-<span class="sourceLineNo">087</span> /**<a name="line.87"></a>
-<span class="sourceLineNo">088</span> * Same as {@link #getStringProperty(String)} but with a default value.<a name="line.88"></a>
-<span class="sourceLineNo">089</span> *<a name="line.89"></a>
-<span class="sourceLineNo">090</span> * @param key The property key.<a name="line.90"></a>
-<span class="sourceLineNo">091</span> * @param def The default value if the property doesn't exist or is <jk>null</jk>.<a name="line.91"></a>
-<span class="sourceLineNo">092</span> * @return The property value.<a name="line.92"></a>
-<span class="sourceLineNo">093</span> */<a name="line.93"></a>
-<span class="sourceLineNo">094</span> public final String getStringProperty(String key, String def) {<a name="line.94"></a>
-<span class="sourceLineNo">095</span> Object v = properties.get(key);<a name="line.95"></a>
+<span class="sourceLineNo">017</span>import java.text.*;<a name="line.17"></a>
+<span class="sourceLineNo">018</span>import java.util.*;<a name="line.18"></a>
+<span class="sourceLineNo">019</span><a name="line.19"></a>
+<span class="sourceLineNo">020</span>import org.apache.juneau.annotation.*;<a name="line.20"></a>
+<span class="sourceLineNo">021</span>import org.apache.juneau.internal.*;<a name="line.21"></a>
+<span class="sourceLineNo">022</span>import org.apache.juneau.json.*;<a name="line.22"></a>
+<span class="sourceLineNo">023</span>import org.apache.juneau.serializer.*;<a name="line.23"></a>
+<span class="sourceLineNo">024</span><a name="line.24"></a>
+<span class="sourceLineNo">025</span>/**<a name="line.25"></a>
+<span class="sourceLineNo">026</span> * A one-time-use non-thread-safe object that's meant to be used once and then thrown away.<a name="line.26"></a>
+<span class="sourceLineNo">027</span> *<a name="line.27"></a>
+<span class="sourceLineNo">028</span> * <p><a name="line.28"></a>
+<span class="sourceLineNo">029</span> * Serializers and parsers use session objects to retrieve config properties and to use it as a scratchpad during<a name="line.29"></a>
+<span class="sourceLineNo">030</span> * serialize and parse actions.<a name="line.30"></a>
+<span class="sourceLineNo">031</span> *<a name="line.31"></a>
+<span class="sourceLineNo">032</span> * @see PropertyStore<a name="line.32"></a>
+<span class="sourceLineNo">033</span> */<a name="line.33"></a>
+<span class="sourceLineNo">034</span>public abstract class Session {<a name="line.34"></a>
+<span class="sourceLineNo">035</span><a name="line.35"></a>
+<span class="sourceLineNo">036</span> private JuneauLogger logger;<a name="line.36"></a>
+<span class="sourceLineNo">037</span><a name="line.37"></a>
+<span class="sourceLineNo">038</span> private final ObjectMap properties;<a name="line.38"></a>
+<span class="sourceLineNo">039</span> private final Context ctx;<a name="line.39"></a>
+<span class="sourceLineNo">040</span> private Map<String,Object> cache;<a name="line.40"></a>
+<span class="sourceLineNo">041</span> private List<String> warnings; // Any warnings encountered.<a name="line.41"></a>
+<span class="sourceLineNo">042</span><a name="line.42"></a>
+<span class="sourceLineNo">043</span><a name="line.43"></a>
+<span class="sourceLineNo">044</span> /**<a name="line.44"></a>
+<span class="sourceLineNo">045</span> * Default constructor.<a name="line.45"></a>
+<span class="sourceLineNo">046</span> *<a name="line.46"></a>
+<span class="sourceLineNo">047</span> * @param ctx<a name="line.47"></a>
+<span class="sourceLineNo">048</span> * The context creating this session object.<a name="line.48"></a>
+<span class="sourceLineNo">049</span> * The context contains all the configuration settings for the session.<a name="line.49"></a>
+<span class="sourceLineNo">050</span> * @param args<a name="line.50"></a>
+<span class="sourceLineNo">051</span> * Runtime arguments.<a name="line.51"></a>
+<span class="sourceLineNo">052</span> */<a name="line.52"></a>
+<span class="sourceLineNo">053</span> protected Session(final Context ctx, SessionArgs args) {<a name="line.53"></a>
+<span class="sourceLineNo">054</span> this.ctx = ctx;<a name="line.54"></a>
+<span class="sourceLineNo">055</span> this.properties = args.properties != null ? args.properties : ObjectMap.EMPTY_MAP;<a name="line.55"></a>
+<span class="sourceLineNo">056</span> }<a name="line.56"></a>
+<span class="sourceLineNo">057</span><a name="line.57"></a>
+<span class="sourceLineNo">058</span> /**<a name="line.58"></a>
+<span class="sourceLineNo">059</span> * Returns the session-level properties.<a name="line.59"></a>
+<span class="sourceLineNo">060</span> *<a name="line.60"></a>
+<span class="sourceLineNo">061</span> * @return The session-level properties.<a name="line.61"></a>
+<span class="sourceLineNo">062</span> */<a name="line.62"></a>
+<span class="sourceLineNo">063</span> protected final ObjectMap getProperties() {<a name="line.63"></a>
+<span class="sourceLineNo">064</span> return properties;<a name="line.64"></a>
+<span class="sourceLineNo">065</span> }<a name="line.65"></a>
+<span class="sourceLineNo">066</span><a name="line.66"></a>
+<span class="sourceLineNo">067</span> /**<a name="line.67"></a>
+<span class="sourceLineNo">068</span> * Returns the session property with the specified key.<a name="line.68"></a>
+<span class="sourceLineNo">069</span> *<a name="line.69"></a>
+<span class="sourceLineNo">070</span> * <p><a name="line.70"></a>
+<span class="sourceLineNo">071</span> * The order of lookup for the property is as follows:<a name="line.71"></a>
+<span class="sourceLineNo">072</span> * <ul><a name="line.72"></a>
+<span class="sourceLineNo">073</span> * <li>Override property passed in through the constructor.<a name="line.73"></a>
+<span class="sourceLineNo">074</span> * <li>Property defined on the context object.<a name="line.74"></a>
+<span class="sourceLineNo">075</span> * <li>System.property.<a name="line.75"></a>
+<span class="sourceLineNo">076</span> * </ul><a name="line.76"></a>
+<span class="sourceLineNo">077</span> *<a name="line.77"></a>
+<span class="sourceLineNo">078</span> * @param key The property key.<a name="line.78"></a>
+<span class="sourceLineNo">079</span> * @return The property value, or <jk>null</jk> if it doesn't exist.<a name="line.79"></a>
+<span class="sourceLineNo">080</span> */<a name="line.80"></a>
+<span class="sourceLineNo">081</span> public final String getStringProperty(String key) {<a name="line.81"></a>
+<span class="sourceLineNo">082</span> return getStringProperty(key, null);<a name="line.82"></a>
+<span class="sourceLineNo">083</span> }<a name="line.83"></a>
+<span class="sourceLineNo">084</span><a name="line.84"></a>
+<span class="sourceLineNo">085</span> /**<a name="line.85"></a>
+<span class="sourceLineNo">086</span> * Same as {@link #getStringProperty(String)} but with a default value.<a name="line.86"></a>
+<span class="sourceLineNo">087</span> *<a name="line.87"></a>
+<span class="sourceLineNo">088</span> * @param key The property key.<a name="line.88"></a>
+<span class="sourceLineNo">089</span> * @param def The default value if the property doesn't exist or is <jk>null</jk>.<a name="line.89"></a>
+<span class="sourceLineNo">090</span> * @return The property value.<a name="line.90"></a>
+<span class="sourceLineNo">091</span> */<a name="line.91"></a>
+<span class="sourceLineNo">092</span> public final String getStringProperty(String key, String def) {<a name="line.92"></a>
+<span class="sourceLineNo">093</span> Object v = properties.get(key);<a name="line.93"></a>
+<span class="sourceLineNo">094</span> if (v == null)<a name="line.94"></a>
+<span class="sourceLineNo">095</span> v = ctx.getPropertyStore().getProperty(key, String.class, null);<a name="line.95"></a>
<span class="sourceLineNo">096</span> if (v == null)<a name="line.96"></a>
-<span class="sourceLineNo">097</span> v = ctx.getPropertyStore().getProperty(key, String.class, null);<a name="line.97"></a>
-<span class="sourceLineNo">098</span> if (v == null)<a name="line.98"></a>
-<span class="sourceLineNo">099</span> v = def;<a name="line.99"></a>
-<span class="sourceLineNo">100</span> return StringUtils.toString(v);<a name="line.100"></a>
-<span class="sourceLineNo">101</span> }<a name="line.101"></a>
-<span class="sourceLineNo">102</span><a name="line.102"></a>
-<span class="sourceLineNo">103</span> /**<a name="line.103"></a>
-<span class="sourceLineNo">104</span> * Same as {@link #getStringProperty(String)} but transforms the value to the specified type.<a name="line.104"></a>
-<span class="sourceLineNo">105</span> *<a name="line.105"></a>
-<span class="sourceLineNo">106</span> * @param key The property key.<a name="line.106"></a>
-<span class="sourceLineNo">107</span> * @param type The class type of the value.<a name="line.107"></a>
-<span class="sourceLineNo">108</span> *<a name="line.108"></a>
-<span class="sourceLineNo">109</span> * @return The property value.<a name="line.109"></a>
-<span class="sourceLineNo">110</span> */<a name="line.110"></a>
-<span class="sourceLineNo">111</span> public final <T> T getProperty(String key, Class<T> type) {<a name="line.111"></a>
-<span class="sourceLineNo">112</span> return getPropertyWithDefault(key, null, type);<a name="line.112"></a>
-<span class="sourceLineNo">113</span> }<a name="line.113"></a>
-<span class="sourceLineNo">114</span><a name="line.114"></a>
-<span class="sourceLineNo">115</span> /**<a name="line.115"></a>
-<span class="sourceLineNo">116</span> * Same as {@link #getProperty(String,Class)} but with a default value.<a name="line.116"></a>
-<span class="sourceLineNo">117</span> *<a name="line.117"></a>
-<span class="sourceLineNo">118</span> * @param key The property key.<a name="line.118"></a>
-<span class="sourceLineNo">119</span> * @param def The default value if the property doesn't exist or is <jk>null</jk>.<a name="line.119"></a>
-<span class="sourceLineNo">120</span> * @param type The class type of the value.<a name="line.120"></a>
-<span class="sourceLineNo">121</span> *<a name="line.121"></a>
-<span class="sourceLineNo">122</span> * @return The property value.<a name="line.122"></a>
-<span class="sourceLineNo">123</span> */<a name="line.123"></a>
-<span class="sourceLineNo">124</span> public final <T> T getPropertyWithDefault(String key, T def, Class<T> type) {<a name="line.124"></a>
-<span class="sourceLineNo">125</span> T t = properties.get(key, type);<a name="line.125"></a>
-<span class="sourceLineNo">126</span> if (t == null)<a name="line.126"></a>
-<span class="sourceLineNo">127</span> t = ctx.getPropertyStore().getProperty(key, type, def);<a name="line.127"></a>
-<span class="sourceLineNo">128</span> return t;<a name="line.128"></a>
-<span class="sourceLineNo">129</span> }<a name="line.129"></a>
-<span class="sourceLineNo">130</span><a name="line.130"></a>
-<span class="sourceLineNo">131</span> /**<a name="line.131"></a>
-<span class="sourceLineNo">132</span> * Adds an arbitrary object to this session's cache.<a name="line.132"></a>
-<span class="sourceLineNo">133</span> *<a name="line.133"></a>
-<span class="sourceLineNo">134</span> * <p><a name="line.134"></a>
-<span class="sourceLineNo">135</span> * Can be used to store objects for reuse during a session.<a name="line.135"></a>
-<span class="sourceLineNo">136</span> *<a name="line.136"></a>
-<span class="sourceLineNo">137</span> * @param key The key. Can be any string.<a name="line.137"></a>
-<span class="sourceLineNo">138</span> * @param val The cached object.<a name="line.138"></a>
-<span class="sourceLineNo">139</span> */<a name="line.139"></a>
-<span class="sourceLineNo">140</span> public final void addToCache(String key, Object val) {<a name="line.140"></a>
-<span class="sourceLineNo">141</span> if (cache == null)<a name="line.141"></a>
-<span class="sourceLineNo">142</span> cache = new TreeMap<>();<a name="line.142"></a>
-<span class="sourceLineNo">143</span> cache.put(key, val);<a name="line.143"></a>
-<span class="sourceLineNo">144</span> }<a name="line.144"></a>
-<span class="sourceLineNo">145</span><a name="line.145"></a>
-<span class="sourceLineNo">146</span> /**<a name="line.146"></a>
-<span class="sourceLineNo">147</span> * Adds arbitrary objects to this session's cache.<a name="line.147"></a>
-<span class="sourceLineNo">148</span> *<a name="line.148"></a>
-<span class="sourceLineNo">149</span> * <p><a name="line.149"></a>
-<span class="sourceLineNo">150</span> * Can be used to store objects for reuse during a session.<a name="line.150"></a>
-<span class="sourceLineNo">151</span> *<a name="line.151"></a>
-<span class="sourceLineNo">152</span> * @param cacheObjects<a name="line.152"></a>
-<span class="sourceLineNo">153</span> * The objects to add to this session's cache.<a name="line.153"></a>
-<span class="sourceLineNo">154</span> * No-op if <jk>null</jk>.<a name="line.154"></a>
-<span class="sourceLineNo">155</span> */<a name="line.155"></a>
-<span class="sourceLineNo">156</span> public final void addToCache(Map<String,Object> cacheObjects) {<a name="line.156"></a>
-<span class="sourceLineNo">157</span> if (cacheObjects != null) {<a name="line.157"></a>
-<span class="sourceLineNo">158</span> if (cache == null)<a name="line.158"></a>
-<span class="sourceLineNo">159</span> cache = new TreeMap<>();<a name="line.159"></a>
-<span class="sourceLineNo">160</span> cache.putAll(cacheObjects);<a name="line.160"></a>
-<span class="sourceLineNo">161</span> }<a name="line.161"></a>
-<span class="sourceLineNo">162</span> }<a name="line.162"></a>
-<span class="sourceLineNo">163</span><a name="line.163"></a>
-<span class="sourceLineNo">164</span> /**<a name="line.164"></a>
-<span class="sourceLineNo">165</span> * Returns an object stored in the session cache.<a name="line.165"></a>
-<span class="sourceLineNo">166</span> *<a name="line.166"></a>
-<span class="sourceLineNo">167</span> * @param c The class type of the object.<a name="line.167"></a>
-<span class="sourceLineNo">168</span> * @param key The session object key.<a name="line.168"></a>
-<span class="sourceLineNo">169</span> * @return The cached object, or <jk>null</jk> if it doesn't exist.<a name="line.169"></a>
-<span class="sourceLineNo">170</span> */<a name="line.170"></a>
-<span class="sourceLineNo">171</span> @SuppressWarnings("unchecked")<a name="line.171"></a>
-<span class="sourceLineNo">172</span> public final <T> T getFromCache(Class<T> c, String key) {<a name="line.172"></a>
-<span class="sourceLineNo">173</span> return cache == null ? null : (T)cache.get(key);<a name="line.173"></a>
-<span class="sourceLineNo">174</span> }<a name="line.174"></a>
-<span class="sourceLineNo">175</span><a name="line.175"></a>
-<span class="sourceLineNo">176</span> /**<a name="line.176"></a>
-<span class="sourceLineNo">177</span> * Logs a warning message.<a name="line.177"></a>
-<span class="sourceLineNo">178</span> *<a name="line.178"></a>
-<span class="sourceLineNo">179</span> * @param msg The warning message.<a name="line.179"></a>
-<span class="sourceLineNo">180</span> * @param args Optional {@link MessageFormat}-style arguments.<a name="line.180"></a>
-<span class="sourceLineNo">181</span> */<a name="line.181"></a>
-<span class="sourceLineNo">182</span> public final void addWarning(String msg, Object... args) {<a name="line.182"></a>
-<span class="sourceLineNo">183</span> if (warnings == null)<a name="line.183"></a>
-<span class="sourceLineNo">184</span> warnings = new LinkedList<>();<a name="line.184"></a>
-<span class="sourceLineNo">185</span> getLogger().warning(msg, args);<a name="line.185"></a>
-<span class="sourceLineNo">186</span> warnings.add((warnings.size() + 1) + ": " + format(msg, args));<a name="line.186"></a>
-<span class="sourceLineNo">187</span> }<a name="line.187"></a>
-<span class="sourceLineNo">188</span><a name="line.188"></a>
-<span class="sourceLineNo">189</span> /**<a name="line.189"></a>
-<span class="sourceLineNo">190</span> * Returns <jk>true</jk> if warnings occurred in this session.<a name="line.190"></a>
-<span class="sourceLineNo">191</span> *<a name="line.191"></a>
-<span class="sourceLineNo">192</span> * @return <jk>true</jk> if warnings occurred in this session.<a name="line.192"></a>
-<span class="sourceLineNo">193</span> */<a name="line.193"></a>
-<span class="sourceLineNo">194</span> public final boolean hasWarnings() {<a name="line.194"></a>
-<span class="sourceLineNo">195</span> return warnings != null && warnings.size() > 0;<a name="line.195"></a>
-<span class="sourceLineNo">196</span> }<a name="line.196"></a>
-<span class="sourceLineNo">197</span><a name="line.197"></a>
-<span class="sourceLineNo">198</span> /**<a name="line.198"></a>
-<span class="sourceLineNo">199</span> * Returns the warnings that occurred in this session.<a name="line.199"></a>
-<span class="sourceLineNo">200</span> *<a name="line.200"></a>
-<span class="sourceLineNo">201</span> * @return The warnings that occurred in this session, or <jk>null</jk> if no warnings occurred.<a name="line.201"></a>
-<span class="sourceLineNo">202</span> */<a name="line.202"></a>
-<span class="sourceLineNo">203</span> public final List<String> getWarnings() {<a name="line.203"></a>
-<span class="sourceLineNo">204</span> return warnings;<a name="line.204"></a>
-<span class="sourceLineNo">205</span> }<a name="line.205"></a>
-<span class="sourceLineNo">206</span><a name="line.206"></a>
-<span class="sourceLineNo">207</span> /**<a name="line.207"></a>
-<span class="sourceLineNo">208</span> * Returns the logger associated with this session.<a name="line.208"></a>
-<span class="sourceLineNo">209</span> *<a name="line.209"></a>
-<span class="sourceLineNo">210</span> * <p><a name="line.210"></a>
-<span class="sourceLineNo">211</span> * Subclasses can override this method to provide their own logger.<a name="line.211"></a>
-<span class="sourceLineNo">212</span> *<a name="line.212"></a>
-<span class="sourceLineNo">213</span> * @return The logger associated with this session.<a name="line.213"></a>
-<span class="sourceLineNo">214</span> */<a name="line.214"></a>
-<span class="sourceLineNo">215</span> protected final JuneauLogger getLogger() {<a name="line.215"></a>
-<span class="sourceLineNo">216</span> if (logger == null)<a name="line.216"></a>
-<span class="sourceLineNo">217</span> logger = JuneauLogger.getLogger(getClass());<a name="line.217"></a>
-<span class="sourceLineNo">218</span> return logger;<a name="line.218"></a>
-<span class="sourceLineNo">219</span> }<a name="line.219"></a>
-<span class="sourceLineNo">220</span><a name="line.220"></a>
-<span class="sourceLineNo">221</span> /**<a name="line.221"></a>
-<span class="sourceLineNo">222</span> * Returns the properties defined on this bean context as a simple map for debugging purposes.<a name="line.222"></a>
-<span class="sourceLineNo">223</span> *<a name="line.223"></a>
-<span class="sourceLineNo">224</span> * @return A new map containing the properties defined on this context.<a name="line.224"></a>
-<span class="sourceLineNo">225</span> */<a name="line.225"></a>
-<span class="sourceLineNo">226</span> @Overrideable<a name="line.226"></a>
-<span class="sourceLineNo">227</span> public ObjectMap asMap() {<a name="line.227"></a>
-<span class="sourceLineNo">228</span> return new ObjectMap();<a name="line.228"></a>
-<span class="sourceLineNo">229</span> }<a name="line.229"></a>
-<span class="sourceLineNo">230</span><a name="line.230"></a>
-<span class="sourceLineNo">231</span> @Override /* Object */<a name="line.231"></a>
-<span class="sourceLineNo">232</span> public String toString() {<a name="line.232"></a>
-<span class="sourceLineNo">233</span> try {<a name="line.233"></a>
-<span class="sourceLineNo">234</span> return asMap().toString(JsonSerializer.DEFAULT_LAX_READABLE);<a name="line.234"></a>
-<span class="sourceLineNo">235</span> } catch (SerializeException e) {<a name="line.235"></a>
-<span class="sourceLineNo">236</span> return e.getLocalizedMessage();<a name="line.236"></a>
-<span class="sourceLineNo">237</span> }<a name="line.237"></a>
-<span class="sourceLineNo">238</span> }<a name="line.238"></a>
-<span class="sourceLineNo">239</span><a name="line.239"></a>
-<span class="sourceLineNo">240</span> @Override /* Closeable */<a name="line.240"></a>
-<span class="sourceLineNo">241</span> public void close() {<a name="line.241"></a>
-<span class="sourceLineNo">242</span> closed = true;<a name="line.242"></a>
-<span class="sourceLineNo">243</span> }<a name="line.243"></a>
-<span class="sourceLineNo">244</span> <a name="line.244"></a>
-<span class="sourceLineNo">245</span> /**<a name="line.245"></a>
-<span class="sourceLineNo">246</span> * Returns <jk>true</jk> if this object is closed.<a name="line.246"></a>
-<span class="sourceLineNo">247</span> * @return <jk>true</jk> if this object is closed.<a name="line.247"></a>
-<span class="sourceLineNo">248</span> */<a name="line.248"></a>
-<span class="sourceLineNo">249</span> protected boolean isClosed() {<a name="line.249"></a>
-<span class="sourceLineNo">250</span> return closed;<a name="line.250"></a>
-<span class="sourceLineNo">251</span> }<a name="line.251"></a>
-<span class="sourceLineNo">252</span><a name="line.252"></a>
-<span class="sourceLineNo">253</span> @Override /* Object */<a name="line.253"></a>
-<span class="sourceLineNo">254</span> protected void finalize() throws Throwable {<a name="line.254"></a>
-<span class="sourceLineNo">255</span>// if (! closed)<a name="line.255"></a>
-<span class="sourceLineNo">256</span>// throw new RuntimeException("Session was not closed.");<a name="line.256"></a>
-<span class="sourceLineNo">257</span> }<a name="line.257"></a>
-<span class="sourceLineNo">258</span>}<a name="line.258"></a>
+<span class="sourceLineNo">097</span> v = def;<a name="line.97"></a>
+<span class="sourceLineNo">098</span> return StringUtils.toString(v);<a name="line.98"></a>
+<span class="sourceLineNo">099</span> }<a name="line.99"></a>
+<span class="sourceLineNo">100</span><a name="line.100"></a>
+<span class="sourceLineNo">101</span> /**<a name="line.101"></a>
+<span class="sourceLineNo">102</span> * Same as {@link #getStringProperty(String)} but transforms the value to the specified type.<a name="line.102"></a>
+<span class="sourceLineNo">103</span> *<a name="line.103"></a>
+<span class="sourceLineNo">104</span> * @param key The property key.<a name="line.104"></a>
+<span class="sourceLineNo">105</span> * @param type The class type of the value.<a name="line.105"></a>
+<span class="sourceLineNo">106</span> *<a name="line.106"></a>
+<span class="sourceLineNo">107</span> * @return The property value.<a name="line.107"></a>
+<span class="sourceLineNo">108</span> */<a name="line.108"></a>
+<span class="sourceLineNo">109</span> public final <T> T getProperty(String key, Class<T> type) {<a name="line.109"></a>
+<span class="sourceLineNo">110</span> return getPropertyWithDefault(key, null, type);<a name="line.110"></a>
+<span class="sourceLineNo">111</span> }<a name="line.111"></a>
+<span class="sourceLineNo">112</span><a name="line.112"></a>
+<span class="sourceLineNo">113</span> /**<a name="line.113"></a>
+<span class="sourceLineNo">114</span> * Same as {@link #getProperty(String,Class)} but with a default value.<a name="line.114"></a>
+<span class="sourceLineNo">115</span> *<a name="line.115"></a>
+<span class="sourceLineNo">116</span> * @param key The property key.<a name="line.116"></a>
+<span class="sourceLineNo">117</span> * @param def The default value if the property doesn't exist or is <jk>null</jk>.<a name="line.117"></a>
+<span class="sourceLineNo">118</span> * @param type The class type of the value.<a name="line.118"></a>
+<span class="sourceLineNo">119</span> *<a name="line.119"></a>
+<span class="sourceLineNo">120</span> * @return The property value.<a name="line.120"></a>
+<span class="sourceLineNo">121</span> */<a name="line.121"></a>
+<span class="sourceLineNo">122</span> public final <T> T getPropertyWithDefault(String key, T def, Class<T> type) {<a name="line.122"></a>
+<span class="sourceLineNo">123</span> T t = properties.get(key, type);<a name="line.123"></a>
+<span class="sourceLineNo">124</span> if (t == null)<a name="line.124"></a>
+<span class="sourceLineNo">125</span> t = ctx.getPropertyStore().getProperty(key, type, def);<a name="line.125"></a>
+<span class="sourceLineNo">126</span> return t;<a name="line.126"></a>
+<span class="sourceLineNo">127</span> }<a name="line.127"></a>
+<span class="sourceLineNo">128</span><a name="line.128"></a>
+<span class="sourceLineNo">129</span> /**<a name="line.129"></a>
+<span class="sourceLineNo">130</span> * Adds an arbitrary object to this session's cache.<a name="line.130"></a>
+<span class="sourceLineNo">131</span> *<a name="line.131"></a>
+<span class="sourceLineNo">132</span> * <p><a name="line.132"></a>
+<span class="sourceLineNo">133</span> * Can be used to store objects for reuse during a session.<a name="line.133"></a>
+<span class="sourceLineNo">134</span> *<a name="line.134"></a>
+<span class="sourceLineNo">135</span> * @param key The key. Can be any string.<a name="line.135"></a>
+<span class="sourceLineNo">136</span> * @param val The cached object.<a name="line.136"></a>
+<span class="sourceLineNo">137</span> */<a name="line.137"></a>
+<span class="sourceLineNo">138</span> public final void addToCache(String key, Object val) {<a name="line.138"></a>
+<span class="sourceLineNo">139</span> if (cache == null)<a name="line.139"></a>
+<span class="sourceLineNo">140</span> cache = new TreeMap<>();<a name="line.140"></a>
+<span class="sourceLineNo">141</span> cache.put(key, val);<a name="line.141"></a>
+<span class="sourceLineNo">142</span> }<a name="line.142"></a>
+<span class="sourceLineNo">143</span><a name="line.143"></a>
+<span class="sourceLineNo">144</span> /**<a name="line.144"></a>
+<span class="sourceLineNo">145</span> * Adds arbitrary objects to this session's cache.<a name="line.145"></a>
+<span class="sourceLineNo">146</span> *<a name="line.146"></a>
+<span class="sourceLineNo">147</span> * <p><a name="line.147"></a>
+<span class="sourceLineNo">148</span> * Can be used to store objects for reuse during a session.<a name="line.148"></a>
+<span class="sourceLineNo">149</span> *<a name="line.149"></a>
+<span class="sourceLineNo">150</span> * @param cacheObjects<a name="line.150"></a>
+<span class="sourceLineNo">151</span> * The objects to add to this session's cache.<a name="line.151"></a>
+<span class="sourceLineNo">152</span> * No-op if <jk>null</jk>.<a name="line.152"></a>
+<span class="sourceLineNo">153</span> */<a name="line.153"></a>
+<span class="sourceLineNo">154</span> public final void addToCache(Map<String,Object> cacheObjects) {<a name="line.154"></a>
+<span class="sourceLineNo">155</span> if (cacheObjects != null) {<a name="line.155"></a>
+<span class="sourceLineNo">156</span> if (cache == null)<a name="line.156"></a>
+<span class="sourceLineNo">157</span> cache = new TreeMap<>();<a name="line.157"></a>
+<span class="sourceLineNo">158</span> cache.putAll(cacheObjects);<a name="line.158"></a>
+<span class="sourceLineNo">159</span> }<a name="line.159"></a>
+<span class="sourceLineNo">160</span> }<a name="line.160"></a>
+<span class="sourceLineNo">161</span><a name="line.161"></a>
+<span class="sourceLineNo">162</span> /**<a name="line.162"></a>
+<span class="sourceLineNo">163</span> * Returns an object stored in the session cache.<a name="line.163"></a>
+<span class="sourceLineNo">164</span> *<a name="line.164"></a>
+<span class="sourceLineNo">165</span> * @param c The class type of the object.<a name="line.165"></a>
+<span class="sourceLineNo">166</span> * @param key The session object key.<a name="line.166"></a>
+<span class="sourceLineNo">167</span> * @return The cached object, or <jk>null</jk> if it doesn't exist.<a name="line.167"></a>
+<span class="sourceLineNo">168</span> */<a name="line.168"></a>
+<span class="sourceLineNo">169</span> @SuppressWarnings("unchecked")<a name="line.169"></a>
+<span class="sourceLineNo">170</span> public final <T> T getFromCache(Class<T> c, String key) {<a name="line.170"></a>
+<span class="sourceLineNo">171</span> return cache == null ? null : (T)cache.get(key);<a name="line.171"></a>
+<span class="sourceLineNo">172</span> }<a name="line.172"></a>
+<span class="sourceLineNo">173</span><a name="line.173"></a>
+<span class="sourceLineNo">174</span> /**<a name="line.174"></a>
+<span class="sourceLineNo">175</span> * Logs a warning message.<a name="line.175"></a>
+<span class="sourceLineNo">176</span> *<a name="line.176"></a>
+<span class="sourceLineNo">177</span> * @param msg The warning message.<a name="line.177"></a>
+<span class="sourceLineNo">178</span> * @param args Optional {@link MessageFormat}-style arguments.<a name="line.178"></a>
+<span class="sourceLineNo">179</span> */<a name="line.179"></a>
+<span class="sourceLineNo">180</span> public final void addWarning(String msg, Object... args) {<a name="line.180"></a>
+<span class="sourceLineNo">181</span> if (warnings == null)<a name="line.181"></a>
+<span class="sourceLineNo">182</span> warnings = new LinkedList<>();<a name="line.182"></a>
+<span class="sourceLineNo">183</span> getLogger().warning(msg, args);<a name="line.183"></a>
+<span class="sourceLineNo">184</span> warnings.add((warnings.size() + 1) + ": " + format(msg, args));<a name="line.184"></a>
+<span class="sourceLineNo">185</span> }<a name="line.185"></a>
+<span class="sourceLineNo">186</span><a name="line.186"></a>
+<span class="sourceLineNo">187</span> /**<a name="line.187"></a>
+<span class="sourceLineNo">188</span> * Returns <jk>true</jk> if warnings occurred in this session.<a name="line.188"></a>
+<span class="sourceLineNo">189</span> *<a name="line.189"></a>
+<span class="sourceLineNo">190</span> * @return <jk>true</jk> if warnings occurred in this session.<a name="line.190"></a>
+<span class="sourceLineNo">191</span> */<a name="line.191"></a>
+<span class="sourceLineNo">192</span> public final boolean hasWarnings() {<a name="line.192"></a>
+<span class="sourceLineNo">193</span> return warnings != null && warnings.size() > 0;<a name="line.193"></a>
+<span class="sourceLineNo">194</span> }<a name="line.194"></a>
+<span class="sourceLineNo">195</span><a name="line.195"></a>
+<span class="sourceLineNo">196</span> /**<a name="line.196"></a>
+<span class="sourceLineNo">197</span> * Returns the warnings that occurred in this session.<a name="line.197"></a>
+<span class="sourceLineNo">198</span> *<a name="line.198"></a>
+<span class="sourceLineNo">199</span> * @return The warnings that occurred in this session, or <jk>null</jk> if no warnings occurred.<a name="line.199"></a>
+<span class="sourceLineNo">200</span> */<a name="line.200"></a>
+<span class="sourceLineNo">201</span> public final List<String> getWarnings() {<a name="line.201"></a>
+<span class="sourceLineNo">202</span> return warnings;<a name="line.202"></a>
+<span class="sourceLineNo">203</span> }<a name="line.203"></a>
+<span class="sourceLineNo">204</span><a name="line.204"></a>
+<span class="sourceLineNo">205</span> /**<a name="line.205"></a>
+<span class="sourceLineNo">206</span> * Returns the logger associated with this session.<a name="line.206"></a>
+<span class="sourceLineNo">207</span> *<a name="line.207"></a>
+<span class="sourceLineNo">208</span> * <p><a name="line.208"></a>
+<span class="sourceLineNo">209</span> * Subclasses can override this method to provide their own logger.<a name="line.209"></a>
+<span class="sourceLineNo">210</span> *<a name="line.210"></a>
+<span class="sourceLineNo">211</span> * @return The logger associated with this session.<a name="line.211"></a>
+<span class="sourceLineNo">212</span> */<a name="line.212"></a>
+<span class="sourceLineNo">213</span> protected final JuneauLogger getLogger() {<a name="line.213"></a>
+<span class="sourceLineNo">214</span> if (logger == null)<a name="line.214"></a>
+<span class="sourceLineNo">215</span> logger = JuneauLogger.getLogger(getClass());<a name="line.215"></a>
+<span class="sourceLineNo">216</span> return logger;<a name="line.216"></a>
+<span class="sourceLineNo">217</span> }<a name="line.217"></a>
+<span class="sourceLineNo">218</span><a name="line.218"></a>
+<span class="sourceLineNo">219</span> /**<a name="line.219"></a>
+<span class="sourceLineNo">220</span> * Returns the properties defined on this bean context as a simple map for debugging purposes.<a name="line.220"></a>
+<span class="sourceLineNo">221</span> *<a name="line.221"></a>
+<span class="sourceLineNo">222</span> * @return A new map containing the properties defined on this context.<a name="line.222"></a>
+<span class="sourceLineNo">223</span> */<a name="line.223"></a>
+<span class="sourceLineNo">224</span> @Overrideable<a name="line.224"></a>
+<span class="sourceLineNo">225</span> public ObjectMap asMap() {<a name="line.225"></a>
+<span class="sourceLineNo">226</span> return new ObjectMap();<a name="line.226"></a>
+<span class="sourceLineNo">227</span> }<a name="line.227"></a>
+<span class="sourceLineNo">228</span><a name="line.228"></a>
+<span class="sourceLineNo">229</span> @Override /* Object */<a name="line.229"></a>
+<span class="sourceLineNo">230</span> public String toString() {<a name="line.230"></a>
+<span class="sourceLineNo">231</span> try {<a name="line.231"></a>
+<span class="sourceLineNo">232</span> return asMap().toString(JsonSerializer.DEFAULT_LAX_READABLE);<a name="line.232"></a>
+<span class="sourceLineNo">233</span> } catch (SerializeException e) {<a name="line.233"></a>
+<span class="sourceLineNo">234</span> return e.getLocalizedMessage();<a name="line.234"></a>
+<span class="sourceLineNo">235</span> }<a name="line.235"></a>
+<span class="sourceLineNo">236</span> }<a name="line.236"></a>
+<span class="sourceLineNo">237</span> <a name="line.237"></a>
+<span class="sourceLineNo">238</span> /**<a name="line.238"></a>
+<span class="sourceLineNo">239</span> * Throws a {@link BeanRuntimeException} if any warnings occurred in this session.<a name="line.239"></a>
+<span class="sourceLineNo">240</span> */<a name="line.240"></a>
+<span class="sourceLineNo">241</span> public void checkForWarnings() {<a name="line.241"></a>
+<span class="sourceLineNo">242</span> if (! warnings.isEmpty())<a name="line.242"></a>
+<span class="sourceLineNo">243</span> throw new BeanRuntimeException("Warnings occurred in session: \n" + join(getWarnings(), "\n")); <a name="line.243"></a>
+<span class="sourceLineNo">244</span> }<a name="line.244"></a>
+<span class="sourceLineNo">245</span>}<a name="line.245"></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/81ca4d4d/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParser.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParser.html b/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParser.html
index 1d78901..551f5c7 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParser.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParser.html
@@ -57,11 +57,27 @@
<span class="sourceLineNo">049</span> return new CsvParserBuilder(propertyStore);<a name="line.49"></a>
<span class="sourceLineNo">050</span> }<a name="line.50"></a>
<span class="sourceLineNo">051</span><a name="line.51"></a>
-<span class="sourceLineNo">052</span> @Override /* Parser */<a name="line.52"></a>
-<span class="sourceLineNo">053</span> public ReaderParserSession createSession(ParserSessionArgs args) {<a name="line.53"></a>
-<span class="sourceLineNo">054</span> return new CsvParserSession(ctx, args);<a name="line.54"></a>
-<span class="sourceLineNo">055</span> }<a name="line.55"></a>
-<span class="sourceLineNo">056</span>}<a name="line.56"></a>
+<span class="sourceLineNo">052</span> /**<a name="line.52"></a>
+<span class="sourceLineNo">053</span> * Instantiates a new clean-slate {@link CsvParserBuilder} object.<a name="line.53"></a>
+<span class="sourceLineNo">054</span> * <a name="line.54"></a>
+<span class="sourceLineNo">055</span> * <p><a name="line.55"></a>
+<span class="sourceLineNo">056</span> * This is equivalent to simply calling <code>CsvParser.create()<a name="line.56"></a>
+<span class="sourceLineNo">057</span> * <a name="line.57"></a>
+<span class="sourceLineNo">058</span> * <p><a name="line.58"></a>
+<span class="sourceLineNo">059</span> * Note that this method creates a builder initialized to all default settings, whereas {@link #builder()} copies <a name="line.59"></a>
+<span class="sourceLineNo">060</span> * the settings of the object called on.<a name="line.60"></a>
+<span class="sourceLineNo">061</span> * <a name="line.61"></a>
+<span class="sourceLineNo">062</span> * @return A new {@link CsvParserBuilder} object.<a name="line.62"></a>
+<span class="sourceLineNo">063</span> */<a name="line.63"></a>
+<span class="sourceLineNo">064</span> public static CsvParserBuilder create() {<a name="line.64"></a>
+<span class="sourceLineNo">065</span> return new CsvParserBuilder();<a name="line.65"></a>
+<span class="sourceLineNo">066</span> }<a name="line.66"></a>
+<span class="sourceLineNo">067</span><a name="line.67"></a>
+<span class="sourceLineNo">068</span> @Override /* Parser */<a name="line.68"></a>
+<span class="sourceLineNo">069</span> public ReaderParserSession createSession(ParserSessionArgs args) {<a name="line.69"></a>
+<span class="sourceLineNo">070</span> return new CsvParserSession(ctx, args);<a name="line.70"></a>
+<span class="sourceLineNo">071</span> }<a name="line.71"></a>
+<span class="sourceLineNo">072</span>}<a name="line.72"></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/81ca4d4d/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParserSession.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParserSession.html b/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParserSession.html
index 23b5e8b..7a597de 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParserSession.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/csv/CsvParserSession.html
@@ -47,11 +47,11 @@
<span class="sourceLineNo">039</span><a name="line.39"></a>
<span class="sourceLineNo">040</span> @Override /* ParserSession */<a name="line.40"></a>
<span class="sourceLineNo">041</span> protected <T> T doParse(ParserPipe pipe, ClassMeta<T> type) throws Exception {<a name="line.41"></a>
-<span class="sourceLineNo">042</span> ParserReader r = pipe.getParserReader();<a name="line.42"></a>
-<span class="sourceLineNo">043</span> if (r == null)<a name="line.43"></a>
-<span class="sourceLineNo">044</span> return null;<a name="line.44"></a>
-<span class="sourceLineNo">045</span> T o = parseAnything(type, r, getOuter(), null);<a name="line.45"></a>
-<span class="sourceLineNo">046</span> return o;<a name="line.46"></a>
+<span class="sourceLineNo">042</span> try (ParserReader r = pipe.getParserReader()) {<a name="line.42"></a>
+<span class="sourceLineNo">043</span> if (r == null)<a name="line.43"></a>
+<span class="sourceLineNo">044</span> return null;<a name="line.44"></a>
+<span class="sourceLineNo">045</span> return parseAnything(type, r, getOuter(), null);<a name="line.45"></a>
+<span class="sourceLineNo">046</span> }<a name="line.46"></a>
<span class="sourceLineNo">047</span> }<a name="line.47"></a>
<span class="sourceLineNo">048</span><a name="line.48"></a>
<span class="sourceLineNo">049</span> @SuppressWarnings({"static-method"})<a name="line.49"></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/81ca4d4d/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializer.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializer.html b/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializer.html
index 6dbf710..79220f7 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializer.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializer.html
@@ -57,11 +57,27 @@
<span class="sourceLineNo">049</span> return new CsvSerializerBuilder(propertyStore);<a name="line.49"></a>
<span class="sourceLineNo">050</span> }<a name="line.50"></a>
<span class="sourceLineNo">051</span><a name="line.51"></a>
-<span class="sourceLineNo">052</span> @Override /* Serializer */<a name="line.52"></a>
-<span class="sourceLineNo">053</span> public WriterSerializerSession createSession(SerializerSessionArgs args) {<a name="line.53"></a>
-<span class="sourceLineNo">054</span> return new CsvSerializerSession(ctx, args);<a name="line.54"></a>
-<span class="sourceLineNo">055</span> }<a name="line.55"></a>
-<span class="sourceLineNo">056</span>}<a name="line.56"></a>
+<span class="sourceLineNo">052</span> /**<a name="line.52"></a>
+<span class="sourceLineNo">053</span> * Instantiates a new clean-slate {@link CsvSerializerBuilder} object.<a name="line.53"></a>
+<span class="sourceLineNo">054</span> * <a name="line.54"></a>
+<span class="sourceLineNo">055</span> * <p><a name="line.55"></a>
+<span class="sourceLineNo">056</span> * This is equivalent to simply calling <code><jk>new</jk> CsvSerializerBuilder()</code>.<a name="line.56"></a>
+<span class="sourceLineNo">057</span> * <a name="line.57"></a>
+<span class="sourceLineNo">058</span> * <p><a name="line.58"></a>
+<span class="sourceLineNo">059</span> * Note that this method creates a builder initialized to all default settings, whereas {@link #builder()} copies <a name="line.59"></a>
+<span class="sourceLineNo">060</span> * the settings of the object called on.<a name="line.60"></a>
+<span class="sourceLineNo">061</span> * <a name="line.61"></a>
+<span class="sourceLineNo">062</span> * @return A new {@link CsvSerializerBuilder} object.<a name="line.62"></a>
+<span class="sourceLineNo">063</span> */<a name="line.63"></a>
+<span class="sourceLineNo">064</span> public static CsvSerializerBuilder create() {<a name="line.64"></a>
+<span class="sourceLineNo">065</span> return new CsvSerializerBuilder();<a name="line.65"></a>
+<span class="sourceLineNo">066</span> }<a name="line.66"></a>
+<span class="sourceLineNo">067</span><a name="line.67"></a>
+<span class="sourceLineNo">068</span> @Override /* Serializer */<a name="line.68"></a>
+<span class="sourceLineNo">069</span> public WriterSerializerSession createSession(SerializerSessionArgs args) {<a name="line.69"></a>
+<span class="sourceLineNo">070</span> return new CsvSerializerSession(ctx, args);<a name="line.70"></a>
+<span class="sourceLineNo">071</span> }<a name="line.71"></a>
+<span class="sourceLineNo">072</span>}<a name="line.72"></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/81ca4d4d/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializerSession.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializerSession.html b/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializerSession.html
index 951d459..b0aa214 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializerSession.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/csv/CsvSerializerSession.html
@@ -52,59 +52,60 @@
<span class="sourceLineNo">044</span> }<a name="line.44"></a>
<span class="sourceLineNo">045</span><a name="line.45"></a>
<span class="sourceLineNo">046</span> @Override /* SerializerSession */<a name="line.46"></a>
-<span class="sourceLineNo">047</span> protected final void doSerialize(SerializerPipe out, Object o) throws Exception {<a name="line.47"></a>
-<span class="sourceLineNo">048</span> Writer w = out.getWriter();<a name="line.48"></a>
-<span class="sourceLineNo">049</span> ClassMeta<?> cm = getClassMetaForObject(o);<a name="line.49"></a>
-<span class="sourceLineNo">050</span> Collection<?> l = null;<a name="line.50"></a>
-<span class="sourceLineNo">051</span> if (cm.isArray()) {<a name="line.51"></a>
-<span class="sourceLineNo">052</span> l = Arrays.asList((Object[])o);<a name="line.52"></a>
-<span class="sourceLineNo">053</span> } else {<a name="line.53"></a>
-<span class="sourceLineNo">054</span> l = (Collection<?>)o;<a name="line.54"></a>
-<span class="sourceLineNo">055</span> }<a name="line.55"></a>
-<span class="sourceLineNo">056</span> // TODO - Doesn't support DynaBeans.<a name="line.56"></a>
-<span class="sourceLineNo">057</span> if (l.size() > 0) {<a name="line.57"></a>
-<span class="sourceLineNo">058</span> ClassMeta<?> entryType = getClassMetaForObject(l.iterator().next());<a name="line.58"></a>
-<span class="sourceLineNo">059</span> if (entryType.isBean()) {<a name="line.59"></a>
-<span class="sourceLineNo">060</span> BeanMeta<?> bm = entryType.getBeanMeta();<a name="line.60"></a>
-<span class="sourceLineNo">061</span> int i = 0;<a name="line.61"></a>
-<span class="sourceLineNo">062</span> for (BeanPropertyMeta pm : bm.getPropertyMetas()) {<a name="line.62"></a>
-<span class="sourceLineNo">063</span> if (i++ > 0)<a name="line.63"></a>
-<span class="sourceLineNo">064</span> w.append(',');<a name="line.64"></a>
-<span class="sourceLineNo">065</span> append(w, pm.getName());<a name="line.65"></a>
-<span class="sourceLineNo">066</span> }<a name="line.66"></a>
-<span class="sourceLineNo">067</span> w.append('\n');<a name="line.67"></a>
-<span class="sourceLineNo">068</span> for (Object o2 : l) {<a name="line.68"></a>
-<span class="sourceLineNo">069</span> i = 0;<a name="line.69"></a>
-<span class="sourceLineNo">070</span> BeanMap<?> bean = toBeanMap(o2);<a name="line.70"></a>
-<span class="sourceLineNo">071</span> for (BeanPropertyMeta pm : bm.getPropertyMetas()) {<a name="line.71"></a>
-<span class="sourceLineNo">072</span> if (i++ > 0)<a name="line.72"></a>
-<span class="sourceLineNo">073</span> w.append(',');<a name="line.73"></a>
-<span class="sourceLineNo">074</span> append(w, pm.get(bean, pm.getName()));<a name="line.74"></a>
-<span class="sourceLineNo">075</span> }<a name="line.75"></a>
-<span class="sourceLineNo">076</span> w.append('\n');<a name="line.76"></a>
-<span class="sourceLineNo">077</span> }<a name="line.77"></a>
-<span class="sourceLineNo">078</span> }<a name="line.78"></a>
-<span class="sourceLineNo">079</span> }<a name="line.79"></a>
-<span class="sourceLineNo">080</span> }<a name="line.80"></a>
-<span class="sourceLineNo">081</span><a name="line.81"></a>
-<span class="sourceLineNo">082</span> private static void append(Writer w, Object o) throws IOException {<a name="line.82"></a>
-<span class="sourceLineNo">083</span> if (o == null)<a name="line.83"></a>
-<span class="sourceLineNo">084</span> w.append("null");<a name="line.84"></a>
-<span class="sourceLineNo">085</span> else {<a name="line.85"></a>
-<span class="sourceLineNo">086</span> String s = o.toString();<a name="line.86"></a>
-<span class="sourceLineNo">087</span> boolean mustQuote = false;<a name="line.87"></a>
-<span class="sourceLineNo">088</span> for (int i = 0; i < s.length() && ! mustQuote; i++) {<a name="line.88"></a>
-<span class="sourceLineNo">089</span> char c = s.charAt(i);<a name="line.89"></a>
-<span class="sourceLineNo">090</span> if (Character.isWhitespace(c) || c == ',')<a name="line.90"></a>
-<span class="sourceLineNo">091</span> mustQuote = true;<a name="line.91"></a>
-<span class="sourceLineNo">092</span> }<a name="line.92"></a>
-<span class="sourceLineNo">093</span> if (mustQuote)<a name="line.93"></a>
-<span class="sourceLineNo">094</span> w.append('"').append(s).append('"');<a name="line.94"></a>
-<span class="sourceLineNo">095</span> else<a name="line.95"></a>
-<span class="sourceLineNo">096</span> w.append(s);<a name="line.96"></a>
-<span class="sourceLineNo">097</span> }<a name="line.97"></a>
-<span class="sourceLineNo">098</span> }<a name="line.98"></a>
-<span class="sourceLineNo">099</span>}<a name="line.99"></a>
+<span class="sourceLineNo">047</span> protected final void doSerialize(SerializerPipe pipe, Object o) throws Exception {<a name="line.47"></a>
+<span class="sourceLineNo">048</span> try (Writer w = pipe.getWriter()) {<a name="line.48"></a>
+<span class="sourceLineNo">049</span> ClassMeta<?> cm = getClassMetaForObject(o);<a name="line.49"></a>
+<span class="sourceLineNo">050</span> Collection<?> l = null;<a name="line.50"></a>
+<span class="sourceLineNo">051</span> if (cm.isArray()) {<a name="line.51"></a>
+<span class="sourceLineNo">052</span> l = Arrays.asList((Object[])o);<a name="line.52"></a>
+<span class="sourceLineNo">053</span> } else {<a name="line.53"></a>
+<span class="sourceLineNo">054</span> l = (Collection<?>)o;<a name="line.54"></a>
+<span class="sourceLineNo">055</span> }<a name="line.55"></a>
+<span class="sourceLineNo">056</span> // TODO - Doesn't support DynaBeans.<a name="line.56"></a>
+<span class="sourceLineNo">057</span> if (l.size() > 0) {<a name="line.57"></a>
+<span class="sourceLineNo">058</span> ClassMeta<?> entryType = getClassMetaForObject(l.iterator().next());<a name="line.58"></a>
+<span class="sourceLineNo">059</span> if (entryType.isBean()) {<a name="line.59"></a>
+<span class="sourceLineNo">060</span> BeanMeta<?> bm = entryType.getBeanMeta();<a name="line.60"></a>
+<span class="sourceLineNo">061</span> int i = 0;<a name="line.61"></a>
+<span class="sourceLineNo">062</span> for (BeanPropertyMeta pm : bm.getPropertyMetas()) {<a name="line.62"></a>
+<span class="sourceLineNo">063</span> if (i++ > 0)<a name="line.63"></a>
+<span class="sourceLineNo">064</span> w.append(',');<a name="line.64"></a>
+<span class="sourceLineNo">065</span> append(w, pm.getName());<a name="line.65"></a>
+<span class="sourceLineNo">066</span> }<a name="line.66"></a>
+<span class="sourceLineNo">067</span> w.append('\n');<a name="line.67"></a>
+<span class="sourceLineNo">068</span> for (Object o2 : l) {<a name="line.68"></a>
+<span class="sourceLineNo">069</span> i = 0;<a name="line.69"></a>
+<span class="sourceLineNo">070</span> BeanMap<?> bean = toBeanMap(o2);<a name="line.70"></a>
+<span class="sourceLineNo">071</span> for (BeanPropertyMeta pm : bm.getPropertyMetas()) {<a name="line.71"></a>
+<span class="sourceLineNo">072</span> if (i++ > 0)<a name="line.72"></a>
+<span class="sourceLineNo">073</span> w.append(',');<a name="line.73"></a>
+<span class="sourceLineNo">074</span> append(w, pm.get(bean, pm.getName()));<a name="line.74"></a>
+<span class="sourceLineNo">075</span> }<a name="line.75"></a>
+<span class="sourceLineNo">076</span> w.append('\n');<a name="line.76"></a>
+<span class="sourceLineNo">077</span> }<a name="line.77"></a>
+<span class="sourceLineNo">078</span> }<a name="line.78"></a>
+<span class="sourceLineNo">079</span> }<a name="line.79"></a>
+<span class="sourceLineNo">080</span> }<a name="line.80"></a>
+<span class="sourceLineNo">081</span> }<a name="line.81"></a>
+<span class="sourceLineNo">082</span><a name="line.82"></a>
+<span class="sourceLineNo">083</span> private static void append(Writer w, Object o) throws IOException {<a name="line.83"></a>
+<span class="sourceLineNo">084</span> if (o == null)<a name="line.84"></a>
+<span class="sourceLineNo">085</span> w.append("null");<a name="line.85"></a>
+<span class="sourceLineNo">086</span> else {<a name="line.86"></a>
+<span class="sourceLineNo">087</span> String s = o.toString();<a name="line.87"></a>
+<span class="sourceLineNo">088</span> boolean mustQuote = false;<a name="line.88"></a>
+<span class="sourceLineNo">089</span> for (int i = 0; i < s.length() && ! mustQuote; i++) {<a name="line.89"></a>
+<span class="sourceLineNo">090</span> char c = s.charAt(i);<a name="line.90"></a>
+<span class="sourceLineNo">091</span> if (Character.isWhitespace(c) || c == ',')<a name="line.91"></a>
+<span class="sourceLineNo">092</span> mustQuote = true;<a name="line.92"></a>
+<span class="sourceLineNo">093</span> }<a name="line.93"></a>
+<span class="sourceLineNo">094</span> if (mustQuote)<a name="line.94"></a>
+<span class="sourceLineNo">095</span> w.append('"').append(s).append('"');<a name="line.95"></a>
+<span class="sourceLineNo">096</span> else<a name="line.96"></a>
+<span class="sourceLineNo">097</span> w.append(s);<a name="line.97"></a>
+<span class="sourceLineNo">098</span> }<a name="line.98"></a>
+<span class="sourceLineNo">099</span> }<a name="line.99"></a>
+<span class="sourceLineNo">100</span>}<a name="line.100"></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/81ca4d4d/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.Row.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.Row.html b/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.Row.html
index 9d4340f..3c8979d 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.Row.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.Row.html
@@ -147,10 +147,10 @@
<span class="sourceLineNo">139</span> * </p><a name="line.139"></a>
<span class="sourceLineNo">140</span> */<a name="line.140"></a>
<span class="sourceLineNo">141</span> @Bean(typeName="row")<a name="line.141"></a>
-<span class="sourceLineNo">142</span> public static class Row {<a name="line.142"></a>
+<span class="sourceLineNo">142</span> public static final class Row {<a name="line.142"></a>
<span class="sourceLineNo">143</span> private List<String> values = new LinkedList<>();<a name="line.143"></a>
<span class="sourceLineNo">144</span><a name="line.144"></a>
-<span class="sourceLineNo">145</span> private void add(String value) {<a name="line.145"></a>
+<span class="sourceLineNo">145</span> void add(String value) {<a name="line.145"></a>
<span class="sourceLineNo">146</span> values.add(value);<a name="line.146"></a>
<span class="sourceLineNo">147</span> }<a name="line.147"></a>
<span class="sourceLineNo">148</span><a name="line.148"></a>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/81ca4d4d/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.html b/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.html
index 9d4340f..3c8979d 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/dto/cognos/DataSet.html
@@ -147,10 +147,10 @@
<span class="sourceLineNo">139</span> * </p><a name="line.139"></a>
<span class="sourceLineNo">140</span> */<a name="line.140"></a>
<span class="sourceLineNo">141</span> @Bean(typeName="row")<a name="line.141"></a>
-<span class="sourceLineNo">142</span> public static class Row {<a name="line.142"></a>
+<span class="sourceLineNo">142</span> public static final class Row {<a name="line.142"></a>
<span class="sourceLineNo">143</span> private List<String> values = new LinkedList<>();<a name="line.143"></a>
<span class="sourceLineNo">144</span><a name="line.144"></a>
-<span class="sourceLineNo">145</span> private void add(String value) {<a name="line.145"></a>
+<span class="sourceLineNo">145</span> void add(String value) {<a name="line.145"></a>
<span class="sourceLineNo">146</span> values.add(value);<a name="line.146"></a>
<span class="sourceLineNo">147</span> }<a name="line.147"></a>
<span class="sourceLineNo">148</span><a name="line.148"></a>