You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2018/01/18 19:35:07 UTC
[31/33] juneau-website git commit: Update javadocs.
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/60d9bd65/content/site/apidocs/org/apache/juneau/dto/swagger/Contact.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/dto/swagger/Contact.html b/content/site/apidocs/org/apache/juneau/dto/swagger/Contact.html
index 8c573d1..6924632 100644
--- a/content/site/apidocs/org/apache/juneau/dto/swagger/Contact.html
+++ b/content/site/apidocs/org/apache/juneau/dto/swagger/Contact.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};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
@@ -113,13 +113,24 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre><a href="../../../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation">@Bean</a>(<a href="../../../../../org/apache/juneau/annotation/Bean.html#properties--">properties</a>="name,url,email")
-public class <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.51">Contact</a>
+<pre><a href="../../../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation">@Bean</a>(<a href="../../../../../org/apache/juneau/annotation/Bean.html#properties--">properties</a>="name,url,email,*")
+public class <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.52">Contact</a>
extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></pre>
<div class="block">Contact information for the exposed API.
<h5 class='section'>Example:</h5>
<p class='bcode'>
+ <jc>// Construct using SwaggerBuilder.</jc>
+ Contact x = <jsm>contact</jsm>(<js>"API Support"</js>, <js>"http://www.swagger.io/support"</js>, <js>"support@swagger.io"</js>);
+
+ <jc>// Serialize using JsonSerializer.</jc>
+ String json = JsonSerializer.<jsf>DEFAULT</jsf>.toString(x);
+
+ <jc>// Or just use toString() which does the same as above.</jc>
+ String json = x.toString();
+ </p>
+ <p class='bcode'>
+ <jc>// Output</jc>
{
<js>"name"</js>: <js>"API Support"</js>,
<js>"url"</js>: <js>"http://www.swagger.io/support"</js>,
@@ -129,17 +140,7 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
- <li class='link'>
- <a class='doclink' href='../../../../../overview-summary.html#DTOs'>Juneau Data Transfer Objects
- (org.apache.juneau.dto)</a>
- <ul>
- <li class='sublink'>
- <a class='doclink' href='../../../../../overview-summary.html#DTOs.Swagger'>Swagger</a>
- </ul>
- </li>
- <li class='jp'>
- <a class='doclink' href='package-summary.html#TOC'>org.apache.juneau.dto.swagger</a>
- </li>
+ <li class='link'><a class='doclink' href='../../../../../overview-summary.html#juneau-dto.Swagger'>Overview > juneau-dto > Swagger</a>
</ul></div>
</li>
</ul>
@@ -178,56 +179,70 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#email-java.lang.String-">email</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> email)</code>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setEmail-java.lang.String-"><code>setEmail(String)</code></a>.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#email-java.lang.Object-">email</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> value)</code>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setEmail-java.lang.String-"><code>setEmail(String)</code></a>.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
+<td class="colFirst"><code><T> T</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#get-java.lang.String-java.lang.Class-">get</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> property,
+ <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> type)</code>
+<div class="block">Generic property getter.</div>
+</td>
+</tr>
+<tr id="i2" 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/dto/swagger/Contact.html#getEmail--">getEmail</a></span>()</code>
<div class="block">Bean property getter: <property>email</property>.</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/dto/swagger/Contact.html#getName--">getName</a></span>()</code>
<div class="block">Bean property getter: <property>name</property>.</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/net/URI.html?is-external=true" title="class or interface in java.net">URI</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#getUrl--">getUrl</a></span>()</code>
<div class="block">Bean property getter: <property>url</property>.</div>
</td>
</tr>
-<tr id="i4" class="altColor">
+<tr id="i5" class="rowColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#name-java.lang.String-">name</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</code>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setName-java.lang.String-"><code>setName(String)</code></a>.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#name-java.lang.Object-">name</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> value)</code>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setName-java.lang.String-"><code>setName(String)</code></a>.</div>
</td>
</tr>
-<tr id="i5" class="rowColor">
+<tr id="i6" class="altColor">
+<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#set-java.lang.String-java.lang.Object-">set</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> property,
+ <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">Generic property setter.</div>
+</td>
+</tr>
+<tr id="i7" class="rowColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setEmail-java.lang.String-">setEmail</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> email)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setEmail-java.lang.String-">setEmail</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> value)</code>
<div class="block">Bean property setter: <property>email</property>.</div>
</td>
</tr>
-<tr id="i6" class="altColor">
+<tr id="i8" class="altColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setName-java.lang.String-">setName</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setName-java.lang.String-">setName</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> value)</code>
<div class="block">Bean property setter: <property>name</property>.</div>
</td>
</tr>
-<tr id="i7" class="rowColor">
+<tr id="i9" class="rowColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setUrl-java.lang.Object-">setUrl</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> url)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setUrl-java.net.URI-">setUrl</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> value)</code>
<div class="block">Bean property setter: <property>url</property>.</div>
</td>
</tr>
-<tr id="i8" class="altColor">
+<tr id="i10" class="altColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#url-java.lang.Object-">url</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> url)</code>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setUrl-java.lang.Object-"><code>setUrl(Object)</code></a>.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#url-java.lang.Object-">url</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> value)</code>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setUrl-java.net.URI-"><code>setUrl(URI)</code></a>.</div>
</td>
</tr>
</table>
@@ -236,14 +251,14 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<!-- -->
</a>
<h3>Methods inherited from class org.apache.juneau.dto.swagger.<a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></h3>
-<code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#isStrict--">isStrict</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#strict--">strict</a></code></li>
+<code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#getExtraProperties--">getExtraProperties</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#isStrict--">isStrict</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#strict--">strict</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#strict-java.lang.Object-">strict</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#toString--">toString</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class java.lang.<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></h3>
-<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang
/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <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>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
+<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang
/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
@@ -265,7 +280,7 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockListLast">
<li class="blockList">
<h4>Contact</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.51">Contact</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.52">Contact</a>()</pre>
</li>
</ul>
</li>
@@ -282,14 +297,14 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<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/dto/swagger/Contact.html#line.65">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/dto/swagger/Contact.html#line.66">getName</a>()</pre>
<div class="block">Bean property getter: <property>name</property>.
<p>
The identifying name of the contact person/organization.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The value of the <property>name</property> property on this bean, or <jk>null</jk> if it is not set.</dd>
+<dd>The property value, or <jk>null</jk> if it is not set.</dd>
</dl>
</li>
</ul>
@@ -299,30 +314,33 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockList">
<li class="blockList">
<h4>setName</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.78">setName</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>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.81">setName</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> value)</pre>
<div class="block">Bean property setter: <property>name</property>.
<p>
The identifying name of the contact person/organization.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>name</code> - The new value for the <property>name</property> property on this bean.</dd>
+<dd><code>value</code> - The new value for this property.
+ <br>Can be <jk>null</jk> to unset the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
</li>
</ul>
-<a name="name-java.lang.String-">
+<a name="name-java.lang.Object-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>name</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.89">name</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>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setName-java.lang.String-"><code>setName(String)</code></a>.</div>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.95">name</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> value)</pre>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setName-java.lang.String-"><code>setName(String)</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>name</code> - The new value for the <property>name</property> property on this bean.</dd>
+<dd><code>value</code> - The new value for this property.
+ <br>Non-String values will be converted to String using <code>toString()</code>.
+ <br>Can be <jk>null</jk> to unset the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
@@ -334,35 +352,36 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockList">
<li class="blockList">
<h4>getUrl</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.101">getUrl</a>()</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.107">getUrl</a>()</pre>
<div class="block">Bean property getter: <property>url</property>.
<p>
- The URL pointing to the contact information. MUST be in the format of a URL.</div>
+ The URL pointing to the contact information.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The value of the <property>url</property> property on this bean, or <jk>null</jk> if it is not set.</dd>
+<dd>The property value, or <jk>null</jk> if it is not set.</dd>
</dl>
</li>
</ul>
-<a name="setUrl-java.lang.Object-">
+<a name="setUrl-java.net.URI-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setUrl</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.118">setUrl</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> url)</pre>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.126">setUrl</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> value)</pre>
<div class="block">Bean property setter: <property>url</property>.
<p>
The value can be of any of the following types: <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net"><code>URI</code></a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URL.html?is-external=true" title="class or interface in java.net"><code>URL</code></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"><code>String</code></a>.
- Strings must be valid URIs.
+ <br>Strings must be valid URIs.
<p>
URIs defined by <a href="../../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau"><code>UriResolver</code></a> can be used for values.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>url</code> - The new value for the <property>url</property> property on this bean.</dd>
+<dd><code>value</code> - The new value for this property.
+ <br>Can be <jk>null</jk> to unset the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
@@ -374,11 +393,13 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockList">
<li class="blockList">
<h4>url</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.129">url</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> url)</pre>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setUrl-java.lang.Object-"><code>setUrl(Object)</code></a>.</div>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.140">url</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> value)</pre>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setUrl-java.net.URI-"><code>setUrl(URI)</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>url</code> - The new value for the <property>url</property> property on this bean.</dd>
+<dd><code>value</code> - The new value for this property.
+ <br>Non-URI values will be converted to URI using <code><jk>new</jk> URI(value.toString())</code>.
+ <br>Can be <jk>null</jk> to unset the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
@@ -390,14 +411,14 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockList">
<li class="blockList">
<h4>getEmail</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/dto/swagger/Contact.html#line.141">getEmail</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/dto/swagger/Contact.html#line.152">getEmail</a>()</pre>
<div class="block">Bean property getter: <property>email</property>.
<p>
- The email address of the contact person/organization. MUST be in the format of an email address.</div>
+ The email address of the contact person/organization.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The value of the <property>email</property> property on this bean, or <jk>null</jk> if it is not set.</dd>
+<dd>The property value, or <jk>null</jk> if it is not set.</dd>
</dl>
</li>
</ul>
@@ -407,30 +428,83 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockList">
<li class="blockList">
<h4>setEmail</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.154">setEmail</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> email)</pre>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.168">setEmail</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> value)</pre>
<div class="block">Bean property setter: <property>email</property>.
<p>
- The email address of the contact person/organization. MUST be in the format of an email address.</div>
+ The email address of the contact person/organization.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>email</code> - The new value for the <property>email</property> property on this bean.</dd>
+<dd><code>value</code> - The new value for this property.
+ <br>MUST be in the format of an email address.
+ <br>Can be <jk>null</jk> to unset the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
</li>
</ul>
-<a name="email-java.lang.String-">
+<a name="email-java.lang.Object-">
<!-- -->
</a>
-<ul class="blockListLast">
+<ul class="blockList">
<li class="blockList">
<h4>email</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.165">email</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> email)</pre>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setEmail-java.lang.String-"><code>setEmail(String)</code></a>.</div>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.183">email</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> value)</pre>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html#setEmail-java.lang.String-"><code>setEmail(String)</code></a>.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>value</code> - The new value for this property.
+ <br>Non-String values will be converted to String using <code>toString()</code>.
+ <br>MUST be in the format of an email address.
+ <br>Can be <jk>null</jk> to unset the property.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>This object (for method chaining).</dd>
+</dl>
+</li>
+</ul>
+<a name="get-java.lang.String-java.lang.Class-">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>get</h4>
+<pre>public <T> T <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.188">get</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> property,
+ <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> type)</pre>
+<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#get-java.lang.String-java.lang.Class-">SwaggerElement</a></code></span></div>
+<div class="block">Generic property getter.
+
+ <p>
+ Can be used to retrieve non-standard Swagger fields such as <js>"$ref"</js>.</div>
+<dl>
+<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
+<dd><code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#get-java.lang.String-java.lang.Class-">get</a></code> in class <code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></code></dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>property</code> - The property name to retrieve.</dd>
+<dd><code>type</code> - The datatype to cast the value to.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>The property value, or <jk>null</jk> if the property does not exist or is not set.</dd>
+</dl>
+</li>
+</ul>
+<a name="set-java.lang.String-java.lang.Object-">
+<!-- -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>set</h4>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/Contact.html" title="class in org.apache.juneau.dto.swagger">Contact</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Contact.html#line.200">set</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> property,
+ <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"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#set-java.lang.String-java.lang.Object-">SwaggerElement</a></code></span></div>
+<div class="block">Generic property setter.
+
+ <p>
+ Can be used to set non-standard Swagger fields such as <js>"$ref"</js>.</div>
<dl>
+<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
+<dd><code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#set-java.lang.String-java.lang.Object-">set</a></code> in class <code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>email</code> - The new value for the <property>email</property> property on this bean.</dd>
+<dd><code>property</code> - The property name to set.</dd>
+<dd><code>value</code> - The new value for the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/60d9bd65/content/site/apidocs/org/apache/juneau/dto/swagger/ExternalDocumentation.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/dto/swagger/ExternalDocumentation.html b/content/site/apidocs/org/apache/juneau/dto/swagger/ExternalDocumentation.html
index 7e97ffc..70423bf 100644
--- a/content/site/apidocs/org/apache/juneau/dto/swagger/ExternalDocumentation.html
+++ b/content/site/apidocs/org/apache/juneau/dto/swagger/ExternalDocumentation.html
@@ -18,7 +18,7 @@
catch(err) {
}
//-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
@@ -113,13 +113,24 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre><a href="../../../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation">@Bean</a>(<a href="../../../../../org/apache/juneau/annotation/Bean.html#properties--">properties</a>="description,url")
-public class <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.50">ExternalDocumentation</a>
+<pre><a href="../../../../../org/apache/juneau/annotation/Bean.html" title="annotation in org.apache.juneau.annotation">@Bean</a>(<a href="../../../../../org/apache/juneau/annotation/Bean.html#properties--">properties</a>="description,url,*")
+public class <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.51">ExternalDocumentation</a>
extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></pre>
<div class="block">Allows referencing an external resource for extended documentation.
<h5 class='section'>Example:</h5>
<p class='bcode'>
+ <jc>// Construct using SwaggerBuilder.</jc>
+ ExternalDocumentation x = <jsm>externalDocumentation</jsm>(<js>"https://swagger.io"</js>, <js>"Find more info here"</js>);
+
+ <jc>// Serialize using JsonSerializer.</jc>
+ String json = JsonSerializer.<jsf>DEFAULT</jsf>.toString(x);
+
+ <jc>// Or just use toString() which does the same as above.</jc>
+ String json = x.toString();
+ </p>
+ <p class='bcode'>
+ <jc>// Output</jc>
{
<js>"description"</js>: <js>"Find more info here"</js>,
<js>"url"</js>: <js>"https://swagger.io"</js>
@@ -128,17 +139,7 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
- <li class='link'>
- <a class='doclink' href='../../../../../overview-summary.html#DTOs'>Juneau Data Transfer Objects
- (org.apache.juneau.dto)</a>
- <ul>
- <li class='sublink'>
- <a class='doclink' href='../../../../../overview-summary.html#DTOs.Swagger'>Swagger</a>
- </ul>
- </li>
- <li class='jp'>
- <a class='doclink' href='package-summary.html#TOC'>org.apache.juneau.dto.swagger</a>
- </li>
+ <li class='link'><a class='doclink' href='../../../../../overview-summary.html#juneau-dto.Swagger'>Overview > juneau-dto > Swagger</a>
</ul></div>
</li>
</ul>
@@ -177,38 +178,52 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#description-java.lang.String-">description</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> description)</code>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setDescription-java.lang.String-"><code>setDescription(String)</code></a>.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#description-java.lang.Object-">description</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> value)</code>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setDescription-java.lang.String-"><code>setDescription(String)</code></a>.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
+<td class="colFirst"><code><T> T</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#get-java.lang.String-java.lang.Class-">get</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> property,
+ <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> type)</code>
+<div class="block">Generic property getter.</div>
+</td>
+</tr>
+<tr id="i2" 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/dto/swagger/ExternalDocumentation.html#getDescription--">getDescription</a></span>()</code>
<div class="block">Bean property getter: <property>description</property>.</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/net/URI.html?is-external=true" title="class or interface in java.net">URI</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#getUrl--">getUrl</a></span>()</code>
<div class="block">Bean property getter: <property>url</property>.</div>
</td>
</tr>
-<tr id="i3" class="rowColor">
+<tr id="i4" class="altColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setDescription-java.lang.String-">setDescription</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> description)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#set-java.lang.String-java.lang.Object-">set</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> property,
+ <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">Generic property setter.</div>
+</td>
+</tr>
+<tr id="i5" class="rowColor">
+<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setDescription-java.lang.String-">setDescription</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> value)</code>
<div class="block">Bean property setter: <property>description</property>.</div>
</td>
</tr>
-<tr id="i4" class="altColor">
+<tr id="i6" class="altColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setUrl-java.lang.Object-">setUrl</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> url)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setUrl-java.net.URI-">setUrl</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> value)</code>
<div class="block">Bean property setter: <property>url</property>.</div>
</td>
</tr>
-<tr id="i5" class="rowColor">
+<tr id="i7" class="rowColor">
<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#url-java.lang.Object-">url</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> url)</code>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setUrl-java.lang.Object-"><code>setUrl(Object)</code></a>.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#url-java.lang.Object-">url</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> value)</code>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setUrl-java.net.URI-"><code>setUrl(URI)</code></a>.</div>
</td>
</tr>
</table>
@@ -217,14 +232,14 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<!-- -->
</a>
<h3>Methods inherited from class org.apache.juneau.dto.swagger.<a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></h3>
-<code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#isStrict--">isStrict</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#strict--">strict</a></code></li>
+<code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#getExtraProperties--">getExtraProperties</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#isStrict--">isStrict</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#strict--">strict</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#strict-java.lang.Object-">strict</a>, <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#toString--">toString</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class java.lang.<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></h3>
-<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang
/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <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>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
+<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang
/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
@@ -246,7 +261,7 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockListLast">
<li class="blockList">
<h4>ExternalDocumentation</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.50">ExternalDocumentation</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.51">ExternalDocumentation</a>()</pre>
</li>
</ul>
</li>
@@ -267,10 +282,10 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<div class="block">Bean property getter: <property>description</property>.
<p>
- A short description of the target documentation. GFM syntax can be used for rich text representation.</div>
+ A short description of the target documentation.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The value of the <property>description</property> property on this bean, or <jk>null</jk> if it is not set.</dd>
+<dd>The property value, or <jk>null</jk> if it is not set.</dd>
</dl>
</li>
</ul>
@@ -280,30 +295,34 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockList">
<li class="blockList">
<h4>setDescription</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.77">setDescription</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> description)</pre>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.80">setDescription</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> value)</pre>
<div class="block">Bean property setter: <property>description</property>.
<p>
- A short description of the target documentation. GFM syntax can be used for rich text representation.</div>
+ A short description of the target documentation.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>description</code> - The new value for the <property>description</property> property on this bean.</dd>
+<dd><code>value</code> - The new value for this property.
+ <br><a class="doclink" href="https://help.github.com/articles/github-flavored-markdown">GFM syntax</a> can be used for rich text representation.
+ <br>Can be <jk>null</jk> to unset the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
</li>
</ul>
-<a name="description-java.lang.String-">
+<a name="description-java.lang.Object-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>description</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.88">description</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> description)</pre>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setDescription-java.lang.String-"><code>setDescription(String)</code></a>.</div>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.94">description</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> value)</pre>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setDescription-java.lang.String-"><code>setDescription(String)</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>description</code> - The new value for the <property>description</property> property on this bean.</dd>
+<dd><code>value</code> - The new value for this property.
+ <br>Non-String values will be converted to String using <code>toString()</code>.
+ <br>Can be <jk>null</jk> to unset the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
@@ -315,42 +334,33 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<ul class="blockList">
<li class="blockList">
<h4>getUrl</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.107">getUrl</a>()</pre>
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.106">getUrl</a>()</pre>
<div class="block">Bean property getter: <property>url</property>.
<p>
- Required. The URL for the target documentation.
-
- <p>
- The value can be of any of the following types: <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net"><code>URI</code></a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URL.html?is-external=true" title="class or interface in java.net"><code>URL</code></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"><code>String</code></a>.
- Strings must be valid URIs.
-
- <p>
- URIs defined by <a href="../../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau"><code>UriResolver</code></a> can be used for values.</div>
+ The URL for the target documentation.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The value of the <property>url</property> property on this bean, or <jk>null</jk> if it is not set.</dd>
+<dd>The property value, or <jk>null</jk> if it is not set.</dd>
</dl>
</li>
</ul>
-<a name="setUrl-java.lang.Object-">
+<a name="setUrl-java.net.URI-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setUrl</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.124">setUrl</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> url)</pre>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.122">setUrl</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</a> value)</pre>
<div class="block">Bean property setter: <property>url</property>.
<p>
- The value can be of any of the following types: <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net"><code>URI</code></a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/net/URL.html?is-external=true" title="class or interface in java.net"><code>URL</code></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"><code>String</code></a>.
- Strings must be valid URIs.
-
- <p>
- URIs defined by <a href="../../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau"><code>UriResolver</code></a> can be used for values.</div>
+ The URL for the target documentation.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>url</code> - The new value for the <property>url</property> property on this bean.</dd>
+<dd><code>value</code> - The new value for this property.
+ <br>Property value is required.
+ <br>URIs defined by <a href="../../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau"><code>UriResolver</code></a> can be used for values.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>
@@ -359,14 +369,72 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
<a name="url-java.lang.Object-">
<!-- -->
</a>
-<ul class="blockListLast">
+<ul class="blockList">
<li class="blockList">
<h4>url</h4>
-<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.135">url</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> url)</pre>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setUrl-java.lang.Object-"><code>setUrl(Object)</code></a>.</div>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.144">url</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> value)</pre>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html#setUrl-java.net.URI-"><code>setUrl(URI)</code></a>.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>value</code> - The new value for this property.
+ <br>URIs defined by <a href="../../../../../org/apache/juneau/UriResolver.html" title="class in org.apache.juneau"><code>UriResolver</code></a> can be used for values.
+ <br>Valid types:
+ <ul>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net"><code>URI</code></a>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/net/URL.html?is-external=true" title="class or interface in java.net"><code>URL</code></a>
+ <li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang"><code>String</code></a>
+ <br>Converted to URI using <code><jk>new</jk> URI(value.toString())</code>.
+ <li>
+ </ul>
+ <br>Can be <jk>null</jk> to unset the property.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>This object (for method chaining).</dd>
+</dl>
+</li>
+</ul>
+<a name="get-java.lang.String-java.lang.Class-">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>get</h4>
+<pre>public <T> T <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.149">get</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> property,
+ <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> type)</pre>
+<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#get-java.lang.String-java.lang.Class-">SwaggerElement</a></code></span></div>
+<div class="block">Generic property getter.
+
+ <p>
+ Can be used to retrieve non-standard Swagger fields such as <js>"$ref"</js>.</div>
+<dl>
+<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
+<dd><code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#get-java.lang.String-java.lang.Class-">get</a></code> in class <code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></code></dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>property</code> - The property name to retrieve.</dd>
+<dd><code>type</code> - The datatype to cast the value to.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>The property value, or <jk>null</jk> if the property does not exist or is not set.</dd>
+</dl>
+</li>
+</ul>
+<a name="set-java.lang.String-java.lang.Object-">
+<!-- -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>set</h4>
+<pre>public <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a> <a href="../../../../../src-html/org/apache/juneau/dto/swagger/ExternalDocumentation.html#line.160">set</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> property,
+ <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"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#set-java.lang.String-java.lang.Object-">SwaggerElement</a></code></span></div>
+<div class="block">Generic property setter.
+
+ <p>
+ Can be used to set non-standard Swagger fields such as <js>"$ref"</js>.</div>
<dl>
+<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
+<dd><code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#set-java.lang.String-java.lang.Object-">set</a></code> in class <code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>url</code> - The new value for the <property>url</property> property on this bean.</dd>
+<dd><code>property</code> - The property name to set.</dd>
+<dd><code>value</code> - The new value for the property.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>This object (for method chaining).</dd>
</dl>