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/08/01 13:00:30 UTC
[10/51] [partial] incubator-juneau-website git commit: Update
Javadocs.
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/ebea5c00/content/site/apidocs/org/apache/juneau/parser/ParserSession.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/parser/ParserSession.html b/content/site/apidocs/org/apache/juneau/parser/ParserSession.html
index 9d7d5ce..13f52fe 100644
--- a/content/site/apidocs/org/apache/juneau/parser/ParserSession.html
+++ b/content/site/apidocs/org/apache/juneau/parser/ParserSession.html
@@ -4,7 +4,7 @@
<head>
<!-- Generated by javadoc -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>ParserSession (Apache Juneau (incubating) 6.3.1-incubating-SNAPSHOT)</title>
+<title>ParserSession (Apache Juneau (incubating) 6.3.2-incubating-SNAPSHOT)</title>
<link rel="stylesheet" type="text/css" href="../../../../javadoc.css" title="Style">
<script type="text/javascript" src="../../../../script.js"></script>
</head>
@@ -12,14 +12,14 @@
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
- parent.document.title="ParserSession (Apache Juneau (incubating) 6.3.1-incubating-SNAPSHOT)";
+ parent.document.title="ParserSession (Apache Juneau (incubating) 6.3.2-incubating-SNAPSHOT)";
}
}
catch(err) {
}
//-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10};
-var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":6,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":6,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":9,"i23":9,"i24":10,"i25":10};
+var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
@@ -49,7 +49,7 @@ var activeTableTab = "activeTableTab";
<div class="subNav">
<ul class="navList">
<li><a href="../../../../org/apache/juneau/parser/ParserReader.html" title="class in org.apache.juneau.parser"><span class="typeNameLink">Prev Class</span></a></li>
-<li><a href="../../../../org/apache/juneau/parser/PartParser.html" title="interface in org.apache.juneau.parser"><span class="typeNameLink">Next Class</span></a></li>
+<li><a href="../../../../org/apache/juneau/parser/ParserSessionArgs.html" title="class in org.apache.juneau.parser"><span class="typeNameLink">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/apache/juneau/parser/ParserSession.html" target="_top">Frames</a></li>
@@ -118,16 +118,17 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<dl>
<dt>Direct Known Subclasses:</dt>
-<dd><a href="../../../../org/apache/juneau/csv/CsvParserSession.html" title="class in org.apache.juneau.csv">CsvParserSession</a>, <a href="../../../../org/apache/juneau/json/JsonParserSession.html" title="class in org.apache.juneau.json">JsonParserSession</a>, <a href="../../../../org/apache/juneau/msgpack/MsgPackParserSession.html" title="class in org.apache.juneau.msgpack">MsgPackParserSession</a>, <a href="../../../../org/apache/juneau/jena/RdfParserSession.html" title="class in org.apache.juneau.jena">RdfParserSession</a>, <a href="../../../../org/apache/juneau/uon/UonParserSession.html" title="class in org.apache.juneau.uon">UonParserSession</a>, <a href="../../../../org/apache/juneau/xml/XmlParserSession.html" title="class in org.apache.juneau.xml">XmlParserSession</a></dd>
+<dd><a href="../../../../org/apache/juneau/parser/InputStreamParserSession.html" title="class in org.apache.juneau.parser">InputStreamParserSession</a>, <a href="../../../../org/apache/juneau/parser/ReaderParserSession.html" title="class in org.apache.juneau.parser">ReaderParserSession</a></dd>
</dl>
<hr>
<br>
-<pre>public class <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.34">ParserSession</a>
+<pre>public abstract class <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.35">ParserSession</a>
extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a></pre>
<div class="block">Session object that lives for the duration of a single use of <a href="../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser"><code>Parser</code></a>.
<p>
- This class is NOT thread safe. It is meant to be discarded after one-time use.</div>
+ This class is NOT thread safe.
+ It is typically discarded after one-time use although it can be reused against multiple inputs.</div>
</li>
</ul>
</div>
@@ -143,17 +144,13 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd"> </span></caption>
<tr>
-<th class="colOne" scope="col">Constructor and Description</th>
+<th class="colFirst" scope="col">Modifier</th>
+<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
-<td class="colOne"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#ParserSession-org.apache.juneau.parser.ParserContext-org.apache.juneau.ObjectMap-java.lang.Object-java.lang.reflect.Method-java.lang.Object-java.util.Locale-java.util.TimeZone-org.apache.juneau.http.MediaType-">ParserSession</a></span>(<a href="../../../../org/apache/juneau/parser/ParserContext.html" title="class in org.apache.juneau.parser">ParserContext</a> ctx,
- <a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a> op,
- <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> input,
- <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> javaMethod,
- <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> outer,
- <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> locale,
- <a href="http://docs.oracle.com/javase/7/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util">TimeZone</a> timeZone,
- <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> mediaType)</code>
+<td class="colFirst"><code>protected </code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#ParserSession-org.apache.juneau.parser.ParserContext-org.apache.juneau.parser.ParserSessionArgs-">ParserSession</a></span>(<a href="../../../../org/apache/juneau/parser/ParserContext.html" title="class in org.apache.juneau.parser">ParserContext</a> ctx,
+ <a href="../../../../org/apache/juneau/parser/ParserSessionArgs.html" title="class in org.apache.juneau.parser">ParserSessionArgs</a> args)</code>
<div class="block">Create a new session using properties specified in the context.</div>
</td>
</tr>
@@ -167,13 +164,13 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
-<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd"> </span></span></caption>
+<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd"> </span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd"> </span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
-<td class="colFirst"><code><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></code></td>
+<td class="colFirst"><code>protected <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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#cast-org.apache.juneau.ObjectMap-org.apache.juneau.BeanPropertyMeta-org.apache.juneau.ClassMeta-">cast</a></span>(<a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a> m,
<a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta,
<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> eType)</code>
@@ -181,102 +178,183 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
</td>
</tr>
<tr id="i1" class="rowColor">
-<td class="colFirst"><code>boolean</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#close--">close</a></span>()</code>
-<div class="block">Perform cleanup on this context object if necessary.</div>
+<td class="colFirst"><code>protected <T> T</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#convertAttrToType-java.lang.Object-java.lang.String-org.apache.juneau.ClassMeta-">convertAttrToType</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> outer,
+ <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/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><T> type)</code>
+<div class="block">Converts the specified string to the specified type.</div>
</td>
</tr>
<tr id="i2" class="altColor">
-<td class="colFirst"><code><a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#getClassMeta-java.lang.String-org.apache.juneau.BeanPropertyMeta-org.apache.juneau.ClassMeta-">getClassMeta</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> typeName,
- <a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta,
- <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> eType)</code>
-<div class="block">Give the specified dictionary name, resolve it to a class.</div>
+<td class="colFirst"><code><a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser">ParserPipe</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#createPipe-java.lang.Object-">createPipe</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> input)</code>
+<div class="block">Wraps the specified input object into a <a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser"><code>ParserPipe</code></a> object so that it can be easily converted into
+ a stream or reader.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
-<td class="colFirst"><code>protected <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></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#getInput--">getInput</a></span>()</code>
-<div class="block">Returns the raw input object passed into this session.</div>
+<td class="colFirst"><code>protected abstract <T> T</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#doParse-org.apache.juneau.parser.ParserPipe-org.apache.juneau.ClassMeta-">doParse</a></span>(<a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser">ParserPipe</a> pipe,
+ <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><T> type)</code>
+<div class="block">Workhorse method.</div>
</td>
</tr>
<tr id="i4" 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/parser/ParserSession.html#getInputAsString--">getInputAsString</a></span>()</code>
-<div class="block">Returns the input to this parser as a plain string.</div>
+<td class="colFirst"><code>protected <E> <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a><E></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#doParseIntoCollection-org.apache.juneau.parser.ParserPipe-java.util.Collection-java.lang.reflect.Type-">doParseIntoCollection</a></span>(<a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser">ParserPipe</a> pipe,
+ <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a><E> c,
+ <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> elementType)</code>
+<div class="block">Implementation method.</div>
</td>
</tr>
<tr id="i5" class="rowColor">
-<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#getInputStream--">getInputStream</a></span>()</code>
-<div class="block">Wraps the specified input object inside an input stream.</div>
+<td class="colFirst"><code>protected <K,V> <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><K,V></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#doParseIntoMap-org.apache.juneau.parser.ParserPipe-java.util.Map-java.lang.reflect.Type-java.lang.reflect.Type-">doParseIntoMap</a></span>(<a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser">ParserPipe</a> pipe,
+ <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><K,V> m,
+ <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> keyType,
+ <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> valueType)</code>
+<div class="block">Implementation method.</div>
</td>
</tr>
<tr id="i6" class="altColor">
-<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a></code></td>
+<td class="colFirst"><code>protected <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#getClassMeta-java.lang.String-org.apache.juneau.BeanPropertyMeta-org.apache.juneau.ClassMeta-">getClassMeta</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> typeName,
+ <a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta,
+ <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> eType)</code>
+<div class="block">Give the specified dictionary name, resolve it to a class.</div>
+</td>
+</tr>
+<tr id="i7" class="rowColor">
+<td class="colFirst"><code>protected <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#getJavaMethod--">getJavaMethod</a></span>()</code>
<div class="block">Returns the Java method that invoked this parser.</div>
</td>
</tr>
-<tr id="i7" class="rowColor">
-<td class="colFirst"><code><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/Object.html?is-external=true" title="class or interface in java.lang">Object</a>></code></td>
+<tr id="i8" class="altColor">
+<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/parser/ParserSession.html#getLastLocation--">getLastLocation</a></span>()</code>
<div class="block">Returns information used to determine at what location in the parse a failure occurred.</div>
</td>
</tr>
-<tr id="i8" class="altColor">
-<td class="colFirst"><code><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></code></td>
+<tr id="i9" class="rowColor">
+<td class="colFirst"><code>protected <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></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#getOuter--">getOuter</a></span>()</code>
<div class="block">Returns the outer object used for instantiating top-level non-static member classes.</div>
</td>
</tr>
-<tr id="i9" class="rowColor">
-<td class="colFirst"><code><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></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#getReader--">getReader</a></span>()</code>
-<div class="block">Wraps the specified input object inside a reader.</div>
+<tr id="i10" class="altColor">
+<td class="colFirst"><code>abstract boolean</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#isReaderParser--">isReaderParser</a></span>()</code>
+<div class="block">Returns <jk>true</jk> if this parser subclasses from <a href="../../../../org/apache/juneau/parser/ReaderParser.html" title="class in org.apache.juneau.parser"><code>ReaderParser</code></a>.</div>
</td>
</tr>
-<tr id="i10" class="altColor">
-<td class="colFirst"><code>boolean</code></td>
+<tr id="i11" class="rowColor">
+<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#isStrict--">isStrict</a></span>()</code>
<div class="block">Returns the <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_strict"><code>ParserContext.PARSER_strict</code></a> setting value for this session.</div>
</td>
</tr>
-<tr id="i11" class="rowColor">
-<td class="colFirst"><code>boolean</code></td>
+<tr id="i12" class="altColor">
+<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#isTrimStrings--">isTrimStrings</a></span>()</code>
<div class="block">Returns the <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_trimStrings"><code>ParserContext.PARSER_trimStrings</code></a> setting value for this session.</div>
</td>
</tr>
-<tr id="i12" class="altColor">
-<td class="colFirst"><code><T> void</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#onUnknownProperty-java.lang.String-org.apache.juneau.BeanMap-int-int-">onUnknownProperty</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> propertyName,
+<tr id="i13" class="rowColor">
+<td class="colFirst"><code>protected <T> void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#onUnknownProperty-org.apache.juneau.parser.ParserPipe-java.lang.String-org.apache.juneau.BeanMap-int-int-">onUnknownProperty</a></span>(<a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser">ParserPipe</a> pipe,
+ <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> propertyName,
<a href="../../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><T> beanMap,
int line,
int col)</code>
<div class="block">Method that gets called when an unknown bean property name is encountered.</div>
</td>
</tr>
-<tr id="i13" class="rowColor">
-<td class="colFirst"><code>void</code></td>
+<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/parser/ParserSession.html#parse-java.lang.Object-java.lang.Class-">parse</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> input,
+ <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/parser/ParserSession.html#parse-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>parse(Object, Type, Type...)</code></a> except optimized for a non-parameterized class.</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/parser/ParserSession.html#parse-java.lang.Object-org.apache.juneau.ClassMeta-">parse</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> input,
+ <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><T> type)</code>
+<div class="block">Same as <a href="../../../../org/apache/juneau/parser/ParserSession.html#parse-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>parse(Object, Type, Type...)</code></a> except the type has already been converted into a <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau"><code>ClassMeta</code></a>
+ object.</div>
+</td>
+</tr>
+<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/parser/ParserSession.html#parse-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type...-">parse</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> input,
+ <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">Parses input into the specified object type.</div>
+</td>
+</tr>
+<tr id="i17" class="rowColor">
+<td class="colFirst"><code><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>[]</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#parseArgs-java.lang.Object-java.lang.reflect.Type:A-">parseArgs</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> input,
+ <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>[] argTypes)</code>
+<div class="block">Parses the specified array input with each entry in the object defined by the <code>argTypes</code>
+ argument.</div>
+</td>
+</tr>
+<tr id="i18" class="altColor">
+<td class="colFirst"><code><E> <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a><E></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#parseIntoCollection-java.lang.Object-java.util.Collection-java.lang.reflect.Type-">parseIntoCollection</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> input,
+ <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a><E> c,
+ <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> elementType)</code>
+<div class="block">Parses the contents of the specified reader and loads the results into the specified collection.</div>
+</td>
+</tr>
+<tr id="i19" class="rowColor">
+<td class="colFirst"><code><K,V> <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><K,V></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#parseIntoMap-java.lang.Object-java.util.Map-java.lang.reflect.Type-java.lang.reflect.Type-">parseIntoMap</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> input,
+ <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><K,V> m,
+ <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> keyType,
+ <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> valueType)</code>
+<div class="block">Parses the contents of the specified reader and loads the results into the specified map.</div>
+</td>
+</tr>
+<tr id="i20" class="altColor">
+<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#setCurrentClass-org.apache.juneau.ClassMeta-">setCurrentClass</a></span>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> currentClass)</code>
<div class="block">Sets the current class being parsed for proper error messages.</div>
</td>
</tr>
-<tr id="i14" class="altColor">
-<td class="colFirst"><code>void</code></td>
+<tr id="i21" class="rowColor">
+<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#setCurrentProperty-org.apache.juneau.BeanPropertyMeta-">setCurrentProperty</a></span>(<a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> currentProperty)</code>
<div class="block">Sets the current bean property being parsed for proper error messages.</div>
</td>
</tr>
-<tr id="i15" class="rowColor">
-<td class="colFirst"><code><K> K</code></td>
+<tr id="i22" class="altColor">
+<td class="colFirst"><code>protected static void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#setName-org.apache.juneau.ClassMeta-java.lang.Object-java.lang.Object-">setName</a></span>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> cm,
+ <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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> name)</code>
+<div class="block">Convenience method for calling the <a href="../../../../org/apache/juneau/annotation/NameProperty.html" title="annotation in org.apache.juneau.annotation"><code>@NameProperty</code></a> method on the specified object if it exists.</div>
+</td>
+</tr>
+<tr id="i23" class="rowColor">
+<td class="colFirst"><code>protected static void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#setParent-org.apache.juneau.ClassMeta-java.lang.Object-java.lang.Object-">setParent</a></span>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> cm,
+ <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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> parent)</code>
+<div class="block">Convenience method for calling the <a href="../../../../org/apache/juneau/annotation/ParentProperty.html" title="annotation in org.apache.juneau.annotation"><code>@ParentProperty</code></a> method on the specified object if it
+ exists.</div>
+</td>
+</tr>
+<tr id="i24" class="altColor">
+<td class="colFirst"><code>protected <K> K</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/parser/ParserSession.html#trim-K-">trim</a></span>(K o)</code>
<div class="block">Trims the specified object if it's a <code>String</code> and <a href="../../../../org/apache/juneau/parser/ParserSession.html#isTrimStrings--"><code>isTrimStrings()</code></a> returns <jk>true</jk>.</div>
</td>
</tr>
-<tr id="i16" 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>
+<tr id="i25" class="rowColor">
+<td class="colFirst"><code>protected <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/parser/ParserSession.html#trim-java.lang.String-">trim</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)</code>
<div class="block">Trims the specified string if <a href="../../../../org/apache/juneau/parser/ParserSession.html#isTrimStrings--"><code>isTrimStrings()</code></a> returns <jk>true</jk>.</div>
</td>
@@ -287,14 +365,14 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<!-- -->
</a>
<h3>Methods inherited from class org.apache.juneau.<a href="../../../../org/apache/juneau/BeanSession.html" title="class in org.apache.juneau">BeanSession</a></h3>
-<code><a href="../../../../org/apache/juneau/BeanSession.html#Z:Z_class--">_class</a>, <a href="../../../../org/apache/juneau/BeanSession.html#asMap--">asMap</a>, <a href="../../../../org/apache/juneau/BeanSession.html#convertToType-java.lang.Object-java.lang.Class-">convertToType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#convertToType-java.lang.Object-org.apache.juneau.ClassMeta-">convertToType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#convertToType-java.lang.Object-java.lang.Object-java.lang.Class-">convertToType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#convertToType-java.lang.Object-java.lang.Object-org.apache.juneau.ClassMeta-">convertToType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getArgsClassMeta-java.lang.reflect.Type:A-">getArgsClassMeta</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getBeanMeta-java.lang.Class-">getBeanMeta</a>, <a href="../../../../org/apache/juneau/BeanSession.html
#getBeanRegistry--">getBeanRegistry</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getBeanTypePropertyName-org.apache.juneau.ClassMeta-">getBeanTypePropertyName</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getClassLoader--">getClassLoader</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getClassMeta-java.lang.Class-">getClassMeta</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getClassMeta-java.lang.reflect.Type-java.lang.reflect.Type...-">getClassMeta</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getClassMetaForObject-T-">getClassMetaForObject</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getLocale--">getLocale</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getMediaType--">getMediaType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getStringBuilder--">getStringBuilder</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getTimeZone--">getTimeZone</a>, <a href="..
/../../../org/apache/juneau/BeanSession.html#isBean-java.lang.Class-">isBean</a>, <a href="../../../../org/apache/juneau/BeanSession.html#isBean-java.lang.Object-">isBean</a>, <a href="../../../../org/apache/juneau/BeanSession.html#isDebug--">isDebug</a>, <a href="../../../../org/apache/juneau/BeanSession.html#isIgnoreUnknownBeanProperties--">isIgnoreUnknownBeanProperties</a>, <a href="../../../../org/apache/juneau/BeanSession.html#newBean-java.lang.Class-">newBean</a>, <a href="../../../../org/apache/juneau/BeanSession.html#newBean-java.lang.Object-java.lang.Class-">newBean</a>, <a href="../../../../org/apache/juneau/BeanSession.html#newBeanMap-java.lang.Class-">newBeanMap</a>, <a href="../../../../org/apache/juneau/BeanSession.html#newBeanMap-java.lang.Object-java.lang.Class-">newBeanMap</a>, <a href="../../../../org/apache/juneau/BeanSession.html#object--">object</a>, <a href="../../../../org/apache/juneau/BeanSession.html#returnStringBuilder-java.lang.StringBuilder-">returnStrin
gBuilder</a>, <a href="../../../../org/apache/juneau/BeanSession.html#string--">string</a>, <a href="../../../../org/apache/juneau/BeanSession.html#toArray-org.apache.juneau.ClassMeta-java.util.Collection-">toArray</a>, <a href="../../../../org/apache/juneau/BeanSession.html#toBeanMap-T-">toBeanMap</a>, <a href="../../../../org/apache/juneau/BeanSession.html#toBeanMap-T-java.lang.Class-">toBeanMap</a></code></li>
+<code><a href="../../../../org/apache/juneau/BeanSession.html#Z:Z_class--">_class</a>, <a href="../../../../org/apache/juneau/BeanSession.html#asMap--">asMap</a>, <a href="../../../../org/apache/juneau/BeanSession.html#close--">close</a>, <a href="../../../../org/apache/juneau/BeanSession.html#convertToType-java.lang.Object-java.lang.Class-">convertToType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#convertToType-java.lang.Object-org.apache.juneau.ClassMeta-">convertToType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#convertToType-java.lang.Object-java.lang.Object-java.lang.Class-">convertToType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#convertToType-java.lang.Object-java.lang.Object-org.apache.juneau.ClassMeta-">convertToType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getArgsClassMeta-java.lang.reflect.Type:A-">getArgsClassMeta</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getBeanMeta-java.lang.Clas
s-">getBeanMeta</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getBeanRegistry--">getBeanRegistry</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getBeanTypePropertyName-org.apache.juneau.ClassMeta-">getBeanTypePropertyName</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getClassLoader--">getClassLoader</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getClassMeta-java.lang.Class-">getClassMeta</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getClassMeta-java.lang.reflect.Type-java.lang.reflect.Type...-">getClassMeta</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getClassMetaForObject-T-">getClassMetaForObject</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getLocale--">getLocale</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getMediaType--">getMediaType</a>, <a href="../../../../org/apache/juneau/BeanSession.html#getStringBuilder--">getStringBuilder</a>, <a href="../../../../or
g/apache/juneau/BeanSession.html#getTimeZone--">getTimeZone</a>, <a href="../../../../org/apache/juneau/BeanSession.html#isBean-java.lang.Class-">isBean</a>, <a href="../../../../org/apache/juneau/BeanSession.html#isBean-java.lang.Object-">isBean</a>, <a href="../../../../org/apache/juneau/BeanSession.html#isDebug--">isDebug</a>, <a href="../../../../org/apache/juneau/BeanSession.html#isIgnoreUnknownBeanProperties--">isIgnoreUnknownBeanProperties</a>, <a href="../../../../org/apache/juneau/BeanSession.html#newBean-java.lang.Class-">newBean</a>, <a href="../../../../org/apache/juneau/BeanSession.html#newBean-java.lang.Object-java.lang.Class-">newBean</a>, <a href="../../../../org/apache/juneau/BeanSession.html#newBeanMap-java.lang.Class-">newBeanMap</a>, <a href="../../../../org/apache/juneau/BeanSession.html#newBeanMap-java.lang.Object-java.lang.Class-">newBeanMap</a>, <a href="../../../../org/apache/juneau/BeanSession.html#object--">object</a>, <a href="../../../../org/apache/junea
u/BeanSession.html#returnStringBuilder-java.lang.StringBuilder-">returnStringBuilder</a>, <a href="../../../../org/apache/juneau/BeanSession.html#string--">string</a>, <a href="../../../../org/apache/juneau/BeanSession.html#toArray-org.apache.juneau.ClassMeta-java.util.Collection-">toArray</a>, <a href="../../../../org/apache/juneau/BeanSession.html#toBeanMap-T-">toBeanMap</a>, <a href="../../../../org/apache/juneau/BeanSession.html#toBeanMap-T-java.lang.Class-">toBeanMap</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.apache.juneau.Session">
<!-- -->
</a>
<h3>Methods inherited from class org.apache.juneau.<a href="../../../../org/apache/juneau/Session.html" title="class in org.apache.juneau">Session</a></h3>
-<code><a href="../../../../org/apache/juneau/Session.html#addToCache-java.util.Map-">addToCache</a>, <a href="../../../../org/apache/juneau/Session.html#addToCache-java.lang.String-java.lang.Object-">addToCache</a>, <a href="../../../../org/apache/juneau/Session.html#addWarning-java.lang.String-java.lang.Object...-">addWarning</a>, <a href="../../../../org/apache/juneau/Session.html#finalize--">finalize</a>, <a href="../../../../org/apache/juneau/Session.html#getFromCache-java.lang.Class-java.lang.String-">getFromCache</a>, <a href="../../../../org/apache/juneau/Session.html#getLogger--">getLogger</a>, <a href="../../../../org/apache/juneau/Session.html#getProperty-java.lang.Class-java.lang.String-">getProperty</a>, <a href="../../../../org/apache/juneau/Session.html#getProperty-java.lang.Class-java.lang.String-T-">getProperty</a>, <a href="../../../../org/apache/juneau/Session.html#getProperty-java.lang.String-">getProperty</a>, <a href="../../../../org/apache/juneau/Session.html#g
etProperty-java.lang.String-java.lang.String-">getProperty</a>, <a href="../../../../org/apache/juneau/Session.html#getWarnings--">getWarnings</a>, <a href="../../../../org/apache/juneau/Session.html#hasWarnings--">hasWarnings</a>, <a href="../../../../org/apache/juneau/Session.html#toString--">toString</a></code></li>
+<code><a href="../../../../org/apache/juneau/Session.html#addToCache-java.util.Map-">addToCache</a>, <a href="../../../../org/apache/juneau/Session.html#addToCache-java.lang.String-java.lang.Object-">addToCache</a>, <a href="../../../../org/apache/juneau/Session.html#addWarning-java.lang.String-java.lang.Object...-">addWarning</a>, <a href="../../../../org/apache/juneau/Session.html#finalize--">finalize</a>, <a href="../../../../org/apache/juneau/Session.html#getFromCache-java.lang.Class-java.lang.String-">getFromCache</a>, <a href="../../../../org/apache/juneau/Session.html#getLogger--">getLogger</a>, <a href="../../../../org/apache/juneau/Session.html#getProperties--">getProperties</a>, <a href="../../../../org/apache/juneau/Session.html#getProperty-java.lang.Class-java.lang.String-">getProperty</a>, <a href="../../../../org/apache/juneau/Session.html#getProperty-java.lang.Class-java.lang.String-T-">getProperty</a>, <a href="../../../../org/apache/juneau/Session.html#getProperty-j
ava.lang.String-">getProperty</a>, <a href="../../../../org/apache/juneau/Session.html#getProperty-java.lang.String-java.lang.String-">getProperty</a>, <a href="../../../../org/apache/juneau/Session.html#getWarnings--">getWarnings</a>, <a href="../../../../org/apache/juneau/Session.html#hasWarnings--">hasWarnings</a>, <a href="../../../../org/apache/juneau/Session.html#toString--">toString</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
@@ -317,54 +395,20 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<!-- -->
</a>
<h3>Constructor Detail</h3>
-<a name="ParserSession-org.apache.juneau.parser.ParserContext-org.apache.juneau.ObjectMap-java.lang.Object-java.lang.reflect.Method-java.lang.Object-java.util.Locale-java.util.TimeZone-org.apache.juneau.http.MediaType-">
+<a name="ParserSession-org.apache.juneau.parser.ParserContext-org.apache.juneau.parser.ParserSessionArgs-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>ParserSession</h4>
-<pre>public <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.89">ParserSession</a>(<a href="../../../../org/apache/juneau/parser/ParserContext.html" title="class in org.apache.juneau.parser">ParserContext</a> ctx,
- <a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a> op,
- <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> input,
- <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> javaMethod,
- <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> outer,
- <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a> locale,
- <a href="http://docs.oracle.com/javase/7/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util">TimeZone</a> timeZone,
- <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> mediaType)</pre>
+<pre>protected <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.56">ParserSession</a>(<a href="../../../../org/apache/juneau/parser/ParserContext.html" title="class in org.apache.juneau.parser">ParserContext</a> ctx,
+ <a href="../../../../org/apache/juneau/parser/ParserSessionArgs.html" title="class in org.apache.juneau.parser">ParserSessionArgs</a> args)</pre>
<div class="block">Create a new session using properties specified in the context.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>ctx</code> - The context creating this session object.
The context contains all the configuration settings for this object.</dd>
-<dd><code>input</code> - The input.
- <br>For character-based parsers, this can be any of the following types:
- <ul>
- <li><jk>null</jk>
- <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a>
- <li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/CharSequence.html?is-external=true" title="class or interface in java.lang"><code>CharSequence</code></a>
- <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> containing UTF-8 encoded text (or whatever the encoding specified by
- <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_inputStreamCharset"><code>ParserContext.PARSER_inputStreamCharset</code></a>).
- <li><code><jk>byte</jk>[]</code> containing UTF-8 encoded text (or whatever the encoding specified by
- <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_inputStreamCharset"><code>ParserContext.PARSER_inputStreamCharset</code></a>).
- <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io"><code>File</code></a> containing system encoded text (or whatever the encoding specified by
- <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_fileCharset"><code>ParserContext.PARSER_fileCharset</code></a>).
- </ul>
- <br>For byte-based parsers, this can be any of the following types:
- <ul>
- <li><jk>null</jk>
- <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a>
- <li><code><jk>byte</jk>[]</code>
- <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io"><code>File</code></a>
- </ul></dd>
-<dd><code>op</code> - The override properties.
- These override any context properties defined in the context.</dd>
-<dd><code>javaMethod</code> - The java method that called this parser, usually the method in a REST servlet.</dd>
-<dd><code>outer</code> - The outer object for instantiating top-level non-static inner classes.</dd>
-<dd><code>locale</code> - The session locale.
- If <jk>null</jk>, then the locale defined on the context is used.</dd>
-<dd><code>timeZone</code> - The session timezone.
- If <jk>null</jk>, then the timezone defined on the context is used.</dd>
-<dd><code>mediaType</code> - The session media type (e.g. <js>"application/json"</js>).</dd>
+<dd><code>args</code> - Runtime session arguments.</dd>
</dl>
</li>
</ul>
@@ -376,71 +420,93 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<!-- -->
</a>
<h3>Method Detail</h3>
-<a name="getInputStream--">
+<a name="doParse-org.apache.juneau.parser.ParserPipe-org.apache.juneau.ClassMeta-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>getInputStream</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.121">getInputStream</a>()
- throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
-<div class="block">Wraps the specified input object inside an input stream.
-
- <p>
- Subclasses can override this method to implement their own input streams.</div>
+<h4>doParse</h4>
+<pre>protected abstract <T> T <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.100">doParse</a>(<a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser">ParserPipe</a> pipe,
+ <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><T> type)
+ throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
+<div class="block">Workhorse method. Subclasses are expected to implement this method.</div>
<dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>T</code> - The class type of the object to create.</dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>pipe</code> - Where to get the input from.</dd>
+<dd><code>type</code> - The class type of the object to create.
+ If <jk>null</jk> or <code>Object.<jk>class</jk></code>, object type is based on what's being parsed.
+ For example, when parsing JSON text, it may return a <code>String</code>, <code>Number</code>,
+ <code>ObjectMap</code>, etc...</dd>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The input object wrapped in an input stream, or <jk>null</jk> if the object is null.</dd>
+<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 object could not be converted to an input stream.</dd>
+<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></code> - If thrown from underlying stream, or if the input contains a syntax error or is malformed.</dd>
</dl>
</li>
</ul>
-<a name="getReader--">
+<a name="isReaderParser--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>getReader</h4>
-<pre>public <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> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.167">getReader</a>()
- throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
-<div class="block">Wraps the specified input object inside a reader.
-
- <p>
- Subclasses can override this method to implement their own readers.</div>
+<h4>isReaderParser</h4>
+<pre>public abstract boolean <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.107">isReaderParser</a>()</pre>
+<div class="block">Returns <jk>true</jk> if this parser subclasses from <a href="../../../../org/apache/juneau/parser/ReaderParser.html" title="class in org.apache.juneau.parser"><code>ReaderParser</code></a>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The input object wrapped in a Reader, or <jk>null</jk> if the object is null.</dd>
-<dt><span class="throwsLabel">Throws:</span></dt>
-<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></code> - If object could not be converted to a reader.</dd>
+<dd><jk>true</jk> if this parser subclasses from <a href="../../../../org/apache/juneau/parser/ReaderParser.html" title="class in org.apache.juneau.parser"><code>ReaderParser</code></a>.</dd>
</dl>
</li>
</ul>
-<a name="getLastLocation--">
+<a name="createPipe-java.lang.Object-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>getLastLocation</h4>
-<pre>public <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/Object.html?is-external=true" title="class or interface in java.lang">Object</a>> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.240">getLastLocation</a>()</pre>
-<div class="block">Returns information used to determine at what location in the parse a failure occurred.</div>
+<h4>createPipe</h4>
+<pre>public final <a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser">ParserPipe</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.142">createPipe</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> input)</pre>
+<div class="block">Wraps the specified input object into a <a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser"><code>ParserPipe</code></a> object so that it can be easily converted into
+ a stream or reader.</div>
<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>input</code> - The input.
+ <br>For character-based parsers, this can be any of the following types:
+ <ul>
+ <li><jk>null</jk>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/CharSequence.html?is-external=true" title="class or interface in java.lang"><code>CharSequence</code></a>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> containing UTF-8 encoded text (or whatever the encoding specified by
+ <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_inputStreamCharset"><code>ParserContext.PARSER_inputStreamCharset</code></a>).
+ <li><code><jk>byte</jk>[]</code> containing UTF-8 encoded text (or whatever the encoding specified by
+ <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_inputStreamCharset"><code>ParserContext.PARSER_inputStreamCharset</code></a>).
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io"><code>File</code></a> containing system encoded text (or whatever the encoding specified by
+ <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_fileCharset"><code>ParserContext.PARSER_fileCharset</code></a>).
+ </ul>
+ <br>For byte-based parsers, this can be any of the following types:
+ <ul>
+ <li><jk>null</jk>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a>
+ <li><code><jk>byte</jk>[]</code>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io"><code>File</code></a>
+ </ul></dd>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>A map, typically containing something like <code>{line:123,column:456,currentProperty:"foobar"}</code></dd>
+<dd>A new <a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser"><code>ParserPipe</code></a> wrapper around the specified input object.</dd>
</dl>
</li>
</ul>
-<a name="getInput--">
+<a name="getLastLocation--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>getInput</h4>
-<pre>protected <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.254">getInput</a>()</pre>
-<div class="block">Returns the raw input object passed into this session.</div>
+<h4>getLastLocation</h4>
+<pre>public final <a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.151">getLastLocation</a>()</pre>
+<div class="block">Returns information used to determine at what location in the parse a failure occurred.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The raw input object passed into this session.</dd>
+<dd>A map, typically containing something like <code>{line:123,column:456,currentProperty:"foobar"}</code></dd>
</dl>
</li>
</ul>
@@ -450,7 +516,7 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getJavaMethod</h4>
-<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.267">getJavaMethod</a>()</pre>
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true" title="class or interface in java.lang.reflect">Method</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.169">getJavaMethod</a>()</pre>
<div class="block">Returns the Java method that invoked this parser.
<p>
@@ -468,7 +534,7 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getOuter</h4>
-<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.279">getOuter</a>()</pre>
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.181">getOuter</a>()</pre>
<div class="block">Returns the outer object used for instantiating top-level non-static member classes.
<p>
@@ -485,7 +551,7 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>setCurrentProperty</h4>
-<pre>public void <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.288">setCurrentProperty</a>(<a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> currentProperty)</pre>
+<pre>protected final void <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.190">setCurrentProperty</a>(<a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> currentProperty)</pre>
<div class="block">Sets the current bean property being parsed for proper error messages.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -499,7 +565,7 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>setCurrentClass</h4>
-<pre>public void <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.297">setCurrentClass</a>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> currentClass)</pre>
+<pre>protected final void <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.199">setCurrentClass</a>(<a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> currentClass)</pre>
<div class="block">Sets the current class being parsed for proper error messages.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -513,7 +579,7 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>isTrimStrings</h4>
-<pre>public final boolean <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.306">isTrimStrings</a>()</pre>
+<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.208">isTrimStrings</a>()</pre>
<div class="block">Returns the <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_trimStrings"><code>ParserContext.PARSER_trimStrings</code></a> setting value for this session.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -527,7 +593,7 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>isStrict</h4>
-<pre>public final boolean <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.315">isStrict</a>()</pre>
+<pre>protected final boolean <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.217">isStrict</a>()</pre>
<div class="block">Returns the <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_strict"><code>ParserContext.PARSER_strict</code></a> setting value for this session.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -543,7 +609,7 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>trim</h4>
-<pre>public final <K> K <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.326">trim</a>(K o)</pre>
+<pre>protected final <K> K <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.228">trim</a>(K o)</pre>
<div class="block">Trims the specified object if it's a <code>String</code> and <a href="../../../../org/apache/juneau/parser/ParserSession.html#isTrimStrings--"><code>isTrimStrings()</code></a> returns <jk>true</jk>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -559,7 +625,7 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>trim</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/parser/ParserSession.html#line.339">trim</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>
+<pre>protected 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/parser/ParserSession.html#line.241">trim</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>
<div class="block">Trims the specified string if <a href="../../../../org/apache/juneau/parser/ParserSession.html#isTrimStrings--"><code>isTrimStrings()</code></a> returns <jk>true</jk>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -575,9 +641,9 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>cast</h4>
-<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.354">cast</a>(<a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a> m,
- <a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta,
- <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> eType)</pre>
+<pre>protected final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.256">cast</a>(<a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau">ObjectMap</a> m,
+ <a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta,
+ <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> eType)</pre>
<div class="block">Converts the specified <code>ObjectMap</code> into a bean identified by the <js>"_type"</js> property in the map.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -595,9 +661,9 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getClassMeta</h4>
-<pre>public final <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.393">getClassMeta</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> typeName,
- <a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta,
- <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> eType)</pre>
+<pre>protected final <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.295">getClassMeta</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> typeName,
+ <a href="../../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta,
+ <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> eType)</pre>
<div class="block">Give the specified dictionary name, resolve it to a class.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -609,22 +675,24 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
</dl>
</li>
</ul>
-<a name="onUnknownProperty-java.lang.String-org.apache.juneau.BeanMap-int-int-">
+<a name="onUnknownProperty-org.apache.juneau.parser.ParserPipe-java.lang.String-org.apache.juneau.BeanMap-int-int-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>onUnknownProperty</h4>
-<pre>public <T> void <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.427">onUnknownProperty</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> propertyName,
- <a href="../../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><T> beanMap,
- int line,
- int col)
- throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
+<pre>protected final <T> void <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.330">onUnknownProperty</a>(<a href="../../../../org/apache/juneau/parser/ParserPipe.html" title="class in org.apache.juneau.parser">ParserPipe</a> pipe,
+ <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> propertyName,
+ <a href="../../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><T> beanMap,
+ int line,
+ int col)
+ throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
<div class="block">Method that gets called when an unknown bean property name is encountered.</div>
<dl>
<dt><span class="paramLabel">Type Parameters:</span></dt>
<dd><code>T</code> - The class type of the bean map that doesn't have the expected property.</dd>
<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>pipe</code> - The parser input.</dd>
<dd><code>propertyName</code> - The unknown bean property name.</dd>
<dd><code>beanMap</code> - The bean that doesn't have the expected property.</dd>
<dd><code>line</code> - The line number where the property was found. <code>-1</code> if line numbers are not available.</dd>
@@ -635,36 +703,396 @@ extends <a href="../../../../org/apache/juneau/BeanSession.html" title="class in
</dl>
</li>
</ul>
-<a name="getInputAsString--">
+<a name="parse-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type...-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>getInputAsString</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.447">getInputAsString</a>()</pre>
-<div class="block">Returns the input to this parser as a plain string.
+<h4>parse</h4>
+<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.419">parse</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> input,
+ <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">Parses input into the specified object type.
+
+ <p>
+ The type can be a simple type (e.g. beans, strings, numbers) or parameterized type (collections/maps).
+
+ <h5 class='section'>Examples:</h5>
+ <p class='bcode'>
+ ReaderParser p = JsonParser.<jsf>DEFAULT</jsf>;
+
+ <jc>// Parse into a linked-list of strings.</jc>
+ List l = p.parse(json, LinkedList.<jk>class</jk>, String.<jk>class</jk>);
+
+ <jc>// Parse into a linked-list of beans.</jc>
+ List l = p.parse(json, LinkedList.<jk>class</jk>, MyBean.<jk>class</jk>);
+
+ <jc>// Parse into a linked-list of linked-lists of strings.</jc>
+ List l = p.parse(json, LinkedList.<jk>class</jk>, LinkedList.<jk>class</jk>, String.<jk>class</jk>);
+
+ <jc>// Parse into a map of string keys/values.</jc>
+ Map m = p.parse(json, TreeMap.<jk>class</jk>, String.<jk>class</jk>, String.<jk>class</jk>);
+
+ <jc>// Parse into a map containing string keys and values of lists containing beans.</jc>
+ Map m = p.parse(json, TreeMap.<jk>class</jk>, String.<jk>class</jk>, List.<jk>class</jk>, MyBean.<jk>class</jk>);
+ </p>
+
+ <p>
+ <code>Collection</code> classes are assumed to be followed by zero or one objects indicating the element type.
+
+ <p>
+ <code>Map</code> classes are assumed to be followed by zero or two meta objects indicating the key and value types.
<p>
- This method only returns a value if <a href="../../../../org/apache/juneau/BeanContext.html#BEAN_debug"><code>BeanContext.BEAN_debug</code></a> is enabled.</div>
+ The array can be arbitrarily long to indicate arbitrarily complex data structures.
+
+ <h5 class='section'>Notes:</h5>
+ <ul>
+ <li>Use the <a href="../../../../org/apache/juneau/parser/ParserSession.html#parse-java.lang.Object-java.lang.Class-"><code>parse(Object, Class)</code></a> method instead if you don't need a parameterized map/collection.
+ </ul></div>
<dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>T</code> - The class type of the object to create.</dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>input</code> - The input.
+ <br>Character-based parsers can handle the following input class types:
+ <ul>
+ <li><jk>null</jk>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/CharSequence.html?is-external=true" title="class or interface in java.lang"><code>CharSequence</code></a>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> containing UTF-8 encoded text (or charset defined by
+ <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_inputStreamCharset"><code>ParserContext.PARSER_inputStreamCharset</code></a> property value).
+ <li><code><jk>byte</jk>[]</code> containing UTF-8 encoded text (or charset defined by
+ <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_inputStreamCharset"><code>ParserContext.PARSER_inputStreamCharset</code></a> property value).
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io"><code>File</code></a> containing system encoded text (or charset defined by
+ <a href="../../../../org/apache/juneau/parser/ParserContext.html#PARSER_fileCharset"><code>ParserContext.PARSER_fileCharset</code></a> property value).
+ </ul>
+ <br>Stream-based parsers can handle the following input class types:
+ <ul>
+ <li><jk>null</jk>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a>
+ <li><code><jk>byte</jk>[]</code>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io"><code>File</code></a>
+ </ul></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 input as a string, or <jk>null</jk> if debug mode not enabled.</dd>
+<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="close--">
+<a name="parse-java.lang.Object-java.lang.Class-">
<!-- -->
</a>
-<ul class="blockListLast">
+<ul class="blockList">
+<li class="blockList">
+<h4>parse</h4>
+<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.463">parse</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> input,
+ <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/parser/ParserSession.html#parse-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>parse(Object, Type, Type...)</code></a> except optimized for a non-parameterized class.
+
+ <p>
+ This is the preferred parse method for simple types since you don't need to cast the results.
+
+ <h5 class='section'>Examples:</h5>
+ <p class='bcode'>
+ ReaderParser p = JsonParser.<jsf>DEFAULT</jsf>;
+
+ <jc>// Parse into a string.</jc>
+ String s = p.parse(json, String.<jk>class</jk>);
+
+ <jc>// Parse into a bean.</jc>
+ MyBean b = p.parse(json, MyBean.<jk>class</jk>);
+
+ <jc>// Parse into a bean array.</jc>
+ MyBean[] ba = p.parse(json, MyBean[].<jk>class</jk>);
+
+ <jc>// Parse into a linked-list of objects.</jc>
+ List l = p.parse(json, LinkedList.<jk>class</jk>);
+
+ <jc>// Parse into a map of object keys/values.</jc>
+ Map m = p.parse(json, TreeMap.<jk>class</jk>);
+ </p></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>input</code> - The input.
+ See <a href="../../../../org/apache/juneau/parser/ParserSession.html#parse-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>parse(Object, Type, Type...)</code></a> for details.</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>
+</dl>
+</li>
+</ul>
+<a name="parse-java.lang.Object-org.apache.juneau.ClassMeta-">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>parse</h4>
+<pre>public final <T> T <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.488">parse</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> input,
+ <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</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/parser/ParserSession.html#parse-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>parse(Object, Type, Type...)</code></a> except the type has already been converted into a <a href="../../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau"><code>ClassMeta</code></a>
+ object.
+
+ <p>
+ This is mostly an internal method used by the framework.</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>input</code> - The input.
+ See <a href="../../../../org/apache/juneau/parser/ParserSession.html#parse-java.lang.Object-java.lang.reflect.Type-java.lang.reflect.Type...-"><code>parse(Object, Type, Type...)</code></a> for details.</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>
+</dl>
+</li>
+</ul>
+<a name="parseIntoMap-java.lang.Object-java.util.Map-java.lang.reflect.Type-java.lang.reflect.Type-">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>parseIntoMap</h4>
+<pre>public final <K,V> <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><K,V> <a href="../../../../src-html/org/apache/juneau/parser/ParserSession.html#line.553">parseIntoMap</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> input,
+ <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><K,V> m,
+ <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> keyType,
+ <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> valueType)
+ throws <a href="../../../../org/apache/juneau/parser/ParseException.html" title="class in org.apache.juneau.parser">ParseException</a></pre>
+<div class="block">Parses the contents of the specified reader and loads the results into the specified map.
+
+ <p>
+ Reader must contain something that serializes to a map (such as text containing a JSON object).
+
+ <p>
+ Used in the following locations:
+ <ul class='spaced-list'>
+ <li>
+ The various character-based constructors in <a href="../../../../org/apache/juneau/ObjectMap.html" title="class in org.apache.juneau"><code>ObjectMap</code></a> (e.g.
+ <a href="../../../../org/apache/juneau/ObjectMap.html#ObjectMap-java.lang.CharSequence-org.apache.juneau.parser.Parser-"><code>ObjectMap.ObjectMap(CharSequence,Parser)</code></a>).
+ </ul></div>
+<dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>K</code> - The key class type.</dd>
+<dd><code>V</code> - The value class type.</dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>i
<TRUNCATED>