http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/1b5bde65/content/site/apidocs/org/apache/juneau/CoreObjectBuilder.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/org/apache/juneau/CoreObjectBuilder.html b/content/site/apidocs/org/apache/juneau/CoreObjectBuilder.html index 15c8713..5688157 100644 --- a/content/site/apidocs/org/apache/juneau/CoreObjectBuilder.html +++ b/content/site/apidocs/org/apache/juneau/CoreObjectBuilder.html @@ -679,7 +679,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockListLast"> <li class="blockList"> <h4>CoreObjectBuilder</h4> -<pre>public <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.49">CoreObjectBuilder</a>(<a href="../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore)</pre> +<pre>public <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.50">CoreObjectBuilder</a>(<a href="../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore)</pre> <div class="block">Constructor.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -701,7 +701,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>build</h4> -<pre>public abstract <a href="../../../org/apache/juneau/CoreObject.html" title="class in org.apache.juneau">CoreObject</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.59">build</a>()</pre> +<pre>public abstract <a href="../../../org/apache/juneau/CoreObject.html" title="class in org.apache.juneau">CoreObject</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.60">build</a>()</pre> <div class="block">Build the object.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> @@ -716,7 +716,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>apply</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.67">apply</a>(<a href="../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> copyFrom)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.68">apply</a>(<a href="../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> copyFrom)</pre> <div class="block">Copies the settings from the specified property store into this builder.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -732,7 +732,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>build</h4> -<pre>public <T extends <a href="../../../org/apache/juneau/CoreObject.html" title="class in org.apache.juneau">CoreObject</a>> T <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.79">build</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true"; title="class or interface in java.lang">Class</a><T> c)</pre> +<pre>public <T extends <a href="../../../org/apache/juneau/CoreObject.html" title="class in org.apache.juneau">CoreObject</a>> T <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.80">build</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true"; title="class or interface in java.lang">Class</a><T> c)</pre> <div class="block">Build a new instance of the specified object.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -748,7 +748,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>property</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.95">property</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.96">property</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="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)</pre> <div class="block">Sets a configuration property on this object.</div> <dl> @@ -768,9 +768,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>properties</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.113">properties</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">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>> properties)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.114">properties</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">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>> properties)</pre> <div class="block">Adds multiple configuration properties on this object. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <a href="../../../org/apache/juneau/PropertyStore.html#addProperties-java.util.Map-"><code>PropertyStore.addProperties(Map)</code></a>. @@ -792,9 +792,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setProperties</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.131">setProperties</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">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>> properties)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.132">setProperties</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">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>> properties)</pre> <div class="block">Sets multiple configuration properties on this object. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <a href="../../../org/apache/juneau/PropertyStore.html#setProperties-java.util.Map-"><code>PropertyStore.setProperties(Map)</code></a>. @@ -816,10 +816,10 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>addToProperty</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.149">addToProperty</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.150">addToProperty</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="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)</pre> <div class="block">Adds a value to a SET property. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>PropertyStore.addToProperty(name, value);</code>. @@ -841,11 +841,11 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>putToProperty</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.168">putToProperty</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.169">putToProperty</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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</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)</pre> <div class="block">Adds or overwrites a value to a MAP property. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>PropertyStore.putToProperty(name, key, value);</code>. @@ -868,10 +868,10 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>putToProperty</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.186">putToProperty</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.187">putToProperty</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="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)</pre> <div class="block">Adds or overwrites a value to a MAP property. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>PropertyStore.putToProperty(name, value);</code>. @@ -893,10 +893,10 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removeFromProperty</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.204">removeFromProperty</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.205">removeFromProperty</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="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)</pre> <div class="block">Removes a value from a SET property. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>PropertyStore.removeFromProperty(name, value);</code>. @@ -918,21 +918,23 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beansRequireDefaultConstructor</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.233">beansRequireDefaultConstructor</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.236">beansRequireDefaultConstructor</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Beans require no-arg constructors. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beansRequireDefaultConstructor"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, a Java class must implement a default no-arg constructor to be considered a bean. Otherwise, the bean will be serialized as a string using the <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--"; title="class or interface in java.lang"><code>Object.toString()</code></a> method. + <p> The <a href="../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation"><code>@Bean</code></a> annotation can be used on a class to override this setting when <jk>true</jk>. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beansRequireDefaultConstructor</jsf>, value)</code>. @@ -953,21 +955,23 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beansRequireSerializable</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.261">beansRequireSerializable</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.266">beansRequireSerializable</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Beans require <a href="http://docs.oracle.com/javase/7/docs/api/java/io/Serializable.html?is-external=true"; title="class or interface in java.io"><code>Serializable</code></a> interface. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beansRequireSerializable"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, a Java class must implement the <a href="http://docs.oracle.com/javase/7/docs/api/java/io/Serializable.html?is-external=true"; title="class or interface in java.io"><code>Serializable</code></a> interface to be considered a bean. Otherwise, the bean will be serialized as a string using the <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--"; title="class or interface in java.lang"><code>Object.toString()</code></a> method. + <p> The <a href="../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation"><code>@Bean</code></a> annotation can be used on a class to override this setting when <jk>true</jk>. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beansRequireSerializable</jsf>, value)</code>. @@ -988,19 +992,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beansRequireSettersForGetters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.287">beansRequireSettersForGetters</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.293">beansRequireSettersForGetters</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Beans require setters for getters. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beansRequireSettersForGetters"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, only getters that have equivalent setters will be considered as properties on a bean. Otherwise, they will be ignored. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beansRequireSettersForGetters</jsf>, value)</code>. @@ -1021,21 +1026,23 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beansRequireSomeProperties</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.315">beansRequireSomeProperties</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.323">beansRequireSomeProperties</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Beans require at least one property. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beansRequireSomeProperties"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>true</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, then a Java class must contain at least 1 property to be considered a bean. Otherwise, the bean will be serialized as a string using the <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--"; title="class or interface in java.lang"><code>Object.toString()</code></a> method. + <p> The <a href="../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation"><code>@Bean</code></a> annotation can be used on a class to override this setting when <jk>true</jk>. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beansRequireSomeProperties</jsf>, value)</code>. @@ -1056,23 +1063,25 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beanMapPutReturnsOldValue</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.345">beanMapPutReturnsOldValue</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.355">beanMapPutReturnsOldValue</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> <a href="../../../org/apache/juneau/BeanMap.html#put-java.lang.String-java.lang.Object-"><code>BeanMap.put()</code></a> method will return old property value. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beanMapPutReturnsOldValue"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, then the <a href="../../../org/apache/juneau/BeanMap.html#put-java.lang.String-java.lang.Object-"><code>BeanMap.put()</code></a> method will return old property values. Otherwise, it returns <jk>null</jk>. + <p> Disabled by default because it introduces a slight performance penalty. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beanMapPutReturnsOldValue</jsf>, value)</code>. @@ -1093,20 +1102,21 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beanConstructorVisibility</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.372">beanConstructorVisibility</a>(<a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.383">beanConstructorVisibility</a>(<a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> value)</pre> <div class="block"><b>Configuration property:</b> Look for bean constructors with the specified minimum visibility. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beanConstructorVisibility"</js> <li><b>Data type:</b> <a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau"><code>Visibility</code></a> <li><b>Default:</b> <a href="../../../org/apache/juneau/Visibility.html#PUBLIC"><code>Visibility.PUBLIC</code></a> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> Constructors not meeting this minimum visibility will be ignored. - For example, if the visibility is <code>PUBLIC</code> and the constructor is <jk>protected</jk>, then - the constructor will be ignored. - <p> + For example, if the visibility is <code>PUBLIC</code> and the constructor is <jk>protected</jk>, then the + constructor will be ignored. + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beanConstructorVisibility</jsf>, value)</code>. @@ -1127,20 +1137,21 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beanClassVisibility</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.399">beanClassVisibility</a>(<a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.411">beanClassVisibility</a>(<a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> value)</pre> <div class="block"><b>Configuration property:</b> Look for bean classes with the specified minimum visibility. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beanClassVisibility"</js> <li><b>Data type:</b> <a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau"><code>Visibility</code></a> <li><b>Default:</b> <a href="../../../org/apache/juneau/Visibility.html#PUBLIC"><code>Visibility.PUBLIC</code></a> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> Classes are not considered beans unless they meet the minimum visibility requirements. - For example, if the visibility is <code>PUBLIC</code> and the bean class is <jk>protected</jk>, then - the class will not be interpreted as a bean class. - <p> + For example, if the visibility is <code>PUBLIC</code> and the bean class is <jk>protected</jk>, then the class + will not be interpreted as a bean class. + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beanClassVisibility</jsf>, value)</code>. @@ -1161,20 +1172,21 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beanFieldVisibility</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.427">beanFieldVisibility</a>(<a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.440">beanFieldVisibility</a>(<a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> value)</pre> <div class="block"><b>Configuration property:</b> Look for bean fields with the specified minimum visibility. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beanFieldVisibility"</js> <li><b>Data type:</b> <a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau"><code>Visibility</code></a> <li><b>Default:</b> <a href="../../../org/apache/juneau/Visibility.html#PUBLIC"><code>Visibility.PUBLIC</code></a> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> Fields are not considered bean properties unless they meet the minimum visibility requirements. - For example, if the visibility is <code>PUBLIC</code> and the bean field is <jk>protected</jk>, then - the field will not be interpreted as a bean property. - <p> + For example, if the visibility is <code>PUBLIC</code> and the bean field is <jk>protected</jk>, then the field + will not be interpreted as a bean property. + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beanFieldVisibility</jsf>, value)</code>. @@ -1196,20 +1208,21 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>methodVisibility</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.455">methodVisibility</a>(<a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.469">methodVisibility</a>(<a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau">Visibility</a> value)</pre> <div class="block"><b>Configuration property:</b> Look for bean methods with the specified minimum visibility. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.methodVisibility"</js> <li><b>Data type:</b> <a href="../../../org/apache/juneau/Visibility.html" title="enum in org.apache.juneau"><code>Visibility</code></a> <li><b>Default:</b> <a href="../../../org/apache/juneau/Visibility.html#PUBLIC"><code>Visibility.PUBLIC</code></a> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> Methods are not considered bean getters/setters unless they meet the minimum visibility requirements. - For example, if the visibility is <code>PUBLIC</code> and the bean method is <jk>protected</jk>, then - the method will not be interpreted as a bean getter or setter. - <p> + For example, if the visibility is <code>PUBLIC</code> and the bean method is <jk>protected</jk>, then the method + will not be interpreted as a bean getter or setter. + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_methodVisibility</jsf>, value)</code>. @@ -1231,19 +1244,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>useJavaBeanIntrospector</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.481">useJavaBeanIntrospector</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.496">useJavaBeanIntrospector</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Use Java <a href="http://docs.oracle.com/javase/7/docs/api/java/beans/Introspector.html?is-external=true"; title="class or interface in java.beans"><code>Introspector</code></a> for determining bean properties. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.useJavaBeanIntrospector"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> Using the built-in Java bean introspector will not pick up fields or non-standard getters/setters. - <p> - <h5 class='section'>Notes:</h5> + + <h5 class 'section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_useJavaBeanIntrospector</jsf>, value)</code>. <li>Most <a href="../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation"><code>@Bean</code></a> annotations will be ignored if you enable this setting. @@ -1264,19 +1278,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>useInterfaceProxies</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.507">useInterfaceProxies</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.523">useInterfaceProxies</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Use interface proxies. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.useInterfaceProxies"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>true</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, then interfaces will be instantiated as proxy classes through the use of an <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"><code>InvocationHandler</code></a> if there is no other way of instantiating them. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_useInterfaceProxies</jsf>, value)</code>. @@ -1297,19 +1312,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>ignoreUnknownBeanProperties</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.533">ignoreUnknownBeanProperties</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.550">ignoreUnknownBeanProperties</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Ignore unknown properties. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.ignoreUnknownBeanProperties"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, trying to set a value on a non-existent bean property will silently be ignored. Otherwise, a <code>BeanRuntimeException</code> is thrown. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_ignoreUnknownBeanProperties</jsf>, value)</code>. @@ -1330,19 +1346,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>ignoreUnknownNullBeanProperties</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.559">ignoreUnknownNullBeanProperties</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.577">ignoreUnknownNullBeanProperties</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Ignore unknown properties with null values. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.ignoreUnknownNullBeanProperties"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>true</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, trying to set a <jk>null</jk> value on a non-existent bean property will silently be ignored. Otherwise, a <code>BeanRuntimeException</code> is thrown. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_ignoreUnknownNullBeanProperties</jsf>, value)</code>. @@ -1363,19 +1380,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>ignorePropertiesWithoutSetters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.585">ignorePropertiesWithoutSetters</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.604">ignorePropertiesWithoutSetters</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Ignore properties without setters. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.ignorePropertiesWithoutSetters"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>true</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, trying to set a value on a bean property without a setter will silently be ignored. Otherwise, a <code>BeanRuntimeException</code> is thrown. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_ignorePropertiesWithoutSetters</jsf>, value)</code>. @@ -1396,19 +1414,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>ignoreInvocationExceptionsOnGetters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.611">ignoreInvocationExceptionsOnGetters</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.631">ignoreInvocationExceptionsOnGetters</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Ignore invocation errors on getters. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.ignoreInvocationExceptionsOnGetters"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, errors thrown when calling bean getter methods will silently be ignored. Otherwise, a <code>BeanRuntimeException</code> is thrown. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_ignoreInvocationExceptionsOnGetters</jsf>, value)</code>. @@ -1429,19 +1448,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>ignoreInvocationExceptionsOnSetters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.637">ignoreInvocationExceptionsOnSetters</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.658">ignoreInvocationExceptionsOnSetters</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Ignore invocation errors on setters. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.ignoreInvocationExceptionsOnSetters"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> If <jk>true</jk>, errors thrown when calling bean setter methods will silently be ignored. Otherwise, a <code>BeanRuntimeException</code> is thrown. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_ignoreInvocationExceptionsOnSetters</jsf>, value)</code>. @@ -1462,26 +1482,28 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>sortProperties</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.669">sortProperties</a>(boolean value)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.692">sortProperties</a>(boolean value)</pre> <div class="block"><b>Configuration property:</b> Sort bean properties in alphabetical order. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.sortProperties"</js> <li><b>Data type:</b> <code>Boolean</code> <li><b>Default:</b> <jk>false</jk> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> When <jk>true</jk>, all bean properties will be serialized and access in alphabetical order. - Otherwise, the natural order of the bean properties is used which is dependent on the - JVM vendor. + Otherwise, the natural order of the bean properties is used which is dependent on the JVM vendor. On IBM JVMs, the bean properties are ordered based on their ordering in the Java file. - On Oracle JVMs, the bean properties are not ordered (which follows the offical JVM specs). - <p> + On Oracle JVMs, the bean properties are not ordered (which follows the official JVM specs). + <h5 class='section'>Notes:</h5> <ul> - <li>This is equivalent to calling <code>property(<jsf>BEAN_sortProperties</jsf>, value)</code>. - <li>This property is disabled by default so that IBM JVM users don't have to use <a href="../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation"><code>@Bean</code></a> annotations + <li> + This is equivalent to calling <code>property(<jsf>BEAN_sortProperties</jsf>, value)</code>. + <li> + This property is disabled by default so that IBM JVM users don't have to use <a href="../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation"><code>@Bean</code></a> annotations to force bean properties to be in a particular order and can just alter the order of the fields/methods in the Java file. </ul></div> @@ -1501,9 +1523,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setNotBeanPackages</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.708">setNotBeanPackages</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>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.734">setNotBeanPackages</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>... values)</pre> <div class="block"><b>Configuration property:</b> Packages whose classes should not be considered beans. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.notBeanPackages.set"</js> <li><b>Data type:</b> <code>Set<String></code> @@ -1520,13 +1542,16 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? </ul> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> When specified, the current list of ignore packages are appended to. + <p> Any classes within these packages will be serialized to strings using <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--"; title="class or interface in java.lang"><code>Object.toString()</code></a>. + <p> Note that you can specify prefix patterns to include all subpackages. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_notBeanPackages</jsf>, values)</code>. @@ -1547,9 +1572,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setNotBeanPackages</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.721">setNotBeanPackages</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.747">setNotBeanPackages</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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>> values)</pre> <div class="block"><b>Configuration property:</b> Packages whose classes should not be considered beans. - <p> + Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#setNotBeanPackages-java.lang.String...-"><code>setNotBeanPackages(String...)</code></a> but using a <code>Collection</code>.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> @@ -1567,9 +1592,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>notBeanPackages</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.738">notBeanPackages</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>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.764">notBeanPackages</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>... values)</pre> <div class="block"><b>Configuration property:</b> Add to packages whose classes should not be considered beans. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>addToProperty(<jsf>BEAN_notBeanPackages</jsf>, values)</code> @@ -1591,8 +1616,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>notBeanPackages</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.751">notBeanPackages</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.778">notBeanPackages</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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>> values)</pre> <div class="block"><b>Configuration property:</b> Add to packages whose classes should not be considered beans. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#notBeanPackages-java.lang.String...-"><code>notBeanPackages(String...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -1611,9 +1637,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removeNotBeanPackages</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.769">removeNotBeanPackages</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>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.796">removeNotBeanPackages</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>... values)</pre> <div class="block"><b>Configuration property:</b> Remove from packages whose classes should not be considered beans. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>removeFromProperty(<jsf>BEAN_notBeanPackages</jsf>, values)</code> @@ -1636,8 +1662,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removeNotBeanPackages</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.783">removeNotBeanPackages</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.811">removeNotBeanPackages</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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>> values)</pre> <div class="block"><b>Configuration property:</b> Remove from packages whose classes should not be considered beans. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#removeNotBeanPackages-java.lang.String...-"><code>removeNotBeanPackages(String...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -1657,19 +1684,20 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setNotBeanClasses</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.809">setNotBeanClasses</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.838">setNotBeanClasses</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> Classes to be excluded from consideration as being beans. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.notBeanClasses.set"</js> <li><b>Data type:</b> <code>Set<Class></code> <li><b>Default:</b> empty set <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> - Not-bean classes are typically converted to <code>Strings</code> during serialization even if they - appear to be bean-like. - <p> + Not-bean classes are typically converted to <code>Strings</code> during serialization even if they appear to be + bean-like. + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_notBeanClasses</jsf>, values)</code>. @@ -1690,8 +1718,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setNotBeanClasses</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.822">setNotBeanClasses</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.852">setNotBeanClasses</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Classes to be excluded from consideration as being beans. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#setNotBeanClasses-java.lang.Class...-"><code>setNotBeanClasses(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -1710,9 +1739,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>notBeanClasses</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.840">notBeanClasses</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.870">notBeanClasses</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> Add to classes that should not be considered beans. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>addToProperty(<jsf>BEAN_notBeanClasses</jsf>, values)</code> @@ -1735,8 +1764,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>notBeanClasses</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.854">notBeanClasses</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.885">notBeanClasses</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Add to classes that should not be considered beans. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#notBeanClasses-java.lang.Class...-"><code>notBeanClasses(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -1756,9 +1786,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removeNotBeanClasses</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.872">removeNotBeanClasses</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.903">removeNotBeanClasses</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> Remove from classes that should not be considered beans. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>removeFromProperty(<jsf>BEAN_notBeanClasses</jsf>, values)</code> @@ -1781,8 +1811,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removeNotBeanClasses</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.886">removeNotBeanClasses</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.918">removeNotBeanClasses</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Remove from classes that should not be considered beans. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#removeNotBeanClasses-java.lang.Class...-"><code>removeNotBeanClasses(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -1802,30 +1833,34 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setBeanFilters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.923">setBeanFilters</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.959">setBeanFilters</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> Bean filters to apply to beans. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.beanFilters.list"</js> <li><b>Data type:</b> <code>List<Class></code> <li><b>Default:</b> empty list <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> This is a programmatic equivalent to the <a href="../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation"><code>@Bean</code></a> annotation. - It's useful when you want to use the Bean annotation functionality, but you don't have the ability - to alter the bean classes. + It's useful when you want to use the Bean annotation functionality, but you don't have the ability to alter the + bean classes. + <p> There are two category of classes that can be passed in through this method: <ul class='spaced-list'> - <li>Subclasses of <a href="../../../org/apache/juneau/transform/BeanFilterBuilder.html" title="class in org.apache.juneau.transform"><code>BeanFilterBuilder</code></a>. + <li> + Subclasses of <a href="../../../org/apache/juneau/transform/BeanFilterBuilder.html" title="class in org.apache.juneau.transform"><code>BeanFilterBuilder</code></a>. These must have a public no-arg constructor. - <li>Bean interface classes. + <li> + Bean interface classes. A shortcut for defining a <a href="../../../org/apache/juneau/transform/InterfaceBeanFilterBuilder.html" title="class in org.apache.juneau.transform"><code>InterfaceBeanFilterBuilder</code></a>. Any subclasses of an interface class will only have properties defined on the interface. All other bean properties will be ignored. </ul> - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_beanFilters</jsf>, values)</code>. @@ -1846,8 +1881,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setBeanFilters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.936">setBeanFilters</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.973">setBeanFilters</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Bean filters to apply to beans. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#setBeanFilters-java.lang.Class...-"><code>setBeanFilters(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -1866,9 +1902,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beanFilters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.954">beanFilters</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.991">beanFilters</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> Add to bean filters. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>addToProperty(<jsf>BEAN_beanFilters</jsf>, values)</code> @@ -1891,8 +1927,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>beanFilters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.968">beanFilters</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1006">beanFilters</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Add to bean filters. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#beanFilters-java.lang.Class...-"><code>beanFilters(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -1912,9 +1949,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removeBeanFilters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.986">removeBeanFilters</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1024">removeBeanFilters</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> Remove from bean filters. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>removeFromProperty(<jsf>BEAN_beanFilters</jsf>, values)</code> @@ -1937,8 +1974,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removeBeanFilters</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1000">removeBeanFilters</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1039">removeBeanFilters</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Remove from bean filters. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#removeBeanFilters-java.lang.Class...-"><code>removeBeanFilters(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -1958,22 +1996,23 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setPojoSwaps</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1029">setPojoSwaps</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1069">setPojoSwaps</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> POJO swaps to apply to Java objects. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.pojoSwaps.list"</js> <li><b>Data type:</b> <code>List<Class></code> <li><b>Default:</b> empty list <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> There are two category of classes that can be passed in through this method: <ul> <li>Subclasses of <a href="../../../org/apache/juneau/transform/PojoSwap.html" title="class in org.apache.juneau.transform"><code>PojoSwap</code></a>. <li>Surrogate classes. A shortcut for defining a <a href="../../../org/apache/juneau/transform/SurrogateSwap.html" title="class in org.apache.juneau.transform"><code>SurrogateSwap</code></a>. </ul> - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_pojoSwaps</jsf>, values)</code>. @@ -1994,8 +2033,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>setPojoSwaps</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1042">setPojoSwaps</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1083">setPojoSwaps</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> POJO swaps to apply to Java objects. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#setPojoSwaps-java.lang.Class...-"><code>setPojoSwaps(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -2014,9 +2054,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>pojoSwaps</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1060">pojoSwaps</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1101">pojoSwaps</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> Add to POJO swaps. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>addToProperty(<jsf>BEAN_pojoSwaps</jsf>, values)</code> @@ -2039,8 +2079,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>pojoSwaps</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1074">pojoSwaps</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1116">pojoSwaps</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Add to POJO swaps. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#pojoSwaps-java.lang.Class...-"><code>pojoSwaps(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -2060,9 +2101,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removePojoSwaps</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1092">removePojoSwaps</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><?>... values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1134">removePojoSwaps</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><?>... values)</pre> <div class="block"><b>Configuration property:</b> Remove from POJO swaps. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>removeFromProperty(<jsf>BEAN_pojoSwaps</jsf>, values)</code> @@ -2085,8 +2126,9 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>removePojoSwaps</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1106">removePojoSwaps</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1149">removePojoSwaps</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true"; title="class or interface in java.util">Collection</a><<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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Remove from POJO swaps. + <p> Same as <a href="../../../org/apache/juneau/CoreObjectBuilder.html#removePojoSwaps-java.lang.Class...-"><code>removePojoSwaps(Class...)</code></a> but using a <code>Collection</code>.</div> <dl> @@ -2106,20 +2148,21 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>implClasses</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1133">implClasses</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">Map</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 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><?>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1177">implClasses</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">Map</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 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><?>> values)</pre> <div class="block"><b>Configuration property:</b> Implementation classes for interfaces and abstract classes. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.implClasses.map"</js> <li><b>Data type:</b> <code>Map<Class,Class></code> <li><b>Default:</b> empty map <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> - For interfaces and abstract classes this method can be used to specify an implementation - class for the interface/abstract class so that instances of the implementation - class are used when instantiated (e.g. during a parse). - <p> + For interfaces and abstract classes this method can be used to specify an implementation class for the + interface/abstract class so that instances of the implementation class are used when instantiated (e.g. during a + parse). + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_implClasses</jsf>, values)</code>. @@ -2140,10 +2183,10 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>implClass</h4> -<pre>public <I> <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1153">implClass</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><I> interfaceClass, +<pre>public <I> <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1197">implClass</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><I> interfaceClass, <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><? extends I> implClass)</pre> <div class="block"><b>Configuration property:</b> Implementation classes for interfaces and abstract classes. - <p> + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>putToProperty(<jsf>BEAN_implClasses</jsf>, interfaceClass, implClass)</code> @@ -2169,25 +2212,28 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>includeProperties</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1185">includeProperties</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">Map</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a>> values)</pre> +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1232">includeProperties</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">Map</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a>> values)</pre> <div class="block"><b>Configuration property:</b> Explicitly specify visible bean properties. - <p> + <ul> <li><b>Name:</b> <js>"BeanContext.includeProperties"</js> <li><b>Data type:</b> <code>Map<String,String></code> <li><b>Default:</b> <code>{}</code> <li><b>Session-overridable:</b> <jk>false</jk> </ul> + <p> Specifies to only include the specified list of properties for the specified bean classes. + <p> The keys are either fully-qualified or simple class names, and the values are comma-delimited lists of property names. The key <js>"*"</js> means all bean classes. + <p> For example, <code>{Bean1:<js>"foo,bar"</js>}</code> means only serialize the <code>foo</code> and <code>bar</code> - properties on the specified bean. - <p> + properties on the specified bean. + <h5 class='section'>Notes:</h5> <ul> <li>This is equivalent to calling <code>property(<jsf>BEAN_includeProperties</jsf>, values)</code>. @@ -2208,10 +2254,10 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html? <ul class="blockList"> <li class="blockList"> <h4>includeProperties</h4> -<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1204">includeProperties</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> beanClassName, +<pre>public <a href="../../../org/apache/juneau/CoreObjectBuilder.html" title="class in org.apache.juneau">CoreObjectBuilder</a> <a href="../../../src-html/org/apache/juneau/CoreObjectBuilder.html#line.1251">includeProperties</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> beanClassName, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">St
<TRUNCATED>
