http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/46c4861b/content/site/apidocs/org/apache/juneau/BeanPropertyMeta.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/org/apache/juneau/BeanPropertyMeta.html b/content/site/apidocs/org/apache/juneau/BeanPropertyMeta.html index 23943db..e099e52 100644 --- a/content/site/apidocs/org/apache/juneau/BeanPropertyMeta.html +++ b/content/site/apidocs/org/apache/juneau/BeanPropertyMeta.html @@ -18,7 +18,7 @@ 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 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,"i17":10,"i18":10}; var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -162,13 +162,6 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <div class="block">Creates a new BeanPropertyMeta using the contents of the specified builder.</div> </td> </tr> -<tr class="rowColor"> -<td class="colFirst"><code>protected </code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#BeanPropertyMeta-java.lang.String-org.apache.juneau.BeanPropertyMeta-">BeanPropertyMeta</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name, - <a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> b)</code> -<div class="block">Creates a BeanPropertyMeta for an "extras" property.</div> -</td> -</tr> </table> </li> </ul> @@ -186,14 +179,16 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? </tr> <tr id="i0" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#add-org.apache.juneau.BeanMap-java.lang.Object-">add</a></span>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, +<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#add-org.apache.juneau.BeanMap-java.lang.String-java.lang.Object-">add</a></span>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, + <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> pName, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value)</code> <div class="block">Adds a value to a <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> or array property.</div> </td> </tr> <tr id="i1" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#add-org.apache.juneau.BeanMap-java.lang.String-java.lang.Object-">add</a></span>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, +<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#add-org.apache.juneau.BeanMap-java.lang.String-java.lang.String-java.lang.Object-">add</a></span>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, + <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> pName, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value)</code> <div class="block">Adds a value to a <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> or bean property.</div> @@ -207,7 +202,8 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? </tr> <tr id="i3" 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/BeanPropertyMeta.html#get-org.apache.juneau.BeanMap-">get</a></span>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#get-org.apache.juneau.BeanMap-java.lang.String-">get</a></span>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, + <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> pName)</code> <div class="block">Equivalent to calling <a href="../../../org/apache/juneau/BeanMap.html#get-java.lang.Object-"><code>BeanMap.get(Object)</code></a>, but is faster since it avoids looking up the property meta.</div> </td> </tr> @@ -230,64 +226,77 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? </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> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#getDynaMap-java.lang.Object-">getDynaMap</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> bean)</code> +<div class="block">Returns the <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> object returned by the DynaBean getter.</div> +</td> +</tr> +<tr id="i8" class="altColor"> <td class="colFirst"><code><M extends <a href="../../../org/apache/juneau/BeanPropertyMetaExtended.html" title="class in org.apache.juneau">BeanPropertyMetaExtended</a>><br>M</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#getExtendedMeta-java.lang.Class-">getExtendedMeta</a></span>(<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><M> c)</code> <div class="block">Returns the language-specified extended metadata on this bean property.</div> </td> </tr> -<tr id="i8" class="altColor"> +<tr id="i9" class="rowColor"> <td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Field.html?is-external=true" title="class or interface in java.lang.reflect">Field</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#getField--">getField</a></span>()</code> <div class="block">Returns the field for this property.</div> </td> </tr> -<tr id="i9" class="rowColor"> +<tr id="i10" 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="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#getGetter--">getGetter</a></span>()</code> <div class="block">Returns the getter method for this property.</div> </td> </tr> -<tr id="i10" class="altColor"> +<tr id="i11" class="rowColor"> <td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#getName--">getName</a></span>()</code> <div class="block">Returns the name of this bean property.</div> </td> </tr> -<tr id="i11" class="rowColor"> +<tr id="i12" 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/BeanPropertyMeta.html#getProperties--">getProperties</a></span>()</code> <div class="block">Returns the override list of properties defined through a <a href="../../../org/apache/juneau/annotation/BeanProperty.html#properties--"><code>BeanProperty.properties()</code></a> annotation on this property.</div> </td> </tr> -<tr id="i12" class="altColor"> +<tr id="i13" class="rowColor"> <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="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#getSetter--">getSetter</a></span>()</code> <div class="block">Returns the setter method for this property.</div> </td> </tr> -<tr id="i13" class="rowColor"> +<tr id="i14" class="altColor"> +<td class="colFirst"><code>boolean</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#isDyna--">isDyna</a></span>()</code> +<div class="block">Returns <jk>true</jk> if this bean property is named <js>"*"</js>.</div> +</td> +</tr> +<tr id="i15" class="rowColor"> <td class="colFirst"><code>boolean</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#isUri--">isUri</a></span>()</code> <div class="block">Returns <jk>true</jk> if this bean property is a URI.</div> </td> </tr> -<tr id="i14" class="altColor"> +<tr id="i16" 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="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#set-org.apache.juneau.BeanMap-java.lang.Object-">set</a></span>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, +<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#set-org.apache.juneau.BeanMap-java.lang.String-java.lang.Object-">set</a></span>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, + <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> pName, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value)</code> <div class="block">Equivalent to calling <a href="../../../org/apache/juneau/BeanMap.html#put-java.lang.String-java.lang.Object-"><code>BeanMap.put(String, Object)</code></a>, but is faster since it avoids looking up the property meta.</div> </td> </tr> -<tr id="i15" class="rowColor"> +<tr id="i17" class="rowColor"> <td class="colFirst"><code>protected void</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyMeta.html#setArray-java.lang.Object-java.util.List-">setArray</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> bean, <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a> l)</code> <div class="block">Sets an array field on this bean.</div> </td> </tr> -<tr id="i16" class="altColor"> +<tr id="i18" 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/BeanPropertyMeta.html#toString--">toString</a></span>()</code> </td> </tr> @@ -316,10 +325,10 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <a name="BeanPropertyMeta-org.apache.juneau.BeanPropertyMeta.Builder-"> <!-- --> </a> -<ul class="blockList"> +<ul class="blockListLast"> <li class="blockList"> <h4>BeanPropertyMeta</h4> -<pre>protected <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.265">BeanPropertyMeta</a>(<a href="../../../org/apache/juneau/BeanPropertyMeta.Builder.html" title="class in org.apache.juneau">BeanPropertyMeta.Builder</a> b)</pre> +<pre>protected <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.266">BeanPropertyMeta</a>(<a href="../../../org/apache/juneau/BeanPropertyMeta.Builder.html" title="class in org.apache.juneau">BeanPropertyMeta.Builder</a> b)</pre> <div class="block">Creates a new BeanPropertyMeta using the contents of the specified builder.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -327,24 +336,6 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? </dl> </li> </ul> -<a name="BeanPropertyMeta-java.lang.String-org.apache.juneau.BeanPropertyMeta-"> -<!-- --> -</a> -<ul class="blockListLast"> -<li class="blockList"> -<h4>BeanPropertyMeta</h4> -<pre>protected <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.292">BeanPropertyMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name, - <a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> b)</pre> -<div class="block">Creates a BeanPropertyMeta for an "extras" property. - <p> - An extras property is one defined with <code><ja>@BeanProperty</ja>(name=<js>"*"</js>)</code></div> -<dl> -<dt><span class="paramLabel">Parameters:</span></dt> -<dd><code>name</code> - The bean property name (e.g. the key if this is a Map field, or the value passed to the getter/setter as the property name).</dd> -<dd><code>b</code> - The real bean property.</dd> -</dl> -</li> -</ul> </li> </ul> <!-- ============ METHOD DETAIL ========== --> @@ -359,7 +350,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>getName</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/BeanPropertyMeta.html#line.316">getName</a>()</pre> +<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/BeanPropertyMeta.html#line.290">getName</a>()</pre> <div class="block">Returns the name of this bean property.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -374,7 +365,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <li class="blockList"> <h4>getBeanMeta</h4> <pre><a href="../../../org/apache/juneau/annotation/BeanIgnore.html" title="annotation in org.apache.juneau.annotation">@BeanIgnore</a> -public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in org.apache.juneau">BeanMeta</a><?> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.326">getBeanMeta</a>()</pre> +public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in org.apache.juneau">BeanMeta</a><?> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.300">getBeanMeta</a>()</pre> <div class="block">Returns the bean meta that this property belongs to.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -388,7 +379,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockList"> <li class="blockList"> <h4>getGetter</h4> -<pre>public <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/BeanPropertyMeta.html#line.335">getGetter</a>()</pre> +<pre>public <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/BeanPropertyMeta.html#line.309">getGetter</a>()</pre> <div class="block">Returns the getter method for this property.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -402,7 +393,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockList"> <li class="blockList"> <h4>getSetter</h4> -<pre>public <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/BeanPropertyMeta.html#line.344">getSetter</a>()</pre> +<pre>public <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/BeanPropertyMeta.html#line.318">getSetter</a>()</pre> <div class="block">Returns the setter method for this property.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -416,7 +407,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockList"> <li class="blockList"> <h4>getField</h4> -<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Field.html?is-external=true" title="class or interface in java.lang.reflect">Field</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.353">getField</a>()</pre> +<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Field.html?is-external=true" title="class or interface in java.lang.reflect">Field</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.327">getField</a>()</pre> <div class="block">Returns the field for this property.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -430,12 +421,12 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockList"> <li class="blockList"> <h4>getClassMeta</h4> -<pre>public <a href="../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.366">getClassMeta</a>()</pre> +<pre>public <a href="../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau">ClassMeta</a><?> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.340">getClassMeta</a>()</pre> <div class="block">Returns the <a href="../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau"><code>ClassMeta</code></a> of the class of this property. <p> If this property or the property type class has a <a href="../../../org/apache/juneau/transform/PojoSwap.html" title="class in org.apache.juneau.transform"><code>PojoSwap</code></a> associated with it, this method returns the transformed class meta. - This matches the class type that is used by the <a href="../../../org/apache/juneau/BeanPropertyMeta.html#get-org.apache.juneau.BeanMap-"><code>get(BeanMap)</code></a> and <a href="../../../org/apache/juneau/BeanPropertyMeta.html#set-org.apache.juneau.BeanMap-java.lang.Object-"><code>set(BeanMap, Object)</code></a> methods.</div> + This matches the class type that is used by the <a href="../../../org/apache/juneau/BeanPropertyMeta.html#get-org.apache.juneau.BeanMap-java.lang.String-"><code>get(BeanMap,String)</code></a> and <a href="../../../org/apache/juneau/BeanPropertyMeta.html#set-org.apache.juneau.BeanMap-java.lang.String-java.lang.Object-"><code>set(BeanMap,String,Object)</code></a> methods.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> <dd>The <a href="../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau"><code>ClassMeta</code></a> of the class of this property.</dd> @@ -448,7 +439,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockList"> <li class="blockList"> <h4>getBeanRegistry</h4> -<pre>public <a href="../../../org/apache/juneau/BeanRegistry.html" title="class in org.apache.juneau">BeanRegistry</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.379">getBeanRegistry</a>()</pre> +<pre>public <a href="../../../org/apache/juneau/BeanRegistry.html" title="class in org.apache.juneau">BeanRegistry</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.353">getBeanRegistry</a>()</pre> <div class="block">Returns the bean dictionary in use for this bean property. The order of lookup for the dictionary is as follows: <ol> @@ -467,7 +458,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockList"> <li class="blockList"> <h4>isUri</h4> -<pre>public boolean <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.395">isUri</a>()</pre> +<pre>public boolean <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.369">isUri</a>()</pre> <div class="block">Returns <jk>true</jk> if this bean property is a URI. <p> A bean property can be considered a URI if any of the following are true: @@ -482,13 +473,27 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o </dl> </li> </ul> +<a name="isDyna--"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>isDyna</h4> +<pre>public boolean <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.377">isDyna</a>()</pre> +<div class="block">Returns <jk>true</jk> if this bean property is named <js>"*"</js>.</div> +<dl> +<dt><span class="returnLabel">Returns:</span></dt> +<dd><jk>true</jk> if this bean property is named <js>"*"</js>.</dd> +</dl> +</li> +</ul> <a name="getProperties--"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getProperties</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/BeanPropertyMeta.html#line.405">getProperties</a>()</pre> +<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/BeanPropertyMeta.html#line.387">getProperties</a>()</pre> <div class="block">Returns the override list of properties defined through a <a href="../../../org/apache/juneau/annotation/BeanProperty.html#properties--"><code>BeanProperty.properties()</code></a> annotation on this property.</div> <dl> @@ -503,7 +508,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockList"> <li class="blockList"> <h4>getExtendedMeta</h4> -<pre>public <M extends <a href="../../../org/apache/juneau/BeanPropertyMetaExtended.html" title="class in org.apache.juneau">BeanPropertyMetaExtended</a>> M <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.415">getExtendedMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><M> c)</pre> +<pre>public <M extends <a href="../../../org/apache/juneau/BeanPropertyMetaExtended.html" title="class in org.apache.juneau">BeanPropertyMetaExtended</a>> M <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.397">getExtendedMeta</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><M> c)</pre> <div class="block">Returns the language-specified extended metadata on this bean property.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -513,29 +518,32 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o </dl> </li> </ul> -<a name="get-org.apache.juneau.BeanMap-"> +<a name="get-org.apache.juneau.BeanMap-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>get</h4> -<pre>public <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/BeanPropertyMeta.html#line.427">get</a>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m)</pre> +<pre>public <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/BeanPropertyMeta.html#line.410">get</a>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, + <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> pName)</pre> <div class="block">Equivalent to calling <a href="../../../org/apache/juneau/BeanMap.html#get-java.lang.Object-"><code>BeanMap.get(Object)</code></a>, but is faster since it avoids looking up the property meta.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>m</code> - The bean map to get the transformed value from.</dd> +<dd><code>pName</code> - The property name.</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>The property value.</dd> </dl> </li> </ul> -<a name="set-org.apache.juneau.BeanMap-java.lang.Object-"> +<a name="set-org.apache.juneau.BeanMap-java.lang.String-java.lang.Object-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>set</h4> -<pre>public <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/BeanPropertyMeta.html#line.502">set</a>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, +<pre>public <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/BeanPropertyMeta.html#line.478">set</a>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, + <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> pName, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value) throws <a href="../../../org/apache/juneau/BeanRuntimeException.html" title="class in org.apache.juneau">BeanRuntimeException</a></pre> <div class="block">Equivalent to calling <a href="../../../org/apache/juneau/BeanMap.html#put-java.lang.String-java.lang.Object-"><code>BeanMap.put(String, Object)</code></a>, but is faster since it avoids @@ -543,6 +551,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>m</code> - The bean map to set the property value on.</dd> +<dd><code>pName</code> - The property name.</dd> <dd><code>value</code> - The value to set.</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>The previous property value.</dd> @@ -551,13 +560,38 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o </dl> </li> </ul> +<a name="getDynaMap-java.lang.Object-"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>getDynaMap</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/BeanPropertyMeta.html#line.698">getDynaMap</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> bean) + throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a>, + <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalAccessException.html?is-external=true" title="class or interface in java.lang">IllegalAccessException</a>, + <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/InvocationTargetException.html?is-external=true" title="class or interface in java.lang.reflect">InvocationTargetException</a></pre> +<div class="block">Returns the <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> object returned by the DynaBean getter. + <p> + The DynaBean property is the property whose name is <js>"*"</js> and returns a map of "extra" properties on the bean.</div> +<dl> +<dt><span class="paramLabel">Parameters:</span></dt> +<dd><code>bean</code> - The bean.</dd> +<dt><span class="returnLabel">Returns:</span></dt> +<dd>The map returned by the getter, or an empty map if the getter returned <jk>null</jk> or this isn't a DynaBean property.</dd> +<dt><span class="throwsLabel">Throws:</span></dt> +<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - Thrown by method invocation.</dd> +<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalAccessException.html?is-external=true" title="class or interface in java.lang">IllegalAccessException</a></code> - Thrown by method invocation.</dd> +<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/InvocationTargetException.html?is-external=true" title="class or interface in java.lang.reflect">InvocationTargetException</a></code> - Thrown by method invocation.</dd> +</dl> +</li> +</ul> <a name="setArray-java.lang.Object-java.util.List-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>setArray</h4> -<pre>protected void <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.738">setArray</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> bean, +<pre>protected void <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.719">setArray</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> bean, <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a> l) throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalAccessException.html?is-external=true" title="class or interface in java.lang">IllegalAccessException</a>, @@ -575,13 +609,14 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o </dl> </li> </ul> -<a name="add-org.apache.juneau.BeanMap-java.lang.Object-"> +<a name="add-org.apache.juneau.BeanMap-java.lang.String-java.lang.Object-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>add</h4> -<pre>public void <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.757">add</a>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, +<pre>public void <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.734">add</a>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, + <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> pName, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value) throws <a href="../../../org/apache/juneau/BeanRuntimeException.html" title="class in org.apache.juneau">BeanRuntimeException</a></pre> <div class="block">Adds a value to a <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> or array property. @@ -590,19 +625,21 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>m</code> - The bean of the field being set.</dd> +<dd><code>pName</code> - The property name.</dd> <dd><code>value</code> - The value to add to the field.</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../org/apache/juneau/BeanRuntimeException.html" title="class in org.apache.juneau">BeanRuntimeException</a></code> - If field is not a collection or array.</dd> </dl> </li> </ul> -<a name="add-org.apache.juneau.BeanMap-java.lang.String-java.lang.Object-"> +<a name="add-org.apache.juneau.BeanMap-java.lang.String-java.lang.String-java.lang.Object-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>add</h4> -<pre>public void <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.851">add</a>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, +<pre>public void <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.811">add</a>(<a href="../../../org/apache/juneau/BeanMap.html" title="class in org.apache.juneau">BeanMap</a><?> m, + <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> pName, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value) throws <a href="../../../org/apache/juneau/BeanRuntimeException.html" title="class in org.apache.juneau">BeanRuntimeException</a></pre> @@ -610,6 +647,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>m</code> - The bean of the field being set.</dd> +<dd><code>pName</code> - The property name.</dd> <dd><code>key</code> - The key to add to the field.</dd> <dd><code>value</code> - The value to add to the field.</dd> <dt><span class="throwsLabel">Throws:</span></dt> @@ -623,7 +661,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockList"> <li class="blockList"> <h4>findAnnotations</h4> -<pre>public <A extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>> <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><A> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.952">findAnnotations</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><A> a)</pre> +<pre>public <A extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>> <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><A> <a href="../../../src-html/org/apache/juneau/BeanPropertyMeta.html#line.888">findAnnotations</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><A> a)</pre> <div class="block">Returns all instances of the specified annotation in the hierarchy of this bean property. <p> Searches through the class hierarchy (e.g. superclasses, interfaces, packages) for all @@ -642,7 +680,7 @@ public <a href="../../../org/apache/juneau/BeanMeta.html" title="class in o <ul class="blockListLast"> <li class="blockList"> <h4>toString</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/BeanPropertyMeta.html#line.1024">toString</a>()</pre> +<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/BeanPropertyMeta.html#line.960">toString</a>()</pre> <dl> <dt><span class="overrideSpecifyLabel">Overrides:</span></dt> <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a></code> in class <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></dd>
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/46c4861b/content/site/apidocs/org/apache/juneau/BeanPropertyValue.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/org/apache/juneau/BeanPropertyValue.html b/content/site/apidocs/org/apache/juneau/BeanPropertyValue.html index 7863a63..8c93e0f 100644 --- a/content/site/apidocs/org/apache/juneau/BeanPropertyValue.html +++ b/content/site/apidocs/org/apache/juneau/BeanPropertyValue.html @@ -18,7 +18,7 @@ catch(err) { } //--> -var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10}; +var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10}; var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -106,10 +106,15 @@ var activeTableTab = "activeTableTab"; <div class="description"> <ul class="blockList"> <li class="blockList"> +<dl> +<dt>All Implemented Interfaces:</dt> +<dd><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau">BeanPropertyValue</a>></dd> +</dl> <hr> <br> <pre>public class <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.19">BeanPropertyValue</a> -extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre> +extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> +implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau">BeanPropertyValue</a>></pre> <div class="block">Represents a simple bean property value and the meta-data associated with it. <p></div> </li> @@ -130,7 +135,8 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <th class="colOne" scope="col">Constructor and Description</th> </tr> <tr class="altColor"> -<td class="colOne"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyValue.html#BeanPropertyValue-org.apache.juneau.BeanPropertyMeta-java.lang.Object-java.lang.Throwable-">BeanPropertyValue</a></span>(<a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta, +<td class="colOne"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyValue.html#BeanPropertyValue-org.apache.juneau.BeanPropertyMeta-java.lang.String-java.lang.Object-java.lang.Throwable-">BeanPropertyValue</a></span>(<a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta, + <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> thrown)</code> <div class="block">Constructor.</div> @@ -152,30 +158,34 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <th class="colLast" scope="col">Method and Description</th> </tr> <tr id="i0" class="altColor"> +<td class="colFirst"><code>int</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyValue.html#compareTo-org.apache.juneau.BeanPropertyValue-">compareTo</a></span>(<a href="../../../org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau">BeanPropertyValue</a> o)</code> </td> +</tr> +<tr id="i1" class="rowColor"> <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/BeanPropertyValue.html#getClassMeta--">getClassMeta</a></span>()</code> <div class="block">Returns the bean property metadata.</div> </td> </tr> -<tr id="i1" class="rowColor"> +<tr id="i2" class="altColor"> <td class="colFirst"><code><a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyValue.html#getMeta--">getMeta</a></span>()</code> <div class="block">Returns the bean property metadata.</div> </td> </tr> -<tr id="i2" class="altColor"> +<tr id="i3" class="rowColor"> <td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyValue.html#getName--">getName</a></span>()</code> <div class="block">Returns the bean property name.</div> </td> </tr> -<tr id="i3" class="rowColor"> +<tr id="i4" class="altColor"> <td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/apache/juneau/BeanPropertyValue.html#getThrown--">getThrown</a></span>()</code> <div class="block">Returns the exception thrown by calling the property getter.</div> </td> </tr> -<tr id="i4" class="altColor"> +<tr id="i5" 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/BeanPropertyValue.html#getValue--">getValue</a></span>()</code> <div class="block">Returns the bean property value.</div> @@ -203,19 +213,21 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <!-- --> </a> <h3>Constructor Detail</h3> -<a name="BeanPropertyValue-org.apache.juneau.BeanPropertyMeta-java.lang.Object-java.lang.Throwable-"> +<a name="BeanPropertyValue-org.apache.juneau.BeanPropertyMeta-java.lang.String-java.lang.Object-java.lang.Throwable-"> <!-- --> </a> <ul class="blockListLast"> <li class="blockList"> <h4>BeanPropertyValue</h4> -<pre>public <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.32">BeanPropertyValue</a>(<a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta, +<pre>public <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.34">BeanPropertyValue</a>(<a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> pMeta, + <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> value, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> thrown)</pre> <div class="block">Constructor.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>pMeta</code> - The bean property metadata.</dd> +<dd><code>name</code> - The bean property name.</dd> <dd><code>value</code> - The bean property value.</dd> <dd><code>thrown</code> - The exception thrown by calling the property getter.</dd> </dl> @@ -235,7 +247,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>getMeta</h4> -<pre>public final <a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.42">getMeta</a>()</pre> +<pre>public final <a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau">BeanPropertyMeta</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.45">getMeta</a>()</pre> <div class="block">Returns the bean property metadata.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -249,7 +261,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <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/BeanPropertyValue.html#line.50">getClassMeta</a>()</pre> +<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/BeanPropertyValue.html#line.53">getClassMeta</a>()</pre> <div class="block">Returns the bean property metadata.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -263,7 +275,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>getName</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/BeanPropertyValue.html#line.58">getName</a>()</pre> +<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.61">getName</a>()</pre> <div class="block">Returns the bean property name.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -277,7 +289,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>getValue</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/BeanPropertyValue.html#line.66">getValue</a>()</pre> +<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/BeanPropertyValue.html#line.69">getValue</a>()</pre> <div class="block">Returns the bean property value.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -288,10 +300,10 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <a name="getThrown--"> <!-- --> </a> -<ul class="blockListLast"> +<ul class="blockList"> <li class="blockList"> <h4>getThrown</h4> -<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.74">getThrown</a>()</pre> +<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.77">getThrown</a>()</pre> <div class="block">Returns the exception thrown by calling the property getter.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -299,6 +311,19 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? </dl> </li> </ul> +<a name="compareTo-org.apache.juneau.BeanPropertyValue-"> +<!-- --> +</a> +<ul class="blockListLast"> +<li class="blockList"> +<h4>compareTo</h4> +<pre>public int <a href="../../../src-html/org/apache/juneau/BeanPropertyValue.html#line.82">compareTo</a>(<a href="../../../org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau">BeanPropertyValue</a> o)</pre> +<dl> +<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> +<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true#compareTo-T-" title="class or interface in java.lang">compareTo</a></code> in interface <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau">BeanPropertyValue</a>></code></dd> +</dl> +</li> +</ul> </li> </ul> </li> http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/46c4861b/content/site/apidocs/org/apache/juneau/annotation/BeanProperty.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/org/apache/juneau/annotation/BeanProperty.html b/content/site/apidocs/org/apache/juneau/annotation/BeanProperty.html index ac4c870..701c1b9 100644 --- a/content/site/apidocs/org/apache/juneau/annotation/BeanProperty.html +++ b/content/site/apidocs/org/apache/juneau/annotation/BeanProperty.html @@ -191,7 +191,7 @@ public @interface <a href="../../../../src-html/org/apache/juneau/annotation/Bea <ul class="blockList"> <li class="blockList"> <h4>name</h4> -<pre>public abstract <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.58">name</a></pre> +<pre>public abstract <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.127">name</a></pre> <div class="block">Identifies the name of the property. <p> Normally, this is automatically inferred from the field name or getter method name @@ -199,7 +199,76 @@ public @interface <a href="../../../../src-html/org/apache/juneau/annotation/Bea property name from the automatically inferred value. <p> If the <a href="../../../../org/apache/juneau/BeanContext.html#BEAN_beanFieldVisibility"><code>BeanContext.BEAN_beanFieldVisibility</code></a> setting on the bean context excludes this field (e.g. the visibility - is set to PUBLIC, but the field is PROTECTED), this annotation can be used to force the field to be identified as a property.</div> + is set to PUBLIC, but the field is PROTECTED), this annotation can be used to force the field to be identified as a property. + <p> + <h6 class='topic'>Dynamic beans</h6> + The bean property named <js>"*"</js> is the designated "dynamic property" which allows for "extra" bean properties not otherwise defined. + This is similar in concept to the Jackson <ja>@JsonGetterAll</ja> and <ja>@JsonSetterAll</ja> annotations. + The primary purpose is for backwards compatibility in parsing newer streams with addition information into older beans. + <p> + The following examples show how to define dynamic bean properties. + <p class='bcode'> + <jc>// Option #1 - A simple public Map field. + // The field name can be anything.</jc> + <jk>public class</jk> BeanWithDynaField { + + <ja>@BeanProperty</ja>(name=<js>"*"</js>) + <jk>public</jk> Map<String,Object> extraStuff = <jk>new</jk> LinkedHashMap<String,Object>(); + } + + <jc>// Option #2 - Getters and setters. + // Method names can be anything. + // Getter must return a Map with String keys. + // Setter must take in two arguments.</jc> + <jk>public class</jk> BeanWithDynaMethods { + + <ja>@BeanProperty</ja>(name=<js>"*"</js>) + <jk>public</jk> Map<String,Object> getMyExtraStuff() { + ... + } + + <ja>@BeanProperty</ja>(name=<js>"*"</js>) + <jk>public void</jk> setAnExtraField(String name, Object value) { + ... + } + } + + <jc>// Option #3 - Getter only. + // Properties will be added through the getter.</jc> + <jk>public class</jk> BeanWithDynaGetterOnly { + + <ja>@BeanProperty</ja>(name=<js>"*"</js>) + <jk>public</jk> Map<String,Object> getMyExtraStuff() { + ... + } + } + </p> + <p> + Similar rules apply for value types and swaps. The property values optionally can be any serializable type + or use swaps. + <p class='bcode'> + <jc>// A serializable type other than Object.</jc> + <jk>public class</jk> BeanWithDynaFieldWithListValues { + + <ja>@BeanProperty</ja>(name=<js>"*"</js>) + <jk>public</jk> Map<String,List<String>> getMyExtraStuff() { + ... + } + } + + <jc>// A swapped value.</jc> + <jk>public class</jk> BeanWithDynaFieldWithSwappedValues { + + <ja>@BeanProperty</ja>(name=<js>"*"</js>, swap=CalendarSwap.<jsf>ISO8601DTZ</jsf>.<jk>class</jk>) + <jk>public</jk> Map<String,Calendar> getMyExtraStuff() { + ... + } + } + </p> + <p class='info'> + Note that if you're not interested in these additional properties, you can also use the <a href="../../../../org/apache/juneau/BeanContext.html#BEAN_ignoreUnknownBeanProperties"><code>BeanContext.BEAN_ignoreUnknownBeanProperties</code></a> setting + to ignore values that don't fit into existing properties. + </p></div> <dl> <dt>Default:</dt> <dd>""</dd> @@ -215,7 +284,7 @@ public @interface <a href="../../../../src-html/org/apache/juneau/annotation/Bea <ul class="blockList"> <li class="blockList"> <h4>type</h4> -<pre>public abstract <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><?> <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.80">type</a></pre> +<pre>public abstract <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><?> <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.149">type</a></pre> <div class="block">Identifies a specialized class type for the property. <p> Normally this can be inferred through reflection of the field type or getter return type. @@ -249,7 +318,7 @@ public @interface <a href="../../../../src-html/org/apache/juneau/annotation/Bea <ul class="blockList"> <li class="blockList"> <h4>params</h4> -<pre>public abstract <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><?>[] <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.97">params</a></pre> +<pre>public abstract <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><?>[] <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.166">params</a></pre> <div class="block">For bean properties of maps and collections, this annotation can be used to identify the class types of the contents of the bean property object when the generic parameter types are interfaces or abstract classes. @@ -278,7 +347,7 @@ public @interface <a href="../../../../src-html/org/apache/juneau/annotation/Bea <ul class="blockList"> <li class="blockList"> <h4>swap</h4> -<pre>public abstract <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><?> <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.119">swap</a></pre> +<pre>public abstract <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><?> <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.188">swap</a></pre> <div class="block">Associates a <a href="../../../../org/apache/juneau/transform/PojoSwap.html" title="class in org.apache.juneau.transform"><code>PojoSwap</code></a> or <a href="../../../../org/apache/juneau/transform/SurrogateSwap.html" title="class in org.apache.juneau.transform"><code>SurrogateSwap</code></a> with this bean property that will swap the value object with another object during serialization and parsing. <p> @@ -312,7 +381,7 @@ public @interface <a href="../../../../src-html/org/apache/juneau/annotation/Bea <ul class="blockList"> <li class="blockList"> <h4>properties</h4> -<pre>public abstract <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.150">properties</a></pre> +<pre>public abstract <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.219">properties</a></pre> <div class="block">Used to limit which child properties are rendered by the serializers. <p> Can be used on any of the following bean property types: @@ -355,7 +424,7 @@ public @interface <a href="../../../../src-html/org/apache/juneau/annotation/Bea <ul class="blockListLast"> <li class="blockList"> <h4>beanDictionary</h4> -<pre>public abstract <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><?>[] <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.167">beanDictionary</a></pre> +<pre>public abstract <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><?>[] <a href="../../../../src-html/org/apache/juneau/annotation/BeanProperty.html#line.236">beanDictionary</a></pre> <div class="block">The list of classes that make up the bean dictionary for this bean property. <p> The dictionary is a name/class mapping used to find class types during parsing when they cannot be inferred through reflection. http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/46c4861b/content/site/apidocs/org/apache/juneau/package-tree.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/org/apache/juneau/package-tree.html b/content/site/apidocs/org/apache/juneau/package-tree.html index ff058b1..3c831b5 100644 --- a/content/site/apidocs/org/apache/juneau/package-tree.html +++ b/content/site/apidocs/org/apache/juneau/package-tree.html @@ -127,7 +127,7 @@ <li type="circle">org.apache.juneau.<a href="../../../org/apache/juneau/BeanPropertyMeta.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanPropertyMeta</span></a></li> <li type="circle">org.apache.juneau.<a href="../../../org/apache/juneau/BeanPropertyMeta.Builder.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanPropertyMeta.Builder</span></a></li> <li type="circle">org.apache.juneau.<a href="../../../org/apache/juneau/BeanPropertyMetaExtended.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanPropertyMetaExtended</span></a></li> -<li type="circle">org.apache.juneau.<a href="../../../org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanPropertyValue</span></a></li> +<li type="circle">org.apache.juneau.<a href="../../../org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanPropertyValue</span></a> (implements java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><T>)</li> <li type="circle">org.apache.juneau.<a href="../../../org/apache/juneau/BeanProxyInvocationHandler.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanProxyInvocationHandler</span></a><T> (implements java.lang.reflect.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/InvocationHandler.html?is-external=true" title="class or interface in java.lang.reflect">InvocationHandler</a>)</li> <li type="circle">org.apache.juneau.<a href="../../../org/apache/juneau/BeanRegistry.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanRegistry</span></a></li> <li type="circle">org.apache.juneau.<a href="../../../org/apache/juneau/ClassMeta.html" title="class in org.apache.juneau"><span class="typeNameLink">ClassMeta</span></a><T> (implements java.lang.reflect.<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>)</li> http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/46c4861b/content/site/apidocs/overview-summary.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/overview-summary.html b/content/site/apidocs/overview-summary.html index cee9f83..4f6e279 100644 --- a/content/site/apidocs/overview-summary.html +++ b/content/site/apidocs/overview-summary.html @@ -6088,7 +6088,7 @@ <h5 class='toc'>What's new in each release</h5> <ul class='toc'> - <li><p><a class='doclink' href='#6.2.1'>6.2.1 (TBD)</a></p> + <li><p><a class='doclink' href='#6.2.0'>6.2.1 (TBD)</a></p> <li><p><a class='doclink' href='#6.2.0'>6.2.0 (Apr 28, 2017)</a></p> <li><p><a class='doclink' href='#6.1.0'>6.1.0 (Feb 25, 2017)</a></p> <li><p><a class='doclink' href='#6.0.1'>6.0.1 (Jan 3, 2017)</a></p> @@ -6171,6 +6171,7 @@ <li><a href="org/apache/juneau/http/AcceptEncoding.html" title="class in org.apache.juneau.http"><code>AcceptEncoding</code></a> <li><a href="org/apache/juneau/http/ContentType.html" title="class in org.apache.juneau.http"><code>ContentType</code></a> </ul> + <li>Support for dynamic beans. See <a href="org/apache/juneau/annotation/BeanProperty.html#name--"><code>@BeanProperty.name()</code></a>. </ul> <h6 class='topic'>org.apache.juneau.rest</h6> @@ -7925,7 +7926,7 @@ <li>New <a href="org/apache/juneau/ClassMeta.html#isInstance-java.lang.Object-"><code>ClassMeta.isInstance(Object)</code></a> method. <li>Performance improvements when using the <a href="org/apache/juneau/BeanMap.html#add-java.lang.String-java.lang.Object-"><code>BeanMap.add(String,Object)</code></a> method. Array properties are stored in a temporary list cache until <a href="org/apache/juneau/BeanMap.html#getBean--"><code>BeanMap.getBean()</code></a> is called. - <li>New <a href="org/apache/juneau/BeanPropertyMeta.html#add-org.apache.juneau.BeanMap-java.lang.Object-"><code>BeanPropertyMeta.add(BeanMap,Object)</code></a> method for adding values to Collection and array properties. + <li>New <code><del>BeanPropertyMeta.add(BeanMap,Object)</del></code> method for adding values to Collection and array properties. <li>Config INI files now support keys with name <js>"*"</js>. </ul> http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/46c4861b/content/site/apidocs/overview-tree.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/overview-tree.html b/content/site/apidocs/overview-tree.html index df4cde8..d04a22f 100644 --- a/content/site/apidocs/overview-tree.html +++ b/content/site/apidocs/overview-tree.html @@ -269,7 +269,7 @@ <li type="circle">org.apache.juneau.xml.<a href="org/apache/juneau/xml/XmlBeanPropertyMeta.html" title="class in org.apache.juneau.xml"><span class="typeNameLink">XmlBeanPropertyMeta</span></a></li> </ul> </li> -<li type="circle">org.apache.juneau.<a href="org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanPropertyValue</span></a></li> +<li type="circle">org.apache.juneau.<a href="org/apache/juneau/BeanPropertyValue.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanPropertyValue</span></a> (implements java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><T>)</li> <li type="circle">org.apache.juneau.<a href="org/apache/juneau/BeanProxyInvocationHandler.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanProxyInvocationHandler</span></a><T> (implements java.lang.reflect.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/InvocationHandler.html?is-external=true" title="class or interface in java.lang.reflect">InvocationHandler</a>)</li> <li type="circle">org.apache.juneau.<a href="org/apache/juneau/BeanRegistry.html" title="class in org.apache.juneau"><span class="typeNameLink">BeanRegistry</span></a></li> <li type="circle">org.apache.juneau.internal.<a href="org/apache/juneau/internal/ByteArrayCache.html" title="class in org.apache.juneau.internal"><span class="typeNameLink">ByteArrayCache</span></a></li>
