juneau-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jamesbog...@apache.org
Subject incubator-juneau-website git commit: Add Jackson comparison section.
Date Thu, 04 May 2017 18:18:54 GMT
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 <jamesbognar@apache.org>
Authored: Thu May 4 14:18:46 2017 -0400
Committer: JamesBognar <jamesbognar@apache.org>
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>


Mime
View raw message