Repository: incubator-juneau-website Updated Branches: refs/heads/asf-site 46c4861ba -> b1c508354
Add Jackson comparison section. Project: http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/commit/b1c50835 Tree: http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/tree/b1c50835 Diff: http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/diff/b1c50835 Branch: refs/heads/asf-site Commit: b1c508354f89d72b7ec83ea367a0ddd55e6a1c5b Parents: 46c4861 Author: JamesBognar <[email protected]> Authored: Thu May 4 14:18:46 2017 -0400 Committer: JamesBognar <[email protected]> Committed: Thu May 4 14:18:46 2017 -0400 ---------------------------------------------------------------------- content/site/apidocs/overview-summary.html | 100 +++++++++++++++++++++++- 1 file changed, 99 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/b1c50835/content/site/apidocs/overview-summary.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/overview-summary.html b/content/site/apidocs/overview-summary.html index 4f6e279..4089f98 100644 --- a/content/site/apidocs/overview-summary.html +++ b/content/site/apidocs/overview-summary.html @@ -440,6 +440,7 @@ <li><p><a class='doclink' href='#Core.SimpleVarLanguage'>Simple Variable Language</a></p> <li><p><a class='doclink' href='#Core.ConfigFile'>Configuration Files</a></p> <li><p><a class='doclink' href='#Core.SupportedLanguages'>Supported Languages</a></p> + <li><p><a class='doclink' href='#Core.JacksonComparison'>Comparison with Jackson</a></p> </ol> <li><p><a class='doclink' href='#DTOs'>Juneau Data Transfer Objects (org.apache.juneau.dto)</a></p> <ol> @@ -1902,6 +1903,102 @@ <li class='p'><a class='doclink' href='org/apache/juneau/dto/cognos/package-summary.html#TOC'>org.apache.juneau.dto.cognos</a> - Cognos support. </ul> </div> + + <!-- ======================================================================================================== --> + <a id="Core.JacksonComparison"></a> + <h3 class='topic' onclick='toggle(this)'>2.12 - Comparison with Jackson</h3> + <div class='topic'> + <p> + Juneau was developed independently from Jackson, but shares many of the same features and capabilities. + Whereas Jackson was created to work primariliy with JSON, Juneau was created to work for multiple languages. + Therefore, the terminology and annotations in Juneau are similar, but language-agnostic. + </p> + <p> + The following charts describe equivalent features between the two libraries: + </p> + <h6 class='topic'>Annotations</h6> + <table class='styled'> + <tr><th>Jackson</th><th>Juneau</th></tr> + <tr> + <td><ja>@JsonGetter</ja><br><ja>@JsonSetter</ja></td> + <td> + <a href="org/apache/juneau/annotation/BeanProperty.html" title="annotation in org.apache.juneau.annotation"><code>@BeanProperty</code></a> + </td> + </tr> + <tr> + <td><ja>@JsonAnyGetter</ja><br><ja>@JsonAnySetter</ja></td> + <td> + <a href="org/apache/juneau/annotation/BeanProperty.html#name--"><code>@BeanProperty(name="*")</code></a> + </td> + </tr> + <tr> + <td><ja>@JsonIgnore</ja><br><ja>@JsonIgnoreType</ja></td> + <td> + <a href="org/apache/juneau/annotation/BeanIgnore.html" title="annotation in org.apache.juneau.annotation"><code>@BeanIgnore</code></a> + </td> + </tr> + <tr> + <td><code><ja>@JsonIgnoreProperties</ja>({...})</code></td> + <td> + <a href="org/apache/juneau/annotation/Bean.html#excludeProperties--"><code>@Bean(excludeProperties="...")</code></a> + </td> + </tr> + <tr> + <td><code><ja>@JsonAutoDetect</ja>(fieldVisibility=...)</code></td> + <td> + No equivalent annotation, but can be controlled via: <br> + <a href="org/apache/juneau/BeanContext.html#BEAN_beanFieldVisibility"><code>BeanContext.BEAN_beanFieldVisibility</code></a><br> + <a href="org/apache/juneau/BeanContext.html#BEAN_methodVisibility"><code>BeanContext.BEAN_methodVisibility</code></a><br> + Future annotation support planned. + </td> + </tr> + <tr> + <td><ja>@JsonCreator</ja><br><ja>@JsonProperty</ja></td> + <td> + <a href="org/apache/juneau/annotation/BeanConstructor.html" title="annotation in org.apache.juneau.annotation"><code>@BeanConstructor</code></a> + </td> + </tr> + <tr> + <td><ja>@JacksonInject</ja></td> + <td> + No equivalent.<br> + Future support planned. + </td> + + </tr> + <tr> + <td><ja>@JsonSerialize</ja><br><ja>@JsonDeserialize</ja></td> + <td> + Juneau uses swaps to convert non-serializable object to serializable forms:<br> + <a href="org/apache/juneau/annotation/BeanProperty.html#swap--"><code>@BeanProperty(swap=...)</code></a><br> + <a href="org/apache/juneau/annotation/Pojo.html#swap--"><code>@Pojo(swap=...)</code></a> + </td> + </tr> + <tr> + <td><ja>@JsonInclude</ja></td> + <td> + No equivalent annotation, but can be controlled via various settings:<br> + <a href="org/apache/juneau/BeanContext.html" title="class in org.apache.juneau"><code>BeanContext</code></a><br> + <a href="org/apache/juneau/serializer/SerializerContext.html" title="class in org.apache.juneau.serializer"><code>SerializerContext</code></a><br> + Future annotation support planned. + </td> + </tr> + <tr> + <td><ja>@JsonPropertyOrder</ja></td> + <td> + <a href="org/apache/juneau/annotation/Bean.html#properties--"><code>@Bean(properties="...")</code></a><br> + <a href="org/apache/juneau/annotation/Bean.html#sort--"><code>@Bean(sort=x)</code></a><br> + </td> + </tr> + <tr> + <td><ja>@JsonValue</ja><br><ja>@JsonRawValue</ja></td> + <td> + No equivalents.<br> + Future support unlikely since these are JSON-centric. + </td> + </tr> + </table> + </div> </div> <!-- ======================================================================================================== --> @@ -6088,7 +6185,7 @@ <h5 class='toc'>What's new in each release</h5> <ul class='toc'> - <li><p><a class='doclink' href='#6.2.0'>6.2.1 (TBD)</a></p> + <li><p><a class='doclink' href='#6.2.1'>6.2.1 (TBD)</a></p> <li><p><a class='doclink' href='#6.2.0'>6.2.0 (Apr 28, 2017)</a></p> <li><p><a class='doclink' href='#6.1.0'>6.1.0 (Feb 25, 2017)</a></p> <li><p><a class='doclink' href='#6.0.1'>6.0.1 (Jan 3, 2017)</a></p> @@ -6172,6 +6269,7 @@ <li><a href="org/apache/juneau/http/ContentType.html" title="class in org.apache.juneau.http"><code>ContentType</code></a> </ul> <li>Support for dynamic beans. See <a href="org/apache/juneau/annotation/BeanProperty.html#name--"><code>@BeanProperty.name()</code></a>. + <li>New doc: <a class='doclink' href='#Core.JacksonComparison'>2.12 - Comparison with Jackson</a> </ul> <h6 class='topic'>org.apache.juneau.rest</h6>
