You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2017/08/27 22:20:18 UTC
[45/51] [partial] incubator-juneau-website git commit: Update
javadocs.
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/2ead32d5/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializer.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializer.html b/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializer.html
index 3329aed..9e11265 100644
--- a/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializer.html
+++ b/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializer.html
@@ -123,8 +123,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre><a href="../../../../org/apache/juneau/annotation/Produces.html" title="annotation in org.apache.juneau.annotation">@Produces</a>(<a href="../../../../org/apache/juneau/annotation/Produces.html#value--">value</a>="text/plain")
-public class <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.47">PlainTextSerializer</a>
+<pre>public class <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.45">PlainTextSerializer</a>
extends <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html" title="class in org.apache.juneau.serializer">WriterSerializer</a></pre>
<div class="block">Serializes POJOs to plain text using just the <code>toString()</code> method on the serialized object.
@@ -200,6 +199,13 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html"
<div class="block">Constructor.</div>
</td>
</tr>
+<tr class="rowColor">
+<td class="colOne"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/plaintext/PlainTextSerializer.html#PlainTextSerializer-org.apache.juneau.PropertyStore-java.lang.String-java.lang.String...-">PlainTextSerializer</a></span>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore,
+ <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> produces,
+ <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>... accept)</code>
+<div class="block">Constructor.</div>
+</td>
+</tr>
</table>
</li>
</ul>
@@ -241,7 +247,7 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html"
<!-- -->
</a>
<h3>Methods inherited from class org.apache.juneau.serializer.<a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a></h3>
-<code><a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession--">createSession</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--">getMediaTypes</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getPrimaryMediaType--">getPrimaryMediaType</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getResponseContentType--">getResponseContentType</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#serialize-java.lang.Object-java.lang.Object-">serialize</a></code></li>
+<code><a href="../../../../org/apache/juneau/serializer/Serializer.html#createDefaultSessionArgs--">createDefaultSessionArgs</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession--">createSession</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--">getMediaTypes</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getResponseContentType--">getResponseContentType</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#serialize-java.lang.Object-java.lang.Object-">serialize</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.apache.juneau.CoreObject">
@@ -277,7 +283,7 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html"
<ul class="blockListLast">
<li class="blockList">
<h4>DEFAULT</h4>
-<pre>public static final <a href="../../../../org/apache/juneau/plaintext/PlainTextSerializer.html" title="class in org.apache.juneau.plaintext">PlainTextSerializer</a> <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.50">DEFAULT</a></pre>
+<pre>public static final <a href="../../../../org/apache/juneau/plaintext/PlainTextSerializer.html" title="class in org.apache.juneau.plaintext">PlainTextSerializer</a> <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.48">DEFAULT</a></pre>
<div class="block">Default serializer, all default settings.</div>
</li>
</ul>
@@ -292,14 +298,43 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html"
<a name="PlainTextSerializer-org.apache.juneau.PropertyStore-">
<!-- -->
</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>PlainTextSerializer</h4>
+<pre>public <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.58">PlainTextSerializer</a>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore)</pre>
+<div class="block">Constructor.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>propertyStore</code> - The property store containing all the settings for this object.</dd>
+</dl>
+</li>
+</ul>
+<a name="PlainTextSerializer-org.apache.juneau.PropertyStore-java.lang.String-java.lang.String...-">
+<!-- -->
+</a>
<ul class="blockListLast">
<li class="blockList">
<h4>PlainTextSerializer</h4>
-<pre>public <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.59">PlainTextSerializer</a>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore)</pre>
+<pre>public <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.83">PlainTextSerializer</a>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore,
+ <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> produces,
+ <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>... accept)</pre>
<div class="block">Constructor.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>propertyStore</code> - The property store containing all the settings for this object.</dd>
+<dd><code>produces</code> - The media type that this serializer produces.</dd>
+<dd><code>accept</code> - The accept media types that the serializer can handle.
+ <p>
+ Can contain meta-characters per the <code>media-type</code> specification of
+ <a class="doclink" href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1">RFC2616/14.1</a>
+ <p>
+ If empty, then assumes the only media type supported is <code>produces</code>.
+ <p>
+ For example, if this serializer produces <js>"application/json"</js> but should handle media types of
+ <js>"application/json"</js> and <js>"text/json"</js>, then the arguments should be:
+ <br><code><jk>super</jk>(propertyStore, <js>"application/json"</js>, <js>"application/json"</js>, <js>"text/json"</js>);</code>
+ <br>...or...
+ <br><code><jk>super</jk>(propertyStore, <js>"application/json"</js>, <js>"*​/json"</js>);</code></dd>
</dl>
</li>
</ul>
@@ -317,7 +352,7 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html"
<ul class="blockList">
<li class="blockList">
<h4>builder</h4>
-<pre>public <a href="../../../../org/apache/juneau/plaintext/PlainTextSerializerBuilder.html" title="class in org.apache.juneau.plaintext">PlainTextSerializerBuilder</a> <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.65">builder</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/plaintext/PlainTextSerializerBuilder.html" title="class in org.apache.juneau.plaintext">PlainTextSerializerBuilder</a> <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.90">builder</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/CoreObject.html#builder--">CoreObject</a></code></span></div>
<div class="block">Creates a new builder class for this object so that a new object can be created that expands upon the current
object's settings.</div>
@@ -335,7 +370,7 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html"
<ul class="blockListLast">
<li class="blockList">
<h4>createSession</h4>
-<pre>public <a href="../../../../org/apache/juneau/serializer/WriterSerializerSession.html" title="class in org.apache.juneau.serializer">WriterSerializerSession</a> <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.70">createSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
+<pre>public <a href="../../../../org/apache/juneau/serializer/WriterSerializerSession.html" title="class in org.apache.juneau.serializer">WriterSerializerSession</a> <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializer.html#line.95">createSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession-org.apache.juneau.serializer.SerializerSessionArgs-">Serializer</a></code></span></div>
<div class="block">Create the session object used for actual serialization of objects.</div>
<dl>
@@ -345,8 +380,7 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html"
<dd><code>args</code> - Runtime arguments.
These specify session-level information such as locale and URI context.
It also include session-level properties that override the properties defined on the bean and serializer
- contexts.
- <br>If <jk>null</jk>, defaults to <a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html#DEFAULT"><code>SerializerSessionArgs.DEFAULT</code></a>.</dd>
+ contexts.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>The new session object.
<br>Note that you must call <a href="../../../../org/apache/juneau/BeanSession.html#close--"><code>BeanSession.close()</code></a> on this object to perform any necessary
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/2ead32d5/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializerSession.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializerSession.html b/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializerSession.html
index 0e20cd3..55a94e7 100644
--- a/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializerSession.html
+++ b/content/site/apidocs/org/apache/juneau/plaintext/PlainTextSerializerSession.html
@@ -253,7 +253,7 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializerSessio
<ul class="blockListLast">
<li class="blockList">
<h4>PlainTextSerializerSession</h4>
-<pre>protected <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializerSession.html#line.39">PlainTextSerializerSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerContext.html" title="class in org.apache.juneau.serializer">SerializerContext</a> ctx,
+<pre>protected <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializerSession.html#line.38">PlainTextSerializerSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerContext.html" title="class in org.apache.juneau.serializer">SerializerContext</a> ctx,
<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
<div class="block">Create a new session using properties specified in the context.</div>
<dl>
@@ -263,8 +263,7 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializerSessio
<dd><code>args</code> - Runtime arguments.
These specify session-level information such as locale and URI context.
It also include session-level properties that override the properties defined on the bean and
- serializer contexts.
- <br>If <jk>null</jk>, defaults to <a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html#DEFAULT"><code>SerializerSessionArgs.DEFAULT</code></a>.</dd>
+ serializer contexts.</dd>
</dl>
</li>
</ul>
@@ -282,7 +281,7 @@ extends <a href="../../../../org/apache/juneau/serializer/WriterSerializerSessio
<ul class="blockListLast">
<li class="blockList">
<h4>doSerialize</h4>
-<pre>protected void <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializerSession.html#line.44">doSerialize</a>(<a href="../../../../org/apache/juneau/serializer/SerializerPipe.html" title="class in org.apache.juneau.serializer">SerializerPipe</a> out,
+<pre>protected void <a href="../../../../src-html/org/apache/juneau/plaintext/PlainTextSerializerSession.html#line.43">doSerialize</a>(<a href="../../../../org/apache/juneau/serializer/SerializerPipe.html" title="class in org.apache.juneau.serializer">SerializerPipe</a> out,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> o)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/serializer/SerializerSession.html#doSerialize-org.apache.juneau.serializer.SerializerPipe-java.lang.Object-">SerializerSession</a></code></span></div>
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/2ead32d5/content/site/apidocs/org/apache/juneau/rest/package-summary.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/package-summary.html b/content/site/apidocs/org/apache/juneau/rest/package-summary.html
index 24f9217..8d3d04b 100644
--- a/content/site/apidocs/org/apache/juneau/rest/package-summary.html
+++ b/content/site/apidocs/org/apache/juneau/rest/package-summary.html
@@ -1824,8 +1824,7 @@
</p>
<p>
The servlet will pick which serializer to use by matching the request <l>Accept</l> header with the
- media types defined through the <a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--"><code>Serializer.getMediaTypes()</code></a> method
- (which itself usually comes from the <a href="../../../../org/apache/juneau/annotation/Produces.html" title="annotation in org.apache.juneau.annotation"><code>@Produces</code></a> annotation).
+ media types defined through the <a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--"><code>Serializer.getMediaTypes()</code></a> method.
</p>
<p>
Serializers can be associated with REST servlets in the following ways:
@@ -1894,8 +1893,7 @@
</p>
<p>
The servlet will pick which parser to use by matching the request <l>Content-Type</l> header with the
- media types defined through the <a href="../../../../org/apache/juneau/parser/Parser.html#getMediaTypes--"><code>Parser.getMediaTypes()</code></a> method (which itself
- usually comes from the <a href="../../../../org/apache/juneau/annotation/Consumes.html" title="annotation in org.apache.juneau.annotation"><code>@Consumes</code></a> annotation).
+ media types defined through the <a href="../../../../org/apache/juneau/parser/Parser.html#getMediaTypes--"><code>Parser.getMediaTypes()</code></a> method.
</p>
<p>
Parsers can be associated with REST servlets in the following ways:
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/2ead32d5/content/site/apidocs/org/apache/juneau/rest/response/DefaultHandler.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/response/DefaultHandler.html b/content/site/apidocs/org/apache/juneau/rest/response/DefaultHandler.html
index e9b4614..9561731 100644
--- a/content/site/apidocs/org/apache/juneau/rest/response/DefaultHandler.html
+++ b/content/site/apidocs/org/apache/juneau/rest/response/DefaultHandler.html
@@ -112,7 +112,7 @@ var activeTableTab = "activeTableTab";
</dl>
<hr>
<br>
-<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/response/DefaultHandler.html#line.40">DefaultHandler</a>
+<pre>public class <a href="../../../../../src-html/org/apache/juneau/rest/response/DefaultHandler.html#line.39">DefaultHandler</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>
implements <a href="../../../../../org/apache/juneau/rest/ResponseHandler.html" title="interface in org.apache.juneau.rest">ResponseHandler</a></pre>
<div class="block">Response handler for POJOs not handled by other handlers.
@@ -125,7 +125,7 @@ implements <a href="../../../../../org/apache/juneau/rest/ResponseHandler.html"
<p>
The <code>Content-Type</code> header is set to the mime-type defined on the selected serializer based on the
- <a href="../../../../../org/apache/juneau/annotation/Produces.html#contentType--"><code>@Produces.contentType</code></a> annotation.</div>
+ <code>produces</code> value passed in through the constructor.</div>
</li>
</ul>
</div>
@@ -197,7 +197,7 @@ implements <a href="../../../../../org/apache/juneau/rest/ResponseHandler.html"
<ul class="blockListLast">
<li class="blockList">
<h4>DefaultHandler</h4>
-<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/response/DefaultHandler.html#line.40">DefaultHandler</a>()</pre>
+<pre>public <a href="../../../../../src-html/org/apache/juneau/rest/response/DefaultHandler.html#line.39">DefaultHandler</a>()</pre>
</li>
</ul>
</li>
@@ -214,7 +214,7 @@ implements <a href="../../../../../org/apache/juneau/rest/ResponseHandler.html"
<ul class="blockListLast">
<li class="blockList">
<h4>handle</h4>
-<pre>public boolean <a href="../../../../../src-html/org/apache/juneau/rest/response/DefaultHandler.html#line.43">handle</a>(<a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req,
+<pre>public boolean <a href="../../../../../src-html/org/apache/juneau/rest/response/DefaultHandler.html#line.42">handle</a>(<a href="../../../../../org/apache/juneau/rest/RestRequest.html" title="class in org.apache.juneau.rest">RestRequest</a> req,
<a href="../../../../../org/apache/juneau/rest/RestResponse.html" title="class in org.apache.juneau.rest">RestResponse</a> res,
<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> output)
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a>,
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/2ead32d5/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializer.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializer.html b/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializer.html
index 2f99f9e..eab161c 100644
--- a/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializer.html
+++ b/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializer.html
@@ -122,17 +122,9 @@ var activeTableTab = "activeTableTab";
</dl>
<hr>
<br>
-<pre>public abstract class <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.31">OutputStreamSerializer</a>
+<pre>public abstract class <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.22">OutputStreamSerializer</a>
extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a></pre>
-<div class="block">Subclass of <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer"><code>Serializer</code></a> for byte-based serializers.
-
- <h6 class='topic'>@Produces annotation</h6>
-
- The media types that this serializer can produce is specified through the <a href="../../../../org/apache/juneau/annotation/Produces.html" title="annotation in org.apache.juneau.annotation"><code>@Produces</code></a> annotation.
-
- <p>
- However, the media types can also be specified programmatically by overriding the <a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--"><code>Serializer.getMediaTypes()</code></a>
- and <a href="../../../../org/apache/juneau/serializer/Serializer.html#getResponseContentType--"><code>Serializer.getResponseContentType()</code></a> methods.</div>
+<div class="block">Subclass of <a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer"><code>Serializer</code></a> for byte-based serializers.</div>
</li>
</ul>
</div>
@@ -168,7 +160,9 @@ extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected </code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/serializer/OutputStreamSerializer.html#OutputStreamSerializer-org.apache.juneau.PropertyStore-">OutputStreamSerializer</a></span>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore)</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/serializer/OutputStreamSerializer.html#OutputStreamSerializer-org.apache.juneau.PropertyStore-java.lang.String-java.lang.String...-">OutputStreamSerializer</a></span>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore,
+ <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> produces,
+ <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>... accept)</code>
<div class="block">Constructor.</div>
</td>
</tr>
@@ -217,7 +211,7 @@ extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title
<!-- -->
</a>
<h3>Methods inherited from class org.apache.juneau.serializer.<a href="../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a></h3>
-<code><a href="../../../../org/apache/juneau/serializer/Serializer.html#builder--">builder</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession--">createSession</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--">getMediaTypes</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getPrimaryMediaType--">getPrimaryMediaType</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getResponseContentType--">getResponseContentType</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#serialize-java.lang.Object-java.lang.Object-">serialize</a></code></li>
+<code><a href="../../../../org/apache/juneau/serializer/Serializer.html#builder--">builder</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#createDefaultSessionArgs--">createDefaultSessionArgs</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession--">createSession</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--">getMediaTypes</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#getResponseContentType--">getResponseContentType</a>, <a href="../../../../org/apache/juneau/serializer/Serializer.html#serialize-java.lang.Object-java.lang.Object-">serialize</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.apache.juneau.CoreObject">
@@ -247,17 +241,32 @@ extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title
<!-- -->
</a>
<h3>Constructor Detail</h3>
-<a name="OutputStreamSerializer-org.apache.juneau.PropertyStore-">
+<a name="OutputStreamSerializer-org.apache.juneau.PropertyStore-java.lang.String-java.lang.String...-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>OutputStreamSerializer</h4>
-<pre>protected <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.38">OutputStreamSerializer</a>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore)</pre>
+<pre>protected <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.45">OutputStreamSerializer</a>(<a href="../../../../org/apache/juneau/PropertyStore.html" title="class in org.apache.juneau">PropertyStore</a> propertyStore,
+ <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> produces,
+ <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>... accept)</pre>
<div class="block">Constructor.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>propertyStore</code> - The property store containing all the settings for this object.</dd>
+<dd><code>produces</code> - The media type that this serializer produces.</dd>
+<dd><code>accept</code> - The accept media types that the serializer can handle.
+ <p>
+ Can contain meta-characters per the <code>media-type</code> specification of
+ <a class="doclink" href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1">RFC2616/14.1</a>
+ <p>
+ If empty, then assumes the only media type supported is <code>produces</code>.
+ <p>
+ For example, if this serializer produces <js>"application/json"</js> but should handle media types of
+ <js>"application/json"</js> and <js>"text/json"</js>, then the arguments should be:
+ <br><code><jk>super</jk>(propertyStore, <js>"application/json"</js>, <js>"application/json"</js>, <js>"text/json"</js>);</code>
+ <br>...or...
+ <br><code><jk>super</jk>(propertyStore, <js>"application/json"</js>, <js>"*​/json"</js>);</code></dd>
</dl>
</li>
</ul>
@@ -275,7 +284,7 @@ extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title
<ul class="blockList">
<li class="blockList">
<h4>createSession</h4>
-<pre>public abstract <a href="../../../../org/apache/juneau/serializer/OutputStreamSerializerSession.html" title="class in org.apache.juneau.serializer">OutputStreamSerializerSession</a> <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.48">createSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
+<pre>public abstract <a href="../../../../org/apache/juneau/serializer/OutputStreamSerializerSession.html" title="class in org.apache.juneau.serializer">OutputStreamSerializerSession</a> <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.55">createSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession-org.apache.juneau.serializer.SerializerSessionArgs-">Serializer</a></code></span></div>
<div class="block">Create the session object used for actual serialization of objects.</div>
<dl>
@@ -285,8 +294,7 @@ extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title
<dd><code>args</code> - Runtime arguments.
These specify session-level information such as locale and URI context.
It also include session-level properties that override the properties defined on the bean and serializer
- contexts.
- <br>If <jk>null</jk>, defaults to <a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html#DEFAULT"><code>SerializerSessionArgs.DEFAULT</code></a>.</dd>
+ contexts.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>The new session object.
<br>Note that you must call <a href="../../../../org/apache/juneau/BeanSession.html#close--"><code>BeanSession.close()</code></a> on this object to perform any necessary
@@ -300,7 +308,7 @@ extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title
<ul class="blockList">
<li class="blockList">
<h4>isWriterSerializer</h4>
-<pre>public final boolean <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.56">isWriterSerializer</a>()</pre>
+<pre>public final boolean <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.63">isWriterSerializer</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/serializer/Serializer.html#isWriterSerializer--">Serializer</a></code></span></div>
<div class="block">Returns <jk>true</jk> if this serializer subclasses from <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html" title="class in org.apache.juneau.serializer"><code>WriterSerializer</code></a>.</div>
<dl>
@@ -317,7 +325,7 @@ extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title
<ul class="blockList">
<li class="blockList">
<h4>serialize</h4>
-<pre>public final byte[] <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.68">serialize</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> o)
+<pre>public final byte[] <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.75">serialize</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> o)
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block">Convenience method for serializing an object to a <code><jk>byte</jk></code>.</div>
<dl>
@@ -338,7 +346,7 @@ extends <a href="../../../../org/apache/juneau/serializer/Serializer.html" title
<ul class="blockListLast">
<li class="blockList">
<h4>serializeToHex</h4>
-<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.79">serializeToHex</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> o)
+<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializer.html#line.86">serializeToHex</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> o)
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block">Convenience method for serializing an object to a hex-encoded String.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/2ead32d5/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializerSession.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializerSession.html b/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializerSession.html
index a2bd11f..7063ea2 100644
--- a/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializerSession.html
+++ b/content/site/apidocs/org/apache/juneau/serializer/OutputStreamSerializerSession.html
@@ -260,7 +260,7 @@ extends <a href="../../../../org/apache/juneau/serializer/SerializerSession.html
<ul class="blockList">
<li class="blockList">
<h4>OutputStreamSerializerSession</h4>
-<pre>protected <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializerSession.html#line.43">OutputStreamSerializerSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerContext.html" title="class in org.apache.juneau.serializer">SerializerContext</a> ctx,
+<pre>protected <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializerSession.html#line.42">OutputStreamSerializerSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerContext.html" title="class in org.apache.juneau.serializer">SerializerContext</a> ctx,
<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
<div class="block">Create a new session using properties specified in the context.</div>
<dl>
@@ -270,8 +270,7 @@ extends <a href="../../../../org/apache/juneau/serializer/SerializerSession.html
<dd><code>args</code> - Runtime arguments.
These specify session-level information such as locale and URI context.
It also include session-level properties that override the properties defined on the bean and
- serializer contexts.
- <br>If <jk>null</jk>, defaults to <a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html#DEFAULT"><code>SerializerSessionArgs.DEFAULT</code></a>.</dd>
+ serializer contexts.</dd>
</dl>
</li>
</ul>
@@ -281,7 +280,7 @@ extends <a href="../../../../org/apache/juneau/serializer/SerializerSession.html
<ul class="blockListLast">
<li class="blockList">
<h4>OutputStreamSerializerSession</h4>
-<pre>protected <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializerSession.html#line.53">OutputStreamSerializerSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
+<pre>protected <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializerSession.html#line.52">OutputStreamSerializerSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
<div class="block">Constructor for sessions that don't require context.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
@@ -303,7 +302,7 @@ extends <a href="../../../../org/apache/juneau/serializer/SerializerSession.html
<ul class="blockList">
<li class="blockList">
<h4>isWriterSerializer</h4>
-<pre>public final boolean <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializerSession.html#line.58">isWriterSerializer</a>()</pre>
+<pre>public final boolean <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializerSession.html#line.57">isWriterSerializer</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/serializer/SerializerSession.html#isWriterSerializer--">SerializerSession</a></code></span></div>
<div class="block">Returns <jk>true</jk> if this serializer subclasses from <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html" title="class in org.apache.juneau.serializer"><code>WriterSerializer</code></a>.</div>
<dl>
@@ -320,7 +319,7 @@ extends <a href="../../../../org/apache/juneau/serializer/SerializerSession.html
<ul class="blockListLast">
<li class="blockList">
<h4>serialize</h4>
-<pre>public final byte[] <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializerSession.html#line.70">serialize</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> o)
+<pre>public final byte[] <a href="../../../../src-html/org/apache/juneau/serializer/OutputStreamSerializerSession.html#line.69">serialize</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> o)
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block">Convenience method for serializing an object to a <code><jk>byte</jk></code>.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/2ead32d5/content/site/apidocs/org/apache/juneau/serializer/Serializer.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/serializer/Serializer.html b/content/site/apidocs/org/apache/juneau/serializer/Serializer.html
index a49aee2..bf6fee3 100644
--- a/content/site/apidocs/org/apache/juneau/serializer/Serializer.html
+++ b/content/site/apidocs/org/apache/juneau/serializer/Serializer.html
@@ -18,7 +18,7 @@
catch(err) {
}
//-->
-var methods = {"i0":10,"i1":10,"i2":6,"i3":10,"i4":10,"i5":10,"i6":6,"i7":10,"i8":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":6,"i4":10,"i5":10,"i6":6,"i7":10,"i8":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
@@ -117,7 +117,7 @@ var activeTableTab = "activeTableTab";
</dl>
<hr>
<br>
-<pre>public abstract class <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.50">Serializer</a>
+<pre>public abstract class <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.39">Serializer</a>
extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in org.apache.juneau">CoreObject</a></pre>
<div class="block">Parent class for all Juneau serializers.
@@ -135,14 +135,7 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
<p>
Subclasses should extend directly from <a href="../../../../org/apache/juneau/serializer/OutputStreamSerializer.html" title="class in org.apache.juneau.serializer"><code>OutputStreamSerializer</code></a> or <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html" title="class in org.apache.juneau.serializer"><code>WriterSerializer</code></a> depending on
- whether it's a stream or character based serializer.
-
- <h6 class='topic'>@Produces annotation</h6>
-
- The media types that this serializer can produce is specified through the <a href="../../../../org/apache/juneau/annotation/Produces.html" title="annotation in org.apache.juneau.annotation"><code>@Produces</code></a> annotation.
- <br>
- However, the media types can also be specified programmatically by overriding the <a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--"><code>getMediaTypes()</code></a>
- and <a href="../../../../org/apache/juneau/serializer/Serializer.html#getResponseContentType--"><code>getResponseContentType()</code></a> methods.</div>
+ whether it's a stream or character based serializer.</div>
</li>
</ul>
</div>
@@ -184,27 +177,27 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
</td>
</tr>
<tr id="i1" class="rowColor">
+<td class="colFirst"><code><a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/serializer/Serializer.html#createDefaultSessionArgs--">createDefaultSessionArgs</a></span>()</code>
+<div class="block">Creates the session arguments object that gets passed to the <a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession-org.apache.juneau.serializer.SerializerSessionArgs-"><code>createSession(SerializerSessionArgs)</code></a> method.</div>
+</td>
+</tr>
+<tr id="i2" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/serializer/SerializerSession.html" title="class in org.apache.juneau.serializer">SerializerSession</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession--">createSession</a></span>()</code>
<div class="block">Shortcut for calling <code>createSession(<jk>null</jk>)</code>.</div>
</td>
</tr>
-<tr id="i2" class="altColor">
+<tr id="i3" class="rowColor">
<td class="colFirst"><code>abstract <a href="../../../../org/apache/juneau/serializer/SerializerSession.html" title="class in org.apache.juneau.serializer">SerializerSession</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession-org.apache.juneau.serializer.SerializerSessionArgs-">createSession</a></span>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</code>
<div class="block">Create the session object used for actual serialization of objects.</div>
</td>
</tr>
-<tr id="i3" class="rowColor">
+<tr id="i4" class="altColor">
<td class="colFirst"><code><a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/serializer/Serializer.html#getMediaTypes--">getMediaTypes</a></span>()</code>
-<div class="block">Returns the media types handled based on the value of the <a href="../../../../org/apache/juneau/annotation/Produces.html" title="annotation in org.apache.juneau.annotation"><code>Produces</code></a> annotation on the serializer class.</div>
-</td>
-</tr>
-<tr id="i4" class="altColor">
-<td class="colFirst"><code><a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/juneau/serializer/Serializer.html#getPrimaryMediaType--">getPrimaryMediaType</a></span>()</code>
-<div class="block">Returns the first media type specified on this serializer via the <a href="../../../../org/apache/juneau/annotation/Produces.html" title="annotation in org.apache.juneau.annotation"><code>Produces</code></a> annotation.</div>
+<div class="block">Returns the media types handled based on the value of the <code>accept</code> parameter passed into the constructor.</div>
</td>
</tr>
<tr id="i5" class="rowColor">
@@ -269,7 +262,7 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>builder</h4>
-<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerBuilder.html" title="class in org.apache.juneau.serializer">SerializerBuilder</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.74">builder</a>()</pre>
+<pre>public <a href="../../../../org/apache/juneau/serializer/SerializerBuilder.html" title="class in org.apache.juneau.serializer">SerializerBuilder</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.60">builder</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../../../org/apache/juneau/CoreObject.html#builder--">CoreObject</a></code></span></div>
<div class="block">Creates a new builder class for this object so that a new object can be created that expands upon the current
object's settings.</div>
@@ -287,7 +280,7 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>isWriterSerializer</h4>
-<pre>public abstract boolean <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.87">isWriterSerializer</a>()</pre>
+<pre>public abstract boolean <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.73">isWriterSerializer</a>()</pre>
<div class="block">Returns <jk>true</jk> if this serializer subclasses from <a href="../../../../org/apache/juneau/serializer/WriterSerializer.html" title="class in org.apache.juneau.serializer"><code>WriterSerializer</code></a>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -301,15 +294,14 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>createSession</h4>
-<pre>public abstract <a href="../../../../org/apache/juneau/serializer/SerializerSession.html" title="class in org.apache.juneau.serializer">SerializerSession</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.103">createSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
+<pre>public abstract <a href="../../../../org/apache/juneau/serializer/SerializerSession.html" title="class in org.apache.juneau.serializer">SerializerSession</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.88">createSession</a>(<a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> args)</pre>
<div class="block">Create the session object used for actual serialization of objects.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>args</code> - Runtime arguments.
These specify session-level information such as locale and URI context.
It also include session-level properties that override the properties defined on the bean and serializer
- contexts.
- <br>If <jk>null</jk>, defaults to <a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html#DEFAULT"><code>SerializerSessionArgs.DEFAULT</code></a>.</dd>
+ contexts.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>The new session object.
<br>Note that you must call <a href="../../../../org/apache/juneau/BeanSession.html#close--"><code>BeanSession.close()</code></a> on this object to perform any necessary
@@ -323,7 +315,7 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>createSession</h4>
-<pre>public final <a href="../../../../org/apache/juneau/serializer/SerializerSession.html" title="class in org.apache.juneau.serializer">SerializerSession</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.118">createSession</a>()</pre>
+<pre>public final <a href="../../../../org/apache/juneau/serializer/SerializerSession.html" title="class in org.apache.juneau.serializer">SerializerSession</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.103">createSession</a>()</pre>
<div class="block">Shortcut for calling <code>createSession(<jk>null</jk>)</code>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -333,13 +325,28 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
</dl>
</li>
</ul>
+<a name="createDefaultSessionArgs--">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>createDefaultSessionArgs</h4>
+<pre>public final <a href="../../../../org/apache/juneau/serializer/SerializerSessionArgs.html" title="class in org.apache.juneau.serializer">SerializerSessionArgs</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.114">createDefaultSessionArgs</a>()</pre>
+<div class="block">Creates the session arguments object that gets passed to the <a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession-org.apache.juneau.serializer.SerializerSessionArgs-"><code>createSession(SerializerSessionArgs)</code></a> method.</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>A new default session arguments object.
+ <p>The arguments can be modified before passing to the <a href="../../../../org/apache/juneau/serializer/Serializer.html#createSession-org.apache.juneau.serializer.SerializerSessionArgs-"><code>createSession(SerializerSessionArgs)</code></a>.</dd>
+</dl>
+</li>
+</ul>
<a name="serialize-java.lang.Object-java.lang.Object-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>serialize</h4>
-<pre>public final void <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.145">serialize</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> o,
+<pre>public final void <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.141">serialize</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> o,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> output)
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block">Serializes a POJO to the specified output stream or writer.
@@ -373,7 +380,7 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>serialize</h4>
-<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.165">serialize</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> o)
+<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.161">serialize</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> o)
throws <a href="../../../../org/apache/juneau/serializer/SerializeException.html" title="class in org.apache.juneau.serializer">SerializeException</a></pre>
<div class="block">Shortcut method for serializing objects directly to either a <code>String</code> or <code><jk>byte</jk>[]</code>
depending on the serializer type.</div>
@@ -395,38 +402,21 @@ extends <a href="../../../../org/apache/juneau/CoreObject.html" title="class in
<ul class="blockList">
<li class="blockList">
<h4>getMediaTypes</h4>
-<pre>public final <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>[] <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.186">getMediaTypes</a>()</pre>
-<div class="block">Returns the media types handled based on the value of the <a href="../../../../org/apache/juneau/annotation/Produces.html" title="annotation in org.apache.juneau.annotation"><code>Produces</code></a> annotation on the serializer class.
-
- <p>
- This method can be overridden by subclasses to determine the media types programmatically.</div>
+<pre>public final <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>[] <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.179">getMediaTypes</a>()</pre>
+<div class="block">Returns the media types handled based on the value of the <code>accept</code> parameter passed into the constructor.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>The list of media types. Never <jk>null</jk>.</dd>
</dl>
</li>
</ul>
-<a name="getPrimaryMediaType--">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>getPrimaryMediaType</h4>
-<pre>public final <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.195">getPrimaryMediaType</a>()</pre>
-<div class="block">Returns the first media type specified on this serializer via the <a href="../../../../org/apache/juneau/annotation/Produces.html" title="annotation in org.apache.juneau.annotation"><code>Produces</code></a> annotation.</div>
-<dl>
-<dt><span class="returnLabel">Returns:</span></dt>
-<dd>The media type.</dd>
-</dl>
-</li>
-</ul>
<a name="getResponseContentType--">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>getResponseContentType</h4>
-<pre>public <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.215">getResponseContentType</a>()</pre>
+<pre>public final <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> <a href="../../../../src-html/org/apache/juneau/serializer/Serializer.html#line.199">getResponseContentType</a>()</pre>
<div class="block">Optional method that returns the response <code>Content-Type</code> for this serializer if it is different from
the matched media type.