blob: 998bfdd5adb0f528335c6cb4b8b70839231ae02a [file] [log] [blame]
Tatu Saloranta688cbc12013-04-23 22:58:26 -07001Project: jackson-databind
Tatu Salorantaaf531892014-06-04 18:29:07 -07002Version: 2.4.1 (xx-Jun-2014)
3
4#479: NPE on trying to deserialize a `String[]` that contains null
5 (reported by huxi@github)
Tatu Saloranta9ae36102014-06-09 16:55:57 -07006#482: Make date parsing error behavior consistent with JDK
7 (suggested by Steve S, sanbeg@github)
Tatu Saloranta54fd6d62014-06-15 15:43:07 -07008#489 (partial): TypeFactory cache prevents garbage collection of custom ClassLoader
9 (reported by sftwrengnr@github)
Tatu Salorantaaf531892014-06-04 18:29:07 -070010
11------------------------------------------------------------------------
12=== History: ===
13------------------------------------------------------------------------
Tatu Salorantac29e06e2013-12-27 19:00:17 -080014
Tatu87052122014-06-10 11:45:43 -0700152.4.0 (02-Jun-2014)
16
Tatu Saloranta9c8022e2014-05-16 16:03:44 -070017#81: Allow use of @JsonUnwrapped with typed (@JsonTypeInfo) classes, provided
18 that (new) feature `SerializationFeature.FAIL_ON_UNWRAPPED_TYPE_IDENTIFIERS`
19 is disabled
20 (constributed by Ben F, UnquietCode@github)
Tatu Saloranta0e1e8782014-01-11 19:51:21 -080021#88: Prevent use of type information for `JsonNode` via default typing
22 (reported by electricmonk@github)
Tatu Saloranta18470152014-03-16 22:56:04 -070023#149: Allow use of "stringified" indexes for Enum values
24 (requested by chenboxiang@github)
Tatu Saloranta77f44972014-03-16 23:00:04 -070025#176: Allow use external Object Id resolver (to use with @JsonIdentityInfo etc)
26 (implemented by Pascal G)
Tatu Saloranta6809c862014-04-14 20:10:15 -070027#193: Conflicting property name definitions
28 (reported by Stuart J, sgjohnston@github)
Tatu Saloranta85841c92014-05-05 21:00:59 -070029#323: Serialization of the field with deserialization config
30 (reported by metanet@github)
Tatu Saloranta4e387c22014-05-07 22:51:56 -070031#327: Should not consider explicitly differing renames a fail, as long as all are explicit
Tatu Salorantabad574a2014-04-12 14:03:07 -070032#335: Allow use of `@JsonPropertyOrder(alphabetic=true)` for Map properties
Tatu Salorantaff56edf2014-04-12 14:39:01 -070033#352 Add `ObjectMapper.setConfig()` for overriding `SerializationConfig`/`DeserializationConfig`
Tatu Saloranta5df4c4e2014-03-14 12:54:09 -070034#353: Problems with polymorphic types, `JsonNode` (related to #88)
35 (reported by cemo@github)
Tatu Saloranta8d6fa482014-03-17 21:06:11 -070036#359: Converted object not using explicitly annotated serializer
Tatu Saloranta6da83fc2014-03-17 21:07:28 -070037 (reported by Florian S [fschopp@github])
Tatu Saloranta11f78112014-03-14 20:55:09 -070038#369: Incorrect comparison for renaming in `POJOPropertyBuilder`
Tatu Saloranta478d4a42014-03-16 21:53:33 -070039#375: Add `readValue()`/`readPropertyValue()` methods in `DeserializationContext`
Tatubc43fb42014-05-21 16:07:20 -070040#376: Add support for `@JsonFormat(shape=STRING)` for number serializers
Tatu Saloranta0f7358f2014-01-10 09:59:14 -080041#381: Allow inlining/unwrapping of value from single-component JSON array
42 (contributed by yinzara@github)
Tatu Saloranta02a63942014-03-14 18:53:45 -070043#390: Change order in which managed/back references are resolved (now back-ref
44 first, then forward)
45 (requested by zAlbee@github)
Tatu Saloranta3ca881e2014-02-25 22:06:04 -080046#407: Properly use null handlers for value types when serializer Collection
47 and array types
48 (contributed by Will P)
Tatu Saloranta97a0dea2014-05-19 23:55:15 -070049#425: Add support for using `Void.class` as "no class", instead of `NoClass.class`
Tatu3118fa02014-03-28 16:12:56 -070050#428: `PropertyNamingStrategy` will rename even explicit name from `@JsonProperty`
Tatu054467f2014-03-28 16:09:51 -070051 (reported by turskip@github)
Tatu Salorantadceaec52014-05-05 21:03:37 -070052#435: Performance bottleneck in TypeFactory._fromClass
53 (reported by Sean D, sdonovanuk@github)
Tatue2f9ea52014-04-07 09:58:56 -070054#434: Ensure that DecimalNodes with mathematically equal values are equal
55 (contributed by Francis G)
Tatu Saloranta2f58c932014-04-09 18:46:22 -070056#435: Performance bottleneck in TypeFactory._fromClass
57 (reported by sdonovanuk@github)
Tatu Salorantaab53ab42014-04-12 12:57:43 -070058#438: Add support for accessing `@JsonProperty(index=N)` annotations
Tatu Salorantad0b02732014-04-22 19:17:57 -070059#442: Make `@JsonUnwrapped` indicate property inclusion
60 (suggested by Ben F)
Tatu Salorantaf249d9e2014-05-19 23:14:51 -070061#447: ArrayNode#addAll should accept Collection<? extends JsonNode>
62 (suggested by alias@github)
Tatu Salorantaf339b5c2014-05-18 21:12:27 -070063#461: Add new standard naming strategy, `PropertyNamingStrategy.LowerCaseStrategy`
Tatu70034622014-05-21 14:41:45 -070064#463: Add 'JsonNode.asText(String defaultValue)`
65 (suggested by Chris C)
Tatu4bc7a732014-05-27 16:20:01 -070066#464: Include `JsonLocation` in more mapping exceptions
67 (contributed by Andy C (q3aiml@github))
Tatu50873672014-05-21 15:20:08 -070068#465: Make it easier to support serialization of custom subtypes of `Number`
Tatu Saloranta9c5fec22014-05-28 21:53:45 -070069#467: Unwanted POJO's embedded in tree via serialization to tree
70 (reported by Benson M)
Tatu Salorantabad574a2014-04-12 14:03:07 -070071- Slightly improve `SqlDateSerializer` to support `@JsonFormat`
Tatu Salorantab6da8662014-05-04 18:49:20 -070072- Improve handling of native type ids (YAML, CBOR) to use non-native type ids
73 as fallback
Tatu Saloranta0f7358f2014-01-10 09:59:14 -080074
Tatu Saloranta1c4a7b12014-04-14 20:24:48 -0700752.3.3 (10-Apr-2014)
76
77#420: Remove 'final' modifier from `BeanDeserializerBase.deserializeWithType`
78 (requested by Ghoughpteighbteau@github)
79#422: Allow use of "True" and "False" as aliases for booleans when coercing from
80 JSON String
81#423: Fix `CalendarSerializer` to work with custom format
82 (reported by sergeymetallic@github)
83#433: `ObjectMapper`'s `.valueToTree()` wraps `JsonSerializable` objects into a POJONode
84 (reported by Francis G)
85- Fix null-handling for `CollectionSerializer`
86
Tatu Saloranta397e4572014-03-06 20:24:47 -0800872.3.2 (01-Mar-2014)
88
89#378: Fix a problem with custom enum deserializer construction
90 (reported by BokoEnos@github)
91#379: Fix a problem with (re)naming of Creator properties; needed to make
92 Paranamer module work with NamingStrategy.
93 (reported by Chris P, cpilsworth@github)
94#398: Should deserialize empty (not null) URI from empty String
95 (reported by pgieser@github)
96#406: @JsonTypeIdResolver not working with external type ids
97 (reported by Martin T)
98#411: NumberDeserializers throws exception with NaN and +/- Infinity
99 (reported by clarkbreyman@github)
100#412: ObjectMapper.writerWithType() does not change root name being used
101 (repoted by jhalterman@github)
102- Added `BeanSerializerBase._serializeObjectId()` needed by modules that
103 override standard BeanSerializer; specifically, XML module.
104
Tatu Salorantac29e06e2013-12-27 19:00:17 -08001052.3.1 (28-Dec-2013)
Tatu Saloranta703bf4a2012-01-11 22:14:37 -0800106
Tatu Saloranta37cf6f22013-11-15 19:31:46 -0800107#346: Fix problem deserializing `ObjectNode`, with @JsonCreator, empty
108 JSON Object
109 (reported by gaff78@github)
Tatu Salorantace457af2013-12-03 22:27:20 -0800110#358: `IterableSerializer` ignoring annotated content serializer
111 (reported by Florian S)
Tatua5810c22014-02-28 14:15:02 -0800112#361: Reduce sync overhead for SerializerCache by using volatile, double-locking
Tatu Salorantaee7b6d82013-12-10 19:46:46 -0800113 (contributed by stuartwdouglas@github)
Tatu Saloranta9077a582013-12-07 20:58:58 -0800114#362: UUID output as Base64 String with ObjectMapper.convertValue()
115 (reported by jknack@github)
Tatu Salorantadf4f7f22013-12-13 19:55:00 -0800116#367: Make `TypeNameIdResolver` call `TypeResolver` for resolving base type
117 (suggested by Ben F)
Tatu Saloranta69b84872013-12-18 20:17:24 -0800118#370: Fail to add Object Id for POJO with no properties
119 (reported by jh3141@github)
Tatu Saloranta00255f22013-12-10 20:07:07 -0800120- Fix for [jackson-module-afterburner#38]: need to remove @JacksonStdImpl from
121 `RawSerializer`, to avoid accidental removal of proper handling.
Tatu Saloranta37cf6f22013-11-15 19:31:46 -0800122
Tatu Saloranta414b8842013-11-15 08:08:02 -08001232.3.0 (13-Nov-2013)
Tatu Salorantadf7fb3d2013-06-06 14:29:52 -0700124
Tatu Salorantaa9f447a2013-07-05 10:10:47 -0700125#48: Add support for `InetSocketAddress`
126 (contributed by Nick T)
Tatu14722dc2013-09-24 11:52:48 -0700127#152: Add support for traversing `JsonNode` with (new!) `JsonPointer` implementation
128 (suggested by fge@github)
Tatu Salorantaefdc0d42013-07-10 19:48:39 -0700129#208: Accept "fromString()" as an implicit Creator (factory) method (alias for "valueOf()")
130 (requested by David P)
Tatu Saloranta21a81e12013-06-06 17:31:07 -0700131#215: Allow registering custom `CharacterEscapes` to use for serialization,
132 via `ObjectWriter.with(CharacterEscapes)` (and `ObjectMapper.writer(CharacterEscapes)`)
Tatu Salorantae4708eb2013-06-06 17:07:10 -0700133#227: Allow "generic" Enum serializers, deserializers, via `SimpleModule`
Tatu Saloranta6f4306b2013-08-12 20:25:37 -0700134#234: Incorrect type information for deeply nested Maps
135 (reported by Andrei P)
Tatu Saloranta3955abb2013-06-06 15:29:58 -0700136#237: Add `DeserializationFeature.FAIL_ON_READING_DUP_TREE_KEY` to optionally
137 throw `JsonMappingException` on duplicate keys, tree model (`JsonNode`)
Tatu Saloranta833680a2013-07-10 19:37:14 -0700138#238: Allow existence of overlapping getter, is-getter (choose 'regular' getter)
Tatu Salorantaf0af8c12013-07-11 10:20:22 -0700139#239: Support `ByteBuffer`
140 (suggested by mckamey@github)
Tatu Saloranta0a42b402013-08-06 20:39:12 -0700141#240: Make sure `@JsonSerialize.include` does not accidentally override
142 class inclusion settings
143 (requested by thierryhenrio@github)
Tatu Salorantac6eaf4b2013-07-04 20:25:17 -0700144#253: `DelegatingDeserializer` causes problems for Managed/BackReferences
145 (reported by bfelaco@github)
Tatu Salorantaae242d72013-09-20 20:37:21 -0700146#257: Make `UntypedObjectDeserializer` support overides for `List`, `Map` etc
Tatu Saloranta4ec01ea2013-11-15 14:25:01 -0800147#268: Add new variant of `ObjectMapper.canSerialize()` that can return `Throwable`
Tatu Salorantaaf263c32013-10-24 16:18:50 -0700148 that caused false to be returned (if any)
Tatu Saloranta105c58a2013-07-26 16:33:43 -0700149#269: Add support for new `@JsonPropertyDescription` via `AnnotationIntrospector`
150 as well as `BeanProperty.getMedata().getDescription()`
Tatu Salorantacded3a22013-08-06 20:29:18 -0700151#270: Add `SerializationFeature.USE_EQUALITY_FOR_OBJECT_ID` to allow use of equality
152 (instead of identity) for figuring out when to use Object Id
153 (requested by beku8@github)
Tatu Salorantaaa321ee2013-09-19 19:53:28 -0700154#271: Support handling of `@JsonUnwrapped` for in-built JSON Schema generation
Tatu Salorantabb0e2b52013-09-12 21:07:31 -0700155#277: Make `TokenBuffer` support new native type and object ids
Tatu Saloranta545e35e2013-09-18 14:18:53 -0700156#302: Add `setNamingStrategy` in `Module.SetupContext`
157 (suggested by Miguel C)
Tatu Saloranta8caf1b42013-09-28 16:49:50 -0700158#305: Add support for accessing `TypeFactory` via `TypeIdResolverBase`
159 (not yet via `TypeIdResolver` interface), other configuration
Tatu Salorantabb0e2b52013-09-12 21:07:31 -0700160#306: Allow use of `@JsonFilter` for properties, not just classes
Tatu Salorantacc7524c2013-10-19 16:46:17 -0700161#307: Allow use of `@JsonFilter` for Maps in addition to POJOs
Tatu Salorantafae643b2013-09-13 23:34:31 -0700162#308: Improve serialization and deserialization speed of `java.util.UUID` by 4x
163 (suggested by David P)
Tatu Saloranta616d3e52013-09-18 14:11:36 -0700164#310: Improve `java.util.UUID` serialization with binary codecs, to use "raw" form.
Tatu Salorantadaab1d92013-09-18 14:07:44 -0700165#311: Make sure that "creator properties" are alphabetically ordered too, if
166 so requested.
Tatu Salorantab69857b2013-10-14 20:57:31 -0700167#315: Allow per-property definition of null serializer to use, using
168 new `@JsonSerialize(nullsUsing=xxx)` annotation property
Tatu Saloranta7012c752013-10-03 15:27:16 -0700169#317: Fix `JsonNode` support for nulls bound to `ObjectNode`, `ArrayNode`
170 (contributed by Seth P)
Tatu Salorantab0091942013-10-18 23:52:30 -0700171#318: Problems with `ObjectMapper.updateValue()`, creator property-backed accessors
Tatu Saloranta09ebacb2013-10-07 20:58:53 -0700172#319: Add support for per-call ("contextual") attributes, with defaulting,
173 to allow keeping track of state during (de)serialization
Tatu Salorantae4670a72013-10-14 19:31:39 -0700174#324: Make sure to throw `JsonMappingException` from `EnumDeserializer` creator,
175 not `IllegalArgumentException`
176 (reported by beverku@github)
Tatu Saloranta34a2e5b2013-10-17 22:37:10 -0700177#326: Support `@JsonFilter` for "any getter" properties
Tatu Saloranta2322ce62013-10-23 22:18:32 -0700178#334: Make `ArrayNode`, `ObjectNode` non-final again
Tatu Saloranta2f044912013-11-02 20:05:23 -0700179#337: `AnySetter` does not support polymorphic types
180 (reported by askvortsov@github)
Tatu Saloranta11f73042013-11-07 22:25:55 -0800181#340: AtomicReference not working with polymorphic types
182#342: Add `DeserializationFeature.FAIL_ON_IGNORED_PROPERTIES` to make `ObjectMapper`
183 throw exception when encountering explicitly ignored properties
184 (requested by Ruslan M)
Tatu Salorantab4b59032013-07-16 14:34:53 -0700185[JACKSON-890]: Support managed/back-references for polymorphic (abstract) types
Tatu Salorantaeb680992013-06-24 19:58:32 -0700186- Add 'BeanPropertyWriter.isUnwrapping()' for future needs (by Afterburner)
Tatu Saloranta955d1f92013-08-10 19:41:47 -0700187- Add coercions from String "null" (as if null token was parsed) for primitives/Wrappers.
Tatu Saloranta47ac6bd2013-09-05 20:55:00 -0700188- Add `JsonDeserializer.handledType()`
Tatu Saloranta3955abb2013-06-06 15:29:58 -0700189
Tatu Salorantadf7fb3d2013-06-06 14:29:52 -07001902.2.2 (26-May-2013)
Tatu Saloranta688cbc12013-04-23 22:58:26 -0700191
Tatu Salorantab7d896f2013-05-17 21:54:11 -0700192#216: Problems with Android, 1.6-only types
Tatu Salorantaded6b8a2013-05-17 21:07:40 -0700193#217: JsonProcessingExceptions not all wrapped as expected
194 (reported by karldmoore@github)
Tatu Saloranta29552ca2013-05-17 20:36:07 -0700195#220: ContainerNode missing 'createNumber(BigInteger)'
196 (reported by Pascal G)
Tatu Saloranta88f44d82013-05-17 20:05:18 -0700197#223: Duplicated nulls with @JsonFormat(shape=Shape.ARRAY)
198 (reported by lukegh@github)
Tatu Salorantad12a42f2013-05-25 21:04:52 -0700199#226: Field mapping fail on deserialization to common referenced object when
200 @JsonUnwrapped is used
201 (reported by ikvia@github)
Tatu Salorantad2ec7c32013-05-25 17:02:32 -0700202#232: Converting bound BigDecimal value to tree fails with WRITE_BIGDECIMAL_AS_PLAIN
203 (reported by celkings@github)
Tatu Saloranta688cbc12013-04-23 22:58:26 -0700204- Minor fix to handle primitive types for key deserializer lookups
Tatu Saloranta580b85f2013-05-01 21:37:09 -0700205- Add convenience method `MappingIterator.getCurrentLocation()`
206 (suggested by Tomdz@github)
Tatu Saloranta688cbc12013-04-23 22:58:26 -0700207
Tatu Salorantaef9e64f2013-05-26 22:18:44 -07002082.2.1 (03-May-2013)
209
210#214: Problem with LICENSE, NOTICE, Android packaging
211 (reported by thierryd@github)
212
Tatu Saloranta688cbc12013-04-23 22:58:26 -07002132.2.0 (22-Apr-2013)
Tatu Saloranta703bf4a2012-01-11 22:14:37 -0800214
Tatu Saloranta6426e042012-11-12 14:31:50 -0800215Fixes:
216
Tatu Saloranta43307b42013-03-15 15:37:45 -0700217#23: Fixing typing of root-level collections
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700218#118: JsonTypeInfo.as.EXTERNAL_PROPERTY not working correctly
Tatu Salorantaa795fa22013-01-18 20:05:11 -0800219 with missing type id, scalar types
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700220#130: TimeZone not set for GregorianCalendar, even if configured
221#144: MissingNode.isValueNode() should return 'false'
Tatu Saloranta99d9d182013-01-11 11:47:38 -0800222 (reported by 'fge@github')
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700223#146: Creator properties were not being renamed as expected
Tatu Salorantaf6ce07d2013-01-12 11:29:46 -0800224 (contributed by Christoper C)
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700225#188: Problem with ObjectId serialization, 'alwaysAsId' references
Tatu Saloranta99d9d182013-01-11 11:47:38 -0800226
Tatu Salorantad8b40712012-11-20 19:01:14 -0800227Improvements:
228
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700229#116: JavaType implements `java.lang.reflect.Type` (as does `TypeReference`)
230#147: Defer reporting of problems with missing creator parameters
Tatu Saloranta6f931562013-01-12 14:13:42 -0800231 (contributed by Christoper C)
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700232#155: Make `ObjectNode` and `ArrayNode` final (other node types already were)
Tatu Saloranta8640b592013-02-08 11:04:22 -0800233 (requested by fge@github)
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700234#161: Add deserializer for java.util.concurrent.ArrayBlockingQueue
235#173: Add 'JsonNode.traverse(ObjectCodec)' for convenience
Tatu Saloranta1e0a7662013-04-08 15:34:02 -0700236#181: Improve error reporting for missing '_valueDeserializer'
Tatu Salorantadfb697a2013-03-28 15:11:48 -0700237#194: Add `FloatNode` type in tree model (JsonNode)
238 (requested by msteiger@github)
Tatu Saloranta10dc5c92013-04-07 16:11:10 -0700239#199: Allow deserializing `Iterable` instances (as basic `Collection`s)
240 (requested by electrum@github)
Tatu Saloranta9adb08e2013-04-11 16:29:59 -0700241#206: Make 'ObjectMapper.createDeserializationContext()' overridable
242 (requested by noter@github)
Tatu Saloranta0a4a0312013-04-16 20:02:37 -0700243#207: Add explicit support for `short` datatypes, for tree model
244 (contributed by msteiger@github)
Tatu Salorantad8b40712012-11-20 19:01:14 -0800245
Tatu Saloranta6426e042012-11-12 14:31:50 -0800246New features:
247
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700248#120: Extend BeanDeserializerModifier to work with non-POJO deserializers
249#121: Extend BeanSerializerModifier to work with non-POJO serializers
250#124: Add support for serialization converters (@JsonSerializer(converter=...))
251#124: Add support for deserialization converters (@JsonDeserializer(converter=...))
252#140: Add 'SerializationFeature.WRITE_BIGDECIMAL_AS_PLAIN' to allow forcing
Tatu Salorantaac5edb82013-01-06 08:27:50 -0800253 of non-scientific notation when serializing BigDecimals.
254 (suggested by phedny@github)
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700255#148: Add 'DeserializationFeature.FAIL_ON_INVALID_SUBTYPE`, which allows mapping
Tatu Saloranta192c1dc2013-02-06 22:28:58 -0800256 entries with missing or invalid type id into null references (instead of failing).
257 Also allows use of '@JsonTypeInfo.defaultImpl = NoClass.class' as alternative.
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700258#159: Add more accessors in 'MappingIterator': getParser(), getParserSchema(),
Tatu Salorantade7e9242013-02-04 16:24:40 -0800259 readAll()
260 (suggested by Tom D)
Tatu Saloranta8f2ea6c2013-03-28 15:46:06 -0700261#190: Add 'MapperFeature.ALLOW_FINAL_FIELDS_AS_MUTATORS' (default: true) for
262 pruning out final fields (to avoid using as mutators)
263 (requested by Eric T)
Tatu Saloranta21d83572013-03-28 14:18:48 -0700264#195: Add 'MapperFeature.INFER_PROPERTY_MUTATORS' (default: enabled) for finer
265 control of what mutators are auto-detected.
266 (requested by Dain S)
Tatu Saloranta42086532013-04-11 16:42:08 -0700267#198: Add SPI metadata, handling in ObjectMapper (findModules()), for
268 automatic registration of auto-detected extension modules
269 (suggested by 'beamerblvd@github')
Tatu Salorantac7112ff2013-04-09 15:47:23 -0700270#203: Added new features to support advanced date/time handling:
271 - SerializationFeature.WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS
272 - DeserializationFeature.READ_DATE_TIMESTAMPS_AS_NANOSECONDS
273 - DeserializationFeature.ADJUST_DATES_TO_CONTEXT_TIME_ZONE
Tatu Salorantad8b40712012-11-20 19:01:14 -0800274
Tatu Saloranta4f62fed2013-01-11 19:43:26 -0800275Other:
276
Tatu Saloranta20d53b02013-03-10 22:56:23 -0700277#126: Update JDK baseline to 1.6
Tatu Salorantaa795fa22013-01-18 20:05:11 -0800278* API under 'com.fasterxml.jackson.databind.jsonFormatVisitors' changed significantly
279 based on experiences with external JSON Schema generator.
280* Version information accessed via code-generated access class, instead of reading
281 VERSION.txt
Tatu Salorantacc737522013-03-03 13:11:25 -0800282* Added 2 methods in Converter interface: getInputType(), getOutputType(),
283 to allow programmatic overrides (needed by JAXB annotation module)
Tatu Saloranta4f62fed2013-01-11 19:43:26 -0800284
Tatu Saloranta7126f552013-03-10 20:14:41 -07002852.1.4 (26-Feb-2013)
286
287* [JACKSON-887]: StackOverflow with parameterized sub-class field
288 (reported by Alexander M)
289* [#130]: TimeZone not set for GregorianCalendar, when deserializing
290* [#157]: NPE when registering module twice
291* [#162]: JsonNodeFactory: work around an old bug with BigDecimal and zero
292 (submitted by fge@github)
293* [#166]: Incorrect optimization for `ObjectMapper.convertValue(Class)`
294 (reported by Eric T)
295* [#167]: Problems with @JsonValue, polymorphic types (regression from 1.x)
296 (reported by Eric T)
297* [#170]: Problems deserializing `java.io.File` if creator auto-discovery disabled
298 (reported by Eric T)
299* [#175]: NPE for JsonMappingException, if no path is specified
300 (reported by bramp@github)
301
3022.1.3 (19-Jan-2013)
303
304* [Issue#141]: ACCEPT_EMPTY_STRING_AS_NULL_OBJECT not working for enums
305* [Issue#142]: Serialization of class containing EnumMap with polymorphic enum
306 fails to generate class type data
307 (reported by kidavis4@github)
308
3092.1.2 (04-Dec-2012)
310
311* [Issue#106]: NPE in ObjectArraySerializer.createContextual(...)
312* [Issue#117]: HandlerInstantiator defaulting not working
313 (reported by Alexander B)
314* [Issue#118]: Problems with JsonTypeInfo.As.EXTERNAL_PROPERTY, scalar values
315 (reported by Adva11@github)
316* [Issue#119]: Problems with @JsonValue, JsonTypeInfo.As.EXTERNAL_PROPERTY
317 (reported by Adva11@github)
318* [Issue#122]: ObjectMapper.copy() was not copying underlying mix-in map
319 (reported by rzlo@github)
320
Tatu Saloranta6426e042012-11-12 14:31:50 -08003212.1.1 (11-Nov-2012)
Tatu Saloranta41a152a2012-10-20 11:18:03 -0700322
323Fixes:
324
Tatu Saloranta002b54f2012-11-08 13:21:50 -0800325* [JACKSON-875]: Enum values not found if Feature.USE_ANNOTATIONS disabled
326 (reported by Laurent P)
Tatu Saloranta41a152a2012-10-20 11:18:03 -0700327* [Issue#93]: ObjectNode.setAll() broken; would not add anything for
328 empty ObjectNodes.
329 (reported by Francis G)
Tatu Salorantaa50e76b2012-11-01 19:34:49 -0700330* Making things implement java.io.Serializable:
Tatu Saloranta92521712012-11-06 16:59:51 -0800331 - Issues: #94, #99, #100, #102
332 (reported by Sean B)
Tatu Saloranta231be532012-10-26 18:19:42 -0700333* [Issue#96]: Problem with JsonTypeInfo.As.EXTERNAL_PROPERTY, defaultImpl
334 (reported by Adva11@github)
Tatu Saloranta41a152a2012-10-20 11:18:03 -0700335
Tatu Salorantaa50e76b2012-11-01 19:34:49 -07003362.1.0 (08-Oct-2012)
Tatu Saloranta41a152a2012-10-20 11:18:03 -0700337
Tatu Saloranta3e96cf62012-10-05 21:38:16 -0700338 New minor version for 2.x series. Major improvements in multiple areas,
339 including:
340
341 - Dataformat auto-detection
342 - More `@JsonFormat.shape` variant to serialize Collections as
343 JSON Objects, POJOs as JSON Arrays (csv-like).
344 - Much more configuration accessible via ObjectReader, ObjectWriter
345 - New mechanism for JSON Schema generation, other uses (in future)
Tatu Salorantac2776412012-05-14 19:40:57 -0700346
347Fixes:
348
Tatu Saloranta01006e32012-08-24 14:35:55 -0700349* [JACKSON-830]/[Issue#19]: Change OSGi bundle name to be fully-qualified
Tatu Salorantae8c1b532012-08-29 11:49:21 -0700350* ]JACKSON-847]: Make @JsonIdentityInfo work with property-based creator
Tatu Salorantabc483d12012-08-01 23:35:59 -0700351* [JACKSON-851]: State corruption with ObjectWriter, DefaultPrettyPrinter
352 (reported by Duncan A)
Tatu Saloranta8075bfa2012-09-29 22:55:20 -0700353* [Issue#75]: Too aggressive KeySerializer caching
Tatu Saloranta01006e32012-08-24 14:35:55 -0700354* Minor fix wrt [Issue#11], coercion needed extra checks
Tatu Salorantafcbce112012-06-28 14:43:43 -0700355
Tatu Salorantace7398c2012-05-30 20:45:03 -0700356Improvements:
357
Tatu Salorantaac1f2ab2012-08-01 19:49:20 -0700358* [JACKSON-758]: Remove 'IOException' from throws clauses of "writeValueAsString"
359 and "writeValueAsBytes" of ObjectMapper/ObjectWriter
360 (suggested by G-T Chen)
Tatu Salorantace7398c2012-05-30 20:45:03 -0700361* [JACKSON-839]: Allow "upgrade" of integer number types for
362 UntypedObjectDeserializer, even with default typing enabled.
Tatu Saloranta11cec4d2012-07-22 22:33:20 -0700363* [JACKSON-850]: Allow use of zero-arg factory methods as "default creator"
364 (suggested by Razvan D)
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700365* [Issue#9]: Implement 'required' JSON Schema attribute for bean properties
366* [Issue#20]: Add new exception type, InvalidFormatException (sub-type of
Tatu Salorantadd348562012-07-18 17:25:02 -0700367 JsonMappingException) to indicate data format problems
368 (suggested by HolySamosa@github)
Tatu Saloranta2aa6dc82012-08-29 23:06:06 -0700369* [Issue#30]: ObjectReader and ObjectWriter now try to pre-fetch root
Tatu Saloranta15d6ea22012-08-03 18:29:23 -0700370 (de)serializer if possible; minor performance improvement (2% for small POJOs).
Tatu Saloranta2aa6dc82012-08-29 23:06:06 -0700371* [Issue#33]: Simplified/clarified definition of 'ObjectReader.readValues()';
Tatu Salorantaa12061f2012-07-20 21:42:26 -0700372 minor change in behavior for JSON Array "wrapped" sequences
Tatu Saloranta2aa6dc82012-08-29 23:06:06 -0700373* [Issue#60]: Add 'JsonNode.hasNonNull(...)' method(s)
374 (suggested by Jeff S on mailing list)
Tatu Salorantaeb4e6b12012-08-30 19:02:17 -0700375* [Issue#64]: Add new "standard" PropertyNamingStrategy, PascalCaseStrategy
376 (PropertyNamingStrategy.PASCAL_CASE_TO_CAMEL_CASE)
377 (contributed by Sean B)
Tatu Saloranta0dc8dec2012-09-06 17:08:29 -0700378* [Issue#65]: Add getters to `ObjectMapper`, DeserializationContext/-Factory.
379 (contributed by Dmitry K)
Tatu Salorantaab374c72012-09-04 22:10:52 -0700380* [Issue#69]: Add `PropertyName` abstraction, new methods in AnnotationIntrospector
Tatu Saloranta4984d592012-09-30 18:04:39 -0700381* [Issue#80]: Make `DecimalNode` normalize input, to make "1.0" and "1.00"equal
382 (reported by fge@github)
Tatu Salorantace7398c2012-05-30 20:45:03 -0700383
Tatu Saloranta6cada0a2012-07-31 22:24:03 -0700384New features:
385
Tatu Salorantad163f5e2012-08-20 16:49:15 -0700386* [Issue#15]: Support data format auto-detection via ObjectReader (added
387 'withFormatDetection(...)' fluent factories)
Tatu Saloranta767cead2012-08-13 16:27:45 -0700388* [Issue#21]: Add 'ObjectNode.set(...)' method (and related) to improve
389 chaining, semantic consistency of Tree Model API
390 (suggested by fge@Github)
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700391* [Issue#22]: Add 'ObjectMapper.setAnnotationIntrospectors()' which allows
Tatu Saloranta15d6ea22012-08-03 18:29:23 -0700392 defining different introspectors for serialization, deserialization
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700393* [Issue#24]: Allow serialization of Enums as JSON Objects
Tatu Saloranta15d6ea22012-08-03 18:29:23 -0700394 (suggested by rveloso@github)
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700395* [Issue#28]: Add 'ObjectMapper.copy()', to create non-linked copy of
396 mapper, with same configuration settings
397* [Issue#29]: Allow serializing, deserializing POJOs as JSON Arrays
Tatu Saloranta6cada0a2012-07-31 22:24:03 -0700398 by using `@JsonFormat(shape=Shape.ARRAY)`
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700399* [Issue#40]: Allow serialization of Collections as JSON Objects
Tatu Saloranta15d6ea22012-08-03 18:29:23 -0700400 (and deserialization from)
Tatu Saloranta8d2cdd72012-08-13 23:10:51 -0700401 (suggested by 'rveloso@github')
402* [Issue#42]: Allow specifying Base64 variant to use for Base64-encoded data
403 using ObjectReader.with(Base64Variant), ObjectWriter.with(Base64Variant).
404 (suggested by 'mpfau@github')
Tatu Saloranta023d8bd2012-08-13 22:17:28 -0700405* [Issue#45]: Add '@JsonNaming' annotation to define per-class PropertyNamingStrategy
406 (suggested by Mark W)
Tatu Saloranta45267962012-08-28 10:10:43 -0700407* [Pull#58]: Make 'MappingIterator' implement 'Closable'
408 (contributed by Pascal G)
Tatu Salorantaf412e852012-09-11 22:05:51 -0700409* [Issue#72]: Add 'MapperFeature.USE_WRAPPER_NAME_AS_PROPERTY_NAME' to use
410 wrapper name annotations for renaming properties
Tatu Saloranta06a23ce2012-10-03 17:18:47 -0700411* [Issue#87]: Add 'StdDelegatingSerializer', 'StdDelegatingDeserializer' to
412 simplify writing of two-step handlers
Tatu Saloranta88040e22012-08-24 13:33:00 -0700413* (issue #4 of jackson-annotations): Add `@JsonIdentityReference(alwaysAsId=true)`
Tatu Saloranta6cada0a2012-07-31 22:24:03 -0700414 to force ALL references to an object written as Object Id, even the first one.
Tatu Saloranta15d6ea22012-08-03 18:29:23 -0700415* Added 'ObjectReader#withHandler' to allow for reconfiguring deserialization
416 problem handler
417 (suggested by 'electricmonk')
Tatu Saloranta6cada0a2012-07-31 22:24:03 -0700418
Tatu Saloranta2b4086a2012-06-29 20:27:24 -0700419Other changes:
420
421* New variant of AnnotationIntrospector.getFormat(), to support class
422 annotations
Tatu Saloranta134d3562012-07-05 21:38:46 -0700423* It is now possible to serialize instances of plain old Object, iff
424 'FAIL_ON_EMPTY_BEANS' is disabled.
Tatu Saloranta9b847962012-09-11 15:16:41 -0700425* Trying to remove reference to "JSON" in datatype conversion errors
426 (since databinding is format-agnostic)
Tatu Saloranta2b4086a2012-06-29 20:27:24 -0700427
Tatu Salorantaa12061f2012-07-20 21:42:26 -0700428INCOMPATIBILITIES: (rats!)
429
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700430* Note that [Issue#33] (see above) is, technically speaking, backwards
Tatu Salorantaa12061f2012-07-20 21:42:26 -0700431 imcompatible change. It is estimated that it should NOT affect most
432 users, as changes are to edge cases (and undocumented ones at that).
433 However, it can potentially cause problems with upgrade.
Tatu Saloranta45c7f242012-10-03 22:36:17 -0700434* Implementation of `JsonFormatVisitable` resulting in 2 new methods
435 being added in `BeanPropertyFilter` interface -- this is unfortunate,
436 but was required to support full traversability.
Tatu Salorantaa12061f2012-07-20 21:42:26 -0700437
Tatu Salorantaa12061f2012-07-20 21:42:26 -07004382.0.4 (26-Jun-2012)
439
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700440* [Issue#6]: element count for PrettyPrinter, endObject wrong
Tatu Salorantaa12061f2012-07-20 21:42:26 -0700441 (reported by "thebluemountain")
442* [JACKSON-838]: Utf8StreamParser._reportInvalidToken() skips letters
443 from reported token name
Tatu Saloranta023d8bd2012-08-13 22:17:28 -0700444 (reported by Lóránt Pintér)
Tatu Salorantaa12061f2012-07-20 21:42:26 -0700445* [JACKSON-841] Data is doubled in SegmentedStringWriter output
446 (reported by Scott S)
447* [JACKSON-842] ArrayIndexOutOfBoundsException when skipping C-style comments
448 (reported by Sebastien R)
449
4502.0.3: no version 2.0.3 released -- only used for extension modules
451
Tatu Salorantac2776412012-05-14 19:40:57 -07004522.0.2 [14-May-2012]
Tatu Saloranta23e267c2012-04-23 19:22:04 -0700453
454Fixes:
455
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700456* [Issue#14]: Annotations were not included from parent classes of
Tatu Saloranta1b30b1a2012-04-28 00:43:34 -0700457 mix-in classes
458 (reported by @guillaup)
Tatu Salorantae16034e2012-04-30 22:51:36 -0700459* [JACKSON-824]: Combination of JSON Views, ObjectMapper.readerForUpdating()
460 was not working
461 (reported by Nir S)
Tatu Salorantab8f79ed2012-05-14 19:04:53 -0700462(and all fixes from 1.9.7)
Tatu Saloranta1b30b1a2012-04-28 00:43:34 -0700463
Tatu Salorantacfa2fc12012-04-27 19:31:28 -0700464Improvements:
465
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700466* [Issue#11]: Improve ObjectMapper.convertValue()/.treeToValue() to use
Tatu Salorantacfa2fc12012-04-27 19:31:28 -0700467 cast if possible
468
Tatu Saloranta23e267c2012-04-23 19:22:04 -07004692.0.1 [23-Apr-2012]
Tatu Saloranta737ad052012-04-02 21:04:47 -0700470
471Fixes:
472
Tatu Salorantafc3db392012-04-23 18:49:08 -0700473* [JACKSON-827] Ensure core packages work on JDK 1.5
474 (reported by Pascal g)
Tatu Salorantaae4ea6e2012-04-19 19:47:53 -0700475* [JACKSON-829] Custom serializers not working for List<String> properties,
476 @JsonSerialize(contentUsing)
477 (reported by James R)
478
Tatu Saloranta737ad052012-04-02 21:04:47 -0700479Improvements:
480
Tatu Saloranta7ccce012012-08-04 16:17:54 -0700481* [Issue#5]: Add support for maps with java.util.Locale keys to the set of
Tatu Saloranta737ad052012-04-02 21:04:47 -0700482 StdKeyDeserializers
483 (contributed by Ryan G)
484
Tatu Salorantafc3db392012-04-23 18:49:08 -07004852.0.0 [25-Mar-2012]
Tatu Saloranta703bf4a2012-01-11 22:14:37 -0800486
487Fixes:
488
Tatu Saloranta337feca2012-03-19 19:11:21 -0700489* [JACKSON-368]: Problems with managed references, abstract types
Tatu3af61ff2012-01-19 15:58:41 -0800490* [JACKSON-711]: Delegating @JsonCreator did not work with Injectable values
Tatu Salorantae1ceccd2012-03-04 19:52:36 -0800491* [JACKSON-798]: Problem with external type id, creators
492 (reported by Casey L)
Tatu Salorantadeaee9c2012-03-25 12:01:34 -0700493(and all fixes up until and including 1.9.6)
Tatu9e6c28f2012-01-19 15:58:08 -0800494
Tatu Salorantae1ceccd2012-03-04 19:52:36 -0800495Improvements:
Tatu Saloranta703bf4a2012-01-11 22:14:37 -0800496
Tatu Saloranta28ff1a92012-01-17 17:54:51 -0800497* [JACKSON-546]: Indicate end-of-input with JsonMappingException instead
498 of EOFException, when there is no parsing exception
Tatu Salorantaee6e3d12012-01-17 17:28:39 -0800499* [JACKSON-664]: Reduce overhead of type resolution by adding caching
500 in TypeFactory
Tatu Saloranta7555fa22012-01-14 23:03:04 -0800501* [JACKSON-690]: Pass DeserializationContext through ValueInstantiator
Tatu418a2392012-01-12 21:52:07 -0800502* [JACKSON-695]: Add 'isEmpty(value)' in JsonSerializer to allow
503 customizing handling of serialization of empty values
Tatu Saloranta15fb6ff2012-01-14 10:31:35 -0800504* [JACKSON-710]: 'ObjectMapper.convertValue()' should ignore root value
505 wrapping/unwrapping settings
Tatu60668262012-01-19 14:21:12 -0800506* [JACKSON-730] Split various features (JsonParser, JsonGenerator,
507 SerializationConfig, DeserializationConfig) into per-factory
Tatu Saloranta048832d2012-03-09 21:48:40 -0800508 features (MapperFeature, JsonFactory.Feature) an per
Tatu60668262012-01-19 14:21:12 -0800509 instance features (existing ones)
Tatu Salorantaa03e0eb2012-01-14 14:01:39 -0800510* [JACKSON-732]: Allow 'AnnotationIntrospector.findContentDeserializer()'
511 (and similar) to return instance, not just Class<?> for instance
512 (requested by James R)
Tatu Saloranta4b02e9e2012-02-03 18:41:29 -0800513* [JACKSON-736]: Add (more) access to array, container and map serializers
Tatu Salorantac166fa32012-02-03 19:42:41 -0800514* [JACKSON-737]: Allow accessing of "creator properties" for BeanDeserializer
Tatucbbfbd32012-01-20 16:07:51 -0800515* [JACKSON-748]: Add 'registerSubtypes' to 'Module.setupContext' (and SimpleModule)
Tatu Saloranta703bf4a2012-01-11 22:14:37 -0800516* [JACKSON-749]: Make @JsonValue work for Enum deserialization
Tatub471a042012-01-27 11:51:39 -0800517* [JACKSON-769]: ObjectNode/ArrayNode: change 'put', 'insert', 'add' to return
518 'this node' (unless already returning something)
Tatu Salorantae5d77692012-01-29 11:20:26 -0800519* [JACKSON-770]: Simplify method naming for JsonNode, drop unnecessary 'get' prefix
520 from methods like 'getTextValue()' (becomes 'textValue()')
Tatu9610aff2012-02-02 11:30:08 -0800521* [JACKSON-777]: Rename 'SerializationConfig.Feature' as 'SerializationFeature',
Tatu Saloranta28808722012-02-24 18:35:50 -0800522 'DeserializationConfig.Feature' as 'DeserializationFeature'
Tatu Salorantadfc4c882012-02-11 13:54:27 -0800523* [JACKSON-780]: MissingNode, NullNode should return 'defaultValue' from 'asXxx' methods,
Tatu Saloranta28808722012-02-24 18:35:50 -0800524 (not 0 for numbers), as they are not numeric types
Tatu Saloranta3ae9c392012-05-18 16:45:47 -0700525* [JACKSON-787]: Allow use of @JsonIgnoreProperties for properties (fields, getters, setters)
Tatu Saloranta28808722012-02-24 18:35:50 -0800526* [JACKSON-795]: @JsonValue was not working for Maps, Collections
Tatu Salorantacf5d5472012-03-03 11:47:51 -0800527* [JACKSON-800]: Add 'Module.SetupContext#addDeserializationProblemHandler'
528 (suggested by James R)
Tatu Saloranta703bf4a2012-01-11 22:14:37 -0800529
530New features:
531
Tatu Salorantac99a7842012-02-22 18:09:00 -0800532* [JACKSON-107]: Add support for Object Identity (to handled cycles, shared refs),
Tatu Salorantadeaee9c2012-03-25 12:01:34 -0700533 with @JsonIdentityInfo
Tatu Saloranta26b2e1b2012-02-22 22:50:21 -0800534* [JACKSON-435]: Allow per-property Date formatting using @JsonFormat.
Tatu Saloranta89580482012-01-20 22:08:56 -0800535* [JACKSON-437]: Allow injecting of type id as POJO property, by setting
536 new '@JsonTypeInfo.visible' property to true.
Tatu Saloranta17ad21f2012-02-19 10:01:31 -0800537* [JACKSON-469]: Support "Builder pattern" for deserialiation; that is, allow
538 use of separate Builder object for data binding, creating actual value
Tatu Saloranta7324b9b2012-02-02 21:51:16 -0800539* [JACKSON-608]: Allow use of JSON Views for deserialization
Tatu Saloranta49117e02012-03-03 16:01:12 -0800540* [JACKSON-636]: Add 'SerializationFeature.ORDER_MAP_ENTRIES_BY_KEYS' to allow
541 forced sorting of Maps during serialization
542 (suggested by Joern H)
Tatu Saloranta2aa64842012-01-14 22:25:08 -0800543* [JACKSON-669]: Allow prefix/suffix for @JsonUnwrapped properties
544 (requested by Aner P)
Tatu Salorantaf0e232d2012-01-29 16:44:28 -0800545* [JACKSON-707]: Add 'JsonNode.deepCopy()', to create safe deep copies
546 of ObjectNodes, ArrayNodes.
Tatu Salorantaff8c08c2012-02-21 22:21:21 -0800547* [JACKSON-714]: Add general-purpose @JsonFormat annotation
Tatubc4153e2012-01-18 15:05:44 -0800548* [JACKSON-718]: Added 'JsonNode.canConvertToInt()', 'JsonNode.canConvertToLong()'
Tatu Saloranta048832d2012-03-09 21:48:40 -0800549* [JACKSON-747]: Allow changing of 'SerializationFeature' for ObjectWriter,
550 'DeserializationFeature' for ObjectReader.
Tatu Saloranta2aa64842012-01-14 22:25:08 -0800551* [JACKSON-752]: Add @JsonInclude (replacement of @JsonSerialize.include)
Tatu Salorantaf7c45bf2012-01-16 18:26:47 -0800552* [JACKSON-754]: Add @JacksonAnnotationsInside for creating "annotation
553 bundles" (also: AnnotationIntrospector.isAnnotationBundle())
Tatubbebf462012-02-03 17:44:31 -0800554* [JACKSON-762]: Allow using @JsonTypeId to specify property to use as
555 type id, instead of using separate type id resolver.
Tatu Salorantae1961742012-01-22 16:03:47 -0800556* [JACKSON-764]: Allow specifying "root name" to use for root wrapping
557 via ObjectReader, ObjectWriter.
Tatu Saloranta361c0a82012-02-24 18:16:29 -0800558* [JACKSON-772]: Add 'JsonNode.withArray()' to use for traversing Array nodes.
559* [JACKSON-793]: Add support for configurable Locale, TimeZone to use
560 (via SerializationConfig, DeserializationConfig)
Tatu Saloranta048832d2012-03-09 21:48:40 -0800561* [JACKSON-805]: Add 'SerializationFeature.WRITE_SINGLE_ELEM_ARRAYS_UNWRAPPED'
562 to improve interoperability with BadgerFish/Jettison
Tatu Salorantaf293cc42012-03-24 21:10:18 -0700563* [JACKSON-810]: Deserialization Feature: Allow unknown Enum values via
564 'DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL'
565 (suggested by Raymond R)
Tatu Saloranta33a9a932012-03-21 18:12:14 -0700566* [JACKSON-813]: Add '@JsonSerializableSchema.id' attribute, to indicate
567 'id' value to add to generated JSON Schemas.
Tatu Saloranta2aa64842012-01-14 22:25:08 -0800568
Tatu Saloranta703bf4a2012-01-11 22:14:37 -0800569[entries for versions 1.x and earlier not retained; refer to earlier releases)