Changes between Version 29 and Version 30 of pyson

Timestamp:

05/18/21 08:42:55 (4 years ago)

Author:

wouter

Comment:

--

pyson

@@ -65 +65 @@
 
 The "Id" value can have the value NONE, NAME, CLASS. We recommend to use NAME,
-||NONE|| Do not include class id at all. Do not use this with @JsonTypeInfo. Only included because it was availale in Jackson||
+
+||Id Value||meaning||
+||NONE||Do not include class id at all. Do not use this with @JsonTypeInfo. Only included because it was availale in Jackson||
 ||NAME||Use the name of the class to refer to the class. All classes referred must have different name (not two the same names with different classpath).||
 ||CLASS||Use the full.class.path to refer to the class. ||
 
-We recommend NAME, because it is shorter and gives more readable json, and gives you flexibility to move around the actual classes if needed without breaking compabibility with existing json files||
-
-
-Indicates how to include the class name is included in/extracted from the json. 
-
-====
+NAME should be used, the others are not properly implemented. We recommend this method anyway, because it is shorter and gives more readable json, and gives you flexibility to move around the actual classes if needed without breaking compabibility with existing json files||
+
+The "As" annotation indicates *how* to include the class name is included in/extracted from the json. 
+
+||As value||meaning||
+||PROPERTY||The json dict is extended with a {{{type}}} parameter containing the class Id||
+||WRAPPER_OBJECT||A dict is created with the class Id as key, and as value the actual class contents||
+||WRAPPER+ARRAY||An array is used for storing the contents of the class|| 
+
+At this moment WRAPPER_OBJECT should be used; the others are not properly implemented.
 
 === Inheritance of annotations