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:34:55 UTC

[19/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/SwaggerElement.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/dto/swagger/SwaggerElement.html b/content/site/apidocs/org/apache/juneau/dto/swagger/SwaggerElement.html
index afcada9..8192a27 100644
--- a/content/site/apidocs/org/apache/juneau/dto/swagger/SwaggerElement.html
+++ b/content/site/apidocs/org/apache/juneau/dto/swagger/SwaggerElement.html
@@ -18,7 +18,7 @@
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10};
 var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -112,23 +112,13 @@ var activeTableTab = "activeTableTab";
 </dl>
 <hr>
 <br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.33">SwaggerElement</a>
+<pre>public abstract class <a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.30">SwaggerElement</a>
 extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
 <div class="block">Root class for all Swagger beans.
  
  <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>
@@ -166,24 +156,54 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
 <th class="colLast" scope="col">Method and Description</th>
 </tr>
 <tr id="i0" class="altColor">
+<td class="colFirst"><code>&lt;T&gt;&nbsp;T</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.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>&nbsp;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>&lt;T&gt;&nbsp;type)</code>
+<div class="block">Generic property getter.</div>
+</td>
+</tr>
+<tr id="i1" class="rowColor">
+<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<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>&gt;</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#getExtraProperties--">getExtraProperties</a></span>()</code>
+<div class="block">The map used to store 'extra' properties on the swagger element.</div>
+</td>
+</tr>
+<tr id="i2" class="altColor">
 <td class="colFirst"><code>protected boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#isStrict--">isStrict</a></span>()</code>
 <div class="block">Returns <jk>true</jk> if contents should be validated per the Swagger spec.</div>
 </td>
 </tr>
-<tr id="i1" class="rowColor">
+<tr id="i3" class="rowColor">
+<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.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>&nbsp;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>&nbsp;value)</code>
+<div class="block">Generic property setter.</div>
+</td>
+</tr>
+<tr id="i4" class="altColor">
 <td class="colFirst"><code>protected <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#strict--">strict</a></span>()</code>
 <div class="block">Sets strict mode on this bean.</div>
 </td>
 </tr>
+<tr id="i5" class="rowColor">
+<td class="colFirst"><code>protected <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html#strict-java.lang.Object-">strict</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>&nbsp;value)</code>
+<div class="block">Sets strict mode on this bean.</div>
+</td>
+</tr>
+<tr id="i6" 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/SwaggerElement.html#toString--">toString</a></span>()</code>&nbsp;</td>
+</tr>
 </table>
 <ul class="blockList">
 <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
 <!--   -->
 </a>
 <h3>Methods inherited from class&nbsp;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>
@@ -205,7 +225,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
 <ul class="blockListLast">
 <li class="blockList">
 <h4>SwaggerElement</h4>
-<pre>public&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.33">SwaggerElement</a>()</pre>
+<pre>public&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.30">SwaggerElement</a>()</pre>
 </li>
 </ul>
 </li>
@@ -222,7 +242,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
 <ul class="blockList">
 <li class="blockList">
 <h4>isStrict</h4>
-<pre>protected&nbsp;boolean&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.42">isStrict</a>()</pre>
+<pre>protected&nbsp;boolean&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.40">isStrict</a>()</pre>
 <div class="block">Returns <jk>true</jk> if contents should be validated per the Swagger spec.</div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
@@ -233,17 +253,114 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
 <a name="strict--">
 <!--   -->
 </a>
-<ul class="blockListLast">
+<ul class="blockList">
+<li class="blockList">
+<h4>strict</h4>
+<pre>protected&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.49">strict</a>()</pre>
+<div class="block">Sets strict mode on this bean.</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>This object (for method chaining).</dd>
+</dl>
+</li>
+</ul>
+<a name="strict-java.lang.Object-">
+<!--   -->
+</a>
+<ul class="blockList">
 <li class="blockList">
 <h4>strict</h4>
-<pre>protected&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.51">strict</a>()</pre>
+<pre>protected&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.63">strict</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>&nbsp;value)</pre>
 <div class="block">Sets strict mode on this bean.</div>
 <dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>value</code> - The new value for this property.
+   <br>Non-boolean values will be converted to boolean using <code>Boolean.<jsm>valueOf</jsm>(value.toString())</code>.
+   <br>Can be <jk>null</jk> (interpreted as <jk>false</jk>).</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>This object (for method chaining).</dd>
 </dl>
 </li>
 </ul>
+<a name="getExtraProperties--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getExtraProperties</h4>
+<pre><a href="../../../../../org/apache/juneau/annotation/BeanProperty.html" title="annotation in org.apache.juneau.annotation">@BeanProperty</a>(<a href="../../../../../org/apache/juneau/annotation/BeanProperty.html#value--">value</a>="*")
+public&nbsp;<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>&lt;<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>&gt;&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.84">getExtraProperties</a>()</pre>
+<div class="block">The map used to store 'extra' properties on the swagger element.
+ 
+ <p>
+ For example, the <js>"$ref"</js> field is not a part of the Swagger doc, but is often
+ found since it is a part of the JSON-Schema spec. 
+ <br>This map allows you to store such properties.
+ 
+ <p>
+ This map is lazy-created once this method is called.</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>The extra properties map.
+   <br>It's an instance of <a href="http://docs.oracle.com/javase/7/docs/api/java/util/LinkedHashMap.html?is-external=true" title="class or interface in java.util"><code>LinkedHashMap</code></a>.</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&nbsp;&lt;T&gt;&nbsp;T&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.100">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>&nbsp;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>&lt;T&gt;&nbsp;type)</pre>
+<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="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="blockList">
+<li class="blockList">
+<h4>set</h4>
+<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.html" title="class in org.apache.juneau.dto.swagger">SwaggerElement</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.119">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>&nbsp;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>&nbsp;value)</pre>
+<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="paramLabel">Parameters:</span></dt>
+<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>
+</li>
+</ul>
+<a name="toString--">
+<!--   -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>toString</h4>
+<pre>public&nbsp;<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>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/SwaggerElement.html#line.131">toString</a>()</pre>
+<dl>
+<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
+<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
+</dl>
+</li>
+</ul>
 </li>
 </ul>
 </li>

http://git-wip-us.apache.org/repos/asf/juneau-website/blob/60d9bd65/content/site/apidocs/org/apache/juneau/dto/swagger/Tag.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/dto/swagger/Tag.html b/content/site/apidocs/org/apache/juneau/dto/swagger/Tag.html
index b5c2010..cf6f67a 100644
--- a/content/site/apidocs/org/apache/juneau/dto/swagger/Tag.html
+++ b/content/site/apidocs/org/apache/juneau/dto/swagger/Tag.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,8 +113,8 @@ 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,description,externalDocs")
-public class <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.47">Tag</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,description,externalDocs,*")
+public class <a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.51">Tag</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 adding meta data to a single tag that is used by the <a class="doclink" href="http://swagger.io/specification/#operationObject">Operation Object</a>.
  
@@ -123,6 +123,19 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
  
  <h5 class='section'>Example:</h5>
  <p class='bcode'>
+   <jc>// Construct using SwaggerBuilder.</jc>
+   Tag x = <jsm>tag</jsm>()
+      .name(<js>"pet"</js>)
+      .description(<js>"Pets operations"</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>"pet"</js>,
       <js>"description"</js>: <js>"Pets operations"</js>
@@ -131,17 +144,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>
@@ -180,55 +183,69 @@ 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/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>&nbsp;description)</code>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Tag.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/Tag.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>&nbsp;value)</code>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setDescription-java.lang.String-"><code>setDescription(String)</code></a>.</div>
 </td>
 </tr>
 <tr id="i1" class="rowColor">
 <td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#externalDocs-org.apache.juneau.dto.swagger.ExternalDocumentation-">externalDocs</a></span>(<a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a>&nbsp;externalDocs)</code>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setExternalDocs-org.apache.juneau.dto.swagger.ExternalDocumentation-"><code>setExternalDocs(ExternalDocumentation)</code></a>.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#externalDocs-java.lang.Object-">externalDocs</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>&nbsp;value)</code>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setExternalDocs-org.apache.juneau.dto.swagger.ExternalDocumentation-"><code>setExternalDocs(ExternalDocumentation)</code></a>.</div>
 </td>
 </tr>
 <tr id="i2" class="altColor">
+<td class="colFirst"><code>&lt;T&gt;&nbsp;T</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>&nbsp;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>&lt;T&gt;&nbsp;type)</code>
+<div class="block">Generic property getter.</div>
+</td>
+</tr>
+<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/Tag.html#getDescription--">getDescription</a></span>()</code>
 <div class="block">Bean property getter:  <property>description</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/Tag.html#getExternalDocs--">getExternalDocs</a></span>()</code>
 <div class="block">Bean property getter:  <property>externalDocs</property>.</div>
 </td>
 </tr>
-<tr id="i4" class="altColor">
+<tr id="i5" class="rowColor">
 <td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/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/Tag.html#getName--">getName</a></span>()</code>
 <div class="block">Bean property getter:  <property>name</property>.</div>
 </td>
 </tr>
-<tr id="i5" class="rowColor">
+<tr id="i6" class="altColor">
 <td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>&nbsp;name)</code>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Tag.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/Tag.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>&nbsp;value)</code>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setName-java.lang.String-"><code>setName(String)</code></a>.</div>
 </td>
 </tr>
-<tr id="i6" class="altColor">
+<tr id="i7" class="rowColor">
 <td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>&nbsp;description)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>&nbsp;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>&nbsp;value)</code>
+<div class="block">Generic property setter.</div>
+</td>
+</tr>
+<tr id="i8" class="altColor">
+<td class="colFirst"><code><a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>&nbsp;value)</code>
 <div class="block">Bean property setter:  <property>description</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/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setExternalDocs-org.apache.juneau.dto.swagger.ExternalDocumentation-">setExternalDocs</a></span>(<a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a>&nbsp;externalDocs)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setExternalDocs-org.apache.juneau.dto.swagger.ExternalDocumentation-">setExternalDocs</a></span>(<a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a>&nbsp;value)</code>
 <div class="block">Bean property setter:  <property>externalDocs</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/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>&nbsp;name)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>&nbsp;value)</code>
 <div class="block">Bean property setter:  <property>name</property>.</div>
 </td>
 </tr>
@@ -238,14 +255,14 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
 <!--   -->
 </a>
 <h3>Methods inherited from class&nbsp;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&nbsp;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>
@@ -267,7 +284,7 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
 <ul class="blockListLast">
 <li class="blockList">
 <h4>Tag</h4>
-<pre>public&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.47">Tag</a>()</pre>
+<pre>public&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.51">Tag</a>()</pre>
 </li>
 </ul>
 </li>
@@ -284,14 +301,14 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
 <ul class="blockList">
 <li class="blockList">
 <h4>getName</h4>
-<pre>public&nbsp;<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>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.61">getName</a>()</pre>
+<pre>public&nbsp;<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>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.66">getName</a>()</pre>
 <div class="block">Bean property getter:  <property>name</property>.
  
  <p>
- Required. The name of the tag.</div>
+ The name of the tag.</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>
@@ -301,30 +318,33 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
 <ul class="blockList">
 <li class="blockList">
 <h4>setName</h4>
-<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.74">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>&nbsp;name)</pre>
+<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.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>&nbsp;value)</pre>
 <div class="block">Bean property setter:  <property>name</property>.
  
  <p>
- Required. The name of the tag.</div>
+ The name of the tag.</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>Property value is required.</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&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.85">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>&nbsp;name)</pre>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setName-java.lang.String-"><code>setName(String)</code></a>.</div>
+<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.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>&nbsp;value)</pre>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>
@@ -336,18 +356,14 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
 <ul class="blockList">
 <li class="blockList">
 <h4>getDescription</h4>
-<pre>public&nbsp;<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>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.102">getDescription</a>()</pre>
+<pre>public&nbsp;<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>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.107">getDescription</a>()</pre>
 <div class="block">Bean property getter:  <property>description</property>.
  
  <p>
- A short description for the tag.
- 
- <p>
- <a class="doclink" href="https://help.github.com/articles/github-flavored-markdown">GFM syntax</a> can be used
- for rich text representation.</div>
+ A short description for the tag.</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>
@@ -357,34 +373,34 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
 <ul class="blockList">
 <li class="blockList">
 <h4>setDescription</h4>
-<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.119">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>&nbsp;description)</pre>
+<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.123">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>&nbsp;value)</pre>
 <div class="block">Bean property setter:  <property>description</property>.
  
  <p>
- A short description for the tag.
- 
- <p>
- <a class="doclink" href="https://help.github.com/articles/github-flavored-markdown">GFM syntax</a> can be used
- for rich text representation.</div>
+ A short description for the tag.</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&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.130">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>&nbsp;description)</pre>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setDescription-java.lang.String-"><code>setDescription(String)</code></a>.</div>
+<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.137">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>&nbsp;value)</pre>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Tag.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>
@@ -396,14 +412,14 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
 <ul class="blockList">
 <li class="blockList">
 <h4>getExternalDocs</h4>
-<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.143">getExternalDocs</a>()</pre>
+<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.149">getExternalDocs</a>()</pre>
 <div class="block">Bean property getter:  <property>externalDocs</property>.
  
  <p>
  Additional external documentation for this tag.</div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
-<dd>The value of the <property>externalDocs</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>
@@ -413,30 +429,89 @@ extends <a href="../../../../../org/apache/juneau/dto/swagger/SwaggerElement.htm
 <ul class="blockList">
 <li class="blockList">
 <h4>setExternalDocs</h4>
-<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.156">setExternalDocs</a>(<a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a>&nbsp;externalDocs)</pre>
+<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.164">setExternalDocs</a>(<a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a>&nbsp;value)</pre>
 <div class="block">Bean property setter:  <property>externalDocs</property>.
  
  <p>
  Additional external documentation for this tag.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>externalDocs</code> - The new value for the <property>externalDocs</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="externalDocs-org.apache.juneau.dto.swagger.ExternalDocumentation-">
+<a name="externalDocs-java.lang.Object-">
 <!--   -->
 </a>
-<ul class="blockListLast">
+<ul class="blockList">
 <li class="blockList">
 <h4>externalDocs</h4>
-<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.167">externalDocs</a>(<a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger">ExternalDocumentation</a>&nbsp;externalDocs)</pre>
-<div class="block">Synonym for <a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setExternalDocs-org.apache.juneau.dto.swagger.ExternalDocumentation-"><code>setExternalDocs(ExternalDocumentation)</code></a>.</div>
+<pre>public&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.186">externalDocs</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>&nbsp;value)</pre>
+<div class="block">Same as <a href="../../../../../org/apache/juneau/dto/swagger/Tag.html#setExternalDocs-org.apache.juneau.dto.swagger.ExternalDocumentation-"><code>setExternalDocs(ExternalDocumentation)</code></a>.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>value</code> - The new value for this property.
+   <br>Valid types:
+   <ul>
+      <li><a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger"><code>ExternalDocumentation</code></a>
+      <li><code>String</code> - JSON object representation of <a href="../../../../../org/apache/juneau/dto/swagger/ExternalDocumentation.html" title="class in org.apache.juneau.dto.swagger"><code>ExternalDocumentation</code></a>
+         <h6 class='figure'>Example:</h6>
+         <p class='bcode'>
+   externalDocs(<js>"{description:'description',url:'url'}"</js>);
+         </p>
+   </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&nbsp;&lt;T&gt;&nbsp;T&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.191">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>&nbsp;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>&lt;T&gt;&nbsp;type)</pre>
+<div class="block"><span class="descfrmTypeLabel">Description copied from class:&nbsp;<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>&nbsp;in class&nbsp;<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&nbsp;<a href="../../../../../org/apache/juneau/dto/swagger/Tag.html" title="class in org.apache.juneau.dto.swagger">Tag</a>&nbsp;<a href="../../../../../src-html/org/apache/juneau/dto/swagger/Tag.html#line.203">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>&nbsp;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>&nbsp;value)</pre>
+<div class="block"><span class="descfrmTypeLabel">Description copied from class:&nbsp;<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>&nbsp;in class&nbsp;<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>externalDocs</code> - The new value for the <property>externalDocs</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>